导入历史用户数据

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

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

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

使用教程

  1. 格式化历史数据,使其遵循支持的 JSON行文本格式
    • 有关必填字段和可选字段的信息,请参见下面的“导入文件格式”部分。
    • Branch可以从任何来源(其他归因提供者,第三方分析提供者和内部BI系统)提取历史数据,只要该数据符合包含必填字段的文件格式要求即可。
  2. 请与您的CSM联系以开始导入过程。
  3. 导入并验证您的历史数据后,您的CSM或支持联系人将发送成功导入通知。

注意事项

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

导入文件格式

在Branch可以提取您的历史用户数据之前,请确保您的数据符合 JSON行文本格式

需要JSON行文本格式

我们无法翻译或提取其他格式的数据。

基于设备ID的用户导入

仅设备ID

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

每个单独的日志都应捕获在单行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>" (required for iOS devices),
    "gaid": "<google ad id string> (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),

附加归因数据导入

附加触点数据

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

"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)

    }

大约一个月前更新

导入历史用户数据


建议的编辑仅限于API参考页

您只能建议对Markdown正文内容进行修改,而不能建议对API规范进行修改。