集成 Adjust:渠道指南

简介

Adjust 是独立的第三方营销归因工具。我们的技术支持跟踪和归因移动营销交互,为第三方合作伙伴提供精确且易用的归因数据,有助于减少偏差和简化数据集成过程。

本渠道指南介绍了如何与 Adjust 的推广活动设置向导集成。这是确保客户跟踪链接的准确性以及回传被发送到正确端点的最简易方式。注册成为我们的技术合作伙伴能够让您便捷地集成推广活动设置向导。如需注册,请尽量完整填写 Adjust 技术合作伙伴注册表格。例如,如果您在该表中注明安装回传 URL,您的客户将可以使用它直接在他们的控制面板中创建跟踪链接。如果您对表格填写有任何疑问,请发送电子邮件至 integration@adjust.com 与我们联系。

如果您已经注册成为我们的技术合作伙伴,请跳过此部分,继续阅读下文。我们将向您介绍如何设置回传。

如果您还未准备好与推广活动设置向导集成,我们将教您如何手动设置推广活动跟踪链接,然后再继续设置客户端回传。您还将了解到如何将自定义参数添加至回传、如何将广告发行商 ID 或推广活动数据发送至您客户的控制面板,以及如何在接收实时流量之前测试您的设置。


手动设置推广活动跟踪链接

Adjust 使用跟踪链接来记录您客户的推广活动带来的点击和展示,以及直接向您的服务器发送回传数据。您的客户将在他们的控制面板中创建跟踪链接,并直接与您共享相关链接。

每个跟踪链接都包含一个唯一的跟踪码,每个跟踪码包含至少六个小写字母数字字符串。本指南中的所有示例均采用最小长度的跟踪链接。请始终使用广告主提供的完整跟踪链接。

点击 URL 示例:

https://app.adjust.com/abc123
展示 URL 示例:
https://view.adjust.com/impression/abc123

在这些示例中,abc123 为跟踪码。
 

步骤 1:使用渠道宏给推广活动结构参数赋值,添加至我们的跟踪链接

首先,确认推广活动结构参数和渠道宏。我们会根据您的客户对受众细分的需求使用相关数据来填充这些内容。在渠道层级跟踪链接下,我们还提供三个层级的参数,这样您的客户在报告中可以使用四个层级的细分数据。

可用的推广活动结构参数名称如下:

  • campaign:顶层跟踪链接下的第一层级
  • adgroup:顶层跟踪链接下的第二层级
  • creative:顶层跟踪链接下的第三层级
这些名称指明了您在各个层级的跟踪信息类型,但是您也可以对其进行自定义,从而满足您客户的需求。例如,很多渠道选择使用这些参数来跟踪广告发行商和素材 ID。

您也可以按降序使用这些参数。换而言之,campaign 参数适用于最大的组(推广活动、国家或地区)。adgroup 参数适用于 campaign 层级组内更小的细分层级(例如:您正在定向营销的目标人群)。最后,creative 参数是最小层级,包含在 adgroup 层级组内。以下是多层级划分的示例:
campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}
添加这些推广活动结构参数后的跟踪链接示例如下:
https://app.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}

在本示例中,{campaign_id}{publisher_id}{creative_id} 并非 Adjust 的占位符。它们是您的点击宏,并且与您的服务器相对应。您的服务器将替换这些宏,并向我们发送您客户推广活动的相应推广 ID、广告发行商 ID 和素材 ID 数据。

如您有任何疑问,请发送电子邮件至 integration@adjust.com 与我们联系。

注意:推广活动结构参数区分大小写,并且必须为小写形式,否则我们的系统将无法识别。您最多可以输入 3 个子层级,但是如果它们与已有设置(例如:您将推广活动参数添加至第二层级的跟踪链接 ID)冲突,我们将优先处理跟踪码发来的数据。请确认您的客户–可以使用哪些子层级,他们可能已在使用其中的一些层级。请确保您们在推广活动结构上达成一致。
 

步骤 2:附加广告标识符以改进转化跟踪

接下来,我们会要求您在客户的跟踪链接中加入唯一的广告标识符。唯一的广告标识符可提高准确性,是我们归因用户时采用的最简单且最安全的方式。

