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

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_APIclient 値と、 GOOGLE_ADS_WEB_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_APIclient 値と、 GOOGLE_ADS_WEB_CLIENT

要約の解釈方法

OfflineConversionUploadClientSummary または OfflineConversionUploadConversionActionSummary には status フィールドがあり、 反映され、 全体的な健康状態 client のアップロード数。次の情報も含まれます。

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

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

さらに、各 OfflineConversionUploadClientSummary または OfflineConversionUploadConversionActionSummary には 2 種類の異なる 次のタイプがあります。

daily_summaries
アップロード リクエストの successful_countfailed_countpending_count 過去 7 日間のデータ(アップロード date 別にグループ化)。
job_summaries

上位 7 件のうち successful_countfailed_countpending_count 最近のアップロード リクエスト(job_id 別にグループ化)。job_id は省略可能なフィールドです UploadClickConversionsRequestUploadConversionAdjustmentsRequest。アラートの取り込み時に job_id2^31 未満の負でない数に変更するか、Google Ads API によって システム生成のジョブ ID をリクエストに追加します。使用するオプションを UploadClickConversionsResponse または UploadConversionAdjustmentsResponsejob_id を返します。

独自の job_id を割り当てることが有用なシナリオの 1 つは、 単一のジョブまたはプロセスで、大量のコンバージョンを 実行できます。これらのリクエストのそれぞれで job_id を そのジョブのエントリを 1 つだけ取得し、 job_summaries。Google Ads API を使って、システムによって生成された を各リクエストの job_id に追加すると、job_summaries には個別の エントリごとに 1 つのエントリが含まれるため、 困難になります。

要約の使用方法

アップロード処理でコンバージョンと拡張が確実に記録されるようにするには、 各アカウントの概要を定期的に取得します。もし サマリーの statusEXCELLENT ではありません。以下のエラーのリストを使用します。 alerts: アップロード プロセスを変更して、 無駄を省くことができます。

例:

  • ステータスが NEEDS_ATTENTION の場合、 アップロードに失敗しました。alerts のエラーを確認し、 エラーを減らしたり排除したりできます。

  • ステータスが NO_RECENT_UPLOADS の場合、Google 広告は最近のリクエストを受信していません client のアップロード。これが予期しない場合は、プロセスを確認します。 そのクライアントを使用してアップロードを実行する クライアントライブラリが含まれます

    たとえば、GOOGLE_ADS_APIstatusNO_RECENT_UPLOADS の場合、 Google Ads API を使用するアップロード プロセスが停止したことを示している可能性がある できます。

  • 大量のメッセージを送信した特定のアップロード日またはジョブがあったかどうか 処理できなかったイベントの数、successful_count を確認する failed_countdaily_summariespending_countjob_summaries。 保留状態のイベントは、最長で 24 時間かかることがあります 完了するまでに時間がかかります

制限事項

アップロードの要約を取得するときは、次の点に注意してください。

  • Google Ads API では、次の場合にのみオフライン データの診断が返されます。 customer_idsearchStream または search のリクエストは、お客様が最近使用したものと同じ顧客です コンバージョンをアップロードできます

    たとえば、クロスアカウント コンバージョン トラッキングを使用するクライアント アカウントは、 診断情報は含まれませんただし、 customer_id がマネージャーの customer_id と一致するリクエスト 使用するアカウントだけです。

  • Google 広告は、拡張コンバージョンで発生した CLICK_NOT_FOUND のエラーを リード アップロードを警告として受け取ります。として 結果。alerts にこのエラーのエントリが含まれる場合、対応する 成功したものと見なされ、 successful_event_count