# ブランド向けにイベント通知のポストバックを有効化する
イベント通知ポストバックは、アクション、クリック、その他のイベントが発生したときに通知する標準的なHTTP通知です。イベントポストバックはイベントデータを内部のレポーティングシステムに送るように設定でき、イベントの最新の状況を把握できます。
#### イベント通知ポストバックを表示
1. 上部ナビゲーションバーから、  **\[ユーザープロファイル] → 設定**.
2. メニューで、 *技術* 左側のセクションで、次を選択 [イベント通知](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).
#### イベントポストバックを有効にする
以下の手順は、次の5種類のイベントポストバックを構成するのに役立ちます：
* **アクションライフサイクルイベント** アクションが追跡、変更、または取り消されたときに、指定されたURL（および含まれる任意のパラメータ）へHTTPリクエストを発行します。
* **トラッキング値リクエストイベント** トラッキングリクエストが作成されたときに、指定された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. を追加します **URL** impact.comがイベントポストバックで使用すべき **URL内の任意の** パラメータとともに。これらのパラメータの完全な一覧と例（ `GET` メソッド）については、以下のセクションを参照してください。
3. HTTPメソッドを選択： `GET` は推奨オプションです。任意のパラメータをURLに直接渡せます。代わりにシステムがデータをリクエストボディで送信する必要がある場合は `POST`を選択してください。
* を使用する場合、 `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} | デバイスのOSバージョン |
| {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} | 電話のWi-FiアダプタのMACアドレスのSHA-1ハッシュ |
| {openUdid} | デバイスのOpenUDID |
| {deviceId} | デバイスID |
| {deviceIp} | デバイスのIP |
アイテムレベルのパラメータ
アクションのアイテムレベルデータを収集している場合、アクションライフサイクルイベント通知にこのデータを含めることもできます。
"join"は3〜5個の引数を取る関数です：
* **引数1：** コレクション。
* **引数2：** コレクション内の各値にバインドするシンボル。
* **引数3：** コレクションの各メンバーについて計算する式。
* **引数4：** 各式の間のオプションの区切り文字（デフォルトはカンマ）。
* **引数5：** コレクションにデータがある場合にのみ含まれるオプションの先頭文字列。
SKUがそれぞれGH23、UT66、RW87の3つのアイテムを想定した例。
"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 |