> 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つのタイプがあります。 **グローバルレベル** アカウント全体に対するポストバックを作成し、】【t\_3e764419】, **イベントレベル** 特定のイベントタイプに対するポストバックを作成します。設定プロセスの詳細については、ニーズに最も適したものを選択してください。
{% hint style="warning" %}
**警告:** グローバルレベルのポストバックでは、変更や取消などの「標準外」イベントが発生するたびにポストバックを受信するはずです。イベントレベルのポストバックでは、標準外のアクションライフサイクルイベントは発火しないことに注意してください。
{% endhint %}
#### アクションライフサイクルポストバックを設定する
グローバルレベルのアクションライフサイクルポストバックを設定する
このセクションでは、アカウント全体に対するポストバックを一度に作成する方法を説明します。これらのポストバックを受信・処理できるシステムが1つしかないパートナー、またはすべての標準外イベントの通知を希望するパートナーは、グローバルレベルのアクションライフサイクルポストバックを設定してください。
{% hint style="info" %}
**注：** ポストバックを受信するイベントタイプをより選択したい場合は、以下のセクションを参照して設定してください *イベントレベルのアクションライフサイクルポストバック*.
{% endhint %}
1. 上部のナビゲーションバーから、  **\[ユーザープロフィール] → 設定**.
2. 〜の下で *技術*」の下で、 **イベント通知**.
3. の横に *アクションライフサイクルイベント*」の下で、  **\[編集]**.
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が提供する対応するデータポイントを選択して角括弧で入力する必要があります `{ }`.
* 必要な値が見つかりませんか？アカウントマネージャーにお問い合わせください（または [サポートにお問い合わせください](https://app.impact.com/support/portal.ihtml)).
6. 選択 **アクションライフサイクルイベント**。これらの設定は任意です。
* 次を入力します： **HTTPヘッダー**。複数のペアが必要な場合は、セミコロンで区切ってください。
* 次を入力します： **最小遅延時間** ：標準外イベントの発生から、ポストバックが生成されてシステムに送信されるまでの間隔です。
* 次のレート制限を入力します： **最大リクエスト数** impact.comが1秒あたりにシステムへ送信できるリクエスト数です。
* 次に指定する内容を入力します： **成功レスポンス** ポストバックに対するものです。
* 次に指定する内容を入力します： **エラーレスポンス** ポストバックに対するものです。
7. 選択 **保存**.
グローバルレベルのポストバックを設定したので、標準外のアクションを実行するブランドにかかわらず、標準外イベントが発生するたびにシステムでポストバックの受信が開始されるはずです。新しいポストバック設定のテスト方法については、次を参照してください： *アクションライフサイクルポストバックをテストする* 以下のセクションを参照してください。
**動的値の例**
トラッキングリンクに動的変数を設定している場合は、アクション発生時に通知を受け、アクションに関連付けられた動的に設定された値を取得するため、自社サーバーへのPostback URLを設定できます。
この例では、次を渡す方法を示します： `SharedId` 値（ブランドと共有する値）をポストバック内のパラメータ（`MyParam`）に渡します。一部のブランドでは、この設定が必要になる場合があります。
ポストバックURLは次のようになります：
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
ポストバックURLは、 `MyParam` パラメータに、次から取得した値を設定します： `SharedId`.
イベントレベルのアクションライフサイクルポストバックを設定する
このセクションでは、アクションを促進した際に追跡される特定のイベントタイプに対するポストバックを作成する方法を説明します。ポストバックを受信するイベントタイプをより選択したい場合は、イベントレベルのアクションライフサイクルポストバックを設定してください。
{% hint style="info" %}
**注：** グローバルレベルのアクションライフサイクルポストバックを設定した場合、イベントレベルのものを設定する必要はありません。
{% endhint %}
1. 上部のナビゲーションバーから、 **Discover → My Brands**.
2. テストするポストバックを所有するブランドのカードを選択します。
3. ブランド名の下で、次を選択します  **\[その他]** → **トラッキング統合**.
4. ページの右上付近で、次を選択します： **ポストバックを追加**.
5. アクションライフサイクルポストバックを設定するイベントタイプ（以前の *アクショントラッカー*）を選択します。
6. サーバーのURLを入力します。これは、impact.comがポストバックを送信するURLです。
7. 希望するHTTPメソッドを選択します。
* 次を選択した場合 **POST**の場合は、リクエスト本文を入力し、 **本文形式**。以下は、JSON形式で各データポイントをマッピングする例です。各キーと値のペアのキーは、自社システムの設定に基づくものにし、値にはimpact.comが提供する対応するデータポイントを選択して中括弧 { } で入力する必要があります。
* 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*。新しいポストバック設定のテスト方法については、次を参照してください： *アクションライフサイクルポストバックをテストする* 以下のセクションを参照してください。
**動的値の例**
トラッキングリンクに動的変数を設定している場合は、アクション発生時に通知を受け、アクションに関連付けられた動的に設定された値を取得するため、自社サーバーへのPostback URLを設定できます。
この例では、次を渡す方法を示します： `SharedId` 値（ブランドと共有する値）をポストバック内のパラメータ（`MyParam`）に渡します。一部のブランドでは、この設定が必要になる場合があります。
ポストバックURLは次のようになります：
`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`
ポストバックURLは、 `MyParam` パラメータに、次から取得した値を設定します： `SharedId`.
#### アクションライフサイクルポストバックをテストする
アクションライフサイクルポストバックを設定したら、適用レベルにかかわらずテストする必要があります。impact.comでテストポストバックを実行する（イベントレベルのポストバックでのみ利用可能）か、コンバージョンを実行できます。
impact.comが送信先URLにポストする際にポストバックが失敗した場合、impact.comは自動的に配信を再試行します。impact.comは失敗したポストバックを合計15回まで再試行します。impact.comは、次からのHTTPレスポンスについては最初の3回の再試行をスキップします `400` 〜へ `500`。再試行スケジュールの全容とトラブルシューティングの詳細については、次を参照してください： [Postback URLをテストしてトラブルシューティングする](/partner/ja/nitsuitebitaidesuka/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).
impact.comでテストポストバックを実行する
イベントレベルのポストバックを設定した場合は、impact.comアカウント内でテストできます。
1. 上部のナビゲーションバーから、 **Discover → My Brands**.
2. テストするポストバックを所有するブランドのカードを選択します。
3. ブランド名の下で、次を選択します  **その他** → **トラッキング統合**.
4. 〜の *ポストバック* セクションで、次を選択してください：  **\[下矢印] アクション**を選択し、次に **テストを起動**.
5. ポストバックのURLが正しいことを確認し、次を選択します： **テストを開始**.
テストコンバージョンを作成する
このテストはimpact.comのウェブアプリでは実行されません。代わりに、一般的なユーザージャーニーに従うエンドツーエンドテストを実行します。テストを実施することを、提携しているブランドに必ず通知してください。
1. 上部のナビゲーションバーから、 **コンテンツ → アセット**.
2. 広告を選択します。
3. 広告名の下で、次を選択します： **トラッキングリンクを取得**.
4. 選択  **\[オンに切り替え]** **トラッキングパラメータ**.
5. Enter **サブ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) 画面に表示されているのにポストバックを受信していない場合は、ポストバック設定を再確認してください。
エラーをトラブルシューティングする
| エラー | 説明 |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 必須パラメータがありません | サーバーは変数ではなく値を想定している可能性があります。Postback URLを変更してテスト値（例： `{SubId1}`ではなく「12345678」）を渡し、ハードコードされた値を受け入れるか確認してください。 |
| 大文字と小文字を区別する変数 | 動的変数は大文字と小文字を区別し、完全に一致する必要があります。つまり、 `{SubId1}` は、次と同じではありません： `{subid1}`。変数で大文字と小文字が正しく区別されていることを再確認してください。 |
| アクセス拒否 | ほとんどのPostbackサーバーには、動的変数とともに渡す必要があるセキュリティトークンまたは値があります。サーバーへのアクセスに必要なトークンまたはセキュリティ値については、ウェブサイトの技術チームと連携するか、ウェブサイトプロバイダーのドキュメントを参照してください。 |
{% 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 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/partner/ja/nitsuitebitaidesuka/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.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.