> 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/partner/ja/nitsuitebitaidesuka/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).

# アクションライフサイクルポストバックを設定する

アクションライフサイクルのポストバックには、主に2種類あります。 **アカウント全体レベル** はアカウント全体のポストバックを作成し、 **イベントレベル** は特定のイベントタイプのポストバックを作成します。設定方法について詳しく知るには、ニーズに最も合ったものを選択してください。

{% hint style="warning" %}
**警告：** アカウント全体レベルのポストバックでは、変更や取り消しなどの「標準外」イベントが発生するたびに、ポストバックを受信する必要があります。イベントレベルのポストバックでは、標準外のアクションライフサイクルイベントは発生しないことに注意してください。
{% endhint %}

## アクションライフサイクルのポストバックを設定する

<details>

<summary>アカウント全体レベルのアクションライフサイクルポストバックを設定する</summary>

このセクションでは、アカウント全体のポストバックを一度に作成する方法について説明します。これらのポストバックを受信して処理できるシステムが1つしかないパートナーや、すべての標準外イベントについて通知を受け取りたいパートナーは、アカウント全体レベルのアクションライフサイクルポストバックを設定してください。

{% hint style="success" %}
**注：** ポストバックを受信するイベントタイプをより細かく選択したい場合は、以下のセクションを参照して *イベントレベルのアクションライフサイクルポストバック*.
{% endhint %}

1. 上部のナビゲーションバーで ![](https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[ユーザープロフィール] → 設定**.
2. の下で *技術*を選択し、 [**イベント通知**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml).
3. の横にある *アクションライフサイクルイベント*を選択し、 ![](https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[編集]**.
4. サーバーのURLを入力します。impact.comがポストバックを送信する先のURLです。
5. 希望するHTTPメソッドを選択します。
   * impact.comで [使用可能なボディパラメーター](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * を確認できます。 **POST**を選択した場合は、リクエスト本文を入力し、 **本文形式**を選択します。以下は、JSON形式で各データポイントを割り当てる方法の例です。各キーと値のペアのキーには、ご利用のシステムの設定に基づいた値を指定し、値にはimpact.comが提供する対応するデータポイントを選んで、角括弧で囲んで入力します。 `{ }`.

     <div data-with-frame="true"><figure><img src="https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FFNWShmuaxZ5VpP14AlWv%2FScreenshot%202026-05-23%20at%2010.58.15.png?alt=media&amp;token=00e80c87-6c12-4f6d-8ca5-3885c9002533" alt="" width="563"><figcaption></figcaption></figure></div>
   * 必要な値が見つからない場合は、アカウントマネージャー（または [サポートに問い合わせ](https://app.impact.com/support/portal.ihtml)).
6. てください）。 **アクションライフサイクルイベント**を選択します。これらの設定は任意です。
   * を入力します。 **HTTPヘッダー**を入力します。複数のペアが必要な場合は、セミコロンで区切ってください。
   * を入力します。 **最小遅延** を指定します。これは、標準外イベントの発生からポストバックが生成され、システムに送信されるまでの時間です。
   * impact.comがシステムに対して1秒あたりに行える **最大リクエスト数** の制限値を入力します。
   * ポストバックに対する **成功レスポンス** として返す内容を入力します。
   * ポストバックに対する **エラーレスポンス** として返す内容を入力します。
7. \[保存] **保存**.

グローバルレベルのポストバックを設定すると、標準外のアクションを実行したブランドにかかわらず、標準外イベントが発生するたびにシステムがポストバックを受信するようになります。新しいポストバック設定をテストする方法については、以下の *アクションライフサイクルのポストバックをテストする* セクションをご覧ください。

### 動的値の例

トラッキングリンクに動的変数を設定している場合は、自社サーバーへのポストバックURLを設定すると、アクションの発生時に通知を受け取り、そのアクションに関連付けられた動的に入力された値を取得できます。

この例では、 `SharedId` の値（ブランドと共有する値）をポストバックのパラメーター（`MyParam`）に渡す方法を示します。ブランドによっては、この設定が必要な場合があります。

<div data-with-frame="true"><figure><img src="https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

ポストバックURLは次のようになります。

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

ポストバックURLでは、 `MyParam` パラメーターに、 `SharedId`.

</details>

<details>

<summary>イベントレベルのアクションライフサイクルのポストバックを設定する</summary>

このセクションでは、アクションの発生を追跡する特定のイベントタイプのポストバックを作成する方法について説明します。ポストバックを受信するイベントタイプを絞り込む場合は、イベントレベルのアクションライフサイクルのポストバックを設定してください。

{% hint style="success" %}
**注：** グローバルレベルのアクションライフサイクルのポストバックを設定している場合、イベントレベルのポストバックを設定する必要はありません。
{% endhint %}

1. 上部のナビゲーションバーから、 **Discover →** [**ブランド**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. テストするポストバックを所有するブランドのカードを選択します。
3. ブランド名の下にある ![](https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More]** → **トラッキング連携**.
4. ページの右上付近にある **ポストバックを追加**.
5. アクションライフサイクルのポストバックを設定するイベントタイプ（以前の *アクショントラッカー*）を選択します。
6. サーバーのURLを入力します。impact.comがポストバックを送信する先のURLです。
7. 希望するHTTPメソッドを選択します。
   * を確認できます。 **POST**を選択した場合は、リクエスト本文を入力し、 **本文形式**。以下は、JSON形式で各データポイントをマッピングする例です。各キーと値のペアのキーには自社システムの設定に基づく値を指定し、値にはimpact.comが提供する対応するデータポイントを入力し、中括弧 { } で囲みます。

     <div data-with-frame="true"><figure><img src="https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FwVvNFu7iuPM0eAwyMk6L%2FScreenshot%202026-05-23%20at%2013.07.16.png?alt=media&amp;token=f33b091a-cead-4e1b-80f2-0ebd97810835" alt="" width="563"><figcaption></figcaption></figure></div>
   * impact.comの [利用可能な本文パラメーター](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * 必要な値が見つからない場合は、アカウントマネージャー（または [サポートに問い合わせ](https://app.impact.com/support/portal.ihtml)).
8. を確認してください。 **詳細設定を表示**を選択します。これらの設定は任意です。
   * を入力します。 **最小遅延** を指定します。これは、標準外イベントの発生からポストバックが生成され、システムに送信されるまでの時間です。
   * impact.comがシステムに対して1秒あたりに行える **最大リクエスト数** の制限値を入力します。
   * ポストバックに対する **成功レスポンス** として返す内容を入力します。
   * ポストバックに対する **エラーレスポンス** として返す内容を入力します。
9. \[保存] **保存**.

イベントレベルのポストバックを設定すると、システムは *手順5*で選択したイベントタイプのポストバックを受信するようになります。新しいポストバック設定をテストする方法については、以下の *アクションライフサイクルのポストバックをテストする* セクションをご覧ください。

### 動的値の例

トラッキングリンクに動的変数を設定している場合は、自社サーバーへのポストバックURLを設定すると、アクションの発生時に通知を受け取り、そのアクションに関連付けられた動的に入力された値を取得できます。

この例では、 `SharedId` の値（ブランドと共有する値）をポストバックのパラメーター（`MyParam`）に渡す方法を示します。ブランドによっては、この設定が必要な場合があります。

<div data-with-frame="true"><figure><img src="https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

ポストバックURLは次のようになります。

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

ポストバックURLでは、 `MyParam` パラメーターに、 `SharedId`.

</details>

## アクションライフサイクルのポストバックをテストする

アクションライフサイクルのポストバックを設定したら、適用レベルにかかわらず、テストしてください。impact.comでテストポストバックを実行する（イベントレベルのポストバックのみ）か、コンバージョンを発生させてテストできます。

impact.comが送信先URLにポストバックを送信した際に失敗すると、impact.comは自動的に再送します。失敗したポストバックは合計15回まで再送されます。HTTPレスポンスが `400` から `500`の場合、impact.comは最初の3回の再送をスキップします。再送スケジュールの全容とトラブルシューティングの詳細については、 [ポストバックURLのテストとトラブルシューティング](https://help.impact.com/partner/ja/nitsuitebitaidesuka/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).

<details>

<summary>impact.comでテスト用ポストバックを実行する</summary>

イベントレベルのポストバックを設定している場合は、impact.comアカウント内でテストできます。

1. 上部のナビゲーションバーから、 **Discover →** [**ブランド**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. テストするポストバックを所有するブランドのカードを選択します。
3. ブランド名の下にある ![](https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **その他** → **トラッキング連携**.
4. 「 *ポストバック* 」セクションで ![](https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[下向き矢印] アクション**を選択し、次に **テストを開始**.
5. ポストバックのURLが正しいことを確認し、 **テストを開始**.

</details>

<details>

<summary>テストコンバージョンを作成する</summary>

このテストはimpact.comのウェブアプリでは実行されません。代わりに、一般的なユーザージャーニーに沿ったエンドツーエンドのテストを実行します。テストを実施することを、提携先のブランドに必ず伝えてください。

1. 上部のナビゲーションバーで **管理 →** [**ブランドクリエイティブ**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all).
2. 広告を選択します。
3. 広告名の下にある **トラッキングリンクを取得**.
4. 次を選択します。 ![](https://3659882269-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FNb1O82vHF1ZWPG3qRZj3%2FToggle.svg?alt=media\&token=58221b77-b655-4ce3-bfba-64a50f3f60db) **\[オンに切り替え]** **トラッキングパラメーター**.
5. 「 **サブID** または **共有ID** を必要に応じて入力します。各フィールドには少なくとも1つ入力する必要があります。
   * これらのフィールドにすでに値が入力されている場合は、この手順をスキップしてください。
6. 必要に応じて、ドロップダウンリストから **プロパティ** を選択します。
7. \[保存] **保存**.
8. 「 **トラッキングリンクをコピー**.
9. **リンクを** 新しいブラウザーウィンドウに貼り付けます。
10. アクションを完了します。
11. 約15分後、このテストアクションによって生成されたポストバックがシステムに届いているか確認します。
    * 通常、アクションの処理には15分ほどかかります。
    * この新しい保留中のアクションは、 [保留中のアクション](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) 画面でも確認できます。画面にアクションが表示されているのにポストバックが届いていない場合は、ポストバックの設定をもう一度確認してください。 *保留中のアクション* 画面でも確認できます。画面にアクションが表示されているのにポストバックが届いていない場合は、ポストバックの設定をもう一度確認してください。
12. ブランドにアクションを取り消してもらいます。
13. この取り消しによって生成されたポストバックがシステムに届いているか確認します。
    * 取り消されたアクションが [取り消し済みアクション](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) 画面に表示されているのにポストバックが届いていない場合は、ポストバックの設定をもう一度確認してください。

</details>

### エラーのトラブルシューティング

以下のリファレンス表を使って、アクションのライフサイクルポストバックの設定中によく発生する問題を特定し、解決してください。

<table><thead><tr><th width="199.859375">エラー</th><th>説明</th></tr></thead><tbody><tr><td>必須パラメーターがありません</td><td>サーバーが変数ではなく値を想定している可能性があります。ポストバックURLを変更して、テスト値（たとえば、{SubId1} の代わりに "12345678"）を渡し、ハードコードした値が受け入れられるか確認してください。 <code>{SubId1}</code>）を渡し、ハードコードした値が受け入れられるか確認してください。</td></tr><tr><td>大文字と小文字が区別される変数</td><td>動的変数では大文字と小文字が区別されるため、正確に指定する必要があります。つまり、 <code>{SubId1}</code> は <code>{subid1}</code>と同じではありません。変数の大文字と小文字が正しく指定されているか、もう一度確認してください。</td></tr><tr><td>アクセスが拒否されました</td><td>ほとんどのポストバックサーバーでは、動的変数とともに渡す必要があるセキュリティトークンまたは値があります。サーバーへのアクセスに必要なトークンやセキュリティ値について、ウェブサイトの技術チームに問い合わせるか、ウェブサイトプロバイダーのドキュメントを参照してください。</td></tr></tbody></table>

{% hint style="success" icon="circle-info" %}
**注:** ポストバックの設定に問題が見つからないにもかかわらず、ポストバックを受信できない場合は、 [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml)。impact.comでは、ポストバックが生成されているか、各ポストバックのレスポンスコード、およびポストバックごとの本文を確認できます。この情報は、設定のデバッグに役立つ場合があります。
{% endhint %}


---

# 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/partner/ja/nitsuitebitaidesuka/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.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.
