# ブランド向けにイベント通知のポストバックを有効にする イベント通知ポストバック（webhook）は、特定のイベントが発生したときに内部システムへリアルタイムで通知します。送信されるデータはイベントごとに異なりますが、設定手順はすべて同じです。 {% stepper %} {% step %} ### イベント通知ポストバックにアクセスする 1. 上部のナビゲーションバーから ![](/files/2c38195ecc23a36266a65082c4bfc52f44a43503) **\[ユーザープロファイル] → 設定**. 2. の下の *技術情報* セクションで、 [**イベント通知**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?). {% endstep %} {% step %} ### グローバル設定フィールドを完了する 1. 通知ポストバックを設定したいイベントにカーソルを合わせ、選択します ![](/files/69e6c7863de57fc89d19a35da7784a14b915cd69) **\[編集]**. 2. 配信設定を構成するには、以下の表を使用してください: | 項目 | 説明 | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | URL | データを受信する、サーバー上のエンドポイント。 | | HTTPメソッド |

GET: データはクエリ文字列としてURLに追加されます。

POST: データはリクエストボディに送信され、設定できるさまざまな任意パラメータが含まれます。

以下を参照してください 通知イベントとペイロード 各イベントとペイロード内容の詳細について。

| | HTTPヘッダー | （任意）認証用のカスタムヘッダーを追加します（例: `Authorization: Bearer token`). | | 最小遅延 | 設定する *最小遅延* 秒単位で、トラフィック急増からサーバーを保護します。 | | 最大リクエスト数 | 設定する *最大リクエスト数* 1秒あたり。トラフィック急増からサーバーを保護します。 | | 成功レスポンス | ポストバックが正しく処理されたときに、サーバーが返す特定のテキスト文字列または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", // デバイス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 } ```
アクション照会イベント アクション照会イベントは、アクション照会が作成または解決されたときに、指定された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形式） } ```
アクションクリアイベント アクションクリアイベントは、アクションがクリアされたときに、指定された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/impact-brand/reference/export-reports) または [エクスポートをクリック](https://integrations.impact.com/impact-brand/reference/retrieve-export-click). ```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="info" %} **注：** この機能はベータ版です。テストしたい場合は、CSMまたは [サポートチーム](https://app.impact.com/support/portal.ihtml?createTicket=true&) にお問い合わせください。 {% endhint %} パブリッシャー申請イベントは、パートナーが申請を送信したときに、指定されたURLへHTTPリクエストを送信します。 空のデータポイントを含むペイロードが配信された場合、システムは情報が利用可能になるたびに更新をトリガーするよう設計されています。その後の正常な配信では、以前空だったフィールドが埋められ、記録が最新の処理済み情報と同期された状態に保たれます。 {% hint style="warning" %} **重要：** 競合する [申請ワークフロー](/brand/ja/nitsuitebitaidesuka/platform-features/review-partner-applications/automate-partner-application-processing/create-workflows-to-automatically-process-partner-applications.md). {% endhint %} ```json // JSON形式のPOST例 { "ProgramId": "9876", // プログラムID "TemplateTermsId": "4455", // テンプレート規約ID "ContractId": "112233", // 契約ID "ApplicationDate": "2026-04-09T08:30:00Z", // 申請日 "PublisherId": "555", // パートナーID "Name": "Elite Content Creators", // パートナー名 "BusinessModel": "SOCIAL_INFLUENCER", // パートナーの主なビジネスモデル "Description": "A premium network of lifestyle and travel influencers.", // プロフィール説明 "Address": "123 Marketing Way", // 住所 "City": "Los Angeles", // 市区町村 "State": "CA", // 州 "Country": "US", // 国 "Language": "en-US", // 言語 "PublisherSize": "M", // XS、S、M、L、XL "PastRelationship": false, // 以前の契約の有無を示すブール値 "MarketplaceApproved": true, // マーケットプレイス承認ステータスを示すブール値 "ReceivedPayout": true, // 報酬を受け取っているかどうかを示すブール値 } ```
### ポストバック再試行メカニズム ポストバックが送信先URLへの投稿に失敗した場合、配信はあらかじめ設定されたスケジュールに基づいて自動的に最大15回まで再試行されます。再試行は、一時的なネットワーク問題やサーバー停止に対応するのに役立ちます。 #### 再試行が行われない条件 次のケースではポストバックは再試行されません: * 送信先URLが不正な形式、または無効です。 * 送信先URLまたはそのホストが解決できません。たとえば、DNSルックアップの失敗が原因です。 #### 再試行スケジュール 再試行は以下のスケジュールに従います。HTTPレスポンスコードが次の範囲内の場合、再試行1、2、3はスキップされます `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: 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: ``` GET https://help.impact.com/brand/ja/nitsuitebitaidesuka/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.