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 フィールドがあります。また、受信したイベントの合計数、正常に処理されたイベントの数、OfflineConversionError でグループ化されたエラーの概要を示す alerts フィールドも含まれます。これらのすべてのフィールドには、暦日でアップロードした直近 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 つは、単一のジョブまたはプロセスで、複数のリクエストを使用して多数のコンバージョンをアップロードする場合です。これらの各リクエストのjob_idを同じ値に設定すると、job_summariesからジョブの単一のエントリを取得できます。システムが生成した値を各リクエストのjob_idに割り当てることを Google Ads API に任せた場合、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と一致するリクエストを送信すると、診断情報を取得できます。リードの拡張コンバージョンのアップロードで発生した
CLICK_NOT_FOUNDエラーは、警告として扱われます。そのため、alertsにこのエラーのエントリが含まれている場合、対応するオペレーションは引き続き成功と見なされ、successful_event_countに含まれます。