Google Analytics

🚧

Google Analytics 与 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.

概述

只需按一下按钮,就可以将 Branch 数据发送到 Google Analytics(分析)操作后台 (Dashboard),以帮助您了解 Branch 作为获取途径的功能。如果您对通过 Branch 进入您的应用的用户群感兴趣,并希望根据您的其他同类群组来衡量他们的事件,则本指南可以为您提供帮助。

它是如何工作的?

将 Branch SDK 集成到应用后,Branch 可以检测到哪些链接导致安装,重新打开和用户操作。启用此集成并提供您的 Google Analytics(分析)追踪 ID,Branch 会以 Google Analytics(分析) 期望的确切格式将参考事件自动转发到 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(分析)中其他追踪的事件一起显示。这是设置了测试信息的 Sources 屏幕的示例。

图片图片

要查看引用的 installopen 以及发生时使用 Branch 追踪的任何自定义事件,请前往 Real-Time > Events。所有引用的 Branch 事件的类别都为 BranchEvent

图片图片

1. 完整的数据集成先决条件

🚧

需要开发人员

BRANCH

Google Analytics

2. 从您的合作伙伴那里获取 Key/凭证

输入您的 Google Analytics(分析)追踪 ID

对于基本的无代码集成:找到您的 Google Analytics(分析)追踪 ID(tid),并将其输入到 Branch 操作后台 (Dashboard) 中。

  1. To locate your Google Analytics Tracking ID, navigate to https://analytics.google.com and log in.
  2. 在页面顶部的导航栏中点击 Home 。您应该会看到您的应用以及随附的追踪 ID。
  3. 复制您要与 Branch 一起使用的任何应用的追踪 ID。这也称为属性 ID,格式为 UA-XXXXXX-YY(例如 UA-000000-01)。例如: 图片图片

3. 启用集成

  1. On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.
  2. 找到 Google Analytics(分析),然后选择 Enable
  • 如果您尚未输入帐单信息,请立即输入。
  1. 输入您的 Google Analytics(分析)追踪 ID,然后点击 Save

图片图片

🚧

请测试您的集成!

Branch 对不正确的 API Key 概不负责。

4. 将 ID/metadata 传递给 Branch

🚧

集成所需

如果您不包含以下代码片段,则事件将发送到 Google,但 Google Analytics(分析)不会提取这些事件,并且这些事件也不会在 Google Analytics(分析)操作后台 (Dashboard)上显示。

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);

高级

可选参数-用户 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(分析)的内容

Property 名称来源于例如要求
vAPI 版本[固定]1Y
tid追踪号码Branch 操作后台 (Dashboard)UA-XXXXXX-YY
dsSource(移动 SDK)[固定]应用Y
an应用名称[固定]BranchAPPY
t类型[固定]事件Y
ec事件类别[固定]BranchEventY
cid客户 ID(如上所述,包括 $google_analytics_client_id)AEBE52E7-03EE-455A-B3C4-E57283966239Y
uid用户 ID$google_analytics_user_id用户AN
cnCampaign 名称utm_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 关键字utm_term -or- Branch $keywords["Keyword1", "keyword3"]N
ccCampaign 内容utm_content -or- Branch tags"Some content"N
ea事件动作(名称)事件名称installY
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.

问题排查

会话长度很短或不存在

当 Branch 发送安装和打开时,Google Analytics(分析)将自动启动会话。因此,您应在应用启动时删除所有创建新会话的代码。例如,在 iOS 上,您可能会触发以下事件:

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

您应该删除它,以便您的应用不会启动新的会话。否则,您可能会看到零秒会话,并且平均会话长度下降。

数据未出现在Google Analytics(分析)中

  1. 检查您的 Branch 操作后台 (Dashboard)中的 property ID 是否与 Google Analytics(分析)中的 ID 相匹配
  2. 确保您正在查看 Google Analytics(分析)操作后台 (Dashboard)的正确部分。数据应显示在 Acquisition > Sources > All
  3. 检查您的 Google Analytics(分析)视图是否没有任何筛选项。例如,如果您的视图筛选掉了英国的用户,而 Branch open 来自英国的用户,则您将不会在视图中看到 Branch 的数据。
筛选项