注意:我们的技术可以采用数字指纹识别来跟踪转化,但是这些变量可能会发生变化(和过期),因此,转化量可能会被低估。如果您的客户要求使用基于指纹识别的归因,则他们必须在自己的 Adjust 控制面板中启用此项功能。指纹识别的默认设置为“关”。

我们可以接受大多数广告 ID 和哈希值。广告 ID 通过 Adjust 参数来传递。

以下是添加了标识符参数的跟踪链接示例(使用步骤 1 中已添加跟踪码和推广活动结构参数的跟踪链接):
https://app.adjust.com/abc123?campaign={publisher_id}&adgroup={sub_publisher_id}&creative={creative_id}&gps_adid=(your_identifier_macro)
如果是 iOS 应用,您可以向我们发送原始 IDFA。通过您的宏来赋值 IDFA 参数。示例如下:
https://app.adjust.com/abc123?campaign={publisher_id}&adgroup={sub_publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]

我们可用的设备 ID (及其格式)的完整列表如下:


广告 ID

gps_adid原始 Google 广告 ID小写字母,带连字符
gps_adid_upper_md5哈希 Google 广告 ID大写字母,带连字符,SHA1
gps_adid_upper_sha1哈希 Google 广告 ID大写字母,带连字符,SHA1
gps_adid_lower_sha1哈希 Google 广告 ID小写字母,带连字符,SHA1
IDFA原始 IDFA大写字母,带连字符
idfa_lower_md5经哈希处理的 IDFA小写字母,带连字符,MD5 哈希
idfa_lower_sha1经哈希处理的 IDFA小写字母,带连字符,SHA1 哈希
idfa_upper_md5经哈希处理的 IDFA大写字母,带连字符,MD5 哈希
idfa_upper_sha1经哈希处理的 IDFA大写字母,带连字符,SHA1 哈希
idfa_short原始 IDFA无连字符
fire_adid原始 Amazon Fire 广告 ID小写字母,带连字符
win_adid原始 Windows 广告 ID无连字符


设备 ID

参数ID类型格式
android_id*原始安卓 ID小写,无连字符
android_id_lower_md5*经哈希处理的安卓 ID小写字母,MD5
android_id_lower_sha1*经哈希处理的安卓 ID小写字母,SHA1
android_id_upper_md5*经哈希处理的安卓 ID大写字母,MD5
android_id_upper_sha1*经哈希处理的安卓 ID大写字母,SHA1
idfv**原始 IDFV大写字母,带连字符
mac_upper_short_md5*经哈希处理的 Wifi MAC大写字母,无冒号,MD5
mac_upper_sha1*经哈希处理的 Wifi MAC大写字母,带冒号,SHA1
win_naid原始 Windows 网络适配器 ID小写字母,带连字符
win_hwid原始 Windows 应用商店硬件 ID无连字符
*Adjust 只在 gps_adid 不可用时才使用安卓 ID 和 MAC 位址进行归因。**当运行交叉推广活动(例如通过电子邮件)来定向启用了 LAT 的用户时,应使用 IDFV。与仅依靠设备指纹识别相比,使用 IDFV 可提高归因的准确度。


步骤 3(可选):设置服务器到服务器的点击或展示跟踪

如果不支持第三方重定向,您可以向 Adjust 发送服务器到服务器 (s2s) 的点击或展示。

为了正确分析服务器到服务器的点击,您需要向我们说明点击是从服务器而不是最终用户报告的。服务器到服务器点击还需要广告 ID。由于指纹识别逻辑不适用,您必须提供用于跟踪的广告 ID(请参阅第 2 节)。只有一种情况例外:如果您正在运行安卓推广活动,则可以选择传递 referrer 来代替。


3.1 通过广告 ID 跟踪的 S2S 点击和展示

步骤 2 一样,您需要提供用于广告 ID 的点击宏,您的广告服务器可将其替换为正确的 ID。以下是正确的服务器到服务器点击调用示例(将 IDFA 占位符和点击宏用作所需广告 ID,IDFA 的占位符是 [idfa]):
https://s2s.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]&s2s=1
传入的点击包括您在推广活动结构参数中指定的任何广告 ID 和设置为 1 的 Adjust s2s 参数。如果没有这些参数,我们将忽略您的点击(以此防止 Bot 作弊),并且不会在您的推广活动下报告任何归因。您可以指定多个广告 ID。以下为跟踪链接示例:
https://s2s.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]&gps_adid=[your_gaid_macro]&s2s=1

