设置 Microsoft 应用商店及原生 PC 游戏监测

Adjust 的 PC 和主机监测解决方案能帮助您获得 Windows 和 Mac 游戏的重要归因洞见。设置完成后,Adjust 就能显示专门针对 Windows 和 Mac 原生游戏的广告在安装量、会话量和应用内事件方面的增量提升作用。您也可以使用同期群分析特定的归因数据,例如在指定时间段内用户在不同关卡或等级中的进展情况。

在本指南中,您将了解到如何设置新的游戏应用,建立安全的服务器到服务器 (S2S) API 连接,以及如何高效管理链接,确保归因监测顺利进行。

要设置 PC 原生游戏监测,请完成下列操作:

  1. 在 AppView 中设置新应用
  2. 设置 Adjust S2S API,开始记录会话数据
  3. 在 Campaign Lab 中设置链接

设置 PC 应用

要添加和设置 PC 端应用,请按照下列步骤操作:

  1. 找到 AppView​ ,选择 所有应用​ 。

  2. 选择 添加应用

  3. 输入应用详情​ 下,输入应用名称,选择报告币种,然后标注游戏是否需要满足下列规定;

    • COPPA 合规​ 。仅适用于位于美国的公司。点击此处,进一步了解 COPPA 合规相关信息。
    • Google DMA​ 。适用于仅存在位于欧洲经济区 (EEA) 之外用户群的应用。在此处进一步了解 Google DMA。
  4. 选择 添加应用​ 。

  5. 选择 关联平台​ ,将平台关联到游戏。

    1. 选择 PC​ > Windows​ 。

    2. 请选择下列两种方式之一关联到平台:

      • 如果您的游戏已在 Microsoft Store 中上架,选择 Microsoft 应用商店​ ,然后输入 应用 ID​ ,或选择暂无 应用 ID​ ,等获得 ID 后再输入。
      • 如果您的应用是在 Windows 或 Mac 中的自定义商店发布的,请选择 原生 PC​ ,启用 将所有点击重定向至自定义 URL​ ,然后输入 URL。
    3. 然后选择 保存​ 。

  1. 应用信息​ 下,您可以自定义所有链接在社交媒体应用上分享时的显示方式

  2. 打开 事件​ 标签页,添加应用内事件,监测用户在游戏中的活动。

  3. 打开 归因设置​ 标签页,查看归因 (设备匹配、概率模型和暂时归因) 和再归因设置。

    • 仔细检查,确保已同时启用点击和展示概率模型。我们强烈建议您将概率模型的归因窗口设置为 24 小时,但您可以将其设置为最长 90 天。90 天的归因窗口只适用于 PC 和主机平台。
  4. 打开 数据管理​ 标签页,设置服务器回传云储存上传,接收原始用户层级数据;或使用测试控制台查看测试设备数据。

  5. 打开 数据保护​ 标签页,进行 S2S 安全设置,以便获得识别码,在 S2S API 设置中使用。

设置 Adjust S2S API

通过 Adjust 的 S2S API 将应用连接到 Adjust,在不改变应用代码的情况下开始监测用户会话和事件。

请使用 session 终端继续设置流程。

操作前须知

Adjust 服务器会严格检查一致性,防止滥用,避免发生系统过载。S2S 归因是一种专用的集成,无法与 Adjust SDK 配合使用。

  • 请务必阅读我们的 S2S 归因检查清单,充分了解 S2S 设置相较于 SDK 集成的局限性。
  • 向我们服务器发送请求的顺序必须与设备上请求发生的顺序相同。

认证

设置 S2S 安全来保护 S2S 会话的安全,抵御欺诈请求的侵害。设置认证后,每个传入的请求都必须带有您在 Adjust 控制面板中生成的认证识别码。识别码缺失或错误的请求会被我们的服务器拒绝。

终端

通过session终端,您可以在用户启动游戏时记录会话。当用户从后台恢复或开始游戏时(例如在游戏保持运行的情况下打开另一应用,或在上次关闭游戏后再次启动游戏),会话就会被触发。Adjust 服务器接收新会话的频率为每 30 分钟一次,以避免不必要的资源占用。

https://s2s.adjust.com/session

POST 标头

授权:​ 调用 Adjust API 时,发送验证类型设置为 Bearer 的 Adjust 认证识别码。

示例:Bearer authentication_token

POST Payload

请注意:

带有 *​ 的参数为必要参数。

参数数据类型In描述
s2s*字符串查询服务器到服务器的参数:允许 Adjust 服务器识别服务器端的活动。必须始终为 1。
app_token*字符串查询应用的唯一认证识别码
os_name*字符串查询根据应用的操作系统选择以下可用参数之一:
  • windows 
  • Mac OS
ip_address*字符串查询设备 IP 地址
created_at*Timestamp查询本地设备创建包的时间戳 (带时区)。
external_device_id*字符串查询唯一 user_id,示例:用户的 account_id 或经过加密的电子邮件地址

请求示例

cURL
curl -X 'POST' -d 's2s=1&app_token=a1234b2x3a4o&ip_address=0.0.0.0&created_at=2018-03-23T09:46:47.288Z-0400&sent_at=2018-03-23T09:46:47.288Z-0400&external_device_id=099aa0bc' -H 'Authorization: Bearer ADD_YOUR_AUTH_TOKEN_HERE' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'

要了解如何使用 S2S API 记录事件,请参阅服务器到服务器 (S2S) 事件

设置链接

设置并测试应用服务器与 Adjust 之间的 S2S API 集成后,您需要将 Adjust 连接到投放推广活动的广告渠道。

使用链接时,用户在其他设备上与您的广告交互后,归因信息就能被记录下来,例如在移动或 CTV 端观看了广告,然后在 PC 端安装游戏。以下为针对网页推广活动的两个渠道示例:

请在 Campaign Lab 中按照以下步骤操作。

  1. 找到 Campaign Lab​ ,选择 合作伙伴​ 。

  2. 选择 新合作伙伴​ 。

  3. 打开 合作伙伴选择​ 界面,选择您要设置的广告渠道。

  4. 应用选择​ 页面,选择要为哪款应用新建链接。

  5. (可选) 在 数据分享​ 界面中,配置渠道与 Adjust 的集成,并选择数据分享设置。

  6. 链接结构​ 界面中,查看渠道提供的默认链接结构参数,并在有必要的时候更新参数值。

  7. (可选) 在 用户目标位置​ 界面中,配置深度链接,或为链接添加重定向或后备。

    • 要将用户重定向至特定游戏商店,请确保将 URL 添加为重定向附加参数。
  8. (可选) 在 归因设置​ 界面,为新用户和已有用户进行归因设置。这些归因设置适用于点击和展示。如果跳过此步骤,系统将应用您在设置应用环节选择的归因设置。

    • 仔细检查,确保已同时启用点击和展示概率模型。我们强烈建议您将概率模型的归因窗口设置为 24 小时,但您可以将其设置为最长 90 天。90 天的归因窗口只适用于 PC 和主机平台。
  9. 检查设置​ 页面,检查您的选择并进行必要更改。

  10. 选择 创建链接​ ,以生成点击 URL、展示 URL、二维码和链接识别码,并且开启数据分享,如果您进行了设置的话。