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

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 広告の管理画面の両方を使用してアップロードした場合、結果には client 値が GOOGLE_ADS_API と GOOGLE_ADS_WEB_CLIENT の 2 つのエントリとして含まれます。

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

コンバージョン アクション単位でコンバージョン アップロードの診断情報を取得するには、次の 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 広告の管理画面の両方を使用してアップロードした場合、結果には client 値が GOOGLE_ADS_API と GOOGLE_ADS_WEB_CLIENT の 2 つのエントリが含まれます。

これらの概要の解釈方法

各 OfflineConversionUploadClientSummary または OfflineConversionUploadConversionActionSummary には status フィールドがあり、client のアップロードの全体的な健全性を反映しています。また、次の情報も含まれます。

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

これらのフィールドには、アップロードされた直近の暦日の情報がすべて含まれます。この情報を使用して、アップロードの現在の状態を評価します。

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

daily_summaries
過去 7 日間のアップロード リクエストの successful_count、failed_count、pending_count。アップロード date ごとにグループ化されています。
job_summaries

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

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

要約の使用方法

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

次に例を示します。

  • ステータスが NEEDS_ATTENTION の場合、アップロード オペレーションの大部分が失敗しました。alerts でエラーを確認し、アップロード プロセスを変更してエラーを減らすか、エラーを排除します。

  • ステータスが NO_RECENT_UPLOADS の場合、client の最近のアップロードは Google 広告に受信されていません。これが想定外である場合は、そのクライアントを使用してアップロードを実行するプロセスを確認します。

    たとえば、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 に含まれます。

前へ
コンバージョン値のルール
次へ
Reporting