Adobe Analytics (Data Connector)

🚧
Data Connector Update
On August 1, 2021, Adobe will no longer support the Data Connectors. To support these changes, Branch has built out a new integration called Adobe Analytics (Processing Rules).
If you are currently using this integration and are satisfied with the data being sent from Branch to Adobe Analytics, then no action is needed; however, if you would like to configure the data manually, you may migrate to the new Processing Rules Integration.

Overview

버튼을 누르면 Branch 데이터를 Adobe Analytics 대시보드로 전송하여 Branch의 유저 획득 경로로서의 영향력을 이해할 수 있습니다.

작동 방식

Branch SDK가 앱에 연동되면 Branch는 어떤 링크가 설치, 재설치, 유저 액션으로 이어지는지 감지할 수 있습니다. 이 연동을 활성화하고 Adobe Analytics 정보를 제공하면 Branch는 서버 간 연동을 통해 리퍼드(Referred)된 이벤트를 Adobe Analytics에 자동으로 전달합니다.

Branch는 어떤 이벤트를 보내나요?

Branch will send referred installs and opens, reinstalls, as well as any custom and commerce events you track with Branch. Non-referred events, clicks, web session starts, and pageviews will be excluded. Branch also sends all the analytics tags that are attached to the link that drove the referred event. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users.

어떻게 생겼습니까?

Branch events will appear on the Adobe Analytics dashboard through Reports > Custom Conversion > Branch eVar. Note, this will automatically appear once the Branch Data Connector is enabled through the Adobe Analytics dashboard.

Branch가 Adobe Analytics로 보내는 데이터가 탑 레벨 eVar로 매핑되므로, Adobe Analytics 플랫폼에서 필요에 따라 데이터를 분석할 수 있는 유연성을 갖게 됩니다. 이 eVar에는 분석 태그인 캠페인, 채널, 타겟, 이벤트 이름 및 액션 속성이 포함됩니다.

Branch 이벤트는 커스텀 리포트를 작성하는 데 사용될 수 있고 다양한 페이지 및 대시보드에서 트래킹된다는 점에서 Adobe Analytics 이벤트와 유사합니다. 그러나 일반 이벤트와 달리 Branch 이벤트에는 유저가 처음에 앱을 어떻게 사용했는지에 대한 중요한 정보가 포함되어 있습니다.

1. 데이터 연동 전제조건 완료

🚧
전제 조건
BRANCH

Branch SDK 구현하기

앱 이벤트를 측정 중인지 확인

Adobe Analytics

Adobe Analytics SDK 구현

2. Adobe에서 Branch Data Connecter 활성화

Adobe Analytics 대시보드의 Admin 탭에서 Data Connectors를 찾습니다.

+Add New를 클릭하고 "Branch"를 검색한 다음 Activate를 클릭하십시오.

3. Branch 데이터 커넥터 설정

연동 설정

이는 데이터 커넥터를 활성화할 때 자동으로 설정됩니다.

변수 매핑

Map your Branch events to your chosen eVar. In the example below, it will be mapped to Custom eVar 1, renamed to the SiteCatalyst metric Branch.

데이터 설정

Branch는 전송될 Branch 데이터에 대한 기본 분류 규칙 세트를 제공합니다. 이를 통해 Branch 분석 데이터가 다음과 같이 Adobe 분류에 매핑됩니다. 원하는 경우 이 분류 규칙 세트를 변경할 수 있지만 편집은 필요하지 않습니다. 또한 데이터 내에 Branch 태그가 포함되어 있기 때문에, 새로운 규칙을 통해 한층 더 세분화된 데이터를 확인할 수 있습니다.

Adobe 분류	Branch Analytics 태그
Source	Channel
Campaign	Campaign
Medium	Feature
Action	Branch Event Name
Action Property	Branch Tags

리뷰 요약

마지막으로 연동을 검토하고 화면 하단으로 스크롤한 다음 Activate Now 을 클릭하여 연동을 활성화합니다.

3. Branch 대시보드 설정

Adobe Analytics 정보 검색

Branch로 이동하기 전에 Adobe Analytics 대시보드에서 모바일 마케팅 UI로 이동하여 앱을 찾습니다.

Manage App Setting -> SDK Analytics Options에서 다음 데이터를 찾습니다.

Branch 필드	Adobe 필드 값
Protocol	Use HTTPS Check Box (if checked, select HTTPS)
Analytics Server Domain	Tracking Server
Omniture iOS/Android Server Key	Report Suite ID for that app
Timestamp	Offline Tracking

For Analytics Server Domain, please do not include http or https. If your value for this is http://test.com, simply put in test.com. This means no extra slashes and no protocol.

Adobe Analytics 정보 입력

Branch 대시보드 (dashboard.branch.io)에서 Data Integrations page로 이동합니다.
Adobe Analytics를 찾아 Enable를 선택합니다.

아직 빌링 정보를 입력하지 않았다면 지금 입력하십시오.

Adobe Analytics 정보를 입력하고 Save를 누르십시오.

4. Adobe ID를 Branch에 전달

🚧
Adobe ID
This step is not required if the Branch SDK is implemented using Adobe Launch
If this step is not completed, events Branch sends to your Adobe Report Suite will not reliably appear, and will not connect to other data already tracked by Adobe Analytics

You'll need to pass through all user IDs configured with Adobe, to the Branch SDKs (There are three possible Adobe IDs this integration can track). First, figure out which ID you use by asking your Adobe Consultant, and then pass that value to Branch by calling setRequestMetadataKey (iOS) or .setRequestMetadata (Android) on the Branch SDK, BEFORE calling initializing session on the Branch SDK.

예를 들어 Adobe 연동에서 Marketing Cloud의 Visitor ID 또는 Experience Cloud ID를 사용하는 경우 Adobe의 SDK에서 ID를 검색하고 $marketing_cloud_visitor_id 라는 키를 사용하여 Branch의 SDK에 전달합니다. 모든 ID 유형에 대한 샘플 스니펫을 아래에서 확인하세요:

Marketing Cloud Visitor ID / Experience Cloud ID

Value sent to Branch using $marketing_cloud_visitor_id key. Value sent to Adobe as mid. Check to see if a cloud id is present, if not, initialize branch within callback to utilize the returned cloud id, else initialize branch outside of the Adobe callback. The best practice is to store the cloud id and then reuse for subsequent app launches

iOS - Objective C

//Inside *didFinishLaunchingWithOptions*
Branch *branch = [Branch getInstance];
            if (experienceCloudId == nil) {
                [ACPIdentity getExperienceCloudId:^(NSString * _Nullable retrievedCloudId) {    
                    [branch setRequestMetadataKey:@"$marketing_cloud_visitor_id" value:[retrievedCloudId]];
                    ...
                    [branch initSessionWithLaunchOptions...];  
                }];
            } else {
                [branch setRequestMetadataKey:@"$marketing_cloud_visitor_id" value:[experienceCloudId]];
                ...
                [branch initSessionWithLaunchOptions...];  
                        }

iOS - Swift

//Inside *didFinishLaunchingWithOptions*
            if let branch = Branch.getInstance() {
                if experienceCloudId == nil { 
                    ACPIdentity.getExperienceCloudId { (retrievedCloudId) in 
                        branch.setRequestMetadataKey("$marketing_cloud_visitor_id", value:retrievedCloudId)
                        ...
                        branch.initSession(...)
                    }  
                } else {
                    branch.setRequestMetadataKey("$marketing_cloud_visitor_id", value:experienceCloudId)
                    ...
                    branch.initSession(...)
                }
            }

Android

//Before you initialize the session.
            if experienceCloudId == null {
                Identity.getExperienceCloudId(new AdobeCallback<String>() {    
                    @Override    
                    public void call(String id) {  
                        Branch branch = Branch.getInstance();      
                        branch.setRequestMetadata("$marketing_cloud_visitor_id", id);
                        ...  
                        branch.sessionBuilder(this)…init();
                    }
                });
            } else {
                Branch branch = Branch.getInstance();      
                branch.setRequestMetadata("$marketing_cloud_visitor_id", experienceCloudId);
                ...  
                branch.sessionBuilder(this)…init();
            }

추가 대기 시간이 염려되는 경우 expectDelayedSessionInitialization 호출 시작시 조건부로 호출할 수 있습니다.


            LauncherActivity.onStart() {
                    ...
                    Branch.expectDelayedSessionInitialization()
            }

                        asyncOperationCallback() {
                            Branch.sessionBuilder(activity).withCallback(callback)...init();
                        }

Analytics Custom Visitor ID

Value sent to Branch using the $analytics_visitor_id key. Value sent to Adobe as vid. This is a custom user ID that can be set using the Adobe SDK.

iOS - Objective C

//Inside *didFinishLaunchingWithOptions*
//Setting the Identifier with Adobe
[ADBMobile setUserIdentifier:@"Whipple"];
//Passing the Identifier to Branch
Branch *branch = [Branch getInstance];
[branch setRequestMetadataKey:@"$analytics_visitor_id" value:[ADBMobile userIdentifier]]
...
[branch initSessionWithLaunchOptions...]

iOS - Swift

//Inside *didFinishLaunchingWithOptions*
//Setting the Identifier with Adobe
ADBMobile.setUserIdentifier("Whipple")
//Passing the Identifier to Branch
if let branch = Branch.getInstance() {
    branch.setRequestMetadataKey("$analytics_visitor_id", value:ADBMobile.userIdentifier())
    ...
    branch.initSession(...);
}

Android

//Before you initialize the session.
//Setting the Identifier with Adobe
Config.setUserIdentifier(""Whipple"");
//Passing the Identifier to Branch
Branch branch = Branch.getInstance();
Branch.getInstance().setRequestMetadata(""$analytics_visitor_id"", Config.getUserIdentifier());
...
Branch.sessionBuilder(this)...init();

Analytics Visitor ID

Value sent to Branch using the $adobe_visitor_id key. Value sent to Adobe as aid.

iOS - Objective C

//Inside *didFinishLaunchingWithOptions*
Branch *branch = [Branch getInstance];
[branch setRequestMetadataKey:@"$adobe_visitor_id" value:[ADBMobile trackingIdentifier]];
...
[branch initSessionWithLaunchOptions...]

iOS - Swift

//Inside *didFinishLaunchingWithOptions*
if let branch = Branch.getInstance() {
    branch.setRequestMetadataKey("$adobe_visitor_id", value:ADBMobile.trackingIdentifier());
    ...
    branch.initSession(...);
}

Android

//Before you initialize the session.
Branch branch = Branch.getInstance();
branch.setRequestMetadata(""$adobe_visitor_id"", Analytics.getTrackingIdentifier());
...
Branch.sessionBuilder(this)...init();

고급

Branch가 Adobe Analytics로 보내는 내용

Branch는 Adobe Context Data의 Branch 링크 데이터에서 다음 값을 보냅니다.

Adobe 분류	Branch Analytics 태그	예시
Source	Channel	웹사이트
Campaign	Campaign	Journeys 솔루션 테스트 캠페인
Medium	Feature	Journeys (웹-투-앱 스마트 배너)
Action	Branch Event Name	Install
Action Property	Branch Tags	tag=bar&tag2=1234
Custom	Branch Custom Data	key=value

Quick Link를 만들고 분석을 지정하면 해당 분석이 Adobe Analytics 리포팅 제품군에 표시됩니다.

서포트

문제를 해결하는 동안 취할 수 있는 일반적인 전략이 있습니다.

이벤트를 시뮬레이션한 뒤 데이터가 나타나지 않습니다.

Adobe Analytics의 대시보드를 사용하면 데이터가 표시되는 데 최대 2시간이 걸릴 수 있습니다. 한 번의 테스트 세션에서 10-15개의 이벤트를 시뮬레이션하고 2시간 후에 이 이벤트가 표시되는지 확인하여 피드백이 투명하고 명확하게 나오도록 하는 것이 좋습니다.

If you're not seeing an Adobe ID appended to the Branch events in Adobe's dashboard, you can call setDebug on the Branch SDK and inspect the requests to v1/open in-app to confirm the ID is being sent. The key you want to find in this request payload is either $adobe_visitor_id, $marketing_cloud_visitor_id, or $analytics_visitor_id.

컨텍스트 데이터란 무엇이며 Branch는 Adobe에 이를 어디에서 제공합니까?

When sending server to server calls to Adobe, Context Data is the part in-between &c. and &.c in the server call. This call cannot be seen via the client (for example, it is not available via Charles Proxy). To see the detailed Branch server calls, please reach out to your Branch Account Manager. In general, values sent in Context Data can be visualized in the Adobe dashboard, and values outside of Context Data cannot. Values like the user identity (e.g.vid, mid or aid) are sent to Adobe, but not in Context Data, so they can’t be visualized in the Adobe Report Suite. However, they are appropriately formatted for Adobe to log events for that user in Adobe.

Adobe Analytics (Data Connector)

🚧
Data Connector Update

Overview

작동 방식

Branch는 어떤 이벤트를 보내나요?

어떻게 생겼습니까?

1. 데이터 연동 전제조건 완료

🚧
전제 조건

2. Adobe에서 Branch Data Connecter 활성화

3. Branch 데이터 커넥터 설정

연동 설정

변수 매핑

데이터 설정

리뷰 요약

3. Branch 대시보드 설정

Adobe Analytics 정보 검색

Adobe Analytics 정보 입력

4. Adobe ID를 Branch에 전달

🚧
Adobe ID

Marketing Cloud Visitor ID / Experience Cloud ID

Analytics Custom Visitor ID

Analytics Visitor ID

고급

Branch가 Adobe Analytics로 보내는 내용

서포트

이벤트를 시뮬레이션한 뒤 데이터가 나타나지 않습니다.

컨텍스트 데이터란 무엇이며 Branch는 Adobe에 이를 어디에서 제공합니까?

필터

🚧Data Connector Update

Overview

작동 방식

Branch는 어떤 이벤트를 보내나요?

어떻게 생겼습니까?

1. 데이터 연동 전제조건 완료

🚧전제 조건

2. Adobe에서 Branch Data Connecter 활성화

3. Branch 데이터 커넥터 설정

연동 설정

변수 매핑

데이터 설정

리뷰 요약

3. Branch 대시보드 설정

Adobe Analytics 정보 검색

Adobe Analytics 정보 입력

4. Adobe ID를 Branch에 전달

🚧Adobe ID

Marketing Cloud Visitor ID / Experience Cloud ID

Analytics Custom Visitor ID

Analytics Visitor ID

고급

Branch가 Adobe Analytics로 보내는 내용

서포트

이벤트를 시뮬레이션한 뒤 데이터가 나타나지 않습니다.

컨텍스트 데이터란 무엇이며 Branch는 Adobe에 이를 어디에서 제공합니까?

🚧
Data Connector Update

🚧
전제 조건

🚧
Adobe ID