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
に含まれます。