トラブルシューティング

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

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

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

Google 広告の管理画面では、コンバージョン指標がインポート日ごとに整理されない ため、管理画面のレポートを使用してインポート結果を確認すると誤解を招く可能性があります。インポートの健全性を確認するには、オフラインデータの診断から始めます。リードの拡張コンバージョンと拡張コンバージョン（ウェブ向け）の 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 広告 API はオフライン データの診断の successful_event_count に含めます。Google 広告 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 広告の管理画面で、リクエストで参照されているコンバージョン アクションの [拡張コンバージョンをオンにする] チェックボックスがオンになっていることを確認してください。手順については、 ヘルプセンターをご覧ください。

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

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

• enum フィールドを 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 広告 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 の組み合わせが同じコンバージョンが以前にアップロードされています。アップロードを再試行していて、この コンバージョンが以前に成功した場合は、このエラーを無視してください。以前にアップロードしたコンバージョンに加えて別のコンバージョンを追加する場合は、以前にアップロードしたコンバージョンが重複しないように、conversion_date_time の ClickConversion を調整してください。
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	location の GoogleAdsError を確認して、次のどの問題がエラーの原因となったかを確認します。 ClickConversion に、gclid と gbraid または wbraid の少なくとも 1 つの値が設定されています。コンバージョンを更新して、1 つのクリック ID または URL パラメータのみを使用するようにします。また、複数のクリックを同じコンバージョンに結合しないようにしてください。各クリック には、クリック ID または URL パラメータが 1 つだけあります。 ClickConversion に gbraid または wbraid のいずれかの値が設定され、custom_variables の値が設定されています。Google 広告では、 gbraid または wbraid URL パラメータを含むコンバージョンのカスタム変数はサポートされていません。コンバージョンの custom_variables フィールドの設定を解除してください。