OpenAI
このページは機械翻訳されています。元の英語の記事を表示。

ChatGPT 広告のコンバージョントラッキングのトラブルシューティング

イベントが見つからない、リクエストが失敗する、コンバージョンレポートに差異がある場合の対処方法をご案内します。

更新日: 6 days ago

概要

イベントが見つからない、リクエストが失敗する、広告マネージャーの数値と自社の記録が一致しない場合は、このガイドをご利用ください。まず、完了した購入、送信されたリード情報、その他のアクションから 1 件を選んでください。何がいつ起きたかを記録し、以下から該当する質問を選んでください。

イベントは、購入などのアクションを記録するものです。ピクセルは訪問者のブラウザーから、コンバージョン API(CAPI)はお客様のサーバーからイベントを送信します。広告マネージャーは、これらのイベントをデータソースに収集します。アトリビューションは、どの広告の成果として計上するかを決める仕組みです。アトリビューション期間は、広告への接触後、アクションが成果の対象となるまでの期間を定めます。

よくある質問

1. 最初に確認すること

測定したいアクション、その送信元、使用する広告アカウントとピクセル ID を確認してください。構成によって、ピクセル、CAPI、パートナー連携、またはこれらの組み合わせを使用します。ブラウザーのピクセルを設置していなくても、CAPI にはピクセル ID が必要です。

初めて設定する場合は、コンバージョン測定とコンバージョントラッキングをご覧ください。開発者の方は、ピクセル、CAPI、対応イベントのガイドを参照できます。CAPI のリクエストとキーは、サーバー側で扱ってください。

パートナーが連携を管理している場合は、測定パートナーの設定ガイドまたはモバイル測定パートナーの設定ガイドをご利用ください。HubSpot との接続については、HubSpot での ChatGPT 広告の設定をご覧ください。

設定済みの場合は、各段階を確認してください。

  • アクションによってイベントリクエストが送信されましたか?

  • リクエストでエラーが返されましたか、それとも受け付けられましたか?

  • 正しいデータソースでイベントが受信されたことを確認できますか?

  • キャンペーンレポートで、そのイベントは広告の成果として計上されましたか?

2. ピクセルを設置済みの場合購入やリードが表示されない理由

ピクセルが読み込まれても、必要な購入イベントやリードイベントが送信されていない場合があります。完了したアクションを 1 件選び、開発者に以下の確認を依頼してください。

  • イベント名、ピクセル ID、イベントを送信するページまたはコールバックを確認してください。ページビューは購入完了を意味しません。

  • タグマネージャーで読み込む場合も含め、イベントを送信する前にピクセルが初期化されていることを確認してください。

  • ブラウザーのコンソールとネットワークリクエストを確認してください。タグマネージャーの「発火済み」というメッセージだけでは、イベントが送信されたことは確認できません。ピクセルのデバッグモードが役立ちます。

  • 訪問者の同意の選択、ブラウザーによるブロック、サイトのセキュリティポリシーによってリクエストが阻止されていないか確認してください。

  • ログイン後のページ、決済ページ、予約サイト、リダイレクト、埋め込みフォームを確認してください。ランディングページでピクセルが動作していても、他の場所でトラッキングできているとは限りません。

リクエストが送信されていない場合は、まずその段階の問題を修正してください。レポートへの反映を待っても解決しません。別の連携を追加する前に、ピクセルのトラブルシューティングガイドをご利用ください。

3. イベントの拒否、タイムアウト、サーバーエラーへの対処法

レスポンスコード、正確なエラー内容、リクエスト時刻、イベント ID を保存してください。開発者に、イベント形式、ピクセル ID、キーの確認を依頼してください。CAPI のイベントリクエストには、同じ広告アカウントのコンバージョン API キーを使用します。設定、管理、レポートのリクエストには、それとは別の広告主 API キーを使用します。API キーをサポートに送信しないでください。

CAPI のバッチでは、無効なイベントが 1 件あるだけで、バッチ全体が失敗することがあります。

CAPI では、アクションが実際に発生した時刻を Unix 時間のミリ秒単位で指定する必要があります。イベントの時刻は過去 7 日以内で、未来の場合は現在から 10 分以内である必要があります。この送信時の制限は、アトリビューション期間とは別のものです。検証を通過させるために、古いイベントの時刻を変更しないでください。

タイムアウトやサーバーエラーが発生すると、イベントが届いたかどうか判断できない場合があります。元のリクエストと、受信記録があればその内容を確認してください。同じアクションの送信を再試行する場合は、元のイベント ID とタイムスタンプを維持してください。新しい ID を使うと、別のアクションとみなされる可能性があります。

拒否された場合やリクエストの失敗が続く場合は、速やかに調査してください。レポートへの反映時間の目安である 24~48 時間は、これらのエラーには当てはまりません。リクエストの要件については、コンバージョン APIをご覧ください。

4. イベントの受け付けを確認できた場合レポートに表示されない理由

イベントが受け付けられても、広告の成果として計上されたとは限りません。レスポンスから何が確認できるか、またリクエストで正しいデータソースを使用したかを確認してください。CAPI で validate_only を true に設定すると、イベントは検証されますが保存されません。

新しいイベントについては、開発者が最近のイベントを確認できます(利用可能な場合)。ここに表示されるのは最近のサンプルであり、全履歴やアトリビューションの結果ではありません。

受信を確認できない場合は、元のレスポンスとイベントのサンプルを添えてサポートにお問い合わせください。どの確認を完了したかをお知らせください。事前に原因を突き止める必要はありません。

受信を確認できた場合は、質問 5 に進んでください。キャンペーンレポートに変化がないという理由だけで、新しい ID を使ってイベントを再送信しないでください。

広告の成果と判定されたコンバージョンが表示されるまで、約 24~48 時間かかる場合があります。また、処理中は直近の合計値が変わることがあります。この時間の目安は、受け付けられたすべてのイベントが表示されることを保証するものでも、受信されたことを確認するものでもありません。成果の測定をご覧ください。

5. イベントを受信できている場合キャンペーンのコンバージョン数が 0 のままの理由

連携を変更する前に、以下を確認してください。

  • 使用するデータソースは正しいアカウントに接続されていますか?

  • 送信しているイベントは、キャンペーンのコンバージョン設定と一致していますか?カスタムイベントの場合は、カスタムタイプと正確なイベント名を確認してください。表示ラベルの一致だけでは不十分です。

  • 確認対象のアクティビティが発生する前に、正しいコンバージョンがキャンペーンに関連付けられていましたか?

  • そのアクションは、アトリビューション設定の条件を満たす広告のクリックや表示の後に発生しましたか?

  • 正しいキャンペーン、イベントの列、日付、レポートの時間基準で表示していますか?

マッチング情報はイベントと広告を結び付けるのに役立ちますが、成果としての計上を保証するものではありません。実際の OpenAI クリック参照値である oppref を訪問中は保持し、取得できる場合はサーバーイベントに含めてください。参照値を捏造したり、別の訪問者の参照値を使用したりしないでください。

ブラウザーイベントとサーバーイベントは、それぞれ個別に確認してください。ピクセルで取得できる参照値や顧客情報のフィールドが、サーバーイベントには含まれていない場合があります。

コンバージョン最適化キャンペーンで選択した目標は、作成後に変更できません。別の目標を使用するには、新しいキャンペーンを作成してください。カスタムイベントは最適化の目標に設定できません。コンバージョン最適化キャンペーンをご覧ください。

設定の不一致を修正したら、条件を満たす新しいアクティビティを確認してください。設定変更によって過去のレポートも修正されるとは限りません。マッチングのルールについては、コンバージョン測定をご覧ください。

6. 広告マネージャー、分析ツール、CRM の数値が一致しない理由

同じアクションとレポートの集計ルールで比較してください。CRM がすべての購入を数える一方、広告レポートはそのプラットフォームの成果と判定された購入を数えます。同じ購入でも、プラットフォームによって成果の帰属先が異なる場合があります。

広告マネージャーでは、ビュースルーのレポート期間が 1 日の場合、コンバージョンにはクリックスルーコンバージョンと対象となるビュースルーコンバージョンが合算されます。ビュースルー期間が 0 日の場合は、クリックスルーコンバージョンのみが集計されます。レポートを比較する際は、同じ設定を使用してください。

たとえば、ユーザーが広告をクリックし、後日サイトに直接アクセスして購入したとします。あるツールではその訪問を「直接流入」と分類し、別のツールでは以前の広告の成果として計上する場合があります。この違いだけで、購入が二重計上されたとは言えません。

流入元のラベルが異なる場合は、その訪問で使用されたランディング URL とトラッキングパラメーターを確認してください。現在のキャンペーン設定は、以前の設定と異なる場合があります。

以下を比較してください。

  • アカウント、キャンペーン、イベントの種類、フィルター、レポートの集計レベル

  • 日付範囲、タイムゾーン、日付の基準が広告への接触時点かコンバージョン自体の発生時点か

  • クリックスルーとビュースルーの設定、および選択した指標や列の正確な名称

  • 直近の処理遅延、重複の扱い、同意、利用可能なマッチング情報

  • 利用可能な場合は、モデル化されたコンバージョン(直接記録された取引とは異なる場合があります)

  • 値を比較する場合は、通貨、単位、比較対象が注文全体か個々の商品か

売上を比較する場合は、税金、送料、割引、手数料を比較してください。ブラウザーとサーバーから送信するイベントの注文金額が一致していることを確認してください。注文作成時の売上と注文作成時の ROASは、広告の成果と判定された order_created イベントのみを集計します。

インポートされた GA4 のアクティビティには、選択したプロパティの各流入元で発生したイベントが含まれます。これらの合計は、キャンペーンの成果と判定されたコンバージョン数ではありません。Google Analytics 4 と OpenAI 広告マネージャーの接続をご覧ください。

API の結果と比較する場合は、エンドポイントを記録し、レポートのオプションを明示的に設定してください。設定を省略すると、広告マネージャーの設定と一致しない場合があります。レポートによって対象イベントが異なる場合もあります。キャンペーン目標は含まれていても、トラッキングしている他のアクションは含まれないことがあります。あるレポートにイベントがないからといって、そのイベントが受信されなかったとは限りません。

CSV で比較する際は同じ設定を使用し、エクスポートしたファイルは編集せずに保存してください。広告マネージャーの表示については成果の測定を、API のオプションについてはレポートをご覧ください。

7. ピクセルと CAPI の併用による購入の二重計上

同じアクションの二重計上を防ぐため、ブラウザーとサーバーから送信するイベントには、同じピクセル ID、イベント名、イベント ID を使用してください。イベント ID のフィールドは、CAPI では id、ピクセルでは event_id です。カスタムイベント名も、両方で同じ名前を使用してください。

同じアクションの送信を再試行する場合は同じ ID を維持し、異なるアクションにはそれぞれ新しい ID を使用してください。タグの重複、ページの再読み込みやコールバックの繰り返し、すでに同じイベントを送信している可能性のあるパートナー連携がないか確認してください。

元のイベントの値やマッチング情報を変更するために、重複するイベントを再送信しないでください。修正を試みる前に、ドキュメントに記載された動作を確認してください。ブラウザーとサーバーのイベントの重複排除をご覧ください。

8. Shopify を利用している場合追加の連携の必要性

別の連携を追加する前に、Shopify との接続を確認してください。接続されている広告アカウントとピクセルを確認し、アプリがストアのどのイベントを送信しているかを確認してください。

カスタムタグ、決済ページのコード、サーバーからの送信の仕組みも使用している場合は、それらが同じイベントを送信していないか確認してください。Shopify では、ブラウザーとサーバーのトラッキングをさまざまな組み合わせで構成できます。Shopify 向け ChatGPT 広告の設定をご覧ください。

9. 同意の扱いとテストの方法

共有が許可されているデータのみを送信し、訪問者の同意に関する選択を尊重してください。開発者は、必要な正規化やハッシュ化も含め、連携における同意と対応するマッチングデータのガイダンスに従ってください。レポートのコンバージョン数を増やしたり、スコアを上げたりするために、同意を管理する仕組みを取り除かないでください。

測定への同意と opt_out は、目的が異なります。opt_out オプションはパーソナライズに関するもので、すべての測定リクエストを停止するものではありません。ブラウザー側とサーバー側の両方の連携で同意がどう扱われているか、開発者に確認を依頼してください。

テスト用アクションを 1 件選び、その時刻、名前、ID を記録してください。そのアクションが送信、検証、受信されたかを確認してください。実装のテストが成功しても、広告の成果として計上される条件を満たしているとは限りません。

CAPI の validate_only オプションは、イベントを保存せずに検証します。ピクセルのデバッグモードはアクティビティをログに記録しますが、テストイベントをレポートから除外するものではありません。自社の記録にはテストであることを明記し、結果を無理に得るために架空の購入を作成したり、イベント時刻を変更したりしないでください。

10. イベント品質スコアの低下・未表示とトラッキングの不具合の関係

それだけでは不具合とは言えません。イベント品質は、データソースから受信した情報を評価するものです。広告の成果として計上されたコンバージョン数を示すものではありません。スコアが低い、または表示されないというだけでは、トラッキングが機能しているかどうかは判断できません。

最近の実際のアクションが正しく記録されていることを確認したうえで、警告の原因を調べてください。スコアを上げるために、余分なイベントや架空の識別子を送信しないでください。確認事項や更新のタイミングについては、イベント品質の理解と改善をご覧ください。

11. サポートへの問い合わせに必要な情報

期待した結果、実際に起きたこと、発生し始めた時期、確認済みの事項をお知らせください。以下のうち、手元にある情報を含めてください。

  • 広告アカウント ID、ピクセル ID またはデータソース、影響を受けるキャンペーンと広告の識別子

  • 連携の種類と、カスタムイベント名を含む正確なイベント名

  • 既存のイベントから 1~2 件のサンプルのイベント ID とアクションのタイムスタンプ(タイムゾーンを含む)

  • リクエストの失敗や受信の有無が不明な場合:レスポンスコード、正確なエラー内容、リクエスト時刻、返されたリクエスト ID または CF-Ray、機密情報を伏せたペイロードまたはログの抜粋

  • レポートに差異がある場合:日付範囲、レポートの時間基準、アトリビューション設定、選択した列、CSV エクスポート、同じ範囲での比較結果

  • 関連するスクリーンショットと最近の設定変更(別の決済ページやパートナー連携を含む)

イベントの送信、受け付け、受信のいずれかを確認したのか、レポートのみを確認したのかをお知らせください。これらの確認をすべて完了できなくても、サポートにお問い合わせいただけます。

添付ファイルから API キー、認証ヘッダー、パスワード、Cookie、不要な顧客情報を削除してください。エラーが発生した場合や、正常に動作していた連携が突然停止した場合は、速やかにご報告ください。レポートへの反映時間が過ぎるまで待つ必要はありません。

この記事は役に立ちましたか?