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

アクションライフサイクルのポストバックには、主に2つのタイプがあります。 **グローバルレベル** は、アカウント全体に対するポストバックを作成し、 **イベントレベル** は、特定のイベントタイプに対するポストバックを作成します。設定プロセスの詳細を確認するには、ニーズに最も適したものを選択してください。

{% hint style="warning" %}
**警告:** グローバルレベルのポストバックでは、変更やリバーサルなどの「標準外」のイベントが発生するたびに、ポストバックを受信するはずです。イベントレベルのポストバックでは、標準外のアクションライフサイクルイベントは発火しないことに注意してください。
{% endhint %}

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

<details>

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

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

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

1. 上部のナビゲーションバーから、次を選択します ![](/files/d5a72930acb494115f0761c5714f7896c3faf424) **\[ユーザープロフィール] → 設定**.
2. 「 *技術情報*」の下で、次を選択します **イベント通知**.
3. 「 *アクションライフサイクルイベント*」の下で、次を選択します ![](/files/94cdbbead4611d45ff966409250aa4f1f8a98802) **\[編集]**.
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="/files/f04562fe8d17e1262c5f77163aa0844645d55672" 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="/files/ccd5c9be35e837e92fb6e8e61983d73282b59777" alt=""><figcaption></figcaption></figure></div>

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

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

ポストバックURLは、 `MyParam` から取得した値でパラメータを入力します `SharedId`.

</details>

<details>

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

このセクションでは、アクションを促進したときに追跡する特定のイベントタイプに対するポストバックを作成する方法について説明します。受信するポストバックのイベントタイプをより選択的にしたい場合は、イベントレベルのアクションライフサイクルポストバックを設定する必要があります。

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

1. 上部のナビゲーションバーから、次を選択します **発見 → マイブランド**.
2. テストしたいポストバックを所有しているブランドのカードを選択します。
3. ブランド名の下で、次を選択します ![](/files/4927eb1e5c4fa3b3dc6c7e11a5ab7eb37b71050d) **\[その他]** → **トラッキング連携**.
4. ページ右上付近で、次を選択します **ポストバックを追加**.
5. アクションライフサイクルポストバックを設定したいイベントタイプ（旧 *アクショントラッカー*）を選択します。
6. サーバーのURLを入力します。これは、impact.comがポストバックを送信するURLです。
7. 希望するHTTPメソッドを選択します。
   * 「 **POST**」を選択した場合は、次にリクエストのボディを入力し、 **ボディ形式**。以下は、JSON形式で各データポイントをマッピングする方法の例です。各キーと値のペアのキーはご自身のシステム設定に基づくものである必要があり、値にはimpact.comが提供する対応するデータポイントを選択して中括弧 { } 内に入力します。

     <div data-with-frame="true"><figure><img src="/files/6647e733c96a12d39c838439e1de79aa2fc3f44a" 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="/files/ccd5c9be35e837e92fb6e8e61983d73282b59777" 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は自動的に配信を再試行します。impact.comは失敗したポストバックを合計で最大15回再試行します。impact.comは、HTTPレスポンスが `400` から `500`までの場合、最初の3回の再試行をスキップします。完全な再試行スケジュールとトラブルシューティングの詳細については、次を参照してください [ポストバックURLのテストとトラブルシューティング](/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. 上部のナビゲーションバーから、次を選択します **発見 → マイブランド**.
2. テストしたいポストバックを所有しているブランドのカードを選択します。
3. ブランド名の下で、次を選択します ![](/files/4927eb1e5c4fa3b3dc6c7e11a5ab7eb37b71050d) **その他** → **トラッキング連携**.
4. 「 *ポストバック* 」セクションから、次を選択します ![](/files/abddecb8ce63e889572eca17db0d705cd899c19f) **\[下矢印] アクション**、次に **テストを開始**.
5. ポストバックのURLが正しいことを確認し、次に **テストを開始**.

</details>

<details>

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

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

1. 上部のナビゲーションバーから、次を選択します **コンテンツ → アセット**.
2. 広告を選択します。
3. 広告名の下で、次を選択します **トラッキングリンクを取得**.
4. 選択します ![](/files/b277637fec1af52d85e46f0b1cccd46b8b0971a6) **\[オンに切り替え]** **トラッキングパラメータ**.
5. 入力します **Sub ID** または **Shared 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>

<details>

<summary>エラーのトラブルシューティング</summary>

| エラー             | 説明                                                                                                                                                 |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| 必須パラメータが不足しています | お使いのサーバーは、変数ではなく値を期待している可能性があります。Postback URLを修正してテスト値（例:  `{SubId1}`の代わりに"12345678"）を渡し、ハードコードされた値を受け入れるか確認してください。                                |
| 大文字と小文字を区別する変数  | 動的変数は大文字と小文字を区別し、正確である必要があります。つまり、 `{SubId1}` は、 `{subid1}`と同じではありません。変数が正しい大文字・小文字を反映していることを再確認してください。                                            |
| アクセス拒否          | ほとんどのポストバックサーバーには、動的変数と一緒に渡す必要があるセキュリティトークンまたは値があります。必要なトークンまたはサーバーにアクセスするためのセキュリティ値については、ウェブサイトの技術チームと連携するか（またはウェブサイトプロバイダーのドキュメントを参照して）確認してください。 |

</details>

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


---

# Agent Instructions: 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:

```
GET https://help.impact.com/partner/ja/nitsuitebitaidesuka/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
