トラブルシューティング

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

重要: API からのインポート成功のレスポンスは、コンバージョンが割り当てられたことを必ずしも意味しません。インポートが完了した後のデータの不一致について詳しくは、こちらのヘルプセンター記事をご覧ください。

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

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

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

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

一般的なエラー

エラー
NO_CONVERSION_ACTION_FOUND	指定されたコンバージョン アクションが有効になっていないか、リクエストの `client_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 広告 API は、UploadClickConversionsRequest で debug_enabled が true の場合にのみ、このエラーを返します。 注: このエラーは、コンバージョンの大部分で発生しない限り、警告として扱ってください。 コンバージョンでこの警告が発生した場合、Google Ads API は、オフライン データ診断の successful_event_count にこの警告を含めます。Google Ads API の alerts コレクションには CLICK_NOT_FOUND のエントリが含まれているため、この警告の頻度をモニタリングできます。 クリックが Google 広告の広告キャンペーンからのものでない場合、このエラーは想定されます。たとえば、SA360 や DV360 から取得できます。考えられるその他の原因は次のとおりです。 アップロードするお客様が Google 広告のコンバージョンのお客様と異なる。 タグ付けがリードフォームに対して正しく設定されていません。 アップロードされたデータが正しく 正規化およびハッシュ化されていません。 アップロードするお客様が Google 広告のコンバージョンのお客様と異なる場合、このエラーは、アップロードするお客様は顧客データに関する規約に同意しているが、配信するお客様は同意していないことを意味することがあります。 アカウントが顧客データに関する規約に同意しているかどうかは、customer リソースにクエリを実行し、customer.offline_conversion_tracking_info.accepted_customer_data_terms フィールドを確認することで判断できます。

指標の不一致

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

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

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

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

• アップロードで consent が正しく指定されていることを確認します。これを行うには、アカウントのデフォルトの同意設定を行う（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, 30] です。

• ほとんどのコンバージョン アクションで、view_through_lookback_window_days フィールドの許容範囲は [1, 30] です。タイプが AD_CALL と WEBSITE_CALL のコンバージョン アクションの場合、このフィールドは設定しないでください。

• コンバージョン アクションの include_in_conversion_metrics フィールドを設定または更新すると、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 を 1 つだけ使用するようにし、複数のクリックを同じコンバージョンに統合しないようにしてください。各クリックにはクリック ID が 1 つだけあります。
VALUE_MUST_BE_UNSET	GoogleAdsError の location を確認して、次のどの問題がエラーの原因になったかを判断します。 ClickConversion には、gclid の値と、gbraid または wbraid の少なくとも 1 つの値が設定されています。コンバージョンを更新してクリック ID を 1 つだけ使用するようにし、複数のクリックを同じコンバージョンに統合しないようにします。各クリックにはクリック ID が 1 つだけあります。 ClickConversion には gbraid または wbraid のいずれかの値が設定され、custom_variables の値があります。Google 広告では、gbraid または wbraid のクリック ID を含むコンバージョンのカスタム変数はサポートされていません。コンバージョンの custom_variables フィールドの設定を解除します。