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

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_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 = < INSERT CONVERSION ACTION ID >

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

これらの要約の解釈方法

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

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

これらのフィールドにはすべて、インポートの最新の 1 日分の情報が含まれています。この情報を使用して、インポートの現在の健全性を評価します。

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

daily_summaries
過去 7 日間のインポート リクエストの
A 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 が、最近コンバージョンのインポートに使用したお客様と同じ場合にのみ、オフライン データ診断を返します。

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

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

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