导入历史用户数据

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

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

为避免不必要的差异,并确保现有用户没有被归为新安装,请使用 Persona Data Import Tool 来向 Branch 导入您先前存在的用户。

使用教程

  1. Format your historical data to adhere to the supported JSON line text format.
    • 有关必填字段和可选字段的信息,请参见下面的导入文件格式(Import File Format)部分。
    • Branch 可以从任何来源(其他归因提供者,第三方分析提供者和内部 BI 系统)提取历史数据,只要该数据符合包含必填字段的文件格式要求即可。
  2. 请与您的 CSM 联系以开始导入过程。
  3. 导入并验证您的历史数据后,您的 CSM 或支持中心将发送成功导入的通知。

注意事项

  • 下游分析不受影响→导入当天安装量没有激增。
  • 根据我们的隐私政策,导入后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)

    }

这个页面对您有帮助吗?