과거 유저 데이터 가져오기

Branch 는 이전에 본적이 없는 유저의 첫 세션에 대해 Install 을 기록합니다. 새로운 앱이 앱 스토어에 도입되는 경우에는 이러한 로직이 완벽하지만, 앱 스토어에 이미 라이브되어 있지만 Branch를 처음 사용하게 되는 앱에서는 문제가 될 수 있습니다.

만약 Branch SDK 를 연동하기전에 이미 기존의 유저 베이스가 존재한다면 false positive 가 발생할 수 있습니다. 실제로 신규 유저가 아니지만 Branch의 입장에서는 신규 유저라서 Install 로 기록할 수 있습니다.

불필요한 수치차이를 방지하고 기존 유저가 신규의 오픈이 신규 Install 로 기록되는 것을 피하기 위해 Persona Data Import Tool 을 사용하여 Branch 에게 기존 유저의 데이터를 알려줄 수 있습니다.

작동 원리

  1. Format your historical data to adhere to the supported JSON line text format.
    • 필수 및 선택 필드에 대한 정보는 아래의 파일 임포트 파일 포맷을 참조하세요.
    • Branch 의 임포트 파일 포맷에 부합되고 필요한 필드가 포함되어 있다면 Branch는 다른 어트리뷰션 제공자, 제3자 분석 플랫폼, 내부 BI 시스템을 포함한 모든 소스의 데이터를 임포트할 수 있습니다.
  2. Persona Import 작업을 시작하려면 담당 CSM에게 문의하세요.
  3. 히스토리 데이터 임포트 및 검증이 완료됨과 동시에 CSM 또는 Support 담당으로부터 작업완료에 대한 알림을 받을 수 있습니다.

유의사항

  • 다운스트림 이벤트 분석은 영향을 받지 않음 → 임포트 당일 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)

    }

이 페이지가 도움이 되었습니까?