> 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/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md). # 为品牌启用事件通知回传 事件通知回传（webhooks）会在特定事件发生时实时通知你的内部系统。虽然发送的数据因事件而异，但配置流程对所有事件都相同。 {% stepper %} {% step %} ### 访问事件通知回传 1. 在顶部导航栏中，选择 ![](/files/34cff7cafbbfcd416778a35b63cb058c27bcda8b) **\[用户资料] → 设置**. 2. 在 *技术* 部分下，选择 [**事件通知**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?). {% endstep %} {% step %} ### 完成全局配置字段 1. 将鼠标悬停在要配置通知回传的事件上，并选择 ![](/files/ae87ea28f541bc1749d482fcfdb423e5cb4965f8) **\[编辑]**. 2. 使用下表配置投递设置： | 字段 | 说明 | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL | 服务器上将接收数据的端点。 | | HTTP 方法 |

GET：数据作为查询字符串附加到 URL。

POST：数据在请求体中发送，其中包含你可以设置的各种可选参数。

请参阅 通知事件和负载 以了解每个事件和负载内容的更多信息。

| | HTTP 头 | (可选) 添加自定义请求头用于身份验证（例如， `Authorization: Bearer token`). | | 最小延迟 | 设置 *最小延迟* 为秒，以保护你的服务器免受流量峰值影响。 | | 最大请求数 | 设置 *最大请求数* 每秒，以保护你的服务器免受流量峰值影响。 | | 成功响应 | 当回传处理正确时，服务器返回的特定文本字符串或 HTTP 状态码。 | | 错误响应 | 表示失败的文本字符串或状态码（例如， `ERROR` 或 `500`). | | {% endstep %} | | | {% endstepper %} | | ### 通知事件和负载 每个事件通知都会发送一组唯一的可配置数据点（例如， `{ActionId}`）。请参阅下面的事件，了解你可以从负载中提取哪些数据点。
行动生命周期事件 当某个行动被跟踪、修改或撤销时，行动生命周期事件会向指定 URL（以及包含的任何参数）发出 HTTP 请求。 ```json // JSON 格式的 POST 示例 { "CampaignId": 9876, // 项目 ID "ActionTrackerId": 12345, // 事件类型 ID "MediaPartnerId": 555, // 合作伙伴 ID "CampaignName": "Spring Global Promotion", // 项目名称 "ActionTrackerName": "Standard Sale Tracker", // 事件类型名称 "MediaPartnerName": "Top Tier Affiliates", // 合作伙伴名称 "ActionId": "ACT-778899", // 行动 ID "Status": "MODIFIED", // 行动状态 "StatusDetail": "Item return - payout adjusted", // 关于行动状态的更多详情 "AdId": 44332, // 广告 ID "Payout": 10.50, // 以合作伙伴货币计算的支付给合作伙伴的行动佣金 "DeltaPayout": -5.00, // 支付金额的变更 "IntendedPayout": 15.50, // 超限行动的预期支付金额 "Amount": 100.00, // 以账户货币计算的行动金额 "DeltaAmount": -50.00, // 上一次行动的修正金额 "IntendedAmount": 150.00, // 超限行动的预期销售金额 "Currency": "USD", // 行动所用货币 "OriginalCurrency": "USD", // 行动的原始（即购物车）货币 "OriginalAmount": 100.00, // 行动的原始（即购物车）金额 // "items" 集合：此行动中各个商品的数据 "items": [{join(items, i, "\{\"sku\":\"{i.sku}\", \"item_price\":{i.amt}, \"category\":\"{i.cat}\", \"quantity\":{i.qty}, \"cartamt\":{i.cartamt}, \"rbt\":\"{i.rbt}\", \"name\":\"{i.name}\"\}")}], "EventDate": "2026-04-08T09:00:00Z", // 转化日期 "CreationDate": "2026-04-08T09:05:00Z", // 在系统中创建的日期 "LockingDate": "2026-05-08T00:00:00Z", // 行动将被锁定的日期 "ClearedDate": "2026-05-15T00:00:00Z", // 计划清算日期 "ReferringDomain": "blog.partner.com", // 引荐域名 "LandingPageUrl": "https://brand.com/sale", // 落地页 URL "RefCustomerArea": "California", // 客户地区（IP 推断） "RefCustomerCity": "San Francisco", // 客户城市（IP 推断） "RefCustomerRegion": "CA", // 客户区域（IP 推断） "RefCustomerCountry": "US", // 客户国家代码（IP 推断） "RefClickId": "CLK9988776655", // 唯一点击标识符 "SharedId": "social_post_01", // 合作伙伴共享 ID "PromoCode": "SAVE20", // 通用促销代码 "CustomerStatus": "EXISTING", // 客户状态 "Oid": "ORD-554433", // 订单 ID "Note": "Partial return processed", // 随行动提供的备注 "CustomerPostCode": "94105", // 客户邮政编码 "CustomerCity": "San Francisco", // 客户城市 "CustomerCountry": "US", // 客户国家代码 "CustomerRegion": "CA", // 客户区域 "CustomerId": "CUST-12345", // 客户 ID "CustomerEmail": "a665a45920422f9d417...", // 哈希处理后的客户邮箱 "IpAddress": "192.168.1.1", // IP 地址 "CallerId": null, // 来电者电话号码 // 自定义补充字段 "Text1": "Custom Val 1", // 文本 1 "Date1": "2026-04-08", // 日期 1 "Money1": 10.00, // 金额 1 "Numeric1": 1, // 数值 1 // 设备与应用元数据 "appPackage": "com.brand.app", // 移动应用包名 "appName": "BrandStore", // 移动应用名称 "appVersion": "4.2.1", // 移动应用版本 "deviceOs": "iOS", // 设备操作系统 "deviceOsVersion": "17.4", // 设备操作系统版本 "deviceManuf": "Apple", // 设备制造商 "deviceModel": "iPhone 15", // 设备型号 "macAddress": "00:1B:44:11:3A:B7", // MAC 地址（大写） "macAddressLower": "00:1b:44:11:3a:b7", // MAC 地址（小写） "macAddressAlpha": "001B44113AB7", // MAC 地址（无冒号） "macAddressSha1": "47a32...", // MAC SHA1 "iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // iOS 广告 ID "iosAdTracking": "1", // iOS 广告跟踪设置 "androidId": null, // Android ID "deviceId": "D-556677", // 设备 ID "deviceIp": "192.168.1.1" // 设备 IP } ```
行动咨询事件 当创建或解决行动咨询时，行动咨询事件会向指定 URL（以及任何包含的参数）发出 HTTP 请求。 ```json // JSON 格式的 POST 示例 { "Id": 554433, // 系统中该行动咨询的唯一标识符 "MediaPartnerId": 555, // 合作伙伴 ID "MediaPartnerName": "Top Tier Affiliates", // 合作伙伴名称 "CampaignId": 9876, // 项目 ID "CampaignName": "Spring Global Promotion", // 项目名称 "OrderId": "ORD-12345", // 所报告行动的订单 ID "TransactionDate": "2026-04-01T14:30:00Z", // 触发行动咨询的事件交易日期 "TransactionAmount": 250.00, // 触发行动咨询的事件交易金额 "InquiryType": "MISSING_ACTION", // 行动咨询类型 "ExpectedPayout": 25.00, // 合作伙伴预期的支付金额 "ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // 咨询必须被接受或拒绝的日期 "TrackingLink": "https://proweb.com/click?cid=1&pid=555", // 合作伙伴提供的追踪链接 "ActionId": "ACT-999000", // 行动 ID（如与现有行动相关） "AutoApprovalDate": "2026-05-05T00:00:00Z", // 系统运行自动批准规则的日期 "ResolutionStatus": "PENDING", // 该行动咨询的最终解决状态 "RejectReason": null, // 行动咨询被拒绝的原因 "FinalPayout": 0.00, // 与该行动咨询相关的最终支付金额 "ResolutionDate": null, // 咨询被决定的日期 "CreationDate": "2026-04-08T10:05:00Z", // 咨询在系统中创建的日期 "InquiryNotes": "客户声称他们点击了链接，但没有显示积分。", // 合作伙伴提交的咨询备注 "ResolutionNotes": null, // 咨询被决定时提交的备注 "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // 添加到咨询中的评论（JSON 格式） } ```
行动清算事件 当行动被清算时，行动清算事件会向指定 URL（以及任何包含的参数）发出 HTTP 请求。 ```json // JSON 格式的 POST 示例 { "ActionTrackerId": 12345, // 事件类型 ID "ActionTrackerName": "Standard Sale Tracker", // 事件类型名称 "CampaignId": 9876, // 项目 ID "CampaignName": "Spring Global Promotion", // 项目名称 "MediaPartnerId": 555, // 合作伙伴 ID "MediaPartnerName": "Top Tier Affiliates", // 合作伙伴名称 "OrderIds": "ORD-9921,ORD-9922", // 所报告行动的订单 ID（逗号分隔） "ActionIds": "ACT-101,ACT-102", // 行动 ID（逗号分隔） "ClearedDate": "2026-04-15T12:00:00Z", // 计划清算行动的日期（ISO 8601） "LedgerDate": "2026-04-08T09:54:43Z" // 行动被清算的日期（ISO 8601） } ```
跟踪值请求事件 当创建跟踪请求时，跟踪值请求事件会向指定 URL（以及任何包含的参数）发出 HTTP 请求。 ```json // JSON 格式的 POST 示例 { "CampaignId": 9876, // 项目 ID "ActionTrackerId": 12345, // 事件类型 ID "MediaPartnerId": 555, // 合作伙伴 ID "ActionId": "ACT-778899", // 行动 ID "Amount": 150.00, // 账户货币中的行动金额 "Currency": "USD", // 行动所用货币 "Oid": "ORD-554433", // 订单 ID // "items" 集合：行动中各个产品的明细 "items": [{join(items, i, "\{\"sku\":\"{i.sku}\",\"item_price\":{i.amt},\"category\":\"{i.cat}\",\"quantity\":{i.qty},\"cartamt\":{i.cartamt},\"rbt\":\"{i.rbt}\",\"name\":\"{i.name}\"\}")}], "EventDate": "2026-04-08T09:00:00Z", // 转化日期 "IpAddress": "192.168.1.1", // 设备的 IP 地址 "RefClickId": "CLK9988776655" // 唯一点击标识符 } ```
已完成作业事件 当某个作业完成时，已完成作业事件会向指定 URL（以及任何附加参数）发出 HTTP 请求，用于一个 [报告导出](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) 或 [点击导出](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport). ```json // JSON 格式的 POST 示例 { "JobId": 10293847, // 作业唯一 ID "JobType": "REPORT_EXPORT", // 作业类型 "AccountId": 7744, // 账户 ID "StartDate": "2026-04-08T10:00:05Z", // 作业开始时间 "EndDate": "2026-04-08T10:11:02Z", // 作业完成时间 "RecordsProcessed": 5240, // 已处理或生成的记录数 "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // 用于获取更多作业详情的 API URI "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // 用于获取作业输出结果的 API URI "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // 下载输出的 URL（5 分钟有效） "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // 下载输出的 URL（15 分钟有效） "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // 下载输出的 URL（30 分钟有效） "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // 下载输出的 URL（60 分钟有效） } ```
发布商申请事件 {% hint style="success" %} **注意：** 此功能处于测试版。请联系您的 CSM 或我们的 [支持团队](https://app.impact.com/support/portal.ihtml?createTicket=true&) 如果您想测试此功能。 {% endhint %} 当合作伙伴提交申请以及申请每次被批准、拒绝或撤回时，发布商申请事件会向指定 URL 发出 HTTP 请求。 如果一个 `PENDING` 负载在数据点为空的情况下传递，系统会在信息可用时触发更新。后续成功的传递会填充之前为空的字段，确保你的记录与最新处理的信息保持同步。 {% hint style="warning" %} **重要：** 如果你有 [申请工作流](/brand/zh/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) 已配置，它们会在 webhook 触发前运行。webhook 会携带结果性的 *状态*: `APPROVED` 或 `REJECTED` 如果工作流处理了申请， `PENDING` 如果没有应用任何工作流，或者 `RETRACTED` 如果合作伙伴撤回了申请。 {% endhint %} 负载内容因 *状态*而异。下面的示例展示了一个 `PENDING` 事件，并通过注释说明其他状态会出现哪些字段。 ```json // JSON 格式的 POST 示例 { "Status": "PENDING", // 申请状态：PENDING, APPROVED, REJECTED, RETRACTED "ProgramId": "9876", // 项目 ID "TemplateTermsId": "4455", // 模板条款 ID "ContractId": "112233", // 合同 ID "ApplicationDate": "2026-04-09T08:30:00Z", // 申请日期 "PublisherSignerName": "Sarah Chen", // 由其处理的发布商用户 "PublisherId": "555", // 合作伙伴 ID "Name": "Elite Content Creators", // 合作伙伴名称 "BusinessModel": "SOCIAL_INFLUENCER", // 合作伙伴的主要业务模式 "Address": "123 Marketing Way", // 街道地址 "City": "Los Angeles", // 城市 "State": "CA", // 州 "Country": "US", // 国家 // 仅限 APPROVED、REJECTED、RETRACTED "DecisionDate": null, // 决定日期 // 仅限 APPROVED "ContractStartDate": null, // 合同开始日期 // 仅限 REJECTED "DeclineReason": null, // 拒绝原因 // 仅限 APPROVED、REJECTED "AdvertiserSignerName": null, // 由其处理的广告主用户 // 仅限 PENDING：合作伙伴资料字段 "Description": "一个面向生活方式和旅行影响者的高端网络。", // 合作伙伴资料描述 "Language": "en-US", // 语言 "PublisherSize": "M", // XS、S、M、L、XL "PastRelationship": "false", // 指示之前是否有合约的布尔值 "MarketplaceApproved": "true", // 指示是否在市场中获批的布尔值 "ReceivedPayout": "true", // 指示他们是否已收到支付的布尔值 // 仅限 PENDING：与合作伙伴关联的媒体属性 "properties": [{join(properties, i, "{\"platform\":\"{i.platform}\",\"verified\":\"{i.verified}\",\"url\":\"{i.url}\",\"category\":\"{i.category}\",\"reach\":\"{i.reach}\",\"engagementRate\":\"{i.engagementRate}\",\"audienceCountryPct\":\"{i.audienceCountryPct}\",\"audienceGenderPct\":\"{i.audienceGenderPct}\",\"audienceAgeRangePct\":\"{i.audienceAgeRangePct}\"}")}], // 仅限 PENDING：创作者人口统计字段 "CreatorIncome": "", // 家庭收入 "CreatorGender": "", // 性别 "CreatorEthnicity": "", // 民族 "CreatorEducation": "", // 教育程度 "CreatorRelationshipStatus": "", // 感情状态 "CreatorParentalStatus": "", // 父母身份 "CreatorPronouns": "", // 代词 "CreatorDOB": "", // 出生日期 // 仅限 PENDING：组 ID "GroupIds": "1001,1002,1003" // 以逗号分隔的组 ID } ```
### 回传重试机制 如果在尝试向目标 URL 发布时回传失败，投递会根据预设计划自动重试最多 15 次。重试有助于应对临时网络问题或服务器不可用。 #### 不会发生重试的情况 在以下情况下，回传不会重试： * 目标 URL 格式错误或无效。 * 目标 URL 或其主机无法解析，例如因 DNS 查询失败。 #### 重试计划 重试尝试遵循以下计划。如果 HTTP 响应代码处于 `400` 以 `500`.
重试计划参考
重试次数重试前延迟
第 1 次重试+15 秒
第 2 次重试+15 秒
第 3 次重试+15 秒
第 4 次重试+3 分钟
第 5 次重试+3 分钟
第 6 次重试+15 分钟
第 7 次重试+15 分钟
第 8 次重试+15 分钟
第 9 次重试+2 小时
第 10 次重试+2 小时
第 11 次重试+2 小时
第 12 次重试+6 小时
第 13 次重试+6 小时
第 14 次重试+6 小时
第 15 次重试+6 小时
--- # 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/brand/zh/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.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.