トラブルシューティング
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Search Ads 360 API の使用中に問題が発生した場合は、このトラブルシューティングのセクションをご覧ください。
このサイトのリソースを読んでも解決できない問題がある場合は、サポートにお問い合わせください。その際、次の情報を用意してください。
承認エラー
よくある認証エラーは次のとおりです。
メッセージ |
説明 |
Access Not Configured. Please use Google API Console to activate the API for your project.
|
このエラーは、アカウントで検索広告 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 がコンバージョンのアップロードの 6 時間前に生成されたことを確認しました。
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 変数が、コンバージョンの帰属先として指定した 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 または名前が、指定したコンバージョンの種類と一致しません。 |
0x00000126 |
Service internal error |
しばらくしてからリクエストを再試行してください。これは一時的なエラーの可能性があります。このエラーが解決しない場合は、SA360 サポートにお問い合わせください。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-04-07 UTC。
[null,null,["最終更新日 2025-04-07 UTC。"],[[["\u003cp\u003eThis page provides troubleshooting information for common issues encountered while using the Search Ads 360 API, including authorization and conversion upload errors.\u003c/p\u003e\n"],["\u003cp\u003eIf the provided resources don't resolve your issue, contact support with specific information about your problem, including your Search Ads 360 and Google API Console credentials, code snippets, and JSON responses.\u003c/p\u003e\n"],["\u003cp\u003eThe page lists common authorization errors such as \u003ccode\u003eAccess Not Configured\u003c/code\u003e, \u003ccode\u003eInvalid grant\u003c/code\u003e, and \u003ccode\u003eInvalid client\u003c/code\u003e, with explanations and solutions.\u003c/p\u003e\n"],["\u003cp\u003eIt also includes a table of conversion upload errors, detailing their hexadecimal error codes, descriptions, and troubleshooting steps.\u003c/p\u003e\n"],["\u003cp\u003eFor report discrepancies, refer to the Response Codes and Standard Error Responses documentation and ensure the \u003ccode\u003eincludeRemovedEntities\u003c/code\u003e setting in your request matches the "Show removed" checkbox selection in the Search Ads 360 UI.\u003c/p\u003e\n"]]],["When troubleshooting the Search Ads 360 API, consult the provided resources. If issues persist, contact support, providing your Agency/Advertiser ID, Project Number, API access username, code snippet, and JSON response (including full error messages). Common authorization errors include `Access Not Configured`, `Invalid grant`, and `Invalid client`, often resolved by enabling the API, refreshing tokens, or naming your project. Conversion upload errors relate to invalid click IDs, Floodlight activity names, or custom dimensions/metrics. Ensure correct permissions and data consistency between UI and API.\n"],null,[]]