トラブルシューティング

コンバージョンの管理には、複数の相互依存ツールやプロセスを伴う複雑な統合が必要になります。このガイドでは、API から理解できないエラーが表示される場合や、UI に表示される指標や診断について不明な点がある場合など、発生している問題をトラブルシューティングするための詳細な手順について説明します。

Google 広告の管理画面で指標を確認する

Google 広告の UI では、コンバージョン指標がインポート日別に整理されないため、UI のレポートを使用してインポート結果を確認すると、誤解を招く可能性があります。インポートの健全性を確認するには、まずオフライン データ診断から始めます。また、Google 広告の管理画面で、リードの拡張コンバージョンと拡張コンバージョン（ウェブ向け）の診断について詳しく確認することもできます。

リードの拡張コンバージョンに関する問題

このセクションでは、リードの拡張コンバージョンをインポートする際に発生する一般的な問題の解決に焦点を当てます。

一般的なエラー

以下のガイダンスは、リードの拡張コンバージョンの一般的なエラーを診断して修正する際に役立ちます。

エラー
NO_CONVERSION_ACTION_FOUND	指定されたコンバージョン アクションが有効になっていないか、リクエストの customer_id フィールドで指定されたクライアント アカウントからアクセスできません。アップロードのコンバージョン アクションが有効になっており、アップロード リクエストを送信するお客様が所有していることを確認します。 このエラーは、リクエスト内の GCLID が、リクエストで指定されたコンバージョン アクションにアクセスできないクライアント アカウントに属している場合にも発生することがあります。click_view リソースを使用して、GCLID がクライアント アカウントに属しているかどうかを確認できます。これを行うには、click_view.gclid と segments.date でフィルタするクエリを送信します。ここで、日付はクリックが発生した日付です。
INVALID_CONVERSION_ACTION_TYPE	指定されたコンバージョン アクションのタイプは、リードの拡張コンバージョンで有効ではありません。アップロード リクエストで指定された ConversionAction の型が UPLOAD_CLICKS であることを確認します。
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	コンバージョン設定でリードの拡張コンバージョンが有効になっていることを確認してください。手順については、前提条件ガイドをご覧ください。
DUPLICATE_ORDER_ID	インポートされたイベントに同じオーダー ID の複数のコンバージョンが含まれているため、イベントが処理されませんでした。オーダー ID が一意であることを確認してから、もう一度お試しください。
CLICK_NOT_FOUND	指定されたユーザー ID に一致するクリックが見つかりませんでした。 コンバージョンでこの警告が発生した場合、Google Ads API はそれをオフライン データ診断の successful_event_count に含めます。Google Ads API の alerts コレクションには CLICK_NOT_FOUND のエントリが含まれているため、この警告の頻度をモニタリングできます。 クリックが Google 広告キャンペーンからのものではない場合、このエラーが想定されます。たとえば、SA360 や DV360 から取得できます。その他の原因としては、次のようなものが考えられます。 アップロードするお客様が Google 広告のコンバージョンのお客様と異なる。 タグ設定がリードフォームに対して正しく構成されていません。 アップロードされたデータが正しく 正規化およびハッシュ化されていない。 アップロードするユーザーが Google 広告のコンバージョン ユーザーと異なる場合、このエラーは、アップロードするユーザーは顧客データに関する規約に同意しているが、配信するユーザーは同意していないことを意味することがあります。 アカウントが顧客データに関する規約に同意しているかどうかは、customer リソースをクエリして customer.conversion_tracking_setting.accepted_customer_data_terms フィールドを確認することで判断できます。

指標の不一致

次の一般的な問題に注意してください。

• コンバージョンは、さまざまな理由で処理パイプラインによって破棄されることがあります。このようなコンバージョンは復元できません。詳しくは、正常にアップロードされた後のデータの不一致をご覧ください。

• Google タグがウェブページに正しく設定され、リードフォームの送信時に呼び出されていることを再確認します。フォーム送信時にタグが発火しない場合や、タグが誤ったデータを送信している場合は、アップロードされたコンバージョンでアトリビューションが低くなるか、アトリビューションがまったく発生しない可能性があります。リードの拡張コンバージョンについて、Google タグの設定と Google タグ マネージャーの設定に関するヘルプセンター記事をご覧ください。

• ウェブページで Google タグを使用せずにリードの拡張コンバージョンを使用している場合は、各コンバージョンの ClickConversion.gclid フィールドを設定して、コンバージョン インポートに GCLID を含める必要があります。

• アップロードで同意が正しく指定されていることを確認します。これを行うには、アカウントのデフォルトの同意設定を行う（Google 広告の管理画面で、[ツール] > [データマネージャー] > [同意設定] をクリック）か、アップロードされた各コンバージョンの ClickConversion.consent フィールドを設定します。

キャンペーンのパフォーマンスに関する問題

コンバージョンのアップロードに関する技術的な問題がなく、表示されている指標に問題はないものの、見込み顧客の拡張コンバージョンを実装してもキャンペーンのパフォーマンスの改善や「リフト」が期待どおりに得られない場合は、Google 広告プロダクト サポートにお問い合わせください。

拡張コンバージョン（ウェブ向け）に関する問題

このセクションでは、ウェブの拡張コンバージョンのインポート時に発生する一般的な問題の解決に焦点を当てます。

一般的なエラー

次のガイダンスは、拡張コンバージョン（ウェブ向け）に関する一般的なエラーの診断と修正に役立ちます。

エラー
CONVERSION_NOT_FOUND	指定されたコンバージョン アクションとコンバージョン ID のペアのコンバージョンが見つかりませんでした。order_idコンバージョンが、リクエストの customer_id で指定された Google 広告のコンバージョン顧客の Google 広告コンバージョンであることを確認します。 また、gclid ではなく gbraid または wbraid が入力されたクリックによるコンバージョンではないことを確認します。Google 広告では、これらのコンバージョンに対する拡張コンバージョン（ウェブ向け）はサポートされていません。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS	リクエストの customer_id で顧客データに関する規約に同意していません。手順については、前提条件ガイドをご覧ください。
CONVERSION_ALREADY_ENHANCED	このコンバージョンには、指定された order_id と conversion_action を使用した調整がすでに適用されています。コンバージョンごとに一意の order_id を指定してください。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT	指定された conversion_action は、拡張コンバージョン（ウェブ向け）の対象ではありません。Google 広告の管理画面で、リクエストで参照されているコンバージョン アクションの [拡張コンバージョンを有効にする] チェックボックスがオンになっていることを確認します。手順については、ヘルプセンターをご覧ください。

コンバージョン管理に関する一般的な問題

次の一般的な問題に注意してください。

• 列挙型フィールドを UNKNOWN に設定しようとすると、RequestError.INVALID_ENUM_VALUE エラーが発生します。これは、広告主が同意が得られたかどうかを把握していない可能性がある場合に consent を指定すると発生する一般的な問題です。consent のステータスが不明な場合は、DENIED に設定する必要があります。

• アプリ コンバージョンまたは Firebase とサードパーティ製アプリ解析のコンバージョン アクションを作成する場合、作成時に app_id フィールドのみを変更できます。コンバージョン アクションを作成した後は、このフィールドを変更できません。

• コンバージョン アクションを作成するときに、ConversionAction.attribution_model_settings.attribution_model フィールドを GOOGLE_ADS_LAST_CLICK または GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN のいずれかに設定できます。他のオプションを選択すると、CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS エラーが発生します。他のアトリビューション モデルのサポート終了を発表した ブログ投稿に、詳細が記載されています。

• click_through_lookback_window_days フィールドの許容範囲は、タイプ AD_CALL と WEBSITE_CALL のコンバージョン アクションの場合、1～60 日です。その他のほとんどのコンバージョン アクションでは、1～90 日の範囲で指定できます。

• ほとんどのコンバージョン アクションでは、view_through_lookback_window_days フィールドの許容範囲は 1～30 日です。AD_CALL 型と WEBSITE_CALL 型のコンバージョン アクションの場合、このフィールドは未設定にする必要があります。

• コンバージョン アクションの include_in_conversions_metric フィールドを設定または更新すると、FieldError.IMMUTABLE_FIELD エラーが発生します。代わりに、コンバージョン目標ガイドの説明に沿って primary_for_goal フィールドを設定します。

• タイプ WEBSITE_CALL または AD_CALL のコンバージョン アクションを作成する場合は、value_settings.always_use_default_value を true に設定する必要があります。false の値を指定すると、INVALID_VALUE エラーが発生します。

一般的なエラー

次のガイダンスは、オフライン コンバージョンのインポートに関する一般的なエラーを診断して修正する際に役立ちます。

エラー
INVALID_CONVERSION_ACTION_TYPE	指定されたコンバージョン アクションのタイプは、クリック コンバージョンのアップロードでは無効です。アップロード リクエストで指定された ConversionAction の型が UPLOAD_CLICKS であることを確認します。
NO_CONVERSION_ACTION_FOUND	指定されたコンバージョン アクションが有効になっていないか、アップロードする customer_id 内で見つかりません。コンバージョン設定に関する情報を取得して、アップロードのコンバージョン アクションが有効になっており、アップロード リクエストの customer_id が所有していることを確認します。
TOO_RECENT_CONVERSION_ACTION	コンバージョン アクションが新しく作成された。アクションの作成後、少なくとも 6 時間待ってから、失敗したコンバージョンを再試行します。
INVALID_CUSTOMER_FOR_CLICK	リクエストの customer_id が、クリック時の Google Ads API コンバージョン アカウントのお客様 ID と一致していません。リクエストの customer_id を正しいお客様に更新します。
EVENT_NOT_FOUND	Google 広告でクリック ID と customer_id の組み合わせが見つかりません。customer_id の要件を確認し、正しい Google 広告アカウントを使用してアップロードしていることを確認します。
DUPLICATE_CLICK_CONVERSION_IN_REQUEST	リクエスト内の複数のコンバージョンで、クリック ID、conversion_date_time、conversion_action の組み合わせが同じです。リクエストから重複するコンバージョンを削除します。
CLICK_CONVERSION_ALREADY_EXISTS	クリック ID、conversion_date_time、conversion_action の組み合わせが同じコンバージョンが以前にアップロードされています。アップロードを再試行していて、この変換が以前に成功した場合は、このエラーを無視してください。以前にアップロードしたコンバージョンに加えて別のコンバージョンを追加する場合は、以前にアップロードしたコンバージョンが重複しないように、ClickConversion の conversion_date_time を調整します。
EVENT_NOT_FOUND	Google 広告でクリック ID と customer_id の組み合わせが見つかりません。customer_id の要件を確認し、正しい Google 広告アカウントを使用してアップロードしていることを確認します。
EXPIRED_EVENT	インポートされたクリックは、click_through_lookback_window_days フィールドで指定された期間より前に発生しています。click_through_lookback_window_days の変更は、変更後に記録されたクリックにのみ影響するため、ルックバック ウィンドウを変更しても、特定のクリックに対するこのエラーは解決されません。必要に応じて、conversion_action をルックバック ウィンドウが長い別のアクションに変更します。
CONVERSION_PRECEDES_EVENT	conversion_date_time がクリックの日時より前である。conversion_date_time をより大きな値に更新します。
GBRAID_WBRAID_BOTH_SET	ClickConversion に gbraid と wbraid の両方の値が設定されている。コンバージョンを更新して、クリック ID または URL パラメータを 1 つだけ使用するようにします。また、複数のクリックを同じコンバージョンに統合しないようにしてください。各クリックには、クリック ID または URL パラメータが 1 つだけ含まれます。
VALUE_MUST_BE_UNSET	GoogleAdsError の location を確認して、次のどの問題がエラーの原因になったかを特定します。 ClickConversion には、gclid の値と、gbraid または wbraid の少なくとも 1 つの値が設定されています。コンバージョンを更新して、クリック ID または URL パラメータを 1 つだけ使用するようにし、複数のクリックを同じコンバージョンに統合していないことを確認します。各クリックには、クリック ID または URL パラメータが 1 つだけ含まれます。 ClickConversion には gbraid または wbraid のいずれかの値が設定され、custom_variables の値が設定されている。Google 広告では、gbraid または wbraid URL パラメータを含むコンバージョンのカスタム変数はサポートされていません。コンバージョンの custom_variables フィールドの設定を解除します。