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

このガイドは、リードの拡張コンバージョンの統合で発生した問題のトラブルシューティングに役立ちます。

アップロードしたファイルの不一致を修正する

リードの拡張コンバージョンのアップロードが正常に処理されなかったり、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 のリクエストとレスポンスのログ、すでにお試しいただいたトラブルシューティングの手順をお知らせください。