トラブルシューティング

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

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

• Google 広告の管理画面では、コンバージョン指標がインポート日別に整理されません。そのため、管理画面のレポートを使用してインポート結果を確認すると、誤った結果になる可能性があります。インポートの健全性を確認するには、オフライン診断から始めます。診断について詳しくは、Google 広告の管理画面で見込み顧客の拡張コンバージョンと拡張コンバージョン（ウェブ向け）についての記事をご覧ください。

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

一般的なエラー

エラー
NO_CONVERSION_ACTION_FOUND	指定されたコンバージョン アクションが有効になっていないか、リクエストの client_id フィールドで指定されたクライアント アカウントからアクセスできません。アップロード内のコンバージョン アクションが有効であり、アップロード リクエストを送信したお客様が所有していることを確認します。 このエラーは、リクエスト内の GCLID が、リクエストで指定されたコンバージョン アクションにアクセス権のないクライアント アカウントに属している場合にも発生することがあります。GCLID がクライアント アカウントに属しているかどうかを確認するには、click_view リソースを使用して、click_view.gclid と segments.date でフィルタするクエリを送信します。日付はクリックが発生した日付です。
INVALID_CONVERSION_ACTION_TYPE	指定されたコンバージョン アクションのタイプは、リードの拡張コンバージョンでは無効です。アップロード リクエストで指定された ConversionAction のタイプが UPLOAD_CLICKS であることを確認します。
CLICK_CONVERSION_ALREADY_EXISTS	このクリックには、この conversion_date_time のコンバージョンがすでに存在します。conversion_date_time がイベントごとに一意であることを確認して、もう一度お試しください。
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 タグ マネージャーの設定に関するヘルプセンター記事をご覧ください。

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

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

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

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

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

一般的なエラー

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