回传结构 要设置回传,您需要指定:
您的回传类型所对应的正确的回传参数。 用于接收数据的服务器终端 URL。 您想记录的数据点的 Adjust 占位符。 您想要分享的数据点的宏。 用于从客户处接收应用内事件和会话相关信息的合作伙伴参数 (如适用)。
集成
Campaign Lab 时,我们会要求您分享回传 URL 和宏。当您的客户生成链接 URL 时,我们会附加您的回传 URL (事件回传除外) 和宏。
对于事件回传,您需要将事件识别码附加至事件回传参数。在这种情况下,我们建议您使用
编码工具 。
如有任何疑问,请联系 integration@adjust.com。
全部展开
使用回传参数将不同类型的回传附加至链接 URL。
如果您使用的是
品牌化链接 或
通用链接 则必须在回传参数中添加前缀
adj_
。例如:针对
install_callback
参数使用
adj_install_callback
。
下面的表格列出了针对不同回传类型的回传参数。
安装 install_callback
再归因 reattribution_callback
转化 (包括安装和再归因) conversion_callback
会话 session_callback
事件 您需要向回传参数中附加事件识别码。请联系客户分享此事件识别码。 event_callback_
被拒安装 rejected_install
Rejected Install Rate (被拒再归因) rejected_reattribution
如有必要,请使用
click_callback
和
impression_callback
回传参数分别设置点击回传和展示回传。
回传 URL 或终端决定了 Adjust 将您的数据发送至何处,应为您的服务器终端 URL。您可以将此回传 URL 添加到 Adjust 链接 URL 来接收安装、会话、再归因或应用内事件相关数据。
请确保将服务器终端 URL/域名指定为回传 URL。出于安全考虑,Adjust 不支持在回传 URL 中包含 IP 地址。
示例: 如果您使用
http://1.2.3.4:80/xxxxx
作为回传 URL,Adjust 服务器会拒绝传入的点击。
您可以为一个回传参数添加多个回传 URL,只需用"+"符号将每个已编码 回传 URL 分隔开来即可。
示例:一个回传 URL
在以下示例中,https://mynetworkserver.com/callback
是安装回传的回传 URL。
install_callback=https%3A%2F%2Fmynetworkserver.com%2Fcallback_%3Fclick_id%3D123456%26idfa%3D%7Bidfa%7D%26gps_adid%3D%7Bgps_adid%7D
示例:两个回传 URL
在以下示例中,http://mynetworkserver.com/callback
和 http://myothernetworkserver.com/install
是通过"+"符号隔开的安装回传 URL。
install_callback=https%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}+https%3A%2F%2Fmyothernetworkserver.com%2Finstall%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}
Adjust 合作伙伴占位符 是一种宏,允许 Adjust 将用户或交互数据动态添加到回传字符串中。您可以根据需要向回传字符串中添加任意数量的参数和占位符,只需用与号 (&) 分隔每个键值对即可。
例如,使用{idfa}
占位符通过回传接收 iOS 设备的标识符。
示例:
https://mynetworkserver.com/adjust/info?client_name={app_name}&iOS_device={idfa}&campaign={campaign_name}
此处的{app_name}
、 {idfa}
和 {campaign_name}
为 Adjust 占位符。
宏是不同合作伙伴特有的占位符,由渠道动态填充。
示例 :{idfa}
、 {gaid}
、 {publisher_id}
、 [creative]
请勿编码动态合作伙伴宏。如果您对宏进行了编码,服务器就无法识别这些宏,也不会填充任何必要的值。
使用合作伙伴参数来从客户处接收应用内事件或会话的额外信息 。您能否接收此类信息取决于客户是否分享。
合作伙伴参数的占位符为{partner_parameters}
。将此占位符添加至回传 URL 后,您将从客户的 SDK 收到针对自定义参数的已编码 JSON payload。
带有推广结构参数、设备标识符、安装及事件回传的点击链接 URL。
https://app.adjust.com/abc1234?campaign=new-campaign&adgroup={sub_id}&creative={crt_id}&idfa={network_idfa_macro}&gps_adid={network_gaid_macro}&install_callback=http%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}&event_callback_r8oaj2=http%3A%2F%2Fmynetworkserver.com%2Fcallback%3Fcountry%3D%7Bcountry%7D%26click_id%3D{click_id}%26event%3Dregister%26partner_parameter%3D%7Bpartner_parameters%7D
在此示例中,我们解释了最终未编码 URL 的结构。请切记在推广活动上线前将 URL 进行编码。
由客户分享的带有链接识别码的 Adjust 链接 - https://app.adjust.com/abc1234
推广活动结构参数 - campaign
、 adgroup
、 creative
合作伙伴宏 - new-campaign
、 {sub_id}
、 {crt_id}
广告标识符 - idfa
、 gps_adid
广告 ID 的合作伙伴宏 - {network_idfa_macro}
、 {network_gaid_macro}
安装回传 - install_callback=http://mynetworkserver.com/callback?country={country}&click_id={click_id}
回传参数 - install_callback
回传 URL/终端 - http://mynetworkserver.com
Adjust 占位符 (Adjust 服务器填充数据) - {country}
渠道宏 (渠道服务器填充数据) - {click_id}
事件回传 - event_callback_r8oaj2=http://mynetworkserver.com/callback?country={country}&click_id={click_id}&event=register
回传参数 - event_callback
事件识别码 (由客户共享并附加至事件回传参数) - r8oaj2
与事件识别码对应的硬编码值 - event=register
合作伙伴参数占位符 - {partner_parameters}