リードの拡張コンバージョンのトラブルシューティング

このガイドでは、リードの拡張コンバージョンの統合に関する問題のトラブルシューティングを行います。

アップロードの不一致を修正する

リードの拡張コンバージョンのアップロードが正常に処理されない、または Google 広告の管理画面に想定どおりに表示されない場合は、さまざまな原因が考えられます。レポートの不一致やアップロードしたコンバージョンが Google 広告の管理画面に表示されない原因となる一般的な設定の問題については、ヘルプセンターをご覧ください。

一般的なエラーをデバッグする

エラー
ConversionUploadError.INVALID_CONVERSION_ACTION_TYPE 指定されたコンバージョン アクションには、リードの拡張コンバージョンで無効なタイプが含まれています。アップロード リクエストで指定された ConversionAction のタイプが UPLOAD_CLICKS であることを確認してください。
ConversionUploadError.NO_CONVERSION_ACTION_FOUND 指定したコンバージョン アクションは有効になっていないか、アップロードした顧客内に見つかりません。アップロード内のコンバージョン アクションが有効になっていて、アップロード リクエストを送信した顧客がそのアクションを所有していることを確認してください。
ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS 指定されたクリック ID と conversion_date_time のクリック コンバージョンがすでに存在します。conversion_date_time が一意であるか、クリック コンバージョンで一意の order_id が指定されていることを確認してください。
ConversionUploadError.CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS コンバージョン設定でリードの拡張コンバージョンを必ず有効にしてください。その手順については、前提条件ガイドをご覧ください。
ConversionUploadError.DUPLICATE_ORDER_ID アップロードしたコンバージョン全体で、オーダー ID が一意であることを確認してください。
ConversionUploadError.CLICK_NOT_FOUND 提供されたユーザー ID に一致するクリックは見つかりませんでした。Google Ads API は、UploadClickConversionsRequestdebug_enabledtrue の場合にのみ、このエラーを返します。

v15 以降、コンバージョンでこの警告が発生した場合、Google Ads API はオフライン データの診断successful_event_count にその警告を含めます。v15 より前のバージョンでは、successful_event_count はこの警告があるコンバージョンを除外します。Google Ads API では、使用可能なすべてのバージョンの API の alerts コレクションに CLICK_NOT_FOUND のエントリが含まれているため、この警告の頻度をモニターできます。

このエラーは、Google 広告の広告キャンペーンからのクリックではない場合に発生します。他にも次のような原因が考えられます。

まれに、アップロードする顧客が Google 広告コンバージョンの顧客と異なる場合があります。このエラーは、アップロードした顧客が顧客データに関する規約に同意しているものの、サービスを提供する顧客が同意していないことを意味します。

その他のトラブルシューティング サポート

ここに記載されていない問題が発生している場合は、Google Ads API のテクニカル サポートのフォームからご連絡ください。その際、Google Ads API のリクエストログとレスポンスログに加え、すでにお試しいただいたトラブルシューティングの手順があれば、必ずご提供ください。