> 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. 以下の表を使用して配信設定を構成してください：
項目説明
URLデータを受信するサーバー上のエンドポイント。
HTTPメソッド

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

POST：データはリクエストボディで送信され、設定できるさまざまなオプションパラメータが含まれます。

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

HTTPヘッダー(省略可) 認証用のカスタムヘッダーを追加します（例： Authorization: Bearer token).
最小遅延設定する 最小遅延 秒単位で、トラフィック急増からサーバーを保護します。
最大リクエスト数設定する 最大リクエスト数 件/秒で、トラフィック急増からサーバーを保護します。
成功レスポンスポストバックが正しく処理されたときにサーバーが返す特定のテキスト文字列または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/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リクエストを送信します。 パブリッシャー申請イベントは、契約イベントのポストバック、申請処理webhook、または申請webhookとしても知られています。 もし `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 %} このwebhookがRecruitment Agentと連携してどのように機能するかについては、以下を参照してください [Recruitment Agent](/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": "ライフスタイルと旅行インフルエンサーのプレミアムネットワーク。", // パートナープロフィールの説明 "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 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=&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.