> 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 %} ## アクションライフサイクルのポストバックを設定する
グローバルレベルのアクションライフサイクルポストバックを設定する このセクションでは、アカウント全体に対するポストバックを一度に作成する方法を説明します。これらのポストバックを受信して処理できるシステムが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 が提供する対応するデータポイントとして選択したものを角括弧で入力してください `{ }`.
* 必要な値が見当たりませんか？アカウントマネージャーに連絡するか（または [サポートにお問い合わせください](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="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) **\[その他]** → **トラッキング連携**. 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] →** [**ブランド**](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が正しいことを確認し、次に **テストを開始**.
テストコンバージョンを作成する このテストは impact.com のWebアプリでは実行されません。代わりに、典型的なユーザージャーニーに沿ったエンドツーエンドテストを実施します。テストを行うことを提携先ブランドに必ず通知してください。 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%2FEv341AdIiPndQSb7uGMI%2FToggle%20on.svg?alt=media\&token=4ae8972d-c510-4ee2-adc5-e7170981650b) **\[オンに切り替え]** **トラッキングパラメータ**. 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) 画面に表示されているのにポストバックを受信していない場合は、ポストバックの設定を再確認してください。
### エラーをトラブルシューティングする 以下の参照表を使用して、アクションライフサイクルのポストバック設定時に発生する一般的な問題を特定し、解決してください。
エラー説明
必須パラメータがありませんサーバーは変数ではなく値を期待している可能性があります。Postback URLを変更して、テスト値（例：「12345678」を、ではなく {SubId1}）として渡し、固定値を受け入れるか確認してください。
大文字・小文字を区別する変数動的変数は大文字・小文字を区別し、正確である必要があります。つまり、 {SubId1} は {subid1}とは同じではありません。変数が正しい大文字・小文字になっているか再確認してください。
アクセスが拒否されましたほとんどのポストバックサーバーには、動的変数と一緒に渡す必要があるセキュリティトークンまたは値があります。サーバーにアクセスするために必要なトークンまたはセキュリティ値を確認するには、Webサイトの技術チームと協力するか（またはWebサイト提供元のドキュメントを参照してください）。
{% 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=&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.