Aghanim-AppsFlyer 통합
해당 가이드는 AppsFlyer와 Aghanim을 통합하여 모바일 애트리뷰션 및 분석을 간소화하는 방법을 설명합니다. Aghanim을 AppsFlyer와 연결하면 게임 허브에서 플레이어가 생성한 이벤트를 추적하여 전체 게임 환경에서 사용자 동작을 정확하게 추적할 수 있습니다.
정보
Aghanim은 현재 플레이어가 게임 허브에서 결제를 성공적으로 완료했을 때에만 AppsFlyer에 이벤트를 보냅니다.
요구 사항
- AppsFlyer 계정
- API 토큰을 생성하거나 조회할 수 있는 관리자 권한
1단계: AppsFlyer API 토큰 제공
AppsFlyer에서 API 토큰을 얻어 통신을 인증하고 Aghanim이 이벤트를 보낼 수 있도록 합니다:
- AppsFlyer에 로그인합니다.
- 대시보드에서 Configuration → API Tokens 또는 Server-to-Server (S2S) Tokens로 이동합니다.
- API 토큰이 아직 없을 경우, 제공된 지침에 따라 새 토큰을 생성합니다.
- 생성된 토큰을 복사합니다.
- Aghanim 대시보드로 이동 → App Connect → AppsFlyer 플러그인을 설치합니다.
- 플러그인 설정에서 생성된 토큰을 붙여넣습니다.
자세한 내용은 AppsFlyer 설명서를 참조하십시오.
2단계: player.verify 웹훅 응답에 AppsFlyer 속성 추가
게임 허브에서 사용자를 정확히 식별하고 행동이 애트리뷰션 될 수 있도록, player.verify 웹훅 응답에 AppsFlyer 전용 속성을 포함하십시오:
| Key | 형식 | 설명 | 필수 여부 |
|---|---|---|---|
attributes.appsflyer_id | string | 앱이 처음 실행될 때 AppsFlyer에서 생성하는 고유 식별자입니다. 이 ID는 앱 내 사용자의 활동을 AppsFlyer 프로필에 연결합니다. 예시: 1234567890123-1234567. | 예 |
attributes.appsflyer_app_id | string | AppsFlyer 대시보드에 정의된 앱 식별자. 데이터를 AppsFlyer의 올바른 애플리케이션에 연결합니다. 예시: id123456789. | 예 |
attributes.appsflyer_event_params | object | AppsFlyer 이벤트에 포함할 선택적 사용자 지정 매개변수. 매개변수를 직접 추가하거나 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