Google Analytics

🚧

Google Analytics vs. Google Firebase

If you are a paying Google Analytics customer, please follow the guide below. If you are a free customer, please refer to our Google Firebase data integration as Google Analytics is now deprecated for free customers.

Overview

버튼을 누르면 Branch 데이터를 Google Analytics 대시보드로 전송하여 Branch의 유저 획득 경로로서의 영향력에 대한 이해를 도울 수 있습니다. Branch를 통해 앱에 들어오는 유저의 세그먼트에 관심이 있고 다른 코호트에 대한 이벤트를 측정하려는 경우 이 안내서가 도움이 될 수 있습니다.

작동 방식

Branch SDK가 앱에 연동되면 Branch는 어떤 링크가 설치, 재오픈, 유저 액션으로 이어지는지 감지할 수 있습니다. 이 연동을 활성화하고 Google Analytics 트래킹 ID를 제공하면 Branch는 Google Analytics가 기대하는 정확한 형식으로 리퍼드(Referred)된 이벤트를 Google Analytics에 자동으로 전달합니다. 여기에는 새 유저의 소스를 결정하는 데 사용할 수 있는 다양한 UTM 태그를 자동으로 설정하는 것이 포함됩니다.

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

Branch will send referred installs and opens, commerce, content, user lifecycle, as well as any custom events you track with Branch. Non-referred events, clicks, web session starts, and pageviews will be excluded. Branch also sends over analytics data that is attached to the link, whether it's UTM tags or fields set on the Branch Dashboard (e.g. Campaign, Channel, Feature). This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users. You can see the list of fields that we send to Google Analytics here.

Do you support Google Analytics 4?

Yes! Branch's Google Analytics integration now supports versions up to GA4.

어떻게 생겼습니까?

Branch 이벤트는 Google Analytics에서 트래킹된 다른 이벤트와 함께 나타납니다. 다음은 테스트 정보가 설정된 Source 화면의 예입니다.

imageimage

리퍼드(Referred)된 설치오픈이나, Branch로 트래킹하는 모든 커스텀 이벤트를 발생시 보려면 Real-Time > Events로 이동하십시오. 모든 리퍼드(Referred)된 Branch 이벤트의 이벤트 카테고리는 BranchEvent입니다.

imageimage

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

🚧

개발자 필요

BRANCH

Google Analytics

2. 파트너의 키/자격 증명 검색

Google Analytics 트래킹 ID를 입력하십시오.

코드 없는 기본 연동의 경우: Google Analytics Tracking ID (tid)를 찾아 Branch 대시보드에 입력하십시오.

  1. To locate your Google Analytics Tracking ID, navigate to https://analytics.google.com and log in.
  2. 페이지 상단의 탐색 표시 줄에서 Home 을 클릭합니다. 트래킹 ID와 함께 앱이 표시되어야 합니다.
  3. Branch에서 사용할 앱의 Tracking ID를 복사하십시오. 이것은 Property ID라고도 하며 UA-XXXXXX-YY (예 : UA-000000-01) 형식입니다. 예를 들면 다음과 같습니다: imageimage

3. 연동 활성화

  1. On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.
  2. Google Analytics를 찾아 Enable 를 선택하십시오.
  • 아직 빌링 정보를 입력하지 않았다면 지금 입력하십시오.
  1. Google Analytics 트래킹 ID를 입력하고 다음을 클릭 Save

imageimage

🚧

연동을 꼭 테스트하십시오!

Branch는 부정확한 API 키에 대해 책임지지 않습니다.

4. ID/Metadata를 Branch로 전송

🚧

연동 필수 요소

아래 code snippet 을 포함하지 않으면 이벤트는 Google로 전송되지만 Google 애널리틱스는 이를 받아들이지 않으며 Google 애널리틱스 대시 보드에 표시되지 않습니다.

Please specify $google_analytics_client_id. We will pass that to Google (as cid) so Google can match the events we send them to a specific user.

let branch = Branch.getInstance();
let val = gai.tracker(withTrackingId: "key")
branch.setRequestMetadataKey("$google_analytics_client_id", value:val?.get("&cid"))
[[Branch getInstance] setRequestMetadataKey:@"$google_analytics_client_id" value: […]];
mTracker = sAnalytics.newTracker("UA-XXXXXXXX-1");

String client_id = mTracker.get("&cid");
Branch.getInstance().setRequestMetadata("$google_analytics_client_id",client_id);

고급

선택적 Parameter - User ID

If you specify $google_analytics_user_id, we can pass that to Google (as uid).

branch.setRequestMetadataKey("$google_analytics_user_id", "USER-ID-HERE")
[[Branch getInstance] setRequestMetadataKey:@"$google_analytics_user_id" value:@"USER-ID-HERE"];
Branch.getInstance().setRequestMetadata("$google_analytics_user_id", "USER-ID-HERE");

Branch에서 Google Analytics로 전송하는 것

속성 이름출처예시 Req
vAPI version[fixed]1Y
tidTracking IDBranch 대시보드UA-XXXXXX-YY
dsSource (mobile SDK)[fixed]Y
an애플리케이션 이름[fixed]BRANCH-APPY
t유형[fixed]eventY
ecEvent Category[fixed]BranchEventY
cid클라이언트 ID(위에서 논의됨, $google_analytics_client_id 포함)AEBE52E7-03EE-455A-B3C4-E57283966239Y
uidUser Id$google_analytics_user_idUser AN
cnCampaign Nameutm_campaign -or- Branch campaign"Beaches and breezes"N
csCampaign Sourceutm_source -or- Branch channel"Twitter"N
cmCampaign Mediumutm_medium -or- Branch feature"480banner"N
ckCampaign Keywordsutm_term -or- Branch $keywords["Keyword1", "keyword3"]N
ccCampaign Contentutm_content-또는-Branch 태그"Some content"N
eaEvent Action (Name)event nameinstallY
uip유저의 IP 주소Branch SDK에서 수집111.111.111.111N
zCache buster[unix time + random number]1461878903666N

📘

익명 클라이언트 ID

If for some reason Branch does not receive an advertising identifier or hardware identifier, and you do not explicitly specify a $google_analytics_client_id, then Branch will send anonymous as the Client ID (cid). This is a required field by Google Analytics.

Troubleshooting

매우 짧거나 존재하지 않는 세션 길이

Branch에서 설치 및 오픈을 보내면 Google Analytics가 자동으로 세션을 시작합니다. 이 때문에 응용 프로그램을 시작할 때 새 세션을 생성하는 모든 코드를 제거해야 합니다. 예를 들어 iOS에서 다음과 같은 이벤트가 발생했을 수 있습니다.

[builder set:@"start" forKey:kGAISessionControl];

앱이 새 세션을 시작하지 않도록 이를 제거해야 합니다. 그렇지 않으면 세션 길이가 0초인 세션들이 발생하여 평균 세션 길이가 낮아져버릴 수 있습니다.

Google Analytics에 표시되지 않는 데이터

  1. Branch 대시보드의 속성 ID가 Google Analytics의 속성 ID와 일치하는지 확인하세요.
  2. Google Analytics 대시보드의 오른쪽 부분을 보고 있는지 확인하십시오. 데이터는 다음에 나타나야 합니다 Acquisition > Sources > All
  3. Google Analytics Views에 필터가 없는지 확인하세요. 예를 들어 View가 영국의 유저를 필터링하고 Branch 오픈이 영국 유저에서 열린다면 View에 이 Branch 데이터가 표시되지 않습니다.
필터