Google Ads API を使ってオフライン データの診断を取得します。これには、コンバージョンのアップロードと調整のプロセスの全体的な健全性に関する情報が含まれます。
アカウントの最新のオフライン データの診断を取得するには、GoogleAdsService を使用して offline_conversion_upload_client_summary リソースに対する次のクエリを送信します。
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.resource_name,
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 値に対応するエントリが別々に含まれます。
各 OfflineConversionUploadClientSummary には、client のアップロードの全体的な健全性を反映する status フィールドがあります。また、受信したイベントの合計数、正常に処理されたイベントの数、エラーの概要を示す alerts フィールド（OfflineConversionError でグループ化）も含まれています。これらのすべてのフィールドには、暦日の直近の丸 1 日のアップロード情報が含まれます。この情報を使用して、アップロードの現在の状態を評価します。
また、各 OfflineConversionUploadClientSummary には次の 2 種類のレポートが含まれます。
daily_summaries- 過去 7 日間のアップロード リクエストの
successful_countとfailed_count（アップロードdateでグループ化）。 job_summaries最新の 7 件のアップロード リクエストの
successful_countとfailed_count（job_idでグループ化）。job_idは、UploadClickConversionsRequestとUploadConversionAdjustmentsRequestのオプション フィールドです。job_idを2^31より小さい負でない数に設定するか、Google Ads API によってシステム生成のジョブ ID をリクエストに割り当てることができます。どちらのオプションを選択しても、UploadClickConversionsResponseまたはUploadConversionAdjustmentsResponseはjob_idを返します。独自の
job_idを割り当てると便利なシナリオの 1 つは、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を確認し、正常に処理されなかったイベントが多数送信された特定のアップロード日またはジョブがあったかどうかを確認します。
制限
アップロードの概要を取得する際は、次の点に注意してください。
Google Ads API は、
searchStreamまたはsearchリクエストのcustomer_idが、コンバージョンのアップロードに最近使用した顧客と同じである場合にのみ、オフライン データの診断を返します。たとえば、クロスアカウント コンバージョン トラッキングを使用するクライアント アカウントには診断情報が含まれない場合があります。ただし、
customer_idがアップロードで使用する MCC アカウントのcustomer_idと一致するリクエストを送信することで、診断情報を取得できます。Google 広告では、リードの拡張コンバージョンのアップロードで発生した
CLICK_NOT_FOUNDエラーは警告として扱われます。そのため、alertsにこのエラーのエントリが含まれている場合、対応するオペレーションは引き続き成功とみなされ、successful_event_countに含まれます。