トラブルシューティング

Search Ads 360 API の使用中に問題が発生した場合は、このトラブルシューティングのセクションをご覧ください。

このサイトのリソースを読んでも問題が解決しない場合は、サポートにお問い合わせのうえ、次の情報をご用意ください。

  • アクセスしようとしている検索広告 360 の代理店 ID と広告主 ID

  • Google API Console のプロジェクト番号

  • API へのアクセスに使用している Google アカウントのユーザー名。
    このアカウントは、検索広告 360 へのアクセスが許可されているアカウントであり、承認の設定に使用しているものと同じアカウントです。

  • リクエストのコード スニペット

  • JSON レスポンス
    レスポンスがエラーの場合は、数値エラーコードだけでなく、必ずエラー メッセージを含めます。

承認エラー

よくある承認エラーは次のとおりです。

メッセージ 説明

Access Not Configured. Please use Google API Console to activate the API for your project.

このエラーは、アカウントで Search Ads 360 API が有効になっていない場合に発生します。次のことを行います。

  1. Google API Console に移動します。

  2. プロジェクトを選択します。まだプロジェクトを作成していない場合は、クライアントのプロジェクトを作成するをご覧ください。

  3. 左側のサイドバーで、[API と認証] を展開します。次に、[API] をクリックします。API のリストで、検索広告 360 API のステータスがオンになっていることを確認します。

Invalid grant

このエラーは、更新トークンが有効でない場合に発生します。更新トークンを取得するには、次のように検索広告 360 ユーティリティ スクリプトを呼び出します。

sa360Api.py --login

詳しくは、推奨される承認ワークフローをご覧ください。

Invalid client
no application name

このエラーは、Google API Console でプロジェクトを設定する際にプロダクト名を指定していない場合に発生します。このエラーを修正するには、Google API Console の同意画面でサービスの名前を入力します。

その他の種類の承認エラー

クライアント ID とクライアント シークレットを取得したり、更新トークンを取得したりする場合は、Google API Console にログインして検索広告 360 にアクセスできる Google アカウントを使用してください。

コンバージョン アップロード エラー

次の表に、コンバージョンのアップロード時に発生する可能性のあるエラーを示します。16 進数エラーコードは不変であるため、独自のスクリプトでエラーを識別するために使用できます。

エラーコード メッセージ 説明
0x00000101

Click ID '{ID}' is not found

update リクエストで指定したクリック ID が無効です。次の手順でコンバージョンを再アップロードします。

  • コンバージョン ID が、コンバージョンがアップロードされる 4 時間前に生成されたことを確認しました。

  • API 変換サービスを有効にした。

  • コンバージョンを特定の訪問に関連付ける場合は、訪問から少なくとも 30 分待ってからコンバージョンをアップロードしてください。訪問後 30 分以内にアップロードした場合、訪問のクリック ID が認識されない可能性があります。まれに、検索広告 360 が clickId を認識するまでに 4 時間ほどかかることがあります。

  • このクリックが、gclsrc パラメータで示されている有効なソースからのものであることを確認しました。

  • advertiserId 列で正しい広告主を指定しているかどうかを確認します。

  • お客様のクリック ID が過去 90 日以内に生成されていることを確認済み。
0x0000010E Floodlight activity name '{name}' is not found

segmentationName 列で指定した Floodlight アクティビティの名前が正しくないか、まだ使用できません。このエラーが表示された場合は、次の一般的な問題を確認してください。

  • 大文字と小文字は区別されます。そのため、リクエストでは大文字と小文字を正確に一致させてください。
  • Floodlight アクティビティ名に、印刷不能な Unicode 文字や二重スペースが含まれていないことを確認してください。
  • Floodlight 列ではなく、Floodlight アクティビティの名前を指定していることを確認します。
  • [ advertiserId] 列に指定した広告主の Floodlight アクティビティが存在することを確認します。（指定した広告主が間違っている可能性があります）。
  • Floodlight アクティビティを作成または編集してから数時間経過したら、そのアクティビティのコンバージョンをアップロードします。
0x00000115 Custom dimension '{name}' is not found

指定したカスタム Floodlight 変数が、コンバージョンに貢献している clickId、criterionId、または productGroupId に関連付けられた広告主のディメンション（指標ではない）として設定されていることを確認します。

0x00000116 Custom metric '{name}' is not found

指定したカスタム Floodlight 変数が、コンバージョンに貢献している clickId、criterionId、または productGroupId に関連付けられた広告主の指標（ディメンションではない）として設定されていることを確認します。

0x0000011A The advertiser conversion ID is already specified for a conversion with Search Ads 360 conversion ID {ID}

conversionId 列で指定された同じスコープと広告主のコンバージョン ID のコンバージョンがすでにアップロードされています。

「広告主のコンバージョン ID」はご自身で生成した ID です。検索広告 360 では、この ID は特定のスコープに対して一意である必要があります。検索広告 360 コンバージョン ID は検索広告 360 によって生成され、必ず一意になります。
0x0000011B Advertiser conversion ID '{ID}' is not found

update リクエストが、存在しない広告主のコンバージョン ID の更新を試みました。正しい ID を指定していることを確認します。
0x0000011D User does not have permission to view advertiser {advertiser ID}

クライアントが使用している Google アカウントには、リクエストで指定された広告主を表示する権限がありません。

Google API Console にログインしてクライアント ID とクライアント シークレットを取得する場合、および更新トークンを取得する場合は、指定した広告主にアクセス権が付与されている Google アカウントを必ず使用してください。
0x0000011F Advertiser conversion ID is already specified in this request

リクエストの 2 つ以上のコンバージョンで、同じスコープと広告主のコンバージョン ID が指定されています。

広告主のコンバージョン ID は、生成して conversionId 列で指定した ID です。検索広告 360 では、この ID は特定のスコープに対して一意である必要があります。

0x0000011E The requested Floodlight activity '{name}' does not match the conversion type (ACTION/TRANSACTION)

指定された Floodlight アクティビティ ID または名前が指定したコンバージョンの種類と一致しません。

レスポンス コードとエラー メッセージを報告する

レポートをリクエストし、レスポンスがエラー メッセージの場合は、検索広告 360 API のレスポンス コードと標準エラー レスポンスでエラーの詳細をご覧ください。

検索広告 360 の管理画面で確認されたデータが、API から返されたレポートに一致しない

検索広告 360 の UI のデータは、デフォルトで API から返されるデータと一致する必要があります。 レポート リクエストで includeRemovedEntities を true に設定した場合は、UI でも [削除済みを表示] チェックボックスがオンになっていることを確認します。