您可以在 Google 跟踪代码管理器中创建用户定义的自定义移动变量,以满足可能不在内置变量涵盖范围内的特定要求。
要创建新的用户定义的变量,请执行以下操作:
- 在左侧导航栏中,点击变量。
- 在“用户定义的变量”部分中,点击新建。
- 点击变量配置,然后选择所需的变量类型。
- 完成对所选变量类型的选项配置。
- 为变量命名。命名方案应当能够体现变量的作用,例如“数据层变量 - 产品名称”。
- 点击保存。
跟踪代码管理器支持下列用户定义的移动变量类型:
Firebase
事件名称
若在您的应用中执行下列代码,该值将设置为“eventNameXYZ”:
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
在大多数情况下,您应该使用等效的内置变量。
事件参数:
该值设置为指定键的 Google Analytics(分析)(Firebase) 事件参数的值。
Firebase 用户属性
该值设置为指定键的 Google Analytics(分析)(Firebase) 用户属性值。
实用工具
广告客户跟踪已启用
对于 Android,如果启用了广告跟踪,该变量返回 true;如果用户选择停用针对用户兴趣的广告,则返回 false。在 Android 开发者中心中了解详情。v4 以前的 SDK 版本将始终返回 false。对于 iOS 6 及更高版本,该值设置为 advertisingTrackingEnabled 属性。否则,该值设置为 true。在大多数情况下,您应该使用等效的内置变量。
常量
该值设置为您指定的字符串。
Google Analytics(分析)设置
在网页版和移动版 (Firebase) 容器中,Google Analytics(分析)设置变量用于在 Universal Analytics 代码内集中配置和共享跨多个代码使用的常见 Google Analytics(分析)设置。当您使用 Universal Analytics 创建 Google Analytics(分析)代码时,跟踪代码管理器会提示您选择或创建 Google Analytics(分析)设置变量。了解详情。
对照表
该值根据对照表中的说明进行设置。对照表包含两列(下表中不包含任何数据,数据的使用方法在下文中介绍):
如果 [选定变量] 等于 | 将 [此变量] 设置为 |
---|---|
通过对照表,您可以创建一个变量,令其值随另一个变量的值变化。如果您的应用的设置方式是使相应的值(如转化跟踪 ID)能够映射到应用版本号或应用的其他部分,那么这就非常有帮助。在此示例中,我们创建了一个名为“Conversion ID”的变量。如果应用版本号是 1.0,该值被设置为“12345”;如果应用版本号是 1.1,该值被设置为“34567”。对照表中的行数没有限制。字段区分大小写。
如果 {{App Version Code}} 等于 | 将 {{Conversion ID}} 设置为 |
---|---|
1.0 | 12345 |
1.1 | 34567 |
1.2 | 56789 |
随机数
该值设置为介于 0 到 2147483647 之间的一个随机数字。在大多数情况下,您应该使用等效的内置变量。
容器数据
容器 ID
该值为容器的公共 ID(例如 GTM-ABC42)。在大多数情况下,您应该使用等效的内置变量。
容器版本号
当容器处于预览模式时,此变量值为容器的预览版本号。在其他情况下,此变量值是容器的实际版本号。在大多数情况下,您应该使用等效的内置变量。
应用
应用 ID
该值设置为程序包名称 (Android) 或应用 ID (iOS)。在大多数情况下,您应该使用等效的内置变量。
应用名称
该值设置为应用的名称。在大多数情况下,您应该使用等效的内置变量。
应用版本号
该值设置为当前正在运行的应用的版本。在大多数情况下,您应该使用等效的内置变量。
用于广告的 ID
对于 Android,该值设置为广告 ID。v4 以前的 SDK 版本将始终返回空字符串。对于 iOS 6 及更高版本,该值设置为广告标识符 (IDFA)。否则,该值设置为空字符串。
SDK 版本
该值设置为安装应用的操作系统的 SDK 版本。在大多数情况下,您应该使用等效的内置变量。
设备
设备名称
该值设置为当前运行应用所在的设备名称(如“Samsung Android”、“Pixel 2”)。在大多数情况下,您应该使用等效的内置变量。
语言
该值设置为由两个字母组成的语言代码,表示由用户设置的设备语言偏好。在大多数情况下,您应该使用等效的内置变量。
操作系统版本
该值设置为安装应用的操作系统的版本。在大多数情况下,您应该使用等效的内置变量。
平台
该值设置为当前运行应用的平台,例如,“Android”、“iOS”。在大多数情况下,您应该使用等效的内置变量。
屏幕分辨率
该值设置为当前运行应用所在设备的屏幕分辨率。格式为“宽 x 高”,例如“1920 x 1080”。在大多数情况下,您应该使用等效的内置变量。
其他
函数调用
该值设置为调用预注册的函数所返回的值。要了解详情,请参阅 Android 或 iOS SDK 文档。
值集合(仅限旧版容器)
此变量包含一组以 JSON 格式表示的键值对。您可以使用值集合为应用设置配置值。例如,对于赛车游戏应用,您可以定义一个类型为“值集合”的“应用设置”变量,如下所示:
{
"max-fuel": 200,
"starting-fuel": 100,
"fuel-burn-rate": 20
}
通过提供键,您的移动应用可以检索变量中的值。例如:
public class MainActivity {
// 添加您的公开容器 ID。
private static final String CONTAINER_ID = "XXX-YYY";
// 容器配置值对应的键,用于在以后
// 检索值。
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// 您的 onCreate 代码的其余部分。
}
}
/*
* 使用 Google 跟踪代码管理器容器更新
* 游戏配置值的方法。
*/
public void updateConfigurationFromContainer(Container container) {
// 获取对容器的引用。
Container container = mFutureContainer.get();
// 使用容器配置值对应的键
// 更新游戏设置。
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
“值集合”变量与触发器相关联。要将配置值应用于您应用的所有实例和版本,将启用触发器设置为预定义的“Always”。请参阅开发者文档(Android 或 iOS),详细了解如何使用“值集合”变量。