> 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).
最小遅延設定 最小遅延 サーバーをトラフィックの急増から保護するための秒数です。
最大リクエスト数設定 最大リクエスト数 サーバーをトラフィックの急増から保護するため、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", // 一意のクリック識別子 "SharedId": "social_post_01", // パートナー共有ID "PromoCode": "SAVE20", // 一般プロモコード "CustomerStatus": "EXISTING", // 顧客ステータス "Oid": "ORD-554433", // 注文ID "Note": "部分返品を処理しました", // アクションに付随するメモ "CustomerPostCode": "94105", // 顧客の郵便番号 "CustomerCity": "San Francisco", // 顧客の都市 "CustomerCountry": "US", // 顧客国コード "CustomerRegion": "CA", // 顧客地域 "CustomerId": "CUST-12345", // 顧客ID "CustomerEmail": "a665a45920422f9d417...", // ハッシュ化された顧客メールアドレス "IpAddress": "192.168.1.1", // IPアドレス "CallerId": null, // 発信者の電話番号 // カスタム追加フィールド "Text1": "カスタム値 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": "トップティア・アフィリエイト", // パートナー名 "CampaignId": 9876, // プログラムID "CampaignName": "春のグローバルプロモーション", // プログラム名 "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": "顧客はリンクをクリックしたが、クレジットが表示されなかったと主張しています。", // パートナーが送信した照会メモ "ResolutionNotes": null, // 照会の決定時に送信されたメモ "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": "トップティア・アフィリエイト", // パートナー名 "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": "ライフスタイルと旅行のインフルエンサーによるプレミアムネットワーク。", // パートナープロフィールの説明 "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レスポンスコードが `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.