본문으로 건너뛰기

Adjust 실시간 콜백

최근 업데이트 2026. 10. 03.
팁

서드파티 데이터 통합으로 생성된 데이터는 클러스터의 소비 데이터양에 포함됩니다

개요​

인터페이스 소개​

인터페이스명타입세분화어트리뷰션비용수익노출클릭전환
실시간 콜백콜백유저 수준✅✅✅

Adjust는 여러 이벤트에 대해 실시간 콜백 기능을 제공합니다. Adjust 백엔드에서 콜백할 데이터 타입을 선택하고 AE 시스템의 콜백 링크를 콜백 주소에 설정하면 유저 수준의 상세 데이터를 콜백할 수 있습니다.

Adjust 데이터 연동을 시작하기 전에 AE 시스템의 유저 식별 규칙을 읽고, AE가 #distinct_id와 #account_id로 유저를 식별하는 방식을 이해했는지 확인하십시오

통합 절차​

  1. Adjust 클라이언트 SDK와 AE SDK를 연동하고, Adjust SDK에 AE의 유저 식별 ID를 설정합니다
  2. AE 백엔드에 로그인하여 서드파티 통합 모듈로 이동한 후 Adjust 실시간 콜백 계획을 추가하고 관련 설정을 완료합니다
  3. Adjust 백엔드에 로그인하여 콜백 설정을 완료합니다
  4. AE 시스템이 데이터를 정상적으로 수신했는지 확인하고 리포트를 구축합니다

1. 클라이언트 SDK 설정​

Adjust 데이터 통합의 첫 단계는 클라이언트에서 AE SDK와 Adjust SDK를 연결하여 Adjust SDK에 AE 시스템의 유저 식별 ID를 설정하는 것입니다

1.1 방안 1(자동 통합)​

  • Android, iOS SDK를 연동한 경우

  • Unity SDK 버전 2.4.0 이상, Unreal SDK 버전 1.5.0 이상을 연동한 경우 이 방안을 바로 사용할 수 있습니다

팁

AE SDK 초기화와 자동 통합 활성화 코드는 반드시 Adjust SDK 초기화 전에 완료해야 합니다. 다음 단계에 따라 진행하십시오:

1. AE SDK를 초기화합니다.

2. `enableThirdPartySharing`을 호출하여 게스트 ID를 자동으로 설정합니다.

3. Adjust SDK를 초기화합니다.

다음은 각 플랫폼 SDK의 코드 예시입니다:

// 1. Android SDK 초기화
TDConfig config = TDConfig.getInstance(this, APPID, TE_SERVER_URL);
TDAnalytics.init(config);
// 2. enableThirdPartySharing 인터페이스를 호출하여 ta_distinct_id를 adjust 이벤트에 설정
TDAnalytics.enableThirdPartySharing(TDThirdPartyType.ADJUST);
// 3. Adjust SDK 초기화
//  ...
// 4. 회원가입 또는 캐릭터 생성 후 login을 호출하여 계정 ID를 설정한 다음 데이터를 다시 동기화해야 함(선택 사항)
TDAnalytics.login("account_id");
TDAnalytics.enableThirdPartySharing(TDThirdPartyType.ADJUST);
팁

AE SDK의 login() 메서드나 identify() 메서드를 호출한 경우 enableThirdPartySharing()을 다시 호출하여 데이터를 동기화해야 합니다.

이 방안의 원리는 내부에서 Adjust SDK의 addGlobalCallbackParameter() 메서드를 자동으로 호출하여 AE 프로젝트의 게스트 ID와 계정 ID를 전달하는 것입니다.

1.2 방안 2(수동 통합)​

수동 통합 방안에서는 Adjust SDK에서 addGlobalCallbackParameter() 인터페이스를 사용하여 AE 프로젝트의 게스트 ID와 계정 ID를 설정해야 합니다.

팁

AE SDK 초기화와 addGlobalCallbackParameter 인터페이스 호출은 반드시 Adjust SDK 초기화 전에 완료해야 합니다. 다음 단계에 따라 진행하십시오:

1. AE SDK를 초기화합니다.

