トラブルシューティング

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

重要: API からインポート レスポンスが成功しても、コンバージョンがアトリビューションされたとは限りません。インポートが正常に完了した後のデータの不一致について詳しくは、正常にアップロードされた後のデータの不一致をご覧ください。

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

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

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

このセクションでは、リードの拡張コンバージョンのインポート時に発生する一般的な問題への対処方法について説明します。

一般的なエラー

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

エラー
NO_CONVERSION_ACTION_FOUND	指定されたコンバージョン アクションが有効になっていないか、リクエストの customer_id フィールドで指定されたクライアント アカウントからアクセスできません。アップロードするコンバージョン アクションが有効になっていて、アップロード リクエストを送信するお客様が所有していることを確認してください。 このエラーは、リクエスト内の GCLID が、リクエストで指定されたコンバージョン アクションにアクセスできないクライアント アカウントに属している場合にも発生することがあります。GCLID がクライアント アカウントに属しているかどうかを確認するには、click_view リソースを使用します。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 の両方の値が設定されています。1 つのクリック ID または URL パラメータのみを使用するようにコンバージョンを更新し、複数のクリックが同じコンバージョンに結合されていないことを確認します。各クリックには、クリック ID または URL パラメータが 1 つだけあります。
VALUE_MUST_BE_UNSET	GoogleAdsError の location を確認して、次のどの問題がエラーの原因となったかを判断します。 ClickConversion には、gclid の値と、gbraid または wbraid の少なくとも 1 つの値が設定されています。1 つのクリック ID または URL パラメータのみを使用するようにコンバージョンを更新し、複数のクリックを同じコンバージョンに結合していないことを確認してください。各クリックには、クリック ID または URL パラメータが 1 つだけあります。 ClickConversion には、gbraid または wbraid の値が設定され、custom_variables の値が設定されています。Google 広告では、gbraid または wbraid URL パラメータを含むコンバージョンのカスタム変数はサポートされていません。コンバージョンの custom_variables フィールドの設定を解除します。