> 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 トークン`). | | 最小遅延 | 設定 *最小遅延* 秒単位で、トラフィック急増からサーバーを保護します。 | | 最大リクエスト数 | 設定 *最大リクエスト数* 1秒あたり、トラフィック急増からサーバーを保護するために。 | | 成功レスポンス | ポストバックが正しく処理されたときにサーバーが返す特定のテキスト文字列またはHTTPステータスコード。 | | エラーレスポンス | 失敗を示すテキスト文字列またはステータスコード（例： `ERROR` または `500`). | | {% endstep %} | | | {% endstepper %} | | ### 通知イベントとペイロード 各イベント通知は、設定可能な固有のデータ項目セット（例： `{ActionId}`）を送信します。ペイロードから抽出できるデータ項目については、以下のイベントを参照してください。
アクションライフサイクルイベント アクションがトラッキング、変更、または取り消されたときに、指定されたURL（および含まれるパラメータ）へHTTPリクエストを送信します。 ```json // JSON形式のPOST例 { "CampaignId": 9876, // プログラムID "ActionTrackerId": 12345, // イベントタイプID "MediaPartnerId": 555, // パートナーID "CampaignName": "春のグローバルプロモーション", // プログラム名 "ActionTrackerName": "標準セールトラッカー", // イベントタイプ名 "MediaPartnerName": "トップティアアフィリエイト", // パートナー名 "ActionId": "ACT-778899", // アクションID "Status": "MODIFIED", // アクションステータス "StatusDetail": "アイテム返品 - 報酬を調整済み", // アクションステータスの詳細 "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", // 参照クリックID "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例 { システム内のアクション問い合わせの一意の識別子 "MediaPartnerId": 555, // パートナーID "MediaPartnerName": "トップティアアフィリエイト", // パートナー名 "CampaignId": 9876, // プログラムID "CampaignName": "春のグローバルプロモーション", // プログラム名 報告されたアクションの注文ID アクション問い合わせをトリガーしたイベントの取引日時 アクション問い合わせをトリガーしたイベントの取引金額 アクション問い合わせの種類 パートナーが期待する報酬額 問い合わせを承認または却下しなければならない期限日 パートナーが提供したトラッキングリンク アクションID（既存のアクションに関連付けられている場合） システムが自動承認ルールを実行する日付 アクション問い合わせの最終解決ステータス アクション問い合わせが却下された理由 アクション問い合わせに関連付けられた最終報酬額 問い合わせが決定された日付 問い合わせがシステムに作成される日時 パートナーが提出した問い合わせメモ：顧客はリンクをクリックしたが、クレジットが表示されなかったと主張しています。 問い合わせが決定されたときに提出されたメモ "Comments": "[{\"user\": \"support_agent\", \"text\": \"クリックログを確認中です。\"}, {\"user\": \"partner\", \"text\": \"顧客が領収書を提出しました。\"}]" // 問い合わせに追加されたコメント（JSON形式） } ```
アクション消込イベント アクションが消込されたときに、指定されたURL（および含まれるパラメータ）へHTTPリクエストを送信します。 ```json // JSON形式のPOST例 { "ActionTrackerId": 12345, // イベントタイプID "ActionTrackerName": "標準セールトラッカー", // イベントタイプ名 "CampaignId": 9876, // プログラムID "CampaignName": "春のグローバルプロモーション", // プログラム名 "MediaPartnerId": 555, // パートナーID "MediaPartnerName": "トップティアアフィリエイト", // パートナー名 報告されたアクションの注文ID（カンマ区切り） アクションID（カンマ区切り） アクションが消込予定の日時（ISO 8601） アクションが消込された日時（ISO 8601） } ```
トラッキング値リクエストイベント トラッキング値リクエストイベントは、トラッキングリクエストが作成されたときに、指定されたURL（および含まれるパラメータ）へHTTPリクエストを送信します。 ```json // JSON形式のPOST例 { "CampaignId": 9876, // プログラムID "ActionTrackerId": 12345, // イベントタイプID "MediaPartnerId": 555, // パートナーID "ActionId": "ACT-778899", // アクションID アカウントの通貨でのアクション金額 "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例 { ジョブの一意のID ジョブの種類 アカウントID ジョブが開始した時刻 ジョブが完了した時刻 処理または生成されたレコード数 ジョブの詳細を取得するためのAPI URI ジョブの出力結果を取得するためのAPI URI 出力をダウンロードするURL（5分で期限切れ） 出力をダウンロードするURL（15分で期限切れ） 出力をダウンロードするURL（30分で期限切れ） 出力をダウンロードする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": "ライフスタイルと旅行インフルエンサーのプレミアムネットワーク。", // パートナープロフィールの説明 "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.