トラブルシューティング

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 を有効にしていない場合に発生します。次のことが完了していることを確認します。 Google API コンソールに移動します。 プロジェクトを選択します。プロジェクトをまだ作成していない場合は、クライアントのプロジェクトを作成するをご覧ください。 左側のサイドバーで [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 が無効です。以下の手順を完了したら、コンバージョンを再アップロードします。 クリック ID がコンバージョンのアップロードの 4 時間前に生成されたことを確認しました。 API コンバージョン サービスを有効化しました。 コンバージョンを特定の訪問に結び付ける場合は、訪問の後、少なくとも 30 分経ってからコンバージョンをアップロードするようにしてください。訪問後 30 分以内にアップロードした場合、検索広告 360 で訪問のクリック ID が認識されないことがあります。まれに、検索広告 360 でクリック ID が認識されるまでに最大 4 時間かかることがあります。 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	コンバージョンに結び付ける clickId、criterionId、または productGroupId に関連付けられた広告主について、指定したカスタム Floodlight 変数が（指標ではなく）ディメンションとして設定されていることを確認します。
0x00000116	Custom metric '{name}' is not found	コンバージョンに結び付ける clickId、criterionId、または productGroupId に関連付けられた広告主の指標（ディメンションではなく）として、指定したカスタム Floodlight 変数が設定されていることを確認します。
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 から返されたデータと一致しています。 レポート リクエストで includeRemovedEntities を true に設定する場合は、UI で [削除済みも表示] チェックボックスも選択されていることを確認してください。