2. `addGlobalCallbackParameter`를 호출하여 게스트 ID를 설정합니다.

3. Adjust SDK를 초기화합니다.

다음은 각 플랫폼 SDK의 수동 통합 코드 예시입니다:

// 1. Android SDK 초기화
TDConfig config = TDConfig.getInstance(this, APPID, TE_SERVER_URL);
TDAnalytics.init(config);
// 2. AE의 게스트 ID 가져오기(AE의 #distinct_id에 해당)
String distinctId = TDAnalytics.getDistinctId();
// 3. 게스트 ID를 adjust 수집 이벤트에 설정

// Adjust sdk V5 미만 버전은 addSessionCallbackParameter 인터페이스를 사용하십시오
//Adjust.addSessionCallbackParameter("ta_distinct_id", distinctId);

// Adjust sdk V5 이상 버전은 addGlobalCallbackParameter  인터페이스를 사용하십시오
Adjust.addGlobalCallbackParameter("ta_distinct_id", distinctId);
// 4. Adjust SDK 초기화
//  ...
// 5. 회원가입 또는 캐릭터 생성 후 login을 호출하여 계정 ID를 설정한 다음 데이터를 다시 동기화해야 함(선택 사항)
String accountId = "ta_account_id";
TDAnalytics.login(accountId);
Adjust.addGlobalCallbackParameter("ta_account_id", accountId);

2. 계획 설정​

SDK 설정을 마친 후에는 AE 시스템 백엔드에 로그인하여 서드파티 통합 모듈에서 Adjust 설정을 완료해야 합니다. 아래 그림은 Adjust의 설정 화면입니다:

2.1 유저 식별 필드​

Adjust가 콜백하는 데이터는 유저 수준 데이터이므로 유저 식별 규칙, 즉 콜백 데이터에서 #distinct_id와 #account_id에 대응하는 필드를 설정해야 합니다. AE 시스템은 이 설정에 따라 콜백 데이터를 변환할 때 해당 필드를 데이터의 유저 식별 필드로 설정합니다.

이 문서의 이전 단계에 따라 클라이언트 SDK를 설정했다면 기본값을 그대로 사용할 수 있습니다:

  • 계정 ID 연관 필드: ta_account_id
  • 게스트 ID 연관 필드: ta_distinct_id

AE 시스템은 이 설정에 따라 콜백 데이터의 유저를 식별하여, Adjust가 콜백한 유저 단위 데이터를 AE 프로젝트의 해당 유저와 연관시킵니다.

기본 규칙은 다음과 같습니다:

  • 계정 ID: 콜백 데이터에 ta_account_id가 있는지 확인하고, 있으면 #account_id로 설정하고 없으면 비워 둡니다
  • 게스트 ID: 콜백 데이터에 ta_distinct_id가 있는지 확인하고, 있으면 #distinct_id로 설정하고 없으면 비워 둡니다
  • 계정 ID와 게스트 ID가 모두 비어 있으면 해당 데이터는 유효하지 않은 데이터로 간주되어 바로 폐기됩니다

2.2 이벤트 테이블 저장 설정​

이벤트 테이블 저장 설정 스위치를 켜면 Adjust가 콜백한 데이터가 모두 이벤트 테이블에 기록됩니다. 이벤트 데이터 저장을 활성화하는 것을 권장합니다.

2.3 유저 속성 저장 규칙​

기본적으로 AE 시스템은 Adjust 콜백 데이터의 어트리뷰션 필드를 표준화 처리된 유저 속성에 자동으로 기록합니다. 유저 속성에 기록되는 필드와 그 의미는 다음과 같습니다:

Adjust 필드AE 저장 후 유저 속성 이름설명
network_namete_ads_object.media_source채널
campaign_namete_ads_object.campaign_name캠페인
adgroup_namete_ads_object.ad_group_name광고 그룹
creative_namete_ads_object.ad_name광고 소재
팁

이전 버전의 유저 속성 저장 기본 규칙은 현재와 다르므로 구분에 주의하십시오. 새 속성과 기존 속성을 병합해야 한다면 가상 속성 기능을 사용할 수 있습니다

수정이 필요하면 규칙 설정을 클릭하여 저장 규칙 설정 페이지로 이동합니다. 아래 그림과 같습니다

여기에서 유저 속성을 어떤 이벤트에서 가져올지 수정할 수 있습니다. 유저 속성이 너무 자주 기록되지 않게 하려면 모든 이벤트 포함을 끄고 소스 이벤트명을 install로 수정하면 됩니다. 이렇게 설정하면 AE 시스템은 Adjust가 콜백한 install 이벤트에서만 유저 속성에 기록할 필드를 추출하여 기록합니다. 저장 방식의 기본값은 user_setOnce이며, 처음 전송된 정보만 유지합니다.

속성 매핑 버튼을 클릭하여 유저 속성에 기록할 필드를 추가할 수 있습니다. 또한 왼쪽의 규칙 버튼을 클릭하여 새 규칙을 추가할 수도 있습니다. 예를 들어 Adjust가 콜백한 수익화 데이터에서 광고 수익을 추출하여 user_add 방식으로 유저 속성에 기록하면 각 유저의 누적 광고 수익을 기록할 수 있습니다.

유저 속성 저장을 끄려면 모든 규칙을 중지하면 됩니다:

2.4 엔드포인트 주소​

2.4.1 기본 설정​

시스템 및 프로젝트 수준의 데이터 수집 주소를 설정한 경우 다음과 같은 링크가 표시됩니다. 이 주소를 그대로 복사하여 Adjust 백엔드의 실시간 콜백 설정에 붙여넣으면 됩니다:

여기에 주소가 표시되지 않으면 오른쪽 상단 메뉴의 프로젝트 관리 → 프로젝트 구성 → 연동 설정에서 공용 네트워크 주소를 설정하십시오. 이 주소는 AE SDK에 설정한 데이터 수집 주소입니다. 설정한 후 Adjust 실시간 콜백 설정 페이지의 엔드포인트 주소로 돌아가 엔드포인트 주소를 복사합니다.

2.4.2 커스텀 매크로​

Adjust의 콜백 주소에는 매크로라는 구조가 포함되며, {macro_name} 형식으로 표기합니다. 매크로는 일종의 플레이스홀더로, 콜백 데이터에 매크로에 대응하는 필드가 포함되어 있으면 Adjust가 해당 필드 값을 매크로가 있는 위치에 채웁니다. {campaign_name}을 예로 들면, Adjust는 데이터를 콜백할 때 campaign_name의 값을 콜백 주소에서 매크로가 있는 위치에 채웁니다. Adjust의 콜백 데모 영상을 참고하여 매크로의 역할을 알아볼 수 있습니다.

AE 화면에 콜백 주소가 표시되므로 그대로 복사하는 것을 권장합니다. 주소에서 다음 내용을 바꿔야 한다는 점에 유의하십시오:

  • {receiver-host}: 데이터 수집 주소, 즉 AE 백엔드 프로젝트 관리 → 프로젝트 구성 → 연동 설정의 공용 네트워크 주소
  • {app-id}: AE의 프로젝트 APP ID
팁

이전 버전의 데이터 소스 주소는 현재와 다르므로 구분에 주의하십시오. 새 주소를 사용하는 것을 권장합니다.

그 밖에 추가하려는 파라미터가 있으면 이 문서를 참고하십시오

2.5 이벤트 저장 규칙​

  • 데이터의 created_at_milli 필드를 이벤트의 #event_time으로 사용하며, created_at_milli가 없으면 created_at 값을 #event_time으로 사용합니다

  • 데이터의 이벤트 이름은 다음과 같습니다:

    • 설치: install
    • 광고 수익: ad_revenue
    • 기타 이벤트: Adjust 백엔드의 이벤트 이름

  • 콜백 링크에 설정한 기타 필드는 모두 저장됩니다

2.6 표준화 필드​

다음 이벤트 속성은 표준화 처리됩니다:

원본 필드표준화 필드의미
network_namete_ads_object.media_source미디어 채널
ad_mediation_platformte_ads_object.media_source수익화 채널
campaign_namete_ads_object.campaign_name캠페인 이름
google_ads_campaign_namete_ads_object.campaign_name캠페인 이름(Google Ads 데이터만)
google_ads_campaign_idte_ads_object.campaign_id캠페인 ID(Google Ads 데이터만)
adgroup_namete_ads_object.ad_group_name광고 그룹 이름
google_ads_adgroup_namete_ads_object.ad_group_name광고 그룹 이름(Google Ads 데이터만)
google_ads_adgroup_idte_ads_object.ad_group_id광고 그룹 ID(Google Ads 데이터만)
creative_namete_ads_object.ad_name광고 이름
google_ads_creative_idte_ads_object.ad_id광고 ID(Google Ads 데이터만)
ad_revenue_placementte_ads_object.placement수익화 광고 위치
google_ads_placementte_ads_object.placement광고 위치(Google Ads 데이터만)
cost_amountte_ads_object.cost집행 비용
cost_currencyte_ads_object.currencyUA 집행 통화
revenue_usdte_ads_object.revenue수익화 수익
USD 고정값te_ads_object.currency수익화 수익의 통화
countryte_ads_object.country국가/지역 코드
os_namete_ads_object.platform플랫폼(Android, iOS 등)
app_idte_ads_object.app_id앱 ID
app_namete_ads_object.app_name앱 이름

3. Adjust 실시간 콜백 인터페이스 설정​

AE 백엔드 설정을 마친 후 관리자 계정으로 Adjust 백엔드에 로그인합니다. 왼쪽 메뉴에서 AppView - All apps를 클릭하고 콜백을 설정할 대상 앱을 찾아 Server callbacks 버튼을 클릭하면 콜백 설정 페이지로 이동합니다.

이어서 콜백 설정 페이지 오른쪽 상단의 새 콜백 버튼을 클릭하고 Classic Setup으로 새 콜백을 생성합니다.

모든 콜백 이벤트를 검토한 결과, 설치 이벤트와 광고 수익 이벤트에 대해 각각 단일 이벤트 콜백을 설정할 것을 권장합니다. 콜백을 권장하는 이벤트는 다음과 같습니다:

이벤트 표시명이벤트 이름(Trigger)
설치install
광고 수익(Adjust Growth Solution 구매 필요)ad revenue

설치 이벤트(install) 콜백에는 다음 매크로를 사용하는 것을 권장합니다

https://{receiver-host}/attribution/callback/adjust/{app-id}?network_name={network_name}&campaign_name={campaign_name}&adgroup_name={adgroup_name}&creative_name={creative_name}&activity_kind={activity_kind}&created_at_milli={created_at_milli}&timezone={timezone}&event_name={event_name}&cost_amount={cost_amount}&cost_currency={cost_currency}&publisher_parameters={publisher_parameters}&app_id={app_id}&app_name={app_name}&country={country}&os_name={os_name}&app_version={app_version}

광고 수익 이벤트(ad revenue)에는 다음 매크로를 사용하는 것을 권장합니다

https://{receiver-host}/attribution/callback/adjust/{app-id}?network_name={network_name}&campaign_name={campaign_name}&adgroup_name={adgroup_name}&creative_name={creative_name}&activity_kind={activity_kind}&created_at_milli={created_at_milli}&timezone={timezone}&event_name={event_name}&cost_amount={cost_amount}&cost_currency={cost_currency}&publisher_parameters={publisher_parameters}&app_id={app_id}&app_name={app_name}&country={country}&os_name={os_name}&currency={currency}&revenue={revenue_float}&placement={ad_revenue_placement}&ad_revenue_unit={ad_revenue_unit}&ad_revenue_network={ad_revenue_network}&app_version={app_version}

4. 후속 사용​

4.1 데이터 저장 확인​

데이터 관리 페이지에서 콜백 이벤트가 저장되었는지 확인할 수 있습니다:

  • 설치: install
  • 광고 수익: ad_revenue
  • 기타 이벤트: Adjust 백엔드의 이벤트 이름

리포트 구축에 대한 몇 가지 권장사항은 다음과 같습니다:

  1. 이벤트 분석 모델에서 Adjust 콜백 데이터로 광고 집행 및 광고 수익화 핵심 지표를 구축하여 광고 분석 리포트를 생성합니다
  2. 리텐션 분석 모델에서 콜백 데이터의 광고 수익화와 게임 내 결제 이벤트를 결합하여 미디어 채널, 캠페인 등의 세분화 수준별로 광고 수익화를 포함한 LTV를 계산합니다
  3. 퍼널 분석 모델에서 설치 이벤트를 신규 유저 전환 퍼널에 추가하고, 미디어 채널, 캠페인 등의 세분화 수준으로 소스별 유저의 전환 현황을 분석합니다

5. 부록​

5.1 Facebook 유저 어트리뷰션 플레이스홀더가 Unattributed로 표시되는 문제의 해결 방법​

배경​

Facebook이 amm을 중단한 이후 Facebook에서 유입된 유저의 어트리뷰션 플레이스홀더(예: {campaign_name})가 모두 Unattributed로 콜백됩니다. Android 플랫폼에서 Facebook 출처 유저의 어트리뷰션 정보를 계속 가져오려면 새 플레이스홀더를 사용해야 합니다.

해결 단계 - Adjust 측 설정​

  1. Install Referrer 플러그인 설치

먼저 Android 앱에 다음 SDK 구성 요소가 통합되어 있는지 확인하십시오: https://help.adjust.com/zh/article/get-started-android-sdk?src=search_page#set-up-install-referrer

  1. Adjust Facebook 모듈에 Facebook의 Decryption Key 추가

다음으로 Facebook developer account (https://developers.facebook.com/)(Dashboard > Settings > Basic > Android (Google Play) Install Referrer Decryption Key)에서 Decryption Key를 가져올 수 있습니다. 각 Decryption Key는 하나의 고유한 Facebook App ID에 대응합니다. 이 값은 앱 데이터의 출처를 가져오는 데 핵심이므로 Adjust 대시보드(해당 Android 앱의 App settings > Partner setup > Facebook)에 추가하십시오

  1. 새 플레이스홀더 사용

다음은 이 해결 방법에서 앱 데이터를 가져오는 데 사용하는 새 플레이스홀더입니다. Adjust는 현재 설치 활동 콜백에 이러한 플레이스홀더를 추가하는 것을 지원하며, 향후 다른 활동으로 확대할 예정입니다. 현재 Adjust는 {adid} 또는 기타 내부 ID로 설치 및 설치 후 이벤트 데이터를 매핑할 것을 권장합니다.

  • {fb_install_referrer}: 디코딩된 Facebook install referrer 전체 값
  • {fb_install_referrer_ad_id}: Facebook install referrer 전체 값의 "ad_id"
  • {fb_install_referrer_adgroup_id}: Facebook install referrer 전체 값의 "adgroup_id"
  • {fb_install_referrer_adgroup_name}: Facebook install referrer 전체 값의 "adgroup_name"
  • {fb_install_referrer_campaign_id}: Facebook install referrer 전체 값의 "campaign_id"
  • {fb_install_referrer_campaign_name}: Facebook install referrer 전체 값의 "campaign_name"
  • {fb_install_referrer_campaign_group_id}: Facebook install referrer 전체 값의 "campaign_group_id"
  • {fb_install_referrer_campaign_group_name}: Facebook install referrer 전체 값의 "campaign_group_name"
  • {fb_install_referrer_account_id}: Facebook install referrer 전체 값의 "account_id"
  • {fb_install_referrer_ad_objective_name}: Facebook install referrer 전체 값의 "ad_objective_name"

해결 단계 - AE 백엔드 설정​

Adjust 실시간 콜백 계획으로 이동합니다. 주로 영향을 받는 부분은 유저 속성 저장 규칙입니다. Facebook의 어트리뷰션 필드를 유저 속성으로 설정하려면 매크로 이름을 소스 속성명 열에 입력하고 대상 속성명을 설정하십시오:

이 문서가 도움이 되었나요?
이 페이지의 내용