# 设置 Callback 回调

_关于点击、完成视频观看或转化安装的事件通知。_

## 添加新的 callback (回调）

-   在 Chartboost 后台转到  [**Callbacks**](https://platform.chartboost.com/advertising/callbacks)  页面：
-   点击  **Add New Callback （添加回调）**.
-   为您的回调命名并添加描述。
-   为您的回调选择一个模板。

**使用第三方 MMP 平台**: Chartboost 为大多数第三方MMP 平台提供预配置的回调模板。点击一个模板，自动填充所有必需的参数。 您可能需要添加您 App 的  [**bundle ID**](/zh/faq/sdk-integration/)  或者其他信息。 所有第三方 MMP 的回调默认为广告主角色。

**使用自定义模板：**如果您没有使用预定义的第三方 MMP 接口，您可以选择自定义模板，并使用以下设置设置回调：  

-   **角色**：选择您的角色（广告主或流量变现端）。只有当您的应用程序中同时有流量变现和投放广告且希望对两者使用相同的回调时，才选择“BOTH”。
-   **Tracking URL:** 我们将发送回调的您的服务器或第三方 MMP 跟踪服务的接口（例如，<https://myserver.com/tracker>）。我们的系统会根据规定将静态和动态参数附加到此 URL。
-   **Static Parameters**: 在回调 URL 的查询字符串中包含静态键值对。要包含像 network=chartboost 这样的静态参数，您需要在 Key 字段中添加 network，并在 Value 中添加 chartboost。
-   **Dynamic Parameters:**  决定关于事件需要发送哪些额外信息。在 Key 字段中输入您的端点支持的参数名称，然后从下拉菜单中选择一个宏值。您可以参考[这些参数](/zh/advertising/callbacks/callback-parameters/)以获得帮助。
-   **Callback URL and Ping Test:**  点击“Test Now”以验证您的接口状况是否正常。您的回调 URL 应该出现在该字段中。以下是我们在测试 Ping 中发送的信息示例：

Chartboost 的 POST 回调不包含请求正文中的数据。相反，它将数据作为附加到 URL 的查询字符串包含在内，类似于 GET 回调。

-   将回调从 OFF 切换到 ON，然后点击保存。



## 将回调关联到您的应用或广告活动  

-   **将回调关联到您的应用**：从列表中打开任意回调，向下滚动到“选择应用”。勾选将关联点击、安装或完成视图回调的应用。或者，从后台 Dashboard 左上角选择任意应用，转到其“基本设置”>“高级设置”，并从下拉菜单中附加回调（见下面的屏幕截图）。

-   请注意，使用我们预定义的第三方供应商模板创建的回调或使用第三方 MMP 跟踪 URL 只能关联到点击或查看事件。
-   安装回调仅支持自定义模板和自定义跟踪 URL。
-   **将回调关联到您的广告活动：**从列表中打开任意回调，向下滚动到“选择广告活动”。勾选将关联点击、安装或视频完播回调的广告活动。或者，打开任意[推广](https://platform.chartboost.com/all/campaigns/advertising)或[变现](https://platform.chartboost.com/all/campaigns/publishing)活动，转到活动的高级设置，并从那里的下拉菜单中附加回调（见下面的屏幕截图）。
-   请注意，使用我们预定义的第三方 MMP 模板创建的回调或使用第三方 MMP 跟踪 URL 只能关联到点击或查看事件。
-   安装回调仅支持自定义模板和自定义跟踪 URL。
-   具有广告主角色的回调在“选择活动”窗口中不会显示网络变现广告活动，同时也无法在网络变现广告活动页面中选择。
-   具有变现端角色的回调在“选择活动”窗口中不会显示网络推广广告活动，同时也无法在网络推广广告活动页面中选择。

如果与此广告活动关联的应用已将此回调关联到相同的事件，则无需将此回调关联到广告活动。

-   将回调关联到您的整个帐户：为简化 Chartboost 仪表板上的回调功能，我们自 2020 年 10 月 7 日起取消了将回调关联到帐户级别的功能。

如果您对此变更有任何疑问，请联系  [**我们的技术支持团队**](/zh/support/contact-us/).



## 申请服务端（S2S）跟踪

-   如果您希望使用服务器端（S2S）跟踪，则需要手动向您的账户经理请求激活。**如果您不需要S2S跟踪，则可以跳过此步骤。**
-   为了使Chartboost启用S2S跟踪，您必须在广告余额中存入至少 $5,000。[**充值到您的账户余额**](/zh/advertising/finances/)
-   了解更多关于[服务器到服务器（S2S）跟踪](/zh/advertising/s2stracking/setting-up-s2s-tracking/)的信息：



## 如果您希望使用服务器端（S2S）跟踪，则需要手动向您的账户经理请求激活。如果您不需要S2S跟踪，则可以跳过此步骤。

-   要复制一个回调，请打开它，然后在页面顶部点击“复制”。

-   要从列表中删除回调，请点击“X”。
-   要编辑回调，请点击铅笔图标。
-   要暂停回调，请点击暂停图标。



## 以下是您需要了解的一些回调规范

-   您需要一个准备好支持实时事件的服务器。
-   我们会尝试三次将回调发送到您的服务器。如果所有尝试都失败，则您的接口将**被列入黑名单15分钟**。在黑名单期间，回调将不会被发送或尝试，直到经过完整的时间为止。
-   如果您的服务器响应 2xx，则我们的服务将视为请求成功。
-   回调可以是重定向 URL，但不能将任何商店（App Store、Google Play Store、Amazon Appstore for Android 等）作为最终的地。它们还必须是有效的 URL。为了最大可靠性，请不要使用重定向。
-   端点必须通过 HTTPS 支持 SSL。
-   在发送之前，所有数据都将进行 URL 编码。




## 您可能也会喜欢...

-   [**Callbacks 回调的相关问答**](/zh/faq/callbacks/)
-   [**Callbacks 回调参数**](/zh/advertising/callbacks/callback-parameters/)