展示也可以通过服务器到服务器的方式来发送。服务器到服务器的展示发送设置与点击非常相似。按上一节中的步骤创建跟踪链接,然后确保添加了参数 s2s=1。如果要将安装归因于服务器到服务器的展示,则必须提供广告 ID。

如果广告 ID 缺失,则 Adjust 将不会根据服务器到服务器的展示进行任何归因。尽管如此,在控制面板中,仍会将其算为一次展示。

3.2 通过指纹识别归因的 S2S 展示

如需使用指纹识别对展示进行归因,则需发送以下信息:

  • 设备类型 (device_type)、(device_name)
  • 操作系统 (os_name)
  • 操作系统版本 (os_version)
  • 语言 (language)
  • IP 地址 (ip_address)
  • 用户代理 (user_agent)

如果用户代理信息缺失,则 Adjust 将不会根据服务器到服务器的展示进行任何归因。尽管如此,在控制面板中,仍会将其算为一次展示。 

3.3 通过 referrer 归因的 S2S 点击

如果您无法访问点击的广告 ID ,并且正在运行安卓推广活动,则可使用 referrer 代替发送 s2s 点击。

将用户跳转到 Google Play 商店时,您必须将相同的 referrer 传递至 Google Play 商店。安装并打开应用后,Play 应用商店会广播 referrer,我们的 SDK 会收到此信息,并将其发送至我们的后端,并在后端与通过点击发送的 referrer 进行匹配。

若要实现此功能,请参照如下示例发送调用至 Adjust:
https://s2s.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&external_click_id=your_network_[clickid]&s2s=1
同时,向 Google Play 商店发送类似调用:
https://play.google.com/store/apps/details?id=my.app.id&referrer=adjust_external_click_id%3Dyour_network_[clickid]%26.....

重要提示:external_click_idadjust_external_click_id 均为强制参数。这两个参数均必须正确设置。


3.4 通过 S2S 点击发送多平台应用数据

如果您的客户将 s2s 点击用于多平台应用,他们可能会希望将点击和展示数据按操作系统进行区分。如果您使用的不是 s2s 点击,我们可以显示 os_name。但是,如果使用的是 s2s 点击,我们会提供不同的解决方案来区分该数据。

在这种情况下,您必须将 os_name 参数附加至跟踪链接。如需向客户提供设备类型和 IP 地址相关信息,请分别使用 device_typeip_address 参数。示例如下:
https://s2s.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&idfa=[idfa]&s2s=1&device_type=[device_type]&os_name=[os_name]&ip_address=[ip_address]
同样,这些占位符应由您的广告服务器来决定和替换。

注意:我们支持并且可以解读多种设备类型名称,但前提是,这些设备类型名称没有版本号,并且 os_name 全部小写。例如:
iphone、tablet、mobile、ios、android、windows

以上就是为您的客户手动设置跟踪链接的全部说明。如您有任何疑问,请发送电子邮件至 integration@adjust.com 与我们联系。在下一节中,我们将介绍如何设置回传。Adjust 回传可以提供实时数据,并且可以将其发送至任何终端(无论是广告服务器或商业智能 (BI) 系统)。


手动设置 Adjust 回传

在 Adjust,您可以将动态回传 URL 直接附加至跟踪链接。这意味着回传可被直接附加至跟踪链接,并且在转化时自动触发回传至您的终端。我们不会要求您在我们的服务器中提供硬编码的回传。这种方式在我们行业中是独一无二的,借此您可以根据需要轻松重定义回传。请记住,您的客户必须向您直接提供其推广活动的跟踪链接。

您可以接收客户授权跟踪的任何事件回传,包括由您的流量触发的点击、安装和应用内事件。我们强烈建议您使用我们的跟踪链接生成器来设置您的 Adjust 回传。通过该工具,您可以输入多个回传 URL 和占位符,并且自动创建准确无误的 URL。您还可在本页面找到我们的可用占位符列表。请阅读该列表来了解可供使用的各种数据点。

例如:install_begin_time install_finish_time 占位符可用于防止点击欺诈。我们的交互数据占位符可以帮助客户了解,从用户首个归因来源到最新再归因之间的一切信息,我们还为经认证的 Google 合作伙伴和 Facebook 营销合作伙伴提供众多专门用于 Google 和 Facebook 的参数。

如果您的客户希望您接收我们的控制面板未显示的收入或自定义应用数据点(例如:交易 ID),那么他们必须设置合作伙伴参数(会话、安装、再归因和事件回传中有提供),并在他们控制面板中的合作伙伴设置 > 外部数据转发下,启用收入共享参数转发功能。

您可以为任何获得跟踪授权的客户跟踪事件设置相应的回传。我们的回传生成器可以帮助您正确编码的回传。如需了解更多信息,请继续参阅下文。


使用跟踪链接生成器手动设置 Adjust 回传

本示例中,我们将使用上一节(有关创建跟踪链接)中的同一跟踪链接。该 URL 已包含跟踪码、推广活动结构参数和广告 ID 参数。示例如下:
https://app.adjust.com/abc123?campaign={publisher_id}&adgroup={sub_publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]

假设您的回传为 http://your-URL.com/php?country={country}**
**如果占位符数据不可用,则将从回传中删除。

操作说明

  1. 进入 partners.adjust.com
  2. 在方框 1('Enter your links')中输入跟踪链接。
  3. 在 'install callback' 栏中输入您的回传 URL。
  4. 向下滚动至占位符列表。确认该工具能正确识别您的宏。
  5. 我们将在页面底部生成您的点击 URL。
本示例中,生成的正确回传 URL 应为:
https://app.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]&install_callback=http%3A%2F%2Fyour-URL.com%2Fcallback.php%3Fcountry%3D%7Bcountry%7D

会话、再归因、被拒安装和点击回传的设置步骤与上述完全相同。例如:对于再归因回传,您需要附加 reattribution_callback 参数。该参数将在用户被成功再归因到您的推广活动时通知您。

添加点击 ID 至 Adjust 回传

我们支持您轻松地在回传中接收渠道的点击 ID/交易 ID。如果您的服务器自身已有可用的宏/占位符(格式通常为 {click_id}{transaction_id},但也可能有差异),您仅需将其添加至 URL 的回传部分。

以下是已添加点击 ID 参数的回传 URL 示例:
http://your-URL.com/callback.php?click_id=[your_click_id]
添加至 Adjust 跟踪链接后将如下所示:
https://app.adjust.com/abc123?campaign={publisher_id}&adgroup={sub_publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]&install_callback=http%3A%2F%2Fyour-URL.com%2Fcallback.php%3Fclick_id%3D[your_click_id]
对于事件回传,还需执行一个额外步骤。如果您需要对特定事件进行回传,您的客户必须首先与您共享该事件识别码。Adjust 为您的客户在其控制面板中设置的每个事件生成一个唯一的事件识别码。如果要设置事件回传,请要求您的客户共享此信息。以下是事件识别码为 xyz456 的回传示例。
https://app.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&idfa=[your_idfa_macro]&install_callback=http%3A%2F%2Fyour-URL.com%2Fcallback.php%3Fcountry%3D%7Bcountry%7D&event_callback_xyz456=http%3A%2F%2Fyour-URL.com%2Fcallback.php%3Fcountry%3D%7Bcountry%7D

注意:您可以将多个事件参数连续添加至同一跟踪链接,只要参数之间正确分隔。

如果您的客户已在其控制面板中为应用激活防作弊套件(包括 Adjust 的匿名 IP 过滤、点击劫持过滤和分布模型排查),则可以使用作弊回传功能。如果您的客户已激活该功能,我们将在归因前检测并拒绝作弊交互。

如果您将 rejected_install_callbackrejected_reattribution_callback 添加至跟踪链接,并且我们检测到作弊,我们将返回正确的 (rejection_reason) 值。当前可用值为:anonymous traffic(匿名流量)、too many engagements(交互过多)、distribution outlier(分布异常)、engagement injection(交互注入)和 invalid signature(无效签名)。
https://s2s.adjust.com/abc123?campaign={campaign_id}&adgroup={publisher_id}&creative={creative_id}&idfa=[idfa]&s2s=1&device_type=[device_type]&os_name=[os_name]&ip_address=[ip_address]&rejection_reason=[distribution_outlier]

注意:归因可能会同时触发已接受的安装回传被拒安装回传。

例如,如果安装可以匹配到两次点击,并且其中一次点击被视为作弊,则我们会为作弊点击发送被拒安装回传,并为有效点击发送常规安装回传。

若要完成您客户的设置,请配置他们的推广活动,以将用户重定向至 Adjust 跟踪链接,并按照我们的以下测试说明操作。

请记住:如果您已填写技术合作伙伴注册表并备注了回传 URL,则会在您客户的推广活动设置向导中自动提供该回传 URL,以供客户在需要时将其添加至他们的跟踪链接,无需您再手动添加。


测试 Adjust 回传

我们建议您在投放推广之前测试您的回传 URL,这样可以避免我们对实时流量进行故障排查的风险。

如需测试 URL,请使用我们的测试跟踪链接(即 cbtest 跟踪链接)。cbtest 跟踪链接会向您的回传 URL 发送模拟回传。示例如下:
https://app.adjust.com/cbtest?install_callback=http%3A%2F%2Fyour-URL.com%2Fcallback.php%3Fparameter%3D{parameter}

此操作将立即触发回传,无需测试安装。如需测试,可以使用 callbackinstall_callbackevent_callback 参数。点击测试回传的跟踪链接不会将您重定向至应用商店。相反,成功的测试会将您带至以下页面:
callbackTest called: http://your-URL.com/callback.php?parameter={parameter}

查看您的服务器日志,确认您是否已成功注册回传;如果已注册,则表明运行正常。上线时将 ‘cbtest’ 替换为您客户提供的跟踪链接。

如果您希望同时使用实时跟踪链接和实时应用来进行某些端到端的测试,则要求您的客户提供跟踪链接,以测试实时 URL。操作过程与上述示例类似。为了进行测试,您必须使用新的设备或提前从设备中清除我们的服务器归因。请注意,一旦您首次安装应用,我们会将您的设备永久归因于您的跟踪链接。

如果您仍有其他疑问,请发送电子邮件至 integration@adjust.com 与我们联系。


高级安全指令(可选)

保护回传结构

为了维护您回传结构的私密性,我们可以为您的 URL 静态部分提供占位符。请将回传的静态部分通过邮箱 integration@adjust.com 发送给我们。我们设置完成后,您就可以像调用其他正常的回传 URL 一样调用该占位符。以下是回传 URL 示例:
http://mynetwork.com/secret_handler?track=1&install=1&click_id={click_id}

如果只有动态点击 ID,我们会创建占位符 mynetwork,以对应于您的静态基础 URL,这将把您的可见安装回传变为 mynetwork(click_id)

别名必须以 http 或 https 开头,完整调用应如下所示:
https://app.adjust.com/abc123?install_callback=mynetwork{click_id}

此操作需要我们后端团队的协助。如需设置,请发送电子邮件至 integration@adjust.com 与我们联系。


保护 Adjust 回传

如果存在他人蓄意错误触发回传的情况,您可以通过仅允许 Adjust 服务器进行调用来保护您的 HTTP 句柄。所有回传都来自 Adjust 服务器的某个 IP

取决于回传界面的结构,您可以阻止应用层级的作弊调用或使用代理。使用 nginx 的示例如下:
location /callback {
                 // add this condition to only check callbacks having an "adjust" parameter
                 // set to 1 for the origin - if this location only processes Adjust calls,
                 // remove the condition
    if ($arg_adjust = 1) {
    allow 178.162.216.64/26; allow 178.162.216.128/26; deny all;
    } }

通过该配置,您只需将 &adjust=1 附加至回传,我们将检查它们的 IP 来源是否正确,以此阻止作弊调用。如果您在设置代理或应用时需要协助,请发送电子邮件至 integration@adjust.com 与我们联系。

有关此主题