앱스플라이어와 Adobe Analytics의 연동

개요

이 연동은 Adobe와 앱스플라이어 사이에 데이터를 양방향으로 흐를 수 있게 구성되어 있습니다. 성공적인 연동을 위해서는 귀사의 앱 내에 코드를 구현해야 합니다. 연동이 성공적으로 완성되기 위해서는 앱스플라이어와 Adobe 양쪽의 요구 조건을 모두 충족해야 합니다.

Adobe Analytics 연동 준비하기

Adobe Analytics Report Suite를 활용해 전체 캠페인 성과 분석과 세그먼트 생성을 하고 계시다면, Adobe Analytics와 앱스플라이어의 연동을 통해 앱스플라이어에서 Adobe로 어트리뷰션 데이터가 자동으로 전송되도록 할 수 있습니다.

선행 조건:

• Adobe Experience Platform 모바일 SDK 문서 설정하기
• Marketing Cloud Visitor ID 혹은 Experience Cloud ID 서비스
• 이 연동만을 위해 리포트 스위트마다 사용할 수 있는 세 개의 eVars

1단계: Adobe Experience Cloud ID(ECID, Marketing Cloud ID 또는 Visitor ID)를 앱스플라이어와 공유해주세요.

Adobe Experience Cloud ID를 추출 및 공유하는 방법:

1. Adobe SDK가 초기화된 직후 Adobe SDK 방식을 이용해 앱을 업데이트하고 Marketing Cloud Visitor ID를 추출하세요.
2. Adobe Marketing Cloud Visitor ID를 설정하기 위한 앱스플라이어 SDK 메소드 중 하나를 사용하세요:
   

HashMap<String, Object> customData = new HashMap<String,Object>();
customData .put("marketingCloudID", "ADOBE_VISITOR_ID");
AppsFlyerLib.setAdditionalData(customData);

[[AppsFlyerTracker sharedTracker] setAdditionalData:@{
  @"marketingCloudID" : "ADOBE_VISITOR_ID"
}];

let CustomDataMap: [AnyHashable: Any] = [
  "marketingCloudID" : "ADOBE_VISITOR_ID"
]
AppsFlyerTracker.shared().customData = CustomDataMap

Dictionary<string, string> CustomDataMap = new Dictionary<string, string>();
CustomDataMap.Add("marketingCloudID", "ADOBE_VISITOR_ID");
AppsFlyer.setAdditionalData(CustomDataMap);

AppsFlyerLib.getInstance().setCustomerUserId("ADOBE_VISITOR_ID");

NSString *customerUserID = [AppsFlyerLib shared].customerUserID;

let customerUserID = AppsFlyerLib.shared().customerUserIDp

Map<String, Object> partnerData = new HashMap();
partnerData.put("puid", "some-adobe-external-id-value");
AppsFlyerLib.getInstance().setPartnerData("aeplaunchmobile_int", partnerData);

NSDictionary *adobeInfo = @{@"external_user_id":@"some-adobe-external-id-value"};[[AppsFlyerLib shared] setPartnerDataWithPartnerId:@"aeplaunchmobile_int" partnerInfo:adobeInfo];

2단계: 앱스플라이어에서 Adobe Analytics 설정하기

선행 조건: 연동을 시작하기 전에, Adobe Marketing Cloud Visitor ID를 앱스플라이어 SDK에 전달하세요.

연동 활성화 또는 편집 방법:

1. 활성화하기: 앱스플라이어에서, 사이드 메뉴를 통해 협업하기> 파트너 마켓플레이스를 선택하세요.
   편집 방법: 앱스플라이어의 사이드 메뉴에서 협업 > 활성 연동을 선택합니다.
2. Adobe Analytics를 찾아서 선택하세요.
3. 연동 설정을 클릭합니다. 연동 설정 페이지로 이동합니다.
4. 연동 탭에서 연동할 앱을 선택하고 파트너 활성화를 켭니다.
   참고: 적용 시 슬라이더가 켜져 있어야 합니다(활성화)<6> 파트너와 협업하는 동안.
5. Adobe Analytics SDK에서, ADBMobileConfig.XML 파일의 일부인 Report_Suite_ID(파랗게 강조)와 Adobe_Analytic_server_URL(녹색으로 강조)를 복사하여 앱스플라이어에서 Adobe Analytics 연동 페이지의 해당 필드에 붙여넣으세요.
   

   

6. 저장하기 연동 설정.

저장 후, 앱스플라이어는 오가닉 및 논오가닉 인스톨 모두에 대해 Adobe Analytics로 다음과 같은 데이터를 전송합니다.

• Adobe ID (MCVID)
• Report Suite ID & Server URL
• Customer Device ID
• 미디어 소스
• 캠페인 이름

3단계: Adobe Analytics에서 eVars로 데이터 매핑

Adobe Analytics 데이터 커넥터가 지원 중단됨에 따라, 컨텍스트 변수를 eVars로 매핑하기 위한 처리 규칙의 활용이 필요합니다.

처리 규칙 사용 방법에 관해 자세히 알아보세요.

앱스플라이어 컨텍스트 데이터 변수가 아래와 같이 매핑됩니다:

• MobileAdCampaign(컨텍스트 데이터)
• MobileAdNetwork(컨텍스트 데이터)
• 모바일 광고 제공자(컨텍스트 데이터)

처리 규칙을 통해 앱스플라이어 컨텍스트 데이터 변수의 매핑에 문제가 있다면, 추가적인 지원을 위해 Adobe 계정 팀에 문의해 주세요.

4단계 [선택 사항]: 마케팅 채널 설정

해당 플랫폼에서 마케팅 채널을 어떻게 설정하는지는 Adobe Analytics 문서를 확인하세요. 식별 규칙을 설정할 때 다음 필드들을 선택하세요:

1. "Adobe의 웹 비콘에 의해 설정된 전환 변수 값": 앱스플라이어 및 존재 선택.
2. "채널을 다음과 같이 식별": 모바일 앱 어트리뷰션 선택.
3. "채널 값 설정": 앱스플라이어 캠페인 선택.

도메인 및 보안 관련 상세 정보

아래에 도메인 및 보안 문제의 상세 정보를 제공합니다:

1. ANALYTIC_SERVER_DOMAIN은 앱의 설정 파일에서 서버 변수로 확인할 수 있습니다. 어트리뷰션 분석을 위한 도메인은 자유롭게 선택 가능합니다. 일반적으로는 Adobe Analytics 수집 서비스의 표준 도메인인 sc.omtrdc.net을 사용합니다. 이는 ADBMobile.config 파일의 애널리틱스(서버) 설정 내에서 확인할 수 있습니다.
2. URL의 프로토콜(HTTP/HTTPS)은 ANALYTIC 서버 도메인이 보안 처리되었는지 여부에 따라 결정됩니다. 올바른 프로토콜 사용이 중요합니다. 설정이 보안 처리되었는지 확인하려면, ADBMobile.config 파일에서 애널리틱스(SSL) 설정이 true로 설정되어 있는지를 확인하세요. 연결 상태가 안전하면 HTTPS를, 그렇지 않다면 HTTP를 사용하세요.
3. 리포트 스위트 ID는 앱의 구성 파일에서 rsids 변수를 통해 찾을 수 있습니다. 리포트 스위트의 이름은 원하는 대로 지정하실 수 있습니다.
4. 귀사의 구성 파일에서 offlineEnabled 설정이 true인 경우에만 ts={timestamp}가 사용됩니다. offlineEnabled이 False로 설정되어 있거나 리포트 스위트가 시간대 기록 기능을 지원하지 않을 경우, URL에서 해당 파라미터를 제거하세요.