> 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/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", // デバイスの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広告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="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への投稿に失敗した場合、配信は設定されたスケジュールに基づいて自動的に最大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.