> 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 %}

## 设置行动生命周期回传

<details>

<summary>设置全局级别行动生命周期回传</summary>

本节将介绍一次性为你的整个账户创建回传。只有一个系统可以接收并处理这些回传的合作伙伴，或者希望在所有非标准事件发生时都收到通知的合作伙伴，应设置全局级别行动生命周期回传。

{% hint style="success" %}
**注意：** 如果你希望更有选择性地决定接收哪些事件类型的回传，请参阅下方部分以设置 *事件级别行动生命周期回传*.
{% endhint %}

1. 从顶部导航栏中，选择 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[用户资料] → 设置**.
2. 在 *技术*下，选择 [**事件通知**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml).
3. 在 *行动生命周期事件*下，选择 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[编辑]**.
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 提供的数据点，并应填写在方括号中 `{ }`.

     <div data-with-frame="true"><figure><img src="https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FFNWShmuaxZ5VpP14AlWv%2FScreenshot%202026-05-23%20at%2010.58.15.png?alt=media&amp;token=00e80c87-6c12-4f6d-8ca5-3885c9002533" alt="" width="563"><figcaption></figcaption></figure></div>
   * 找不到你需要的值？请联系你的客户经理（或 [联系支持](https://app.impact.com/support/portal.ihtml)).
6. 选择 **行动生命周期事件**。这些设置是可选的。
   * 输入一个 **HTTP 标头**。如果需要多个键值对，请用分号分隔。
   * 输入一个 **最小延迟** ，指非标准事件发生与回传生成并发送到你的系统之间的时间。
   * 为 **最大请求数** 输入速率限制，表示 impact.com 每秒可向你的系统发出的请求数。
   * 输入你希望 **成功响应** 对于回传而言应是什么。
   * 输入你希望 **错误响应** 对于回传而言应是什么。
7. 选择 **保存**.

现在你已经设置了全局级别回传，你的系统应在任何非标准事件发生时开始接收回传，而不受执行非标准操作的品牌影响。要了解如何测试你的新回传设置，请查看下面的 *测试行动生命周期回传* 部分。

### 动态值示例

如果你已为跟踪链接配置了动态变量，你可以为自己的服务器配置一个回传 URL，以便在操作发生时通知你，并检索与该操作相关的动态填充值。

此示例展示了如何将一个 `SharedId` 值（你希望与品牌共享的值）传递到回传中的一个参数（`MyParam`）。某些品牌可能要求你进行此配置。

<div data-with-frame="true"><figure><img src="https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

回传 URL 大致如下：

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

回传 URL 将填充该 `MyParam` 参数，并使用从 `SharedId`.

</details>

<details>

<summary>设置事件级别行动生命周期回传</summary>

本节将介绍为跟踪你推动操作时的特定事件类型创建回传。如果你希望更有选择性地接收回传，应设置事件级别行动生命周期回传。

{% hint style="success" %}
**注意：** 如果你已设置全局级别行动生命周期回传，则无需再设置事件级别回传。
{% endhint %}

1. 从顶部导航栏中，选择 **探索 →** [**品牌**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. 选择拥有你要测试的回传的品牌卡片。
3. 在品牌名称下方，选择 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[更多]** → **跟踪集成**.
4. 在页面右上角附近，选择 **添加回传**.
5. 选择事件类型（原名 *action tracker*），以便为其设置行动生命周期回传。
6. 输入你服务器的 URL。impact.com 将向此 URL 发送回传。
7. 选择你偏好的 HTTP 方法。
   * 如果你选择 **POST**，然后你将输入请求正文并选择一个 **正文格式**。以下是一个 JSON 格式下如何映射每个数据点的示例。每个键值对中的键应来自你自己系统的设置，而值应为你选择的、与之对应且由 impact.com 提供的数据点，并应填写在大括号 { } 中。

     <div data-with-frame="true"><figure><img src="https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FwVvNFu7iuPM0eAwyMk6L%2FScreenshot%202026-05-23%20at%2013.07.16.png?alt=media&amp;token=f33b091a-cead-4e1b-80f2-0ebd97810835" alt="" width="563"><figcaption></figcaption></figure></div>
   * 查看 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`）。某些品牌可能要求你进行此配置。

<div data-with-frame="true"><figure><img src="https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

回传 URL 大致如下：

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

回传 URL 将填充该 `MyParam` 参数，并使用从 `SharedId`.

</details>

## 测试行动生命周期回传

一旦你设置了行动生命周期回传，无论它适用于哪个级别，都应进行测试。你可以在 impact.com 中运行测试回传（仅适用于事件级别回传），也可以执行一次转化。

如果回传在 impact.com 向你的目标 URL 发送时失败，impact.com 会自动重试发送。impact.com 最多总共会重试失败的回传 15 次。对于来自 `400` 到 `500`的 HTTP 响应，impact.com 会跳过前 3 次重试。有关完整重试时间表和故障排除详情，请参阅 [测试并排查回传 URL 问题](/partner/zh/ni-xiang-liao-jie-shen-me/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).

<details>

<summary>在 impact.com 中运行测试回传</summary>

如果你设置了事件级别回传，则可以在你的 impact.com 帐户中对其进行测试。

1. 从顶部导航栏中，选择 **探索 →** [**品牌**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. 选择拥有你要测试的回传的品牌卡片。
3. 在品牌名称下方，选择 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **更多** → **跟踪集成**.
4. 从 *回传* 部分中，选择 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[下箭头] 操作**，然后选择 **启动测试**.
5. 确认回传的 URL 正确，然后选择 **开始测试**.

</details>

<details>

<summary>创建测试转化</summary>

此测试不会在 impact.com 网页应用中执行。相反，你将进行一次遵循典型用户旅程的端到端测试。请确保通知你合作的品牌，你将执行此测试。

1. 从顶部导航栏中，选择 **管理 →** [**品牌素材**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all).
2. 选择一个广告。
3. 在广告名称下方，选择 **获取跟踪链接**.
4. 选择 ![](https://1152657667-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FEv341AdIiPndQSb7uGMI%2FToggle%20on.svg?alt=media\&token=4ae8972d-c510-4ee2-adc5-e7170981650b) **\[切换打开]** **跟踪参数**.
5. 输入 **子 ID** 或 **共享 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) 屏幕上看到已撤销的操作，但尚未收到回传，请再次检查你的回传设置。

</details>

### 排查错误

使用下面的参考表来识别并解决配置行动生命周期回传时遇到的常见问题。

<table><thead><tr><th width="199.859375">错误</th><th>描述</th></tr></thead><tbody><tr><td>缺少必填参数</td><td>你的服务器可能期望的是一个值，而不是一个变量。修改你的回传 URL 以传递一个测试值（例如，“12345678” 而不是 <code>{SubId1}</code>）并查看它是否接受硬编码值。</td></tr><tr><td>区分大小写的变量</td><td>动态变量区分大小写，并且必须完全一致，这意味着 <code>{SubId1}</code> 与 <code>{subid1}</code>不是同一个值。请再次确认你的变量是否具有正确的大小写。</td></tr><tr><td>访问被拒绝</td><td>大多数回传服务器都需要一个安全令牌或值，该值必须与动态变量一起传递。请与你网站的技术团队合作（或参考你网站提供商的文档），了解访问服务器所需的令牌或安全值。</td></tr></tbody></table>

{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.