과거 유저 데이터 가져오기
Branch 는 이전에 본적이 없는 유저의 첫 세션에 대해 Install 을 기록합니다. 새로운 앱이 앱 스토어에 도입되는 경우에는 이러한 로직이 완벽하지만, 앱 스토어에 이미 라이브되어 있지만 Branch를 처음 사용하게 되는 앱에서는 문제가 될 수 있습니다.
만약 Branch SDK 를 연동하기전에 이미 기존의 유저 베이스가 존재한다면 false positive 가 발생할 수 있습니다. 실제로 신규 유저가 아니지만 Branch의 입장에서는 신규 유저라서 Install 로 기록할 수 있습니다.
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.
작동 원리
- Format your historical data to adhere to the supported JSON line text format.
- 필수 및 선택 필드에 대한 정보는 아래의 파일 임포트 파일 포맷을 참조하세요.
- Branch 의 임포트 파일 포맷에 부합되고 필요한 필드가 포함되어 있다면 Branch는 다른 어트리뷰션 제공자, 제3자 분석 플랫폼, 내부 BI 시스템을 포함한 모든 소스의 데이터를 임포트할 수 있습니다.
- Contact your TAM or Account Executive to begin the import process.
- Once your historical data has been imported and verified, your TAM or Support contact will send notification of a successful import.
유의사항
- 다운스트림 이벤트 분석은 영향을 받지 않음 → 임포트 당일 Install 급증이 발생하지 않습니다.
- Branch의 개인정보 보호정책에 따르면 유저 데이터가 임포된 이후 30일 동안 Branch 플랫폼에 어트리뷰션 데이터가 기록되지 않거나 90일 동안 활동이 없으면 자동으로 삭제됩니다.
- 현재 지원되지 않는 기능은 다음과 같습니다.
- 데이터 임포트 이전에 기록된 클릭에 어트리뷰
- 대시보드 또는 추출된 데이터 내에서 히스토리 데이터 분석/보기.
임포트 파일 포맷
Before Branch can ingest your historical user data, please ensure your data conforms to the JSON line text format.
JSON 행 텍스트 포맷 필요
다른 형식의 데이터는 핵석하거나 처리할 수 없습니다.
디바이스 ID 기반의 유저 임포트
디바이스 ID만 가능
다음과 같은 필수 필드를 제공하면 Branch에서는 데이터 임포트에 제공된 디바이스 ID를 기반으로 개별 유저에 대한 페르소나를 만들 수 있습니다.
Branch 에서 iOS 유저의 데이터 임포트를 처리하려면 IDFA, IDFV 중 하나 또는 둘다 있어야 합니다. 마찬가지로 Android 유저의 데이터를 임포트하려면 GAID 또는 Android ID가 있어야 합니다.
특정 ID가 없거나 그것이 디바이스와 관련이 없는 경우 해당 필드를 완전히 생략하시기 바랍니다.
각 개별로그는 아래의 필수 필드가 포함된 single line 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)
}
선택적으로 지원되는 필드
선택적 필드
필수는 아니지만, 보다 강력한 유저 페르소나를 생성하고 Fraud 규칙과 같은 다른 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),
예시
다음은 광고 추적 제한이 설정된 iOS 디바이스에 대한 디바이스 정보 임포트의 예입니다. 여기서 IDFV만 사용할 수 있습니다.
{
"timestamp": 1600720443123,
"app_id": 123456789012345678,
"idfv": "30255BCE-4CDA-4F62-91DC-4758FDFF8512"
}
추가 어트리뷰션 데이터 임포트
추가 터치 데이터
다음의 선택적 터치 데이터 필드를 제공하면 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)
}
Updated 4 months ago