> 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. 上部ナビゲーションバーで、次を選択します ![](/files/173ecabf39fd91e83f3ac16fba44d8e9c845708d) **\[ユーザープロフィール] → 設定**. 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", // デバイスのOS "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広告識別子 "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/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/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 %} ペイロードの内容は *ステータス*によって異なります。以下の例は `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 } ```
### ポストバックの再試行メカニズム 送信先URLへのPOSTに失敗した場合、配信は定められたスケジュールに基づいて自動的に最大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 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/ja/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.