导入历史用户数据

任何时候,只要 Branch SDK 看到我们从未见过的用户,都会新增该用户的新安装记录。这对于刚上架应用商店的新应用没什么问题,然而对于 app store 中现有的,但对 Branch 是新的应用来说是一个问题。

如果在实现 Branch SDK 之前,您的应用已经具有一定的用户基础,您则会遇到误报(新安装)的问题。这些用户实际上不是应用的新用户,而只是在 Branch 看来是新用户。

To avoid unnecessary discrepancies and ensure your existing users are not attributed as new installs, use the Link Data Import Tool to inform Branch about your pre-existing users.

使用教程

  1. Format your historical data to adhere to the supported JSON line text format.
    • 有关必填字段和可选字段的信息,请参见下面的导入文件格式(Import File Format)部分。
    • Branch 可以从任何来源(其他归因提供者,第三方分析提供者和内部 BI 系统)提取历史数据,只要该数据符合包含必填字段的文件格式要求即可。
  2. Contact your TAM or Account Executive to begin the import process.
  3. Once your historical data has been imported and verified, your TAM or Support contact will send notification of a successful import.

注意事项

  • 下游分析不受影响→导入当天安装量没有激增。
  • 根据我们的隐私政策,导入后30天内在 Branch 平台上没有任何归因数据记录的用户,或在导入后90天内完全没有活动的用户将被删除。
  • 当前不支持以下功能:
    —归因导入之前的点击。
    —分析/查看操作后台 (Dashboard)或导出(Exports)中的历史数据。

导入文件格式

Before Branch can ingest your historical user data, please ensure your data conforms to the JSON line text format.

🚧

需要 JSON 行文本格式

我们无法转化或提取其他格式的数据。

基于设备 ID 的用户导入

📘

仅设备 ID

提供以下必填字段可确保 Branch 可以根据您在导入期间提供的设备 ID 为每个用户创建一个 Persona (同人用户)。

iOS 设备必须具有 IDFA,IDFV 或两者兼备,以便 Branch 将其提取。同样,Android 设备必须具有 GAID 或Android ID,以便 Branch 将其提取。

如果您没有特定的 ID 或与设备无关,请完全省略该字段。

每个单独的日志都应在单行 json 对象中捕获,包括以下字段:

{
    "timestamp": <unix epoch milliseconds long>(required),
    "app_id": <app ID long>(required; your **Branch** App ID found on your Branch dashboard under Account Settings),
    "idfa": "<idfa string>" (IDFA or IDFV is required for iOS devices),
    "gaid": "<google ad id string> (GAID or Android ID is required for Android devices),
    "windows_aid": "<windows ad id string>" (required for Windows devices),
    "kindle_aid": "<kindle hardware id string>" (required for Kindle devices),
    "touch_type": "click/impression" (required if not organic)
}

可选的受支持字段:

📘

可选字段

尽管不是必需的,但我们建议您提供额外信息,以创建更可靠的用户角色,并增强 Branch 的其他功能,例如欺诈规则。

"idfv": "<idfv string>",
“android_id”: <google android id string>,
"developer_id": "<customer user id string">,
"os_version": string,
"sdk_version": string,
"country_code": string,
“region_name": string,
"skip_record": 0 (=>1 to exclude record from import),

例如

以下是设备导入的示例,与启用了“限制广告追踪(Limit Ad Tracking)”功能的 iOS 设备有关,因此只有 IDFV 可用:

{
    "timestamp": 1600720443123
    "app_id": 123456789012345678,
        "idfv": "30255BCE-4CDA-4F62-91DC-4758FDFF8512"
}

额外归因数据导入

📘

额外触点数据

提供以下可选触点数据字段可确保 Branch 可以将与导入用户相关联的安装事件的 campaign 详细信息相关联。这样就可以进行下游安装同期群群组分析。

"install": {
           “timestamp”:<unix epoch milliseconds long>,
           “touch_data”: {

                  "~campaign": string
                  "~campaign_id": string
                  "~advertising_partner_name": string
                  "~advertising_partner_id": string
                  "~keywords": array
                  …
                  …
                  *refer to extended list of supported fields in this
            }
        },
           “strong_match”: boolean (defaults to false, determines whether subsequent attribution type would be strong/weak, stores click as last_click or weak_match_last_click),
           “force_update”: boolean (defaults to false, determines whether to add the attribution data to install cohorts)

    }