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

Google Ads API を使ってオフライン データの診断を取得します。オフライン データの診断には、コンバージョンのアップロードと調整のプロセスの全体的な健全性に関する情報が含まれます。

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

• offline_conversion_upload_client_summaryアップロード診断をアカウント単位で集約します。
• offline_conversion_upload_conversion_action_summary（v17 以降でのみ使用可能）: アップロード診断をコンバージョン アクション レベルで集計します。

アカウント単位の診断

アカウント単位のコンバージョン アップロード診断を取得するには、次の 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 には、client のアップロードの全体的な健全性を反映する status フィールドがあります。また、次の情報も含まれます。

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

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

また、各 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 からジョブのエントリを 1 つ取得できます。システムが生成した値を各リクエストの job_id に割り当てることを Google Ads API に任せた場合、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 に含まれます。