> 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/set-up-postbacks-for-partners.md).

# パートナー向けポストバックを設定する

パートナー向けにポストバックを設定すると、イベントが発生するたびに、プラットフォームからパートナーのシステムへリアルタイムのHTTP通知（ポストバック）が直接送信されます。これにより、追加のピクセルを実装したり、カスタムのサーバーサイド連携を構築したりする必要がなくなります。

パートナー連携とOptimizeのメディアソース連携を使用することで、ウェブサイトのコードを変更することなく、技術スタックを簡素化し、データの一貫性を確保できます。代わりに自社のシステムへポストバックを送信するには、次を参照してください： [ブランド向けイベント通知ポストバックを有効にする](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).

## パートナーポストバックの設定方法を選択する

### パートナー連携のポストバック

パートナートラッキング連携を使用すると、サイトに追加のピクセルやタグを設置せずに、コンバージョンデータをパートナーのシステムと同期するためのポストバックを設定できます。これにより、開発や保守の負担、およびトラッキングの競合リスクを軽減できます。

これらのポストバックにより、パートナーは信頼性の高いサーバー間通信を通じて必要なコンバージョンデータにアクセスできます。また、重複した実装や不要なフロントエンドの変更を避けられます。

{% hint style="warning" %}
**重要：** パートナー契約には、パートナー通知ポストバックの設定に使用するイベントタイプを指定する必要があります。
{% endhint %}

1. 左側のナビゲーションメニューから、 ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[エンゲージ]** → **パートナー** → [**パートナー**](https://app.impact.com/secure/advertiser/engage/mediapartners/view-mediapartners-flow.ihtml).
2. ポストバックを設定するパートナーにカーソルを合わせ、次を選択します： ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[その他]** → **パートナー連携**.
3. 右上で次を選択します： **ポストバックを追加**.

### Optimizeメディアソースのポストバック

{% hint style="success" %}
**注：** このセクションは、 [Optimize](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/account-administration/account-settings/subscription-add-ons/get-the-optimize-add-on.md) アドオンを利用している場合にのみ適用されます。
{% endhint %}

テクノロジーパートナーをメディアソースとして追加し、通知を設定することで、従来の契約プロセスを省略できます。この設定により、正式な契約や契約レベルでの特定のイベントタイプを必要とせず、ポストバックをシームレスに送信できます。

1. 左側のナビゲーションメニューから次を選択します： ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1e02b2659c94fa0756772cc6c1880977fc9aba73%2F6ad16bf9b7edb0a28ab3574d313014f32392aa7f9508686b63bfacfafc7a9735.svg?alt=media) **\[Optimize]** → **設定** → [**ネットワーク**](https://app.impact.com/secure/advertiser/optimize/mediamanager/mediasources/manage-media-sources-flow.ihtml).
2. ポストバックを設定するメディアソースにカーソルを合わせ、次を選択します： ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FMLtRUwWz0pujlfmYWOgg%2FMoreVN.svg?alt=media\&token=03a3c355-a347-4207-baf7-c44fadf6d080) **\[その他]** → **イベント通知**.
3. 右上で次を選択します： **ポストバックを追加**.

## ポストバックのフィールドを設定する

1. 「 *アクショントラッカー* 」ドロップダウンメニューから、ポストバックを設定するイベントタイプを選択します。
2. 「 *イベントトリガー*」で、impact.comがパートナーにポストバックを送信するタイミングを選択します：
   * **成果が付与された場合（推奨）**：パートナーにコンバージョンの成果が付与されると、ポストバックが送信されます。
   * **関与した場合**：成果が付与されたかどうかにかかわらず、パートナーがタッチポイントに関与した各コンバージョンについてポストバックが送信されます。以下の次のタブを参照してください： [*関与した場合*](#when-involved) タブ *（ポストバックパラメータ* 内）。
   * **常に**：パートナーが関与したかどうかにかかわらず、このイベントタイプのすべてのコンバージョンについてポストバックが送信されます。ほとんどのブランドではこのオプションは不要なため、特定のケースにのみ使用してください。使用されるパラメータは次のオプションと同じです： **成果が付与された場合**.
3. 必要に応じて、モバイルアプリのイベントタイプでは、次を選択して ![](https://1458456015-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FwXho9QKP3e4iU4ZKUSJ5%2F167ebb8cc30303.svg?alt=media\&token=a046e9f0-63aa-46f6-8a35-f73973fd326c) **\[チェックボックス] インストール** アプリのインストールに対するポストバックを設定します。
   * イベントタイプとしてモバイルアプリを選択した場合は、ポストバックに必要なアプリ内イベント名を正確に選択してください。
4. サーバーのURLを入力します。impact.comがポストバックを送信する宛先のURLです。必要に応じて、追加のプレースホルダーのパラメーター値を含めることもできます。URLを呼び出す前に、パラメーターのプレースホルダーは実際の値に置き換えられます。例： `http://www.domain.com?campaignId={CampaignId}`.
   * プラットフォームでパラメーターを表示するには、 **オプションのパラメーターを表示/非表示** を *URL* フィールドで選択します。説明については、以下の *ポストバックパラメーター* を参照してください。
5. 希望する **HTTPメソッド**.

<details>

<summary>GETメソッド</summary>

GETメソッドは、ほとんどの連携で推奨される方法です。URL文字列にクエリパラメーターとしてオプションのパラメーターを直接渡すことができます。

**URLの例：** `https://www.someadvertiser.com?myCampaignId={CampaignId}&theMpId={MediaPartnerId}&theActionId={ActionId}&status={Status}&lockingDate={LockingDate}&mpPayout={Payout}&saleAmt={Amount}`

</details>

<details>

<summary>POSTメソッド</summary>

パートナーがURLではなくリクエスト本文でデータを送信する必要がある場合は、POSTメソッドを使用します。この設定を行うには、本文の形式（例：JSON）を定義する必要があります。

**設定手順：**

1. **本文の形式を選択：** システムで必要な形式（例：JSON、XML、QueryString）を選択します。
2. **データ項目をマッピング：** キーと値のペアを定義します。
   * **キー：** 内部システムで定義されている特定のフィールド名です。
   * **値：** 中かっこで囲んだ変数を使用します `{ }`.

**JSONの例：**

```json
{
  "campaign_id": "{CampaignId}", 
  "partner_id": "{MediaPartnerId}", 
  "action_id": "{ActionId}", 
  "payout": "{Payout}" 
}
```

</details>

6. 必要に応じて、 **HTTPヘッダー**.
7. 必要に応じて、 **詳細設定を表示**.
   * 次の値を入力します： **最小遅延時間** 標準以外のイベントが発生してから、ポストバックが生成され、システムに送信されるまでの時間を指定します。
   * 次のレート制限を入力します： **最大リクエスト数** impact.comが1秒あたりにシステムへ送信できるリクエスト数です。
   * ポストバックに対する **成功レスポンス** として返す内容を入力します。
   * ポストバックに対する **エラーレスポンス** として返す内容を入力します。
8. 選択： **保存** すべてのイベントについて繰り返します。

## ポストバックパラメーター

使用できるパラメーターは、選択したイベントトリガーによって異なります。ポストバックに対応するタブを選択してください。

{% tabs %}
{% tab title="クレジット時および常時" %}

### 注文レベルのパラメーター（クレジット時および常時）

<table data-header-hidden="false" data-header-sticky><thead><tr><th>パラメーター</th><th>マッピング / 説明</th></tr></thead><tbody><tr><td><code>{CampaignId}</code></td><td>プログラムID</td></tr><tr><td><code>{ActionTrackerId}</code></td><td>イベントタイプID</td></tr><tr><td><code>{MediaPartnerId}</code></td><td>パートナーID</td></tr><tr><td><code>{CampaignName}</code></td><td>プログラム名</td></tr><tr><td><code>{ActionTrackerName}</code></td><td>イベントタイプ名</td></tr><tr><td><code>{MediaPartnerName}</code></td><td>パートナー名</td></tr><tr><td><code>{ActionId}</code></td><td>アクションID</td></tr><tr><td><code>{Status}</code></td><td>アクションのステータス</td></tr><tr><td><code>{StatusDetail}</code></td><td>アクション変更の理由など、アクションステータスの詳細情報</td></tr><tr><td><code>{AdId}</code></td><td>広告ID</td></tr><tr><td><code>{Payout}</code></td><td>パートナーへのアクション報酬（パートナー通貨）</td></tr><tr><td><code>{DeltaPayout}</code></td><td>報酬額の変更</td></tr><tr><td><code>{IntendedPayout}</code></td><td>上限超過アクションに対する予定報酬額</td></tr><tr><td><code>{Amount}</code></td><td>アクション金額（アカウント通貨）。</td></tr><tr><td><code>{DeltaAmount}</code></td><td>以前のアクションから修正された金額。</td></tr><tr><td><code>{IntendedAmount}</code></td><td>上限超過アクションに対する予定販売額</td></tr><tr><td><code>{Currency}</code></td><td>アクションの通貨</td></tr><tr><td><code>{OriginalCurrency}</code></td><td>アクションの元の通貨（カート通貨など）</td></tr><tr><td><code>{OriginalAmount}</code></td><td>アクションの元の金額（カート金額など）</td></tr><tr><td><code>{EventDate}</code></td><td>コンバージョンが発生した日付</td></tr><tr><td><code>{CreationDate}</code></td><td>アクションがシステムに作成された日付</td></tr><tr><td><code>{LockingDate}</code></td><td>アクションがロックされる日付（ISO 8601形式）。</td></tr><tr><td><code>{ClearedDate}</code></td><td>アクションのクリア予定日（ISO 8601形式）</td></tr><tr><td><code>{ReferringDomain}</code></td><td>リファラルが発生したドメイン（オンラインの場合）</td></tr><tr><td><code>{LandingPageUrl}</code></td><td>ランディングページのURL（オンラインの場合）</td></tr><tr><td><code>{RefCustomerArea}</code></td><td>IPアドレスから特定される顧客エリア</td></tr><tr><td><code>{RefCustomerCity}</code></td><td>IPアドレスから取得した顧客の市区町村</td></tr><tr><td><code>{RefCustomerRegion}</code></td><td>IPアドレスから取得した顧客の地域</td></tr><tr><td><code>{RefCustomerCountry}</code></td><td>IPアドレスから取得した顧客の国コード</td></tr><tr><td><code>{RefClickId}</code></td><td>クリック時に生成される一意の大文字と小文字を区別する識別子（該当する場合）</td></tr><tr><td><code>{SharedId}</code></td><td>パートナーがクリックURLに含めることができ、広告主が利用できる値</td></tr><tr><td><code>{PromoCode}</code></td><td>プロモーションコード</td></tr><tr><td><code>{CustomerStatus}</code></td><td>顧客ステータス</td></tr><tr><td><code>{Oid}</code></td><td>注文ID</td></tr><tr><td><code>{Note}</code></td><td>報告されたアクションに付随するメモ</td></tr><tr><td><code>{CustomerPostCode}</code></td><td>顧客の郵便番号</td></tr><tr><td><code>{CustomerCity}</code></td><td>報告されたアクションとともに提供された顧客の市区町村</td></tr><tr><td><code>{CustomerCountry}</code></td><td>報告されたアクションとともに提供された顧客の国コード</td></tr><tr><td><code>{CustomerRegion}</code></td><td>報告されたアクションとともに提供された顧客の地域</td></tr><tr><td><code>{Text1}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Text2}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Text3}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Date1}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Date2}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Date3}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Money1}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Money2}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Money3}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Numeric1}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Numeric2}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{Numeric3}</code></td><td>報告されたアクションとともに提供</td></tr><tr><td><code>{appPackage}</code></td><td>モバイルアプリのパッケージ</td></tr><tr><td><code>{appName}</code></td><td>モバイルアプリ名</td></tr><tr><td><code>{appVersion}</code></td><td>モバイルアプリのバージョン</td></tr><tr><td><code>{deviceOs}</code></td><td>デバイスのオペレーティングシステム</td></tr><tr><td><code>{deviceOsVersion}</code></td><td>デバイスのオペレーティングシステムのバージョン</td></tr><tr><td><code>{deviceManuf}</code></td><td>デバイスのメーカー</td></tr><tr><td><code>{deviceModel}</code></td><td>デバイスのモデル</td></tr><tr><td><code>{macAddress}</code></td><td>MACアドレスのオプション（大文字、小文字、ハッシュ化）</td></tr><tr><td><code>{iosIfa}</code></td><td>iOS広告識別子のオプション</td></tr><tr><td><code>{iosAdTracking}</code></td><td>iOS広告トラッキングの設定</td></tr><tr><td><code>{androidId}</code></td><td>Android IDのオプション</td></tr><tr><td><code>{odin1}</code></td><td>MACアドレスのSHA-1ハッシュ</td></tr><tr><td><code>{openUdid}</code></td><td>デバイスのOpenUDID</td></tr><tr><td><code>{deviceId}</code></td><td>デバイスID</td></tr><tr><td><code>{deviceIp}</code></td><td>デバイスIP</td></tr><tr><td><code>{UserAgent}</code></td><td>ユーザーエージェント</td></tr><tr><td><code>{IpAddressPlain}</code></td><td>IPアドレス</td></tr></tbody></table>

### アイテム単位のパラメーター（関与時および常時）

<table data-header-hidden="false" data-header-sticky><thead><tr><th>マッピング</th><th>式</th><th>結果</th></tr></thead><tbody><tr><td>SKU</td><td><code>{join(items, i, "sku{i}={i.sku}", "&#x26;", "?")}</code></td><td><code>?sku1=GH23&#x26;sku2=UT66&#x26;sku3=RW87</code></td></tr><tr><td>カテゴリ</td><td><code>{join(items, i, "cat{i}={i.cat}", "&#x26;", "?")}</code></td><td><code>?cat1=Watches&#x26;cat2=Shoes&#x26;cat3=Hats</code></td></tr><tr><td>数量</td><td><code>{join(items, i, "qty{i}={i.qty}", "&#x26;", "?")}</code></td><td><code>?qty1=3&#x26;qty2=4&#x26;qty3=11</code></td></tr><tr><td>金額</td><td><code>{join(items, i, "amt{i}={i.amt}", "&#x26;", "?")}</code></td><td><code>?amt1=2.92&#x26;amt2=99.32&#x26;amt3=4.99</code></td></tr><tr><td>カート金額</td><td><code>{join(items, i, "cartamt{i}={i.cartamt}", "&#x26;", "?")}</code></td><td><code>?cartamt1=50.01&#x26;cartamt2=23.89&#x26;cartamt3=34.00</code></td></tr><tr><td>リベート</td><td><code>{join(items, i, "rbt{i}={i.rbt}", "&#x26;", "?")}</code></td><td><code>?rbt1=1.00&#x26;rbt2=5.00&#x26;rbt3=1.50</code></td></tr><tr><td>名前</td><td><code>{join(items, i, "name{i}={i.name}", "&#x26;", "?")}</code></td><td><code>?name1=1.00&#x26;name2=5.00&#x26;name3=1.50</code></td></tr></tbody></table>
{% endtab %}

{% tab title="関与時" %}
「関与時」のポストバックは、別のパートナーがクレジットを獲得した場合でも、カスタマージャーニーで接点があったコンバージョンごとにパートナーへ通知します。impact.comは、ポストバックデータの対象を、クレジットを獲得したパートナーではなく、ポストバックを受信するパートナーに限定します。

これらのパラメーターは、ポストバックURLまたはPOST本文で使用します。 *返却* 列には、パラメーターが常に値を返すのか、受信パートナーがクレジットを獲得した場合にのみ値を返すのかが示されます。 `{ReasonCode}` は、パートナーがクレジットを獲得したかどうか、獲得していない場合はその理由を示します。詳細については、 *理由コード* 以下。

{% hint style="success" %}
**注:** 既存の「関与時」ポストバックでは、元のパラメーターが維持されます。これらのパラメーターを使用するには、「関与時」ポストバックを追加してください。
{% endhint %}

### 注文レベルのパラメーター（関与時）

<table data-header-hidden="false" data-header-sticky><thead><tr><th>パラメーター</th><th>説明</th><th>返却値</th></tr></thead><tbody><tr><td><code>{ReasonCode}</code></td><td>パートナーがコンバージョンの成果報酬を獲得したか、獲得しなかった場合はその理由</td><td>常に</td></tr><tr><td><code>{AdvertiserId}</code></td><td>ブランドアカウントID</td><td>常に</td></tr><tr><td><code>{AdvertiserName}</code></td><td>ブランドアカウント名</td><td>常に</td></tr><tr><td><code>{MediaPartnerId}</code></td><td>パートナーアカウントID</td><td>常に</td></tr><tr><td><code>{MediaPartnerName}</code></td><td>パートナーアカウント名</td><td>常に</td></tr><tr><td><code>{CampaignId}</code></td><td>プログラムID</td><td>常に</td></tr><tr><td><code>{CampaignName}</code></td><td>プログラム名</td><td>常に</td></tr><tr><td><code>{ActionTrackerId}</code></td><td>イベントタイプID</td><td>常に</td></tr><tr><td><code>{ActionTrackerName}</code></td><td>イベントタイプ名</td><td>常に</td></tr><tr><td><code>{ActionId}</code></td><td>一意のアクションID</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{Status}</code></td><td>アクションの表示ステータス</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{StatusDetail}</code></td><td>アクションステータスの追加詳細</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{Payout}</code></td><td>パートナー向けの純支払額（パートナーの通貨）</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{Amount}</code></td><td>パートナー向けの純アクション金額</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{Currency}</code></td><td>アクションのパートナー向け通貨</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{OriginalCurrency}</code></td><td>アクションの元のカート通貨</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{OriginalAmount}</code></td><td>アクションの元のカート金額</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{OriginalSubTotal}</code></td><td>調整前の注文の元の小計</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{OriginalOrderDiscount}</code></td><td>注文レベルの元の割引額</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{OrderDiscountRate}</code></td><td>注文に適用された割引率</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{EventDate}</code></td><td>コンバージョンイベントが発生した日付</td><td>常に</td></tr><tr><td><code>{CreationDate}</code></td><td>アクションが作成された日付</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{LockingDate}</code></td><td>アクションがロックされる予定日</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{ClearedDate}</code></td><td>アクションが確定する予定日</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{OrderId}</code></td><td>注文ID</td><td>常に</td></tr><tr><td><code>{CustomerStatus}</code></td><td>アクションとともに提供された顧客ステータス</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CustomerCity}</code></td><td>アクションとともに提供された顧客の市区町村</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CustomerRegion}</code></td><td>アクションとともに提供された顧客の地域または州</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CustomerCountry}</code></td><td>アクションとともに提供された顧客の国</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{LocationId}</code></td><td>購入場所を示すブランド提供の識別子（主に旅行向け）</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{LocationName}</code></td><td>購入場所を示すブランド提供の名称（主に旅行向け）</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{LocationType}</code></td><td>購入場所の種類（例: 市区町村。主に旅行向け）</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{RefClickId}</code></td><td>参照元クリックのクリックID</td><td>常に</td></tr><tr><td><code>{RefType}</code></td><td>内部参照元またはアトリビューションの種類（例: <code>COOKIE</code>, <code>FPRINT</code>、または <code>MOBILE</code></td><td>常に</td></tr><tr><td><code>{ReferringType}</code></td><td>読みやすい形式のアトリビューションまたはリファラーの種類</td><td>常に</td></tr><tr><td><code>{ReferringDate}</code></td><td>リファラーとなったクリックまたはインプレッションの日付</td><td>常に</td></tr><tr><td><code>{ReferringDomain}</code></td><td>リファラルが発生したドメイン</td><td>常に</td></tr><tr><td><code>{LandingPageUrl}</code></td><td>リファラルのランディングページ URL</td><td>常に</td></tr><tr><td><code>{RefCustomerArea}</code></td><td>リファラーの IP アドレスから判定された顧客の地域</td><td>常に</td></tr><tr><td><code>{RefCustomerCity}</code></td><td>リファラーの IP アドレスから判定された顧客の市区町村</td><td>常に</td></tr><tr><td><code>{RefCustomerRegion}</code></td><td>リファラーの IP アドレスから判定された顧客の州・地域</td><td>常に</td></tr><tr><td><code>{RefCustomerCountry}</code></td><td>リファラーの IP アドレスから判定された顧客の国</td><td>常に</td></tr><tr><td><code>{RefEventDate}</code></td><td>リファラルイベントの日付</td><td>常に</td></tr><tr><td><code>{RefTrafficCat}</code></td><td>リファラーとなったクリックのトラフィックカテゴリ</td><td>常に</td></tr><tr><td><code>{RefTrafficSrc}</code></td><td>リファラーとなったクリックのトラフィックソース</td><td>常に</td></tr><tr><td><code>{RefSubPartnerId}</code></td><td>リファラーとなったクリックのサブパートナー ID</td><td>常に</td></tr><tr><td><code>{RefSubClickId}</code></td><td>リファラーとなったクリックのサブパートナークリック ID</td><td>常に</td></tr><tr><td><code>{RefSubPartnerName}</code></td><td>リファラーとなったクリックのサブパートナー名</td><td>常に</td></tr><tr><td><code>{SubId1}</code></td><td>受信側パートナーのクリックに含まれるサブ ID 1</td><td>常に</td></tr><tr><td><code>{SubId2}</code></td><td>受信側パートナーのクリックに含まれるサブ ID 2</td><td>常に</td></tr><tr><td><code>{SubId3}</code></td><td>受信側パートナーのクリックに含まれるサブ ID 3</td><td>常に</td></tr><tr><td><code>{SharedId}</code></td><td>受信側パートナーのクリックに含まれる共有 ID（サブ ID 4）</td><td>常に</td></tr><tr><td><code>{ContentCampaignId}</code></td><td>コンテンツキャンペーン ID</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{SowId}</code></td><td>作業明細書 ID</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{TaskId}</code></td><td>タスク ID</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CallerCountry}</code></td><td>発信者の国</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CalledCountry}</code></td><td>着信先の国</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CalledNumber}</code></td><td>着信先の電話番号</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CallDuration}</code></td><td>通話の合計時間（秒）</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CallTalkDuration}</code></td><td>通話時間（秒）</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CallPhoneType}</code></td><td>通話の電話タイプ</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{CallTrafficSource}</code></td><td>通話トラフィックソース</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{appPackage}</code></td><td>モバイルアプリのパッケージ</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{appName}</code></td><td>モバイルアプリ名</td><td>成果報酬が発生した場合のみ</td></tr><tr><td><code>{appVersion}</code></td><td>モバイルアプリのバージョン</td><td>成果報酬が発生した場合のみ</td></tr></tbody></table>

### アイテム単位のパラメーター（該当する場合）

impact.com は、受信パートナーがクレジットを獲得したパートナーである場合にのみ、アイテムデータを返します。 `items[]` の各アイテムには、次のフィールドがあります。

| 項目               | 説明                      |
| ---------------- | ----------------------- |
| `items[].SKU`    | アイテムの商品識別子または SKU       |
| `items[].NAME`   | 商品名または説明                |
| `items[].CAT`    | 商品カテゴリー                 |
| `items[].QTY`    | 購入された数量                 |
| `items[].AMT`    | アイテムの取引額または販売金額         |
| `items[].PAYOUT` | アイテムに対して発生したコミッションまたは報酬 |

ポストバックにアイテムデータを追加するには、次の式を使用します。

| マッピング         | 式                                                      | 結果                                              |
| ------------- | ------------------------------------------------------ | ----------------------------------------------- |
| SKU           | `{join(items, i, "sku{i}={i.sku}", "&", "?")}`         | `?sku1=GH23&sku2=UT66&sku3=RW87`                |
| カテゴリ          | `{join(items, i, "cat{i}={i.cat}", "&", "?")}`         | `?cat1=Watches&cat2=Shoes&cat3=Hats`            |
| 数量            | `{join(items, i, "qty{i}={i.qty}", "&", "?")}`         | `?qty1=3&qty2=4&qty3=11`                        |
| 金額            | `{join(items, i, "amt{i}={i.amt}", "&", "?")}`         | `?amt1=2.92&amt2=99.32&amt3=4.99`               |
| カート金額         | `{join(items, i, "cartamt{i}={i.cartamt}", "&", "?")}` | `?cartamt1=50.01&cartamt2=23.89&cartamt3=34.00` |
| リベート          | `{join(items, i, "rbt{i}={i.rbt}", "&", "?")}`         | `?rbt1=1.00&rbt2=5.00&rbt3=1.50`                |
| 名前            | `{join(items, i, "name{i}={i.name}", "&", "?")}`       | `?name1=1.00&name2=5.00&name3=1.50`             |
| {% endtab %}  |                                                        |                                                 |
| {% endtabs %} |                                                        |                                                 |

### 理由コード

&#x20;`{ReasonCode}`  パラメーターは、次のいずれかの値を返します。

<table data-header-hidden="false" data-header-sticky><thead><tr><th>理由コード</th><th>説明</th></tr></thead><tbody><tr><td><code>WON</code></td><td>パートナーはコンバージョンのクレジットを獲得しました。</td></tr><tr><td><code>LOST_TO_OTHER_PARTNER</code></td><td>プログラムのアトリビューションルール（ラストクリック、ファーストクリック、優先度の低いクレジットグループなど）に基づき、別のパートナーがクレジットを獲得しました。</td></tr><tr><td><code>LOST_TO_OVERRIDE</code></td><td>クレジットを獲得したパートナーには、クリック ID、プロモーションコード、発信者 ID、またはブランドが投稿したリファラーなど、優先されるコンバージョンとの直接的な一致がありました。</td></tr><tr><td><code>LOST_TO_EXISTING_RELATIONSHIP</code></td><td>プログラムのリピート購入ルールに基づき、顧客はすでに別のパートナーに帰属していました。</td></tr><tr><td><code>IMPRESSION_NOT_CREDITED</code></td><td>パートナーのタッチポイントはビュースルーインプレッションでしたが、クレジット獲得の条件を満たしませんでした。</td></tr><tr><td><code>STAND_DOWN_POLICY</code></td><td>パートナーのタッチポイントが別のパートナーのタッチポイントに近すぎるタイミングで発生したため、プログラムのスタンドダウンポリシーによって優先度が下げられました。</td></tr><tr><td><code>OUTSIDE_ATTRIBUTION_WINDOW</code></td><td>パートナーのクリックまたはインプレッションがコンバージョンよりもかなり前に発生したため、条件を満たしませんでした。</td></tr><tr><td><code>OUTSIDE_REPEAT_PURCHASE_WINDOW</code></td><td>パートナーは顧客の初回購入を促しましたが、このコンバージョンはプログラムのリピート購入期間が終了した後に発生しました。</td></tr><tr><td><code>RECURRENCE_LIMIT_REACHED</code></td><td>パートナーのクリックは、プログラムで許可されているコンバージョンの上限数にすでに達しています。再びクレジットを獲得するには、同じ顧客から新たにクリックを獲得する必要があります。</td></tr><tr><td><code>CALL_RULE_NOT_MET</code></td><td>通話が、通話時間、1日の時間帯、または通話の完了に関するプログラムの電話ルールを満たしませんでした。</td></tr><tr><td><code>DUPLICATE_CONVERSION</code></td><td>コンバージョンはすでにクレジットが付与されているか、重複しています。</td></tr><tr><td><code>NOT_ELIGIBLE_FOR_PROGRAM</code></td><td>コンバージョン発生時点で、パートナーのアカウント、契約、またはネットワーク設定がプログラムの参加条件を満たしていませんでした。</td></tr><tr><td><code>BLOCKED_BY_PROGRAM_POLICY</code></td><td>プロモーションコードの制限や、ブランドが設定したソースフィルターなど、プログラムのポリシーによってコンバージョンがブロックされました。</td></tr><tr><td><code>OTHER</code></td><td>パートナーは内部的な理由によりクレジットを獲得できませんでした。</td></tr></tbody></table>


---

# 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/set-up-postbacks-for-partners.md?ask=<question>&goal=<user_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.
