オフライン データ診断をモニタリングする

Google Ads API を使用して、コンバージョンのインポートおよび調整プロセスの全体的な健全性に関する情報を含むオフライン データ診断を取得します。

アカウントの最新のオフライン データ診断を取得するには、次のいずれかのリソースを使用します。

アカウント単位の診断

アカウント単位のコンバージョン アップロード診断を取得するには、次の GAQL クエリを使用します。

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

このクエリは、最近のインポートで使用されたクライアントのタイプごとに個別の OfflineConversionUploadClientSummary 行を返します。たとえば、最近 Google Ads API と Google 広告の管理画面の両方を使用してインポートした場合、結果には GOOGLE_ADS_API と GOOGLE_ADS_WEB_CLIENT の client 値の個別のエントリが含まれます。

コンバージョン アクション単位の診断

コンバージョン アクション単位でコンバージョン アップロードの診断を取得するには、次の GAQL クエリを使用します。

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = <CONVERSION_ACTION_ID>

アカウント レベルの診断と同様に、このクエリは、最近のインポートで使用されたクライアントのタイプごとに個別の OfflineConversionUploadConversionActionSummary 行を返します。たとえば、最近 Google Ads API と Google 広告の管理画面の両方を使用してインポートした場合、結果には GOOGLE_ADS_API と GOOGLE_ADS_WEB_CLIENT の client 値の個別のエントリが含まれます。

これらの概要の解釈方法

各 OfflineConversionUploadClientSummary または OfflineConversionUploadConversionActionSummary には、client のインポートの全体的な健全性を反映する status フィールドがあります。また、次の情報も含まれています。

  • 受信した合計イベントの数。
  • 正常に処理されたイベントの数。
  • 保留中のイベントの数（処理中のイベント）。
  • エラーの概要を示す alerts フィールド（OfflineConversionError でグループ化される）。

これらのフィールドにはすべて、直近の 1 日（暦日）のインポートに関する情報が含まれています。この情報を使用して、インポートの現在の健全性を評価します。

また、各 OfflineConversionUploadClientSummary または OfflineConversionUploadConversionActionSummary には、次の 2 種類のレポートが含まれています。

daily_summaries
過去 7 日間のインポート リクエストの successful_count、failed_count、pending_count。インポート date でグループ化されます。
job_summaries

直近 7 件のインポート リクエストの successful_count、failed_count、pending_count。job_id でグループ化されます。job_id は、UploadClickConversionsRequest と UploadConversionAdjustmentsRequest のオプション フィールドです。job_id を 2^31 未満の負でない数値に設定するか、Google Ads API でシステム生成のジョブ ID をリクエストに割り当てることができます。どちらのオプションを選択しても、UploadClickConversionsResponse または UploadConversionAdjustmentsResponse は job_id を返します。

独自の job_id を割り当てることが有用なシナリオの 1 つは、複数のリクエストを使用して大量のコンバージョンをインポートする単一のジョブまたはプロセスがある場合です。これらの各リクエストで job_id を同じ値に設定すると、job_summaries からジョブの単一のエントリを取得できます。代わりに、Google Ads API でシステム生成の値を各リクエストの job_id に割り当てると、job_summaries には各リクエストの個別のエントリが含まれます。これにより、ジョブの全体的な健全性の分析が難しくなる可能性があります。

要約の使用方法

インポート プロセスでコンバージョンと拡張機能が想定どおりに記録されていることを確認するには、各アカウントの概要を定期的に取得します。サマリーの status が EXCELLENT でない場合は、alerts のエラーリストを使用して、インポート プロセスを変更し、エラーを減らすか、排除します。

次に例を示します。

  • ステータスが NEEDS_ATTENTION の場合、インポート オペレーションの大部分が失敗しています。alerts のエラーを確認し、インポート プロセスを変更してエラーを減らすか、なくします。

  • ステータスが NO_RECENT_UPLOADS の場合、Google 広告は client の最近のインポートを受信していません。これが予期しないものである場合は、そのクライアントを使用してインポートを実行するプロセスを確認してください。

    例えば、GOOGLE_ADS_API の status が NO_RECENT_UPLOADS である場合、Google Ads API を使用するインポート処理が最近停止したことを示している可能性があります。

  • 処理に失敗した大量のイベントを送信した特定のインポート日またはジョブがあったかどうかを判断するには、daily_summaries と job_summaries の successful_count、failed_count、pending_count を確認します。保留中のイベントが完了するまでに、最大で 24 時間ほどかかることがあります。

オフライン データの診断を改善する方法について詳しくは、ヘルプセンターをご覧ください。

制限事項

インポートの概要を取得する際は、次の点に注意してください。

  • Google Ads API は、searchStream リクエストまたは search リクエストの customer_id が、最近コンバージョンのインポートに使用したお客様と同じ場合にのみ、オフライン データの診断を返します。

    たとえば、クロスアカウント コンバージョン トラッキングを使用するクライアント アカウントには、診断情報が含まれていない場合があります。ただし、customer_id がインポートで使用するマネージャー アカウントの customer_id と一致するリクエストを送信することで、診断情報を取得できます。

  • Google 広告では、リードの拡張コンバージョンのインポートで発生した CLICK_NOT_FOUND エラーは警告として扱われます。その結果、alerts にこのエラーのエントリが含まれている場合でも、対応するオペレーションは成功とみなされ、successful_event_count に含まれます。

前へ
カスタム コンバージョン変数
次へ
レポート