PC 游戏监测

Last updated June 20, 2025

为了评估 PC 游戏广告的效果，不仅需要监测展示广告的 App 和 Web 的表现，也需对运行游戏的 PC 进行监测。Airbridge 能够对 App、Web 以及 PC 进行综合监测。

提示
此功能处于测试阶段。如有疑问或功能需求，请联系您的 CSM。如果没有指定的 CSM，请通过 [帮助] 提交请求。

PC 游戏监测方案

为了监测 PC 游戏广告的效果，需要实现跨平台的数据收集，因为用户在多个平台接触广告后选择在 PC 上玩游戏。这要求从 App、Web 以及 PC 收集数据。

PC 游戏监测设置

为了设置 PC 游戏监测，您需要从 App、Web 和 PC 收集数据，并以不同方式将数据传输至 Airbridge。从追踪链接和网站收集的数据需要通过 Airbridge SDK 传输至 Airbridge。从 PC 游戏收集的数据，则需通过 API 传输。

提前准备

使用落地页的 PC 游戏监测需要一些提前准备。若您的监测方案不需落地页，请直接进入下一步。

创建追踪链接

请创建追踪链接，并在集成渠道专用追踪链接的 [跳转]>[目的地]>[网站] 输入各平台的落地页地址。若无独立落地页，请输入其他游戏平台的地址，如 Steam 或 Epic Games Store。

有关如何创建追踪链接的更多信息，请参阅本指南。

从 PC 游戏中收集的事件传输

请收集在 PC 游戏中发生的事件，并通过 S2S 事件 API，按顺序将这些事件传输至 Airbridge。

请参考以下设置将 PC 游戏中发生的事件通过 S2S 事件 API 传输至 Airbridge。有关 S2S 事件 API 的更多信息，请参阅本指南。您必须使用应用内事件发送功能，而不是网页内事件发送功能。

关键事件的端点

发送 PC 游戏安装、PC 游戏打开、以及游戏内事件的端点（Endpoint）各不相同。

游戏内事件是指用户开启 PC 游戏后可能发生的事件。例如，完成教程、达到特定等级等。

`#{"width":"80px"}` 事件	`#{"width":"240px"}` 端点
PC 游戏安装	`https://api.airbridge.io/events/v1/apps/{{APP_NAME}}/mobile-app/9161`
PC 游戏打开	`https://api.airbridge.io/events/v1/apps/{{APP_NAME}}/mobile-app/9160`
游戏内事件	`https://api.airbridge.io/events/v1/apps/{{APP_NAME}}/mobile-app/9360`

#{"width":"80px"}

事件

#{"width":"240px"}

端点

PC 游戏安装

https://api.airbridge.io/events/v1/apps/{{APP_NAME}}/mobile-app/9161

PC 游戏打开

https://api.airbridge.io/events/v1/apps/{{APP_NAME}}/mobile-app/9160

游戏内事件

https://api.airbridge.io/events/v1/apps/{{APP_NAME}}/mobile-app/9360

请求头设置

请在 X-Forwarded-For 请求头（Header）中发送游戏内事件发生的 IP。

如果您没有在 X-Forwarded-For 请求头中发送游戏内事件发生的 IP，您发送的事件将记录调用 API 的服务器 IP，则广告点击和游戏内事件将无法匹配。

参数设置

请参考下表发送从 PC 游戏中收集的事件。您发送的事件可定义为标准事件或自定义事件，具体取决于您在 eventData.goal 中发送的信息。有关标准事件和自定义事件的更多信息，请参阅本指南。

`#{"width":"80px"}` 名称	`#{"width":"40px"}` 必须 / 可选	`#{"width":"200px"}` 说明
`user.externalUserID`	必须	请向 Airbridge 发送在游戏中用于识别用户的 ID。归因将基于此 ID 进行。
`device`	可选	您可以发送从 PC 游戏中收集的事件的发生平台和设备信息。
`eventData.goal`	可选	请发送从 PC 游戏中收集的事件。 `eventData.goal.category` 为事件名称，您可以在报告中查看该事件。若使用 `eventData.goal.action`、 `eventData.goal.label`、或 `eventData.goal.value` 发送其他信息，您可以在报告中查看更多细节。发送为 `eventData.goal.customAttributes` 的信息仅在原始数据中查看。

#{"width":"80px"}

名称

#{"width":"40px"}

必须 / 可选

#{"width":"200px"}

说明

user.externalUserID

必须

请向 Airbridge 发送在游戏中用于识别用户的 ID。归因将基于此 ID 进行。

device

可选

您可以发送从 PC 游戏中收集的事件的发生平台和设备信息。

eventData.goal

可选

请发送从 PC 游戏中收集的事件。

eventData.goal.category 为事件名称，您可以在报告中查看该事件。

若使用 eventData.goal.action、 eventData.goal.label、或 eventData.goal.value 发送其他信息，您可以在报告中查看更多细节。

发送为 eventData.goal.customAttributes 的信息仅在原始数据中查看。

每次用户进入游戏时，在发送游戏内事件之前，请根据用户类型向 Airbridge 发送 PC 游戏安装事件或 PC 游戏打开事件。您首次发送的事件将决定是否监测后续的游戏内事件。对于后续的游戏内事件，您可以自由发送。

您可以通过重新激活追踪功能来追踪返回游戏的前沉睡用户。有关重新激活追踪的更多信息，请参阅本指南。

`#{"width":"120px"}` 用户类型	`#{"width":"80px"}` 您首次发送的事件	`#{"width":"200px"}` 说明
新用户，或在 Airbridge 没有追踪记录的用户	PC 游戏安装事件	该事件为目标事件, 启动新的效果监测。从接收 PC 游戏安装事件的时刻，对归因窗口内发生的事件进行归因。在回溯窗口内的触点才有资格被归因。
现有用户，或在 Airbridge 有追踪记录的用户	PC 游戏打开事件	该事件非是目标事件，不会启动新的效果监测。纳入现有效果监测或处理为无归因（Unattributed）。

#{"width":"120px"}

用户类型

#{"width":"80px"}

您首次发送的事件

#{"width":"200px"}

说明

新用户，或在 Airbridge 没有追踪记录的用户

PC 游戏安装事件

该事件为目标事件, 启动新的效果监测。

从接收 PC 游戏安装事件的时刻，对归因窗口内发生的事件进行归因。在回溯窗口内的触点才有资格被归因。

现有用户，或在 Airbridge 有追踪记录的用户

PC 游戏打开事件

该事件非是目标事件，不会启动新的效果监测。

纳入现有效果监测或处理为无归因（Unattributed）。

例) 事件发送场景

设置的归因窗口为 3 天。

`#{"width":"80px"}` 日期	`#{"width":"60px"}` 用户	`#{"width":"100px"}` 发送至 Airbridge 的事件	`#{"width":"240px"}` 说明
1月 1日	用户 A	1. PC 游戏安装事件 2. 完成教程事件 3. 达到特定等级事件	从 PC 游戏安装事件重新开始效果监测。
1月 2日	用户 A	1. PC 游戏打开事件 2. 游戏内内容购买事件	这些事件的用户相同，且发生在归因窗口内。现有的效果监测将继续。
1月 3日	用户 B	1. PC 游戏安装事件 2. 最终内容参与事件	从 PC 游戏安装事件重新开始效果监测。
1月 4日	用户 C	1. PC 游戏打开事件 2. 完成教程事件 3. 达到特定等级事件 4. 游戏内内容购买事件	无现有的效果监测。将处理为无归因。
1月 5日	用户 A	1. PC 游戏打开事件 2. 游戏内内容购买事件	虽然这些事件由用户 A 触发，但发生在从 PC 游戏安装划定的归因窗口之外。因此，它们没有可被纳入的现有效果监测。将处理为无归因。

请参考以下示例，了解如何通过 S2S 事件 API 发送从 PC 游戏中收集的事件。

您可以向 Airbridge 发送 PC 游戏安装事件，如下所示。

1234567891011121314151617181920
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 游戏打开事件，如下所示。

123456789101112131415161718
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 查看该事件的详情。

1234567891011121314151617181920212223242526272829303132
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 中所包含的数据是金额数据。

1234567891011121314151617181920212223242526272829
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 游戏监测是否正常进行。

`#{"width":"80px"}` 测试	`#{"width":"240px"}` 内容	`#{"width":"160px"}` 推荐解决方法
归因	您需要确认点击追踪链接后发生的 PC 游戏安装事件和游戏内事件是否归因于正确的广告渠道。请在 Airbridge 面版的 [原始数据]>[App 实时记录] 确认引发 PC 游戏安装事件和游戏内事件的广告渠道。	您可能没有在 `X-Forwarded-For` 请求头发送游戏内事件发生的 IP。请在 `X-Forwarded-For` 请求头中发送游戏内事件发生的 IP。
API 设置	您需要确认事件是否按 API 设置被收集。若发送事件时不使用 `X-Forwarded-For` 请求头，则只能测试 API 设置。	请检查 API 设置。

#{"width":"80px"}

测试

#{"width":"240px"}

内容

#{"width":"160px"}

推荐解决方法

归因

您需要确认点击追踪链接后发生的 PC 游戏安装事件和游戏内事件是否归因于正确的广告渠道。

请在 Airbridge 面版的 [原始数据]>[App 实时记录] 确认引发 PC 游戏安装事件和游戏内事件的广告渠道。

您可能没有在 X-Forwarded-For 请求头发送游戏内事件发生的 IP。

请在 X-Forwarded-For 请求头中发送游戏内事件发生的 IP。

API 设置

您需要确认事件是否按 API 设置被收集。若发送事件时不使用 X-Forwarded-For 请求头，则只能测试 API 设置。

请检查 API 设置。

查看广告效果

您可以在 Airbridge 报告中查看 PC 游戏监测功能追踪到的的广告效果。在 PC 游戏发生的事件作为应用内事件而发送，因此可通过选择 App 指标查看。App 指标是在指标名称中包含 “(App)” 的指标。

从 PC 游戏发送的事件被定义为标准事件或自定义事件，具体取决于您在 eventData.goal 中发送的信息。您可以根据 eventData.goal 的设置，在基础报告中进行选择，以查看广告效果。

注意事项

Was this helpful?

Any questions or suggestions?

PC 游戏监测

提示

PC 游戏监测方案

使用落地页的 PC 游戏监测方案（推荐）

无落地页的 PC 游戏监测方案

PC 游戏监测设置

提前准备

准备落地页

Airbridge 注册

在落地页安装 Airbridge Web SDK

设计事件结构

创建追踪链接

从 PC 游戏中收集的事件传输

设置 S2S 事件 API

向 Airbridge 发送游戏内事件

例 1）PC 游戏安装事件

例 2）PC 游戏打开事件

例 3）不产生金额数据的游戏内事件

例 4）产生金额数据的游戏内事件

测试 PC 游戏监测

查看广告效果

例) 查看达到特定等级的事件

例) 查看 "购买物品" 事件

注意事项

PC 游戏监测如何识别用户

常见错误

PC 游戏监测self.__wrap_n!=1&&self.__wrap_b(":R96fnkvcupkvecq:",0.5)

提示

PC 游戏监测方案

使用落地页的 PC 游戏监测方案（推荐）

无落地页的 PC 游戏监测方案

PC 游戏监测设置

提前准备

准备落地页

Airbridge 注册

在落地页安装 Airbridge Web SDK

设计事件结构

创建追踪链接

从 PC 游戏中收集的事件传输

设置 S2S 事件 API

向 Airbridge 发送游戏内事件

例 1）PC 游戏安装事件

例 2）PC 游戏打开事件

例 3）不产生金额数据的游戏内事件

例 4）产生金额数据的游戏内事件

测试 PC 游戏监测

查看广告效果

例) 查看达到特定等级的事件

例) 查看 "购买物品" 事件

注意事项

PC 游戏监测如何识别用户

常见错误

PC 游戏监测