# 为品牌启用事件通知回传
事件通知回传是标准的 HTTP 通知，用于在发生操作、点击或其他事件时通知您。事件回传可以配置为将事件数据传入您的内部报告系统，从而提供事件的最新视图。
#### 查看事件通知回传
1. 从顶部导航栏，选择  **\[用户资料] → 设置**.
2. 在 *技术* 左侧的部分，选择 [事件通知](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).
#### 启用事件回传
下面的说明将帮助您配置以下五种类型的事件回传：
* **操作生命周期事件** 当操作被跟踪、修改或撤销时，会向指定的 URL（以及任何包含的参数）发出 HTTP 请求。
* **跟踪值请求事件** 当创建跟踪请求时，会向指定的 URL（以及任何包含的参数）发出 HTTP 请求。
* **操作清除事件** 当操作被清除时，会向指定的 URL（以及任何包含的参数）发出 HTTP 请求。
* **操作查询事件** 当创建或解决操作查询时，会向指定的 URL（以及任何包含的参数）发出 HTTP 请求。
* **作业完成事件** 当某个作业已为一个 [报告导出](https://integrations.impact.com/impact-brand/reference/export-reports) 或 [点击导出](https://integrations.impact.com/impact-brand/reference/retrieve-export-click).
1. 从 [事件通知回传](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?) 屏幕，在要启用的 **标题上将鼠标悬停** 并选择  **要返回编辑界面，请选择** 在右侧。
2. 添加 **网址** impact.com 应该用于事件回传的 URL，以及任何 **可选参数** 在 URL 中。有关这些参数的完整列表和示例 URL（针对 `GET` 方法），请参阅下面的部分。
3. 选择 HTTP 方法： `GET` 是推荐选项，因为可选参数可以直接传入 URL。选择 `POST`如果您的系统要求 impact.com 将数据提交在请求主体中。
* 如果您使用 `POST` 方法，请从单选按钮中选择 **正文格式** 。
4. 选择 **保存** 以完成该过程。
{% hint style="info" %}
**注意**: 步骤 3 不适用于操作查询事件——查询字符串改为使用复选框选择。
{% endhint %}
{% hint style="info" %}
**事件回传示例**: 此示例包含以下参数：
* `{CampaignId}`
* `{MediaPartnerId}`
* `{ActionId}`
* `{Status}`
* `{LockingDate}`
* `{Payout}`
* `{Amount}`
```programlisting
[https://www.someadvertiser.com?myCampaignId=]{}{CAMPAIGNID}&theMpId={MEDIAPARTNERID}&theActionId={ACTIONID}&status={STATUS}&lockingDate={LOCKINGDATE}&mpPayout={PAYOUT}&saleAmt={AMOUNT}
```
注意花括号中定义的属性。实际请求将针对该 URL（假设有相应的参数值）：
```programlisting
https://www.myadvertiser.com?myCampaignId=1000&theMpId=900&theActionId=12323&status=PENDING&lockingDate=2015-01-01&mpPayout=50.00&saleAmt=100.00
```
{% endhint %}
事件回传的可选参数
| 查询字符串 | 说明 |
| ---------------------- | --------------------------------------------------------- |
| {CampaignId} | 活动 ID |
| {ActionTrackerId} | 事件类型 ID |
| {MediaPartnerId} | 合作伙伴 ID |
| {CampaignName} | 活动名称 |
| {ActionTrackerName} | 事件类型名称 |
| {MediaPartnerName} | 合作伙伴名称 |
| {ActionId} | 行为 ID |
| {Status} | 行为状态 |
| {StatusDetail} | 关于操作状态的更多详细信息，例如操作修改的原因 |
| {AdId} | 广告 ID |
| {Payout} | 支付给合作伙伴的操作佣金，使用合作伙伴货币。 |
| {DeltaPayout} | 佣金金额的变更 |
| {IntendedPayout} | 超限操作的预期佣金金额 |
| {Amount} | 操作金额，以广告商的货币计。仅适用于销售类操作。 |
| {DeltaAmount} | 相对于先前操作的更正金额。 |
| {IntendedAmount} | 超限操作的预期销售金额 |
| {Currency} | 操作的货币 |
| {OriginalCurrency} | 操作的原始（即购物车）货币 |
| {OriginalAmount} | 操作的原始（即购物车）金额 |
| {EventDate} | 发生转化的日期 |
| {CreationDate} | 该操作在系统中创建的日期 |
| {LockingDate} | 操作将在广告商时区被锁定的日期。 |
| {ClearedDate} | 操作将在广告商时区被清除的日期。 |
| {ReferringDomain} | 发生推荐的域名（如果是在线的） |
| {LandingPageUrl} | 着陆页的 URL（如果是在线的） |
| {RefCustomerArea} | 根据 IP 地址推断的客户区域 |
| {RefCustomerCity} | 根据 IP 地址推断的客户城市 |
| {RefCustomerRegion} | 根据 IP 地址推断的客户省/区 |
| {RefCustomerCountry} | 根据 IP 地址推断的客户国家代码 |
| {SharedId} | 合作伙伴可以包含在点击 URL 中并且可供您的广告商使用的值 |
| {PromoCode} | 优惠代码 |
| {CustomerStatus} | 客户状态 |
| {Oid} | 订单 ID |
| {Note} | 随报告的操作提供的备注 |
| {CustomerPostCode} | 客户邮编 |
| {CustomerCity} | 随报告的操作提供的客户城市 |
| {CustomerCountry} | 随报告的操作提供的客户国家代码 |
| {CustomerRegion} | 随报告的操作提供的客户省/区 |
| {CustomerId} | 客户 ID |
| {CustomerEmail} | 随报告的操作提供的已哈希客户电子邮件 |
| {IpAddress} | 设备的 IP 地址 |
| {CallerId} | 来电者的电话号码 |
| {Text1-10} | 随报告的操作提供
例如，{Text2}、{Text4}、{Text5}、{Text7}
|
| {Date1-10} | 随报告的操作提供
例如，{Date3}、{Date4}、{Date5}、{Date8}
|
| {Money1} | 随报告的操作提供 |
| {Money2} | 随报告的操作提供 |
| {Money3} | 随报告的操作提供 |
| {Numeric1-10} | 随报告的操作提供
例如，{Numeric1}、{Numeric4}、{Numeric6}
|
| {appPackage} | 移动应用包名 |
| {appName} | 移动应用名称 |
| {appVersion} | 移动应用版本 |
| {deviceOs} | 设备操作系统 |
| {deviceOsVersion} | 设备操作系统版本 |
| {deviceManuf} | 设备制造商 |
| {deviceModel} | 设备型号 |
| {macAddress} | 大写的 MAC 地址 |
| {macAddressLower} | 小写的 MAC 地址 |
| {macAddressAlpha} | 无冒号的 MAC 地址 |
| {macAddressAlphaLower} | 无冒号且小写的 MAC 地址 |
| {macAddressSha1} | 使用 SHA1 哈希的 MAC 地址 |
| {macAddressSha1Lower} | 小写并使用 SHA1 哈希的 MAC 地址 |
| {macAddressMd5} | 使用 MD5 哈希的 MAC 地址 |
| {macAddressMd5Lower} | 小写并使用 MD5 哈希的 MAC 地址 |
| {iosIfa} | iOS 广告标识符 |
| {iosIfaSha1} | 使用 SHA1 哈希的 iOS 广告标识符 |
| {iosIfaMd5} | 使用 MD5 哈希的 iOS 广告标识符 |
| {iosIfaNoHyphens} | 无连字符的 iOS 广告标识符 |
| {iosAdTracking} | iOS 广告跟踪设置 |
| {androidId} | Android ID |
| {androidIdSha1} | 使用 SHA1 哈希的 Android ID |
| {androidIdMd5} | 使用 MD5 哈希的 Android ID |
| {odin1} | 手机 wifi 适配器的 MAC 地址的 SHA-1 哈希 |
| {openUdid} | 设备的 OpenUDID |
| {deviceId} | 设备 ID |
| {deviceIp} | 设备 IP |
商品级参数
如果您为操作收集商品级数据，也可以将这些数据包含在您的操作生命周期事件通知中。
“join”是一个接受 3-5 个参数的函数：
* **参数 1：** 集合。
* **参数 2：** 绑定到集合中每个值的符号。
* **参数 3：** 针对集合中每个成员要计算的表达式。
* **参数 4：** 每个表达式之间的可选分隔符（默认是逗号）。
* **参数 5：** 一个可选的前导字符串，仅在集合中有数据时存在。
示例假设有 3 件商品，SKU 分别为 GH23、UT66 和 RW87。
“items” 是商品数据的集合。每个商品都有 “cat”、“sku”、“qty”、“amt”、“rbt”、“name”...
| 表达式 | 结果 |
| ------------------------------------------------------ | ---------------------------------------------------------- |
| {join(items, i, "sku{i}={i.sku}", "&", "?")} | ?sku1=GH23\&sku2=UT66\&sku3=RW87 |
| {join(items, i, "cat{i}={i.cat}", "&", "?")} | ?cat1=Watches\&cat2=Shoes\&cat3=Hats |
| {join(items, i, "qty{i}={i.qty}", "&", "?")} | ?qty1=3\&qty2=4\&qty3=11 |
| {join(items, i, "amt{i}={i.amt}", "&", "?")} | ?amt1=2.92\&amt2=99.32\&amt3=4.99 |
| {join(items, i, "cartamt{i}={i.cartamt}", "&", "?")} | ?cartamt1=50.01\&cartamt2=23.89\&cartamt3=34.00 |
| {join(items, i, "rbt{i}={i.rbt}", "&", "?")} | ?rbt1=1.00\&rbt2=5.00\&rbt3=1.50 |
| {join(items, i, "name{i}={i.name}", "&", "?")} | ?name1=1.00\&name2=5.00\&name3=1.50 |
| {join(items, i, "promo{i}={i.promo}", "&", "?")} | ?promo1=HAPPY\&promo2=H10DAY\&promo3=NOW30 |
| {join(items, i, "price{i}={i.price}", "&", "?")} | ?price1=1.70\&price2=2.00\&price3=0.00 |
| {join(items, i, "brand{i}={i.brand}", "&", "?")} | ?brand1=lulu\&brand2=NB\&brand3=impact |
| {join(items, i, "discount{i}={i.disc}", "&", "?")} | ?discount1=2.00\&discount2=0.50\&discount3=10.00 |
| {join(items, i, "itemlist{i}={i.itemlist}", "&", "?")} | ?itemlist1=accessories\&itemlist2=apparel\&itemlist3=games |