주요 콘텐츠로 건너뛰기

Aghanim-AppsFlyer 통합

해당 가이드는 AppsFlyer와 Aghanim을 통합하여 모바일 애트리뷰션 및 분석을 간소화하는 방법을 설명합니다. Aghanim을 AppsFlyer와 연결하면 게임 허브에서 플레이어가 생성한 이벤트를 추적하여 전체 게임 환경에서 사용자 동작을 정확하게 추적할 수 있습니다.

정보

Aghanim은 현재 플레이어가 게임 허브에서 결제를 성공적으로 완료했을 때에만 AppsFlyer에 이벤트를 보냅니다.

요구 사항

  • AppsFlyer 계정
  • API 토큰을 생성하거나 조회할 수 있는 관리자 권한

1단계: AppsFlyer API 토큰 제공

AppsFlyer에서 API 토큰을 얻어 통신을 인증하고 Aghanim이 이벤트를 보낼 수 있도록 합니다:

  1. AppsFlyer에 로그인합니다.
  2. 대시보드에서 ConfigurationAPI Tokens 또는 Server-to-Server (S2S) Tokens로 이동합니다.
  3. API 토큰이 아직 없을 경우, 제공된 지침에 따라 새 토큰을 생성합니다.
  4. 생성된 토큰을 복사합니다.
  5. Aghanim 대시보드로 이동 → App ConnectAppsFlyer 플러그인을 설치합니다.
  6. 플러그인 설정에서 생성된 토큰을 붙여넣습니다.

자세한 내용은 AppsFlyer 설명서를 참조하십시오.

2단계: player.verify 웹훅 응답에 AppsFlyer 속성 추가

게임 허브에서 사용자를 정확히 식별하고 행동이 애트리뷰션 될 수 있도록, player.verify 웹훅 응답에 AppsFlyer 전용 속성을 포함하십시오:

Key형식설명필수 여부
attributes.appsflyer_idstring앱이 처음 실행될 때 AppsFlyer에서 생성하는 고유 식별자입니다. 이 ID는 앱 내 사용자의 활동을 AppsFlyer 프로필에 연결합니다. 예시: 1234567890123-1234567.
attributes.appsflyer_app_idstringAppsFlyer 대시보드에 정의된 앱 식별자. 데이터를 AppsFlyer의 올바른 애플리케이션에 연결합니다. 예시: id123456789.
attributes.appsflyer_event_paramsobjectAppsFlyer 이벤트에 포함할 선택적 사용자 지정 매개변수. 매개변수를 직접 추가하거나 eventValue 안에 중첩할 수 있습니다. 예: {"idfa": "9876F1SS-2983-3855-27RR-2R626772VFNB", "eventValue": {"your_custom_attribute": "456.123"}}.아니요

속성 값에 대한 추가 세부 사항은 AppsFlyer 문서를 참조하세요.

웹훅 응답 예시:

{
"player_id": "1x1x-xxxx1",
"name": "Molly",
"attributes": {
"appsflyer_id": "1234567890123-1234567",
"appsflyer_app_id": "id123456789",
"appsflyer_event_params": {
"idfa": "9876F1SS-2983-3855-27RR-2R626772VFNB",
"eventValue": {
"your_custom_attribute": "456.123"
}
}
}
}

2단계 (B): AppsFlyer 속성을 딥링크를 통해 전송

또는 player.verify 웹훅 응답을 통해 속성을 보낼 수 없을 경우, 예를 들어 이 ID를 서버에 저장하지 않은 경우 딥 링크 로그인 URL에 쿼리 매개변수를 전달할 수 있습니다.

https://<GAME_HUB_URL>/go/login?player_id=<UNIQUE_PLAYER_ID>&attributes.appsflyer_id=<APPSFLYER_ID>&attributes.appsflyer_app_id=<APPSFLYER_APP_ID>

하지만 웹훅 방법을 사용하는 것이 더 신뢰할 수 있고 안전하기 때문에 권장합니다.

도움이 필요하세요?
통합팀에 문의하십시오 integration@aghanim.com