トラブルシューティング

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.

このエラーは、アカウントで検索広告 360 API が有効になっていない場合に発生します。次の準備ができていることを確認します。

  1. Google API コンソールに移動します。

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

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

Invalid grant

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

sa360Api.py --login

承認に推奨されるワークフローの詳細については、こちらをご覧ください。

Invalid client
no application name

このエラーは、Google API Console でプロジェクトを設定するときにプロダクト名を指定していない場合に発生します。このエラーを修正するには、Google API コンソールの [同意画面] にプロダクトの名前を入力します。

その他のタイプの認証エラー

Google API Console にログインしてクライアント ID とクライアント シークレットを取得する際、および更新トークンを取得する際は、検索広告 360 へのアクセス権が付与されている Google アカウントを使用してください。

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

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

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

Click ID '{ID}' is not found

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

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

  • API コンバージョン サービスを有効化しました。

  • コンバージョンを特定の訪問に結び付ける場合は、訪問の後、少なくとも 6 時間経ってからコンバージョンをアップロードするようにしてください。訪問後 6 時間以内にアップロードした場合、訪問のクリック ID が認識されないことがあります。まれに、検索広告 360 でクリック ID が認識されるまでに最長で 24 時間ほどかかることがあります。

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

  • [ advertiserId] 列に正しい広告主が指定されていることを確認しました。

  • クリック ID が過去 90 日以内に生成されたことを確認しました。

0x0000010E Floodlight activity name '{name}' is not found

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

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

指定したカスタム Floodlight 変数が、コンバージョンの帰属先として指定した clickIdcriterionIdproductGroupId に関連付けられている広告主のディメンション(指標ではない)として設定されていることを確認します。

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

指定したカスタム Floodlight 変数が、コンバージョンの帰属先として指定した clickIdcriterionIdproductGroupId に関連付けられている広告主の指標(ディメンションではない)として設定されていることを確認します。

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 の管理画面のデータは、API から返されたデータと一致しています。レポート リクエストで includeRemovedEntitiestrue に設定する場合は、UI で [削除済みも表示] チェックボックスも選択されていることを確認してください。