- User Guide
- 追踪
- 跨平台监测
PC 游戏监测
为了评估 PC 游戏广告的效果，不仅需要监测展示广告的 App 和 Web 的表现，也需对运行游戏的 PC 进行监测。Airbridge 能够对 App、Web 以及 PC 进行综合监测。
提示
此功能处于测试阶段。 如有疑问或功能需求，请联系您的 CSM。如果没有指定的 CSM，请通过 [帮助] 提交请求。
为了监测 PC 游戏广告的效果，需要实现跨平台的数据收集，因为用户在多个平台接触广告后选择在 PC 上玩游戏。这要求从 App、Web 以及 PC 收集数据。
您可以引导点击广告的用户至安装了 Airbridge Web SDK 的落地页后，根据在网站和 PC 游戏中收集的数据监测广告效果。此方案便于追踪不支持追踪链接的广告渠道，并通过收集 Cookie ID，实现高效的再营销推广活动。
您可以根据从追踪链接和 PC 游戏收集的数据来监测广告效果。
为了设置 PC 游戏监测，您需要从 App、Web 和 PC 收集数据，并以不同方式将数据传输至 Airbridge。 从追踪链接和网站收集的数据需要通过 Airbridge SDK 传输至 Airbridge。从 PC 游戏收集的数据，则需通过 API 传输。
使用落地页的 PC 游戏监测需要一些提前准备。若您的监测方案不需落地页，请直接进入下一步。
您需要一个落地页，作为点击广告的用户的目的地。用户既可直接从落地页开启 PC 游戏，也可以被引导至其他游戏平台，如 Steam 或 Epic Games Store。
通过在落地页安装 Airbridge Web SDK，您可以追踪不支持追踪链接的广告渠道，并收集 Cookie ID 以便高效再营销。
请在您的落地页安装 Airbridge Web SDK。启用 Web SDK 的 UTM 解析功能，即可追踪 UTM 参数中导入的数据，无需追踪链接。
请设计您的事件结构。 根据您设计的事件结构，在 PC 游戏中发生的事件将通过 S2S 事件 API 传输至 Airbridge。
请创建追踪链接，并在集成渠道专用追踪链接的 [跳转]>[目的地]>[网站] 输入各平台的落地页地址。 若无独立落地页，请输入其他游戏平台的地址，如 Steam 或 Epic Games Store。
有关如何创建追踪链接的更多信息，请参阅 本指南。
请收集在 PC 游戏中发生的事件，并通过 S2S 事件 API，按顺序将这些事件传输至 Airbridge。
请参考以下设置将 PC 游戏中发生的事件通过 S2S 事件 API 传输至 Airbridge。有关 S2S 事件 API 的更多信息，请参阅 本指南。 您必须使用应用内事件发送功能，而不是网页内事件发送功能。
发送 PC 游戏安装、PC 游戏打开、以及游戏内事件的端点（Endpoint）各不相同。
游戏内事件是指用户开启 PC 游戏后可能发生的事件。 例如，完成教程、达到特定等级等。
事件 |
端点 |
|---|---|
PC 游戏安装 |
|
PC 游戏打开 |
|
游戏内事件 |
|
请在 X-Forwarded-For 请求头（Header）中发送游戏内事件发生的 IP。
如果您没有在 X-Forwarded-For 请求头中发送游戏内事件发生的 IP，您发送的事件将记录调用 API 的服务器 IP，则广告点击和游戏内事件将无法匹配。
请参考下表发送从 PC 游戏中收集的事件。 您发送的事件可定义为标准事件或自定义事件，具体取决于您在 eventData.goal 中发送的信息。 有关标准事件和自定义事件的更多信息，请参阅 本指南。
名称 |
必须 / 可选 |
说明 |
|---|---|---|
| 必须 | 请向 Airbridge 发送在游戏中用于识别用户的 ID。归因将基于此 ID 进行。 |
| 可选 | 您可以发送从 PC 游戏中收集的事件的发生平台和设备信息。 |
| 可选 | 请发送从 PC 游戏中收集的事件。
若使用 发送为 |
每次用户进入游戏时，在发送游戏内事件之前，请根据用户类型向 Airbridge 发送 PC 游戏安装事件或 PC 游戏打开事件。您首次发送的事件将决定是否监测后续的游戏内事件。对于后续的游戏内事件，您可以自由发送。
您可以通过重新激活追踪功能来追踪返回游戏的前沉睡用户。 有关重新激活追踪的更多信息，请参阅 本指南。
用户类型 |
您首次发送的事件 |
说明 |
|---|---|---|
新用户，或在 Airbridge 没有追踪记录的用户 | PC 游戏安装事件 | 该事件为 目标事件, 启动新的效果监测。 从接收 PC 游戏安装事件的时刻，对归因窗口内发生的事件进行归因。在回溯窗口内的触点才有资格被归因。 |
现有用户，或在 Airbridge 有追踪记录的用户 | PC 游戏打开事件 | 该事件非是目标事件，不会启动新的效果监测。 纳入现有效果监测或处理为无归因（Unattributed）。 |
设置的 归因窗口 为 3 天。
日期 |
用户 |
发送至 Airbridge 的事件 |
说明 |
|---|---|---|---|
1月 1日 | 用户 A | 1. PC 游戏安装事件 | 从 PC 游戏安装事件重新开始效果监测。 |
1月 2日 | 用户 A | 1. PC 游戏打开事件 | 这些事件的用户相同，且发生在归因窗口内。现有的效果监测将继续。 |
1月 3日 | 用户 B | 1. PC 游戏安装事件 | 从 PC 游戏安装事件重新开始效果监测。 |
1月 4日 | 用户 C | 1. PC 游戏打开事件 | 无现有的效果监测。 将处理为无归因。 |
1月 5日 | 用户 A | 1. PC 游戏打开事件 | 虽然这些事件由用户 A 触发，但发生在从 PC 游戏安装划定的归因窗口之外。因此，它们没有可被纳入的现有效果监测。 将处理为无归因。 |
请参考以下示例，了解如何通过 S2S 事件 API 发送从 PC 游戏中收集的事件。
您可以向 Airbridge 发送 PC 游戏安装事件，如下所示。
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9161' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "steam",
"deviceType": "desktop",
"osName": "Windows",
"osVersion": "11",
"deviceModel": "pc",
"screen": {
"width": 1920,
"height": 1080
}
}
}'您可以向 Airbridge 发送 PC 游戏打开事件，如下所示。
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9160' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "playstaion",
"deviceType": "console",
"osName": "playstation_5",
"screen": {
"width": 1920,
"height": 1080
}
}
}'您可以向 Airbridge 发送用户触发的各种游戏内事件。
您发送的事件将根据在 eventData.goal 中发送的信息定义。例如，如果 eventData.goal.category 的值为 buy_item，您可以在基础报告中选择 buy_item 查看该事件的详情。
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9360' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "iOS",
"deviceType": "desktop",
"osName": "iOS",
"osVersion": "17.1",
"deviceModel": "Mac",
"screen": {
"width": 1920,
"height": 1080
}
},
"eventData": {
"goal": {
"category": "buy_item",
"action": "weapon",
"label": "longsword",
"value": 1.234,
"customAttributes": {
"foo": "foo",
"bar": 1.234
}
}
}
}'建议将产生金额数据的收入相关事件作为标准事件发送。这样，金额数据既可以在 收入报告中查看，也可以在回传中使用。
如果将 eventData.goal.category 设置为 airbridge.ecommerce.order.completed，可以将数据作为标准事件中的 “完成订单” 事件发送。 eventData.goal.value 中所包含的数据是金额数据。
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9360' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "Android",
"deviceType": "desktop",
"osName": "Android",
"osVersion": "7",
"deviceModel": "pc",
"screen": {
"width": 1920,
"height": 1080
}
},
"eventData": {
"goal": {
"category": "airbridge.ecommerce.order.completed",
"value": 1.234,
"semanticAttributes": {
"currency": "USD"
}
}
}
}'请检查以下项目以确认 PC 游戏监测是否正常进行。
测试 |
内容 |
推荐解决方法 |
|---|---|---|
归因 | 您需要确认点击追踪链接后发生的 PC 游戏安装事件和游戏内事件是否归因于正确的广告渠道。 请在 Airbridge 面版的 [原始数据]>[App 实时记录] 确认引发 PC 游戏安装事件和游戏内事件的广告渠道。 | 您可能没有在 请在 |
API 设置 | 您需要确认事件是否按 API 设置被收集。若发送事件时不使用 | 请检查 API 设置。 |
您可以在 Airbridge 报告中查看 PC 游戏监测功能追踪到的的广告效果。在 PC 游戏发生的事件作为应用内事件而发送，因此可通过选择 App 指标查看。App 指标是在指标名称中包含 “(App)” 的指标。
从 PC 游戏发送的事件被定义为标准事件或自定义事件，具体取决于您在 eventData.goal 中发送的信息。您可以根据 eventData.goal 的设置，在基础报告中进行选择，以查看广告效果。
如下，“达到等级” 事件被设置为自定义事件。
eventData.goal.category: level_achievedeventData.goal.action: 发送达到特定等级的游戏中的区域信息eventData.goal.label: 发送达到特定等级的方法信息
如果在基础报告中，选择 level_achieved (App) 作为指标，然后选择 Channel、Event Action 和 Event Label 作为分组，就可以看到如下结果。
如下，“购买物品” 事件被设置为自定义事件。
eventData.goal.category: purchase_itemeventData.goal.action: 发送有关所购物品的等级信息eventData.goal.label: 发送有关所购物品的类型信息
如果在基础报告中，选择 purchase_item (App) 作为指标，然后选择 Channel、Event Action 和 Event Label 作为分组，就可以看到如下结果。
PC 游戏监测采用 概率模型匹配，猜测同一用户的窗口期为 6 小时。 仅限 PC 游戏监测，此时间段可修改。
IP 未发送：请在
X-Forwarded-For请求头中发送游戏内事件发生的 IP。端点错误：不同事件使用不同的 API 端点。请使用与您要发送的事件相对应的正确端点。
S2S 事件 API 设置错误：请使用 S2S 事件 API 的应用内事件发送功能。请勿使用网页内事件发送功能。
Was this helpful?