한눈에 보기: 앱스플라이어와 Amplitude를 연동하여 사용자 어트리뷰션 데이터 및 이벤트 분석 정보를 공유하고 유저 인게이지먼트, 리텐션 및 수익에 대한 더 풍부한 인사이트를 확보하세요. 사용 사례 및 분석 정보 필요에 따라 두 개의 연동 버전—V1 또는 V2 중에서 선택하십시오.
연동에 대하여
Amplitude는 앱스플라이어 연동 파트너로, 제품, 성장 및 마케팅 팀이 모바일 및 웹에서 사용자 행동을 이해하기 위해 활용하는 제품 분석 플랫폼입니다. 이번 연동은 앱스플라이어가 Amplitude에 설치 후 핵심 이벤트 데이터를 전송할 수 있게 하여 포괄적인 사용자 수준 분석을 가능하게 합니다.
두 개의 Amplitude 연동 버전이 있습니다:
-
Amplitude V1:
이 버전은 Amplitude의 어트리뷰션 API를 사용합니다. 앱스플라이어는 연동이 완료된 후 수집된 설치 데이터를 전송합니다. Amplitude는 광고 ID를 식별자로 사용하며, 72시간 이내에 일치하는 사용자 이벤트가 기록되지 않으면 데이터를 삭제합니다. 더 알아보기 -
Amplitude V2 :
이 버전은 Amplitude의 HTTP V2 API를 사용합니다. 앱스플라이어는 연동이 완료된 후 설치 및 인앱 이벤트 데이터를 모두 전송합니다. 식별자에 우선 순위가 부여되며(user_id and device_id), 일치하지 않을 경우 새로운 사용자를 생성합니다. 더 알아보기
연동 버전:
| 버전 | 사용된 API | 사용된 식별자 | 이벤트 범위 |
|---|---|---|---|
| V1 | 어트리뷰션 API | 광고 ID (AdID) | 인스톨만 |
| V2 | HTTP V2 API |
user_id, device_id (폴백 로직) |
설치 및 인앱 이벤트 |
중요!
- Amplitude V1 또는 V2 연동 중 하나를 선택하세요. 두 개의 버전을 동시에 사용하지 마세요 두 버전을 동시에 사용하면 중복 이벤트가 Amplitude로 전송될 수 있습니다.
- 일부 미디어 소스는 제3자와의 데이터 공유를 제한합니다. 제한된 이벤트에 대한 포스트백은 설정이 되어 있더라도 해당 파트너에게 전송되지 않습니다.
선행 조건
시작하기 전에
- 계정이 없으면 Amplitude에 연락하여 계정을 생성하세요.
- Amplitude V1과 V2 중 사용할 버전을 결정하세요.
- 중복을 방지하기 위해 Amplitude SDK와 앱스플라이어에서 동일한 이벤트를 전송하지 않도록 하세요.
- Amplitude V2 연동에 대한 추가 전제 조건을 참조하세요.
Amplitude V2 연동을 위한 추가 전제 조건
V2 연동은 다음의 설정이 필요합니다:
Amplitude 디바이스 ID
사용자 수준의 어트리뷰션을 활성화하려면 Amplitude 디바이스 ID를 앱스플라이어 SDK에 전달해야 합니다. 이 값은 각 포스트백과 함께 전송됩니다.
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())
언어 Java/Kotlin
관련 문서: 안드로이드 SDK 레퍼런스, Amplitude
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeDeviceId": [[Amplitude instance] getDeviceId]}];
언어 Objective-C
문서: iOS SDK 레퍼런스, Amplitude
AppsFlyerLib.shared().customData = ["AmplitudeDeviceId": Amplitude.instance().getDeviceId()]
언어 Swift
문서: iOS SDK 레퍼런스, Amplitude
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeDeviceId", Amplitude.getInstance().getDeviceId());
AppsFlyer.setAdditionalData(customData);
언어 C#
관련 문서: Unity SDK 레퍼런스
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()},
(res) => {
//...
}
);
언어 JavaScript
관련 문서: React Native SDK 레퍼런스
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()});
언어 JavaScript
관련 문서: 해당 없음
var data = {"AmplitudeDeviceId": amplitude.getDeviceId()};
appsFlyerSdk.setAdditionalData(data);
언어 Dart
관련 문서: Flutter SDK 레퍼런스
고객 사용자 ID
고객 사용자 ID(CUID)를 설정합니다. 이는 일반적으로 사용자 등록 시 앱 소유자가
생성하고 설정하는 고유의 식별자입니다. 더 알아보기
Amplitude 세션 ID
Amplitude 세션 ID를 설정하고 앱스플라이어에 전달합니다(선택 사항). 더 알아보기
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())
언어 Java/Kotlin
관련 문서: 안드로이드 SDK 레퍼런스
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeSessionId": [[Amplitude instance] getSessionId]}];
언어 Objective-C
문서: iOS SDK 레퍼런스
AppsFlyerLib.shared().customData = ["AmplitudeSessionId": Amplitude.instance().getSessionId()]
언어 Swift
문서: iOS SDK 레퍼런스
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeSessionId", Amplitude.getInstance().getSessionId());
AppsFlyer.setAdditionalData(customData);
언어 C#
관련 문서: Unity SDK 레퍼런스
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()},
(res) => {
//...
}
);
언어 JavaScript
관련 문서: React Native SDK 레퍼런스
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()});
언어 JavaScript
관련 문서: 해당 없음
var data = {"AmplitudeSessionId": amplitude.getSessionId()};
appsFlyerSdk.setAdditionalData(data);
언어 Dart
관련 문서: Flutter SDK 레퍼런스
연동 설정
연동을 설정하려면:
- 앱스플라이어에서 협업>파트너 마켓플레이스로 이동합니다.
- Amplitude V1 연동을 설정하려면 Amplitude V1(기술 파트너)을 선택합니다.
선택
Amplitude V2 연동을 설정하려면 Amplitude V2 (기술 파트너)을 선택합니다.선택
- Amplitude 버전을 선택한 후 연동 설정을 클릭합니다.
-
연동 탭에서
- 앱을 선택합니다.
-
파트너 활성화 토글을 켭니다.
- 나머지 탭에서 구성을 완료하십시오:
연동 탭
연동 탭은 아래와 같이 다양한 섹션으로 나누어져 있습니다.
파트너 활성화
첫 번째 방문 시에 파트너 활성화를 켜서 연동 탭의 파라미터 설정을 활성화해야 합니다. 파트너와 작업하는 동안에는 토글이 켜져 있어야 합니다.
파트너 활성화에 대해 더 알아보십시오.
일반 설정
고급 데이터 공유
Amplitude와 추가 설치 정보를 공유하려면 고급 데이터 공유를 켭니다. 활성화되면, Amplitude는 설치(인앱 이벤트 제외)에 대해 Amplitude 속성에 매핑된 데이터를 수신하게 됩니다.
| Amplitude 속성 | 앱스플라이어 데이터 포인트 |
|---|---|
| sub_publisher | af_siteid |
| network_name | pid |
| adgroup_name | af_adset |
| creative_name | af_ad_id |
| installed_at | install_timestamp |
| search_term | af_keywords |
| channe | af_channel |
| user_id | af_customer_user_id |
| af_sub1 | af_sub1 |
| af_sub2 | af_sub2 |
| af_sub3 | af_sub3 |
| af_sub4 | af_sub4 |
| af_sub5 | af_sub5 |
| app_version | app_version |
Amplitude EU 데이터 센터
Amplitude EU 데이터 센터가 설정되지 않은 경우, 인스톨 포스트백은 미국 데이터 센터로 전송됩니다.
Amplitude의 EU 데이터 센터로 설치 포스트백을 보내려면 Amplitude EU 데이터 센터를 켜십시오.
API Key
Amplitude는 고유한 API 키를 통해 앱스플라이어와 연결됩니다. 아직 키가 없는 경우, 연동을 위해서는 Amplitude에서 키를 가져오거나 아래의 단계를 수행하십시오.
Amplitude에서 API 키 가져오기
참고: 일러두기: Amplitude에서 어드민 또는 관리자 역할이 있는 사용자만 API 키에 액세스할 수 있습니다.
- Amplitude 계정에 로그인합니다.
- 페이지 오른쪽 상단에서 설정 > 조직 설정 아이콘을 클릭합니다.
Amplitude - 프로젝트를 클릭하고 앱스플라이어로 데이터를 전송할 프로젝트를 선택합니다.
Amplitude -
프로젝트 탭에서 API 키를 복사합니다.
Amplitude - 앱스플라이어 대시보드에서 Amplitude 설정을 진행합니다.
기본 포스트백
앱스플라이어는 사용자 인스톨 후 자동 포스트백을 전송할 수 있습니다. 이 섹션에서는 각 이벤트별로 포스트백을 전송할 사용자 소스를 설정합니다. 기본 포스트백에 대해 자세히 알아보세요.
인앱 이벤트 설정
- API 키를 입력합니다.
-
Amplitude 데이터 센터가 설정되지 않은 경우, 인앱이벤트 포스트백은 미국 데이터 센터로 전송됩니다.
Amplitude의 EU 데이터 센터에 인앱이벤트 포스트백을 보내려면 Amplitude 데이터 센터를 켜십시오.
설정을 저장하면 앱스플라이어는 다음과 같은 데이터를 Amplitude로 전송합니다:
- 디바이스 ID(IDFV/Google 광고 ID)
- 미디어 소스
- 캠페인 이름
iOS 디바이스의 IDFA 전송은 ATT에 대한 사용자 동의 및 고급 개인정보 보호 정책 설정에 따릅니다.
인앱 이벤트 포스트백
Amplitude로 인앱 이벤트 포스트백 전송을 구성합니다.
어트리뷰션 링크 탭
비용 탭
이 파트너와의 연동에서 비용 데이터는 지원되지 않습니다.
광고 수익 탭
이 파트너와의 연동에서 광고 수익은 지원되지 않습니다.
권한 탭
Amplitude에 대한 권한이 제공되지 않습니다.
Amplitude 콘솔에서 어트리뷰션 데이터 보기
앱스플라이어에서 Amplitude로 전송된 어트리뷰션 데이터는 대시보드에 [앱스플라이어] 접두사가 붙어 이벤트와 속성으로 표시됩니다.
중요!
경우에 따라 Amplitude는 앱스플라이어에서 전송된 데이터를 “차단됨"으로 표시합니다. Amplitude에서 앱스플라이어 데이터를 볼 수 없는 경우, 차단된 이벤트로 정의되어 있는지 확인하십시오.
Amplitude 이벤트를 앱스플라이어로 전송하기
이 연동은 서버-투-서버 API를 통해 Amplitude 이벤트를 앱스플라이어로 전송할 수 있도록 합니다. 자세한 사항은 Amplitude 관련 문서를 참조하십시오.