> 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/ja/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md).

# ブランド向けにイベント通知ポストバックを有効にする

イベント通知ポストバック（Webhook）は、特定のイベントが発生したときに内部システムにリアルタイムで通知します。送信されるデータはイベントによって異なりますが、設定手順はすべて同じです。

{% stepper %}
{% step %}

## イベント通知ポストバックにアクセスする

1. 上部のナビゲーションバーで、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[ユーザープロフィール] → 設定**.
2. 「 *テクニカル* 」セクションで「 [**イベント通知」を選択します。**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).
   {% endstep %}

{% step %}

## 共通設定項目を入力する

1. 通知ポストバックを設定するイベントにカーソルを合わせ、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **［編集］を選択します。**.
2. 以下の表を参照して配信設定を行います。

<table><thead><tr><th width="225.36328125">項目</th><th>説明</th></tr></thead><tbody><tr><td>URL</td><td>データを受信するサーバー上のエンドポイントです。</td></tr><tr><td>HTTPメソッド</td><td><p><code>GET</code>：データはクエリ文字列としてURLに追加されます。</p><p><code>POST</code>：データはリクエスト本文で送信されます。本文には、設定可能なさまざまなオプションパラメータが含まれます。<br><br>各イベントとペイロードの内容について詳しくは、 <a href="#notification-events-and-payloads">通知イベントとペイロード</a> を参照してください。</p></td></tr><tr><td>HTTPヘッダー</td><td>（オプション）認証用のカスタムヘッダーを追加します（例： <code>Authorization: Bearer token</code>).</td></tr><tr><td>最小遅延</td><td>「 <em>最小遅延</em> 」を秒単位で設定し、急激なトラフィックの増加からサーバーを保護します。</td></tr><tr><td>最大リクエスト数</td><td>1秒あたりの「 <em>最大リクエスト数</em> 」を設定し、急激なトラフィックの増加からサーバーを保護します。</td></tr><tr><td>成功レスポンス</td><td>ポストバックが正常に処理されたときにサーバーが返す、特定の文字列またはHTTPステータスコードです。</td></tr><tr><td>エラーレスポンス</td><td>失敗を示す文字列またはステータスコードです（例： <code>ERROR</code> または <code>500</code>).</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

## 通知イベントとペイロード

各イベント通知は、設定可能な固有のデータ項目セット（例： `{ActionId}`）を送信します。ペイロードから抽出できるデータ項目については、以下のイベントを参照してください。

<details>

<summary>アクションライフサイクルイベント</summary>

アクションライフサイクルイベントは、アクションがトラッキング、変更、または取り消されたときに、指定された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", // デバイスのOSバージョン
  "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アドレス
}
```

</details>

<details>

<summary>アクション照会イベント</summary>

アクション照会イベントでは、アクション照会が作成または解決されたときに、指定された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": "Customer claims they clicked the link but no credit was shown.", // パートナーが送信した照会メモ
  "ResolutionNotes": null, // 照会の判定時に送信されたメモ
  "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // 照会に追加されたコメント（JSON形式）
}
```

</details>

<details>

<summary>アクションクリアイベント</summary>

アクションクリアイベントでは、アクションがクリアされたときに、指定された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）
}
```

</details>

<details>

<summary>トラッキング値リクエストイベント</summary>

トラッキング値リクエストイベントでは、トラッキングリクエストが作成されたときに、指定された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" // 一意のクリック識別子
}
```

</details>

<details>

<summary>ジョブ完了イベント</summary>

ジョブ完了イベントは、ジョブが完了すると、指定した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分）
}
```

</details>

<details>

<summary>パブリッシャー申請イベント</summary>

{% hint style="success" %}
**注：** この機能はベータ版です。この機能をお試しになりたい場合は、CSMまたは [サポートチーム](https://app.impact.com/support/portal.ihtml?createTicket=true&) までお問い合わせください。
{% endhint %}

パブリッシャー申請イベントは、パートナーが申請を送信したとき、および申請が承認、却下、撤回されるたびに、指定したURLにHTTPリクエストを送信します。

パブリッシャー申請イベントは、契約イベントのポストバック、申請処理Webhook、または申請Webhookとも呼ばれます。

PENDING `PENDING` ペイロードがデータポイントなしで配信された場合、システムは情報が利用可能になり次第、更新をトリガーするように設計されています。その後の配信が成功すると、以前は空だったフィールドに値が入力され、レコードが最新の処理済み情報と同期された状態に保たれます。

{% hint style="warning" %}
**重要：** 申請ワークフロー [申請ワークフロー](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) が設定されている場合、Webhookが実行される前にワークフローが実行されます。Webhookには、ワークフローで申請が処理された場合は処理後の *ステータス*: `APPROVED` または `REJECTED` が設定され、ワークフローが適用されなかった場合は `PENDING` が設定されます。また、パートナーが申請を取り下げた場合は `RETRACTED` が設定されます。
{% endhint %}

このWebhookとRecruitment Agentがどのように連携するかについては、 [Recruitment Agent](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md#see-where-the-agent-fits-with-your-existing-automation).

ペイロードの内容は *ステータス*によって異なります。以下の例は `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": "A premium network of lifestyle and travel influencers.", // パートナープロフィールの説明
  "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
}
```

</details>

## ポストバックの再試行メカニズム

宛先URLへの送信時にポストバックが失敗すると、設定されたスケジュールに基づいて最大15回、自動的に再試行されます。一時的なネットワークの問題やサーバーの利用不能に対処するため、再試行が行われます。

### 再試行が行われない条件

次の場合、ポストバックは再試行されません。

* 宛先URLの形式が正しくないか、無効です。
* 宛先URLまたはそのホストを名前解決できません。たとえば、DNS検索に失敗した場合です。

### 再試行スケジュール

再試行は以下のスケジュールに従って行われます。HTTPレスポンスコードが次の範囲内の場合、再試行1、2、3はスキップされます。 `400` から `500`.

<details>

<summary>再試行スケジュールの参照</summary>

<table><thead><tr><th width="180.5390625">再試行回数</th><th>再試行までの遅延時間</th></tr></thead><tbody><tr><td>再試行 1</td><td>+15秒</td></tr><tr><td>再試行 2</td><td>+15秒</td></tr><tr><td>再試行 3</td><td>+15秒</td></tr><tr><td>再試行 4</td><td>+3分</td></tr><tr><td>再試行 5</td><td>+3分</td></tr><tr><td>再試行 6</td><td>+15分</td></tr><tr><td>再試行 7</td><td>+15分</td></tr><tr><td>再試行 8</td><td>+15分</td></tr><tr><td>再試行 9</td><td>+2時間</td></tr><tr><td>再試行 10</td><td>+2時間</td></tr><tr><td>再試行 11</td><td>+2時間</td></tr><tr><td>再試行 12</td><td>+6時間</td></tr><tr><td>再試行 13</td><td>+6時間</td></tr><tr><td>再試行 14</td><td>+6時間</td></tr><tr><td>再試行 15</td><td>+6時間</td></tr></tbody></table>

</details>


---

# 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/brand/ja/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.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.
