乐元素用户7485
Sigmob 下载类产品投放对接文档
输入“/”快速插入内容
Sigmob 下载类产品投放对接文档
Sigmob 下载类产品投放对接文档
本文档面向广告主侧技术对接人员，说明转化回调（callback）、后续事件回调；
版本历史
更新日期 | 更新说明 |
2022-11-03 | _CLICKID_ 宏参数格式调整到最长50个字符以内 |
2023-06-02 | 增加 _CAID_ 宏参数支持 |
2023-08-24 | 增加 caid 分版本的 宏参数替换支持，详见文档 |
2023-11-24 | 后续事件增加变现广告相关参数上报，ad_quality、imp_id、ad_paltform，详见文档 |
2023-12-13 | 增加_IDFA1_、_IMEI1_、_CAIDCON_、_CAIDCON1_宏参数支持 |
2024-03-21 | 后续事件增加变现广告类型参数上报，ad_type |
概述
广告主在Sigmob投放下载类广告时，必须填写点击监测链接（也称追踪链接，点击监测链接是广告主的api接口，用来接收Sigmob媒体上发送的点击信息）。点击信息中会至少包含三类重要信息：clickid（经_CLICKID_ 这个宏参数替换，代表广告唯一标识）、转化回调链接（经_CALLBACK_这个宏参数替换）、用户侧的设备ID（不同设备类型对应的设备ID需要经过不同的宏参数替换上报）。
广告主收到点击监测后，需要将设备id 和 clickid、callback 的对应关系缓存起来。之后会有如下场景：
a.
当广告主自己的 APP 内发生转化行为时（也可称之为广告投放目标，需要技术同学跟广告主业务侧确定），广告主可以在自己的 APP 内采集的设备 id，与收到的点击上报的设备 id中逐一匹配，如果命中，就将对应的 callback 回传给Sigmob（不需要做任何更改），完成一次转化上报；
b.
当广告主自己的 APP 内发生非转化行为，但该行为有利于优化广告投放后续质量的，广告主侧，将自己的 APP 内采集的设备 id，与收到的点击上报的设备 id中逐一匹配，如果命中，将对应的事件+clickid 按照【非必须】后续事件接口回传给sigmob，用于优化后续质量。
业务流程示例如下：
监测链接说明
用来接收Sigmob媒体上发送的点击信息，Sigmob侧提供的信息是通过宏参数替换上报的。
目前支持的宏参数列表如下：
【必需】转化回调（callback）
回调方式
sigmob 目前的callback的回调域名有：https://track.sigmob.cn、https://tnaacc.sigmob.cn、https://trackstage.sigmob.cn（该域名仅在测试联调发生）、https://toactivity.happyelements.cn/track?
callback直接访问即可（除了decode操作外，不要对callback url做任何改动，调用的域名仅上述4个；也不要拼接任何参数）；
成功判断
Http 状态码 =200，即回调成功
_CALLBACK_ 替换结果示例：
代码块
https%3A%2F%2Ftrack.sigmob.cn%2Ftrack%3Fc%3DCiRmMmIzMzYxOS05ZjZmLTExZWMtYTg2Zi0wMDE2M2UzMjk0N2YSJGYyYjMzNjE5LTlmNmYtMTFlYy1hODZmLTAwMTYzZTMyOTQ3ZioLZTdjYzI5NDk1ZTk6cQoCNjQSBTU0MTk3GgYxMzA4MzAgAyiIJzCIJ0oeaHR0cDovL2Euc2lnbW9iLmNvbS8jL2luZGV4MTExUgUzNjI2NloEMTA1OWkotnCu-IzCP3FkI3QPsdGCP3gBgAHaFYgBqpsCmAH3pAWgAWSoAYgnSAJQAVqJAhIQMzQxZmU0MjY2MWI2ODM3ZCIPODY3Nzg3MDMzMjk2ODI3KhAzNDFmZTQyNjYxYjY4MzdkMgd1bmtub3duQiQzMmY5Y2YyOC1lZWVhLTQ2MDItOGJiOC0wN2RmMGI1YjUxNjhKEDA4NTI4NTI0MzZjM2FmZTJSBlhpYW9taVoPODY3Nzg3MDMzMjk2ODI3Yg84Njc3ODcwMzMyOTY4MzWSASA2YjkxYTJlYTIyODVmNjEzMmIxMTYzMjg4YjljZmJkNpoBIDE3N2NhMDUxMzVjYjI3MzA4M2VhMTZhOGI1MGM3OTM1ogEgYjgwOGQ2NmM1NDg4ODhjOTRlYzk4NjRmMTRiZDRlZDdiBDEyODJqDjEyMC4xMzMuNDIuMTM1kAEHmAECoAEBwAEE0AEB%26e%3Dactive%26p%3DOML9xjIE2GpXa5Auktzzng
📌
在阅读以下内容前，请务必完成【必须】转化回调 部分的处理逻辑
后续事件，其中【次留】事件需对接
当广告主自己的 APP 内发生非转化行为，但该行为有利于优化广告投放后续质量的，可以使用后续接口回传给sigmob.