> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/partner/zh/ni-xiang-liao-jie-shen-me/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).
# 设置操作生命周期回传
动作生命周期回传主要有两种类型。 **全局级** 为您的整个账户创建回传，并且 **事件级** 为特定事件类型创建回传。请选择最符合您需求的选项，了解更多设置流程。
{% hint style="warning" %}
**警告：** 对于全局级回传，每当发生“非标准”事件时，您都应收到一次回传，例如修改或撤销。请注意，事件级回传不会触发非标准动作生命周期事件。
{% endhint %}
#### 设置动作生命周期回传
设置全局级动作生命周期回传
本节将介绍一次性为您的整个账户创建回传。只有一个系统可以接收并处理这些回传的合作伙伴，或希望接收所有非标准事件通知的合作伙伴，应设置全局级动作生命周期回传。
{% hint style="info" %}
**注意：** 如果您希望对接收回传的事件类型更加有选择性，请参阅下方部分以设置 *事件级动作生命周期回传*.
{% endhint %}
1. 在顶部导航栏中，选择  **\[用户资料] → 设置**.
2. 在 *技术*，选择 **事件通知**.
3. 旁边 *动作生命周期事件*，选择  **\[编辑]**.
4. 输入您的服务器 URL。这是 impact.com 将发送回传的 URL。
5. 选择您首选的 HTTP 方法。
* 查看 impact.com 的一些 [可用的正文参数](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* 如果您选择 **POST**，随后您将输入请求正文并选择一个 **正文格式**。下面是一个示例，说明在 JSON 格式下如何映射每个数据点。每个键值对中的键应来自您自己的系统设置，而值将是您选择的、与 impact.com 提供的数据点相对应的内容，并应填写在方括号中 `{ }`.
* 没有看到您需要的值？请联系您的客户经理（或 [联系支持](https://app.impact.com/support/portal.ihtml)).
6. 选择 **动作生命周期事件**。这些设置是可选的。
* 输入一个 **HTTP 标头**。如果需要多个键值对，请用分号分隔。
* 输入一个 **最小延迟** 在非标准事件发生与回传生成并发送到您的系统之间。
* 为以下内容输入速率限制： **最大请求数** impact.com 每秒可向您的系统发出的请求数。
* 输入您希望 **成功响应** 的回传响应内容。
* 输入您希望 **错误响应** 的回传响应内容。
7. 选择 **保存**.
既然您已经设置了全局级回传，您的系统应在发生非标准事件时开始接收回传，而不受执行非标准操作的品牌影响。要了解如何测试您的新回传设置，请查看 *测试动作生命周期回传* 部分。
**动态值示例**
如果您已为跟踪链接配置了动态变量，您可以为自己的服务器配置一个回传 URL，以便在发生动作时通知您，并检索与该动作相关的动态填充值。
本示例展示如何传递一个 `SharedId` 值（您希望与品牌共享的值）到回传中的一个参数（`MyParam`）。某些品牌可能要求您进行此配置。
回传 URL 看起来大致如下：
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
回传 URL 将填充 `MyParam` 参数，其值取自 `SharedId`.
设置事件级动作生命周期回传
本节将介绍为特定事件类型创建回传，以跟踪您推动动作发生的情况。如果您希望对接收回传的事件类型更加有选择性，应设置事件级动作生命周期回传。
{% hint style="info" %}
**注意：** 如果您已设置全局级动作生命周期回传，则无需设置事件级回传。
{% endhint %}
1. 在顶部导航栏中，选择 **发现 → 我的品牌**.
2. 选择拥有您要测试的回传的品牌卡片。
3. 在品牌名称下方，选择  **\[更多]** → **跟踪集成**.
4. 在页面右上角附近，选择 **添加回传**.
5. 选择事件类型（原 *动作跟踪器*）为其设置动作生命周期回传。
6. 输入您的服务器 URL。这是 impact.com 将发送回传的 URL。
7. 选择您首选的 HTTP 方法。
* 如果您选择 **POST**，随后您将输入请求正文并选择一个 **正文格式**。下面是一个示例，说明在 JSON 格式下如何映射每个数据点。每个键值对中的键应来自您自己的系统设置，而值将是您选择的、与 impact.com 提供的数据点相对应的内容，并应填写在花括号 { } 中。
* 查看 impact.com 的一些 [可用的正文参数](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
* 没有看到您需要的值？请联系您的客户经理（或 [联系支持](https://app.impact.com/support/portal.ihtml)).
8. 选择 **显示高级设置**。这些设置是可选的。
* 输入一个 **最小延迟** 在非标准事件发生与回传生成并发送到您的系统之间。
* 为以下内容输入速率限制： **最大请求数** impact.com 每秒可向您的系统发出的请求数。
* 输入您希望 **成功响应** 的回传响应内容。
* 输入您希望 **错误响应** 的回传响应内容。
9. 选择 **保存**.
既然您已经设置了事件级回传，您的系统应开始接收您在以下位置选择的事件类型的回传： *第 5 步*。要了解如何测试您的新回传设置，请查看 *测试动作生命周期回传* 部分。
**动态值示例**
如果您已为跟踪链接配置了动态变量，您可以为自己的服务器配置一个回传 URL，以便在发生动作时通知您，并检索与该动作相关的动态填充值。
本示例展示如何传递一个 `SharedId` 值（您希望与品牌共享的值）到回传中的一个参数（`MyParam`）。某些品牌可能要求您进行此配置。
回传 URL 看起来大致如下：
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
回传 URL 将填充 `MyParam` 参数，其值取自 `SharedId`.
#### 测试动作生命周期回传
一旦您设置了动作生命周期回传，无论适用于哪个级别，都应对其进行测试。您可以在 impact.com 中运行测试回传（仅适用于事件级回传），或者执行一次转化。
如果 impact.com 向您的目标 URL 发送回传时失败，impact.com 会自动重试投递。impact.com 最多会对失败的回传重试 15 次。对于来自以下内容的 HTTP 响应，impact.com 会跳过前 3 次重试： `400` 用于 `500`。有关完整的重试计划和故障排除详情，请参阅 [测试并排查回传 URL](/partner/zh/ni-xiang-liao-jie-shen-me/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).
在 impact.com 中运行测试回传
如果您设置了事件级回传，则可以在您的 impact.com 账户中测试它。
1. 在顶部导航栏中，选择 **发现 → 我的品牌**.
2. 选择拥有您要测试的回传的品牌卡片。
3. 在品牌名称下方，选择  **更多** → **跟踪集成**.
4. 从 *回传* 部分中，选择  **\[下箭头] 操作**，然后选择 **启动测试**.
5. 确认回传的 URL 正确，然后选择 **开始测试**.
创建测试转化
此测试不会在 impact.com Web 应用中执行。相反，您将执行一次端到端测试，模拟典型用户旅程。请务必通知您合作的品牌您将进行此测试。
1. 在顶部导航栏中，选择 **内容 → 素材**.
2. 选择一个广告。
3. 在广告名称下方，选择 **获取跟踪链接**.
4. 选择  **\[切换开启]** **跟踪参数**.
5. Enter **子 ID** 或一个 **Shared ID** ，按要求填写。每个字段至少需要一项输入。
* 如果这些字段中已存在值，请跳过此步骤。
6. 可选地，选择一个 **属性** 从下拉列表中选择。
7. 选择 **保存**.
8. 选择 **复制跟踪链接**.
9. **粘贴** 将链接粘贴到一个新的浏览器窗口中。
10. 完成该操作。
11. 大约 15 分钟后，检查您的系统中是否有由此测试动作生成的回传。
* 动作处理通常需要 15 分钟。
* 您还可以在 [待处理操作](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) 页面上看到这个新的待处理操作。如果您在 *待处理操作* 页面上看到该操作但尚未收到回传，请再次检查您的回传设置。
12. 请您的品牌撤销该操作。
13. 检查您的系统中是否有由此次撤销生成的回传。
* 如果您在 [已撤销操作](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) 页面上看到已撤销的操作，但尚未收到回传，请再次检查您的回传设置。
排查错误
| 错误 | 说明 |
| -------- | ---------------------------------------------------------------------------------- |
| 缺少必需参数 | 您的服务器可能期望传入一个值而不是变量。修改您的回传 URL 以传递一个测试值（例如，“12345678” 而不是 `{SubId1}`），看看它是否接受硬编码值。 |
| 区分大小写的变量 | 动态变量区分大小写，且必须完全一致，这意味着 `{SubId1}` 不同于 `{subid1}`。请再次检查您的变量是否体现了正确的大小写。 |
| 拒绝访问 | 大多数回传服务器都有一个安全令牌或值，必须与动态变量一起传递。请与您网站的技术团队合作（或参考您网站提供商的文档），了解访问服务器所需的令牌或安全值。 |
{% hint style="success" icon="circle-info" %}
**注意：** 如果您无法在回传设置中发现任何问题，但仍然没有收到回传， [联系支持](https://app.impact.com/support/portal.ihtml)。impact.com 可以检查是否正在生成回传、每个回传的响应代码是什么，以及每个回传的正文内容。这些信息可能有助于您调试设置。
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/partner/zh/ni-xiang-liao-jie-shen-me/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.