レポートの範囲をどう設定すればよいですか？
ほとんどのレポートでは、Reports.reportScope を特定のエンジン アカウントまたは広告主に設定することをおすすめします。キーワード レポート、コンバージョン レポート、細分化されたレポートなど、非常に大きなレポートの場合は、特定のエンジン アカウントに範囲を制限することをおすすめします。1,000 万行を超えるレポートの場合、API からエラーが返されることがあります。
Forbidden（403）エラーが表示されるのはなぜですか？
ほとんどの場合、更新 OAuth トークンの取得が必要になります。
代理店や広告主の ID を確認する方法
閲覧権限のある代理店と広告主の ID をまだ取得していない場合は、agencyId 列と advertiserId 列を含む advertiser レポートをリクエストします。ただし、reportScope は指定しないでください。
ご利用の Google アカウントに閲覧権限があるすべての代理店 ID と広告主 ID のリストが返されます。
リクエストの例を次に示します。
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"reportType": "advertiser",
"columns": [
{ "columnName": "agency" },
{ "columnName": "agencyId" },
{ "columnName": "advertiser" },
{ "columnName": "advertiserId" }
],
"statisticsCurrency": "usd"
}
レポートデータの更新頻度
指標の中には他よりも新しいものがあります。詳しくは、検索広告 360 のレポートデータの更新頻度をご覧ください。
利用可能なすべての指標をレポートに含めるには、午前 0 時（エンジン アカウントのタイムゾーン）から約 4 時間待ってから、前日の指標のレポートをリクエストすることをおすすめします。conversion レポートの場合は、午前 0 時（キャンペーン マネージャーの広告主のタイムゾーン）から 12 時間待つことをおすすめします。API を使用してコンバージョン データをアップロードする場合、アップロード データの可用性について詳しくは、insert.operation をご覧ください。
数日経っても、エンジンのスパムフィルタや、API を介してアップロードされたオフライン コンバージョンによって、指標が変わることがあります。これらの変更を段階的にダウンロードするには、前回のダウンロード以降に変更されたデータに関するレポートをリクエストします。増分変更をダウンロードする場合は、定期的に完全なレポートをリクエストすることをおすすめします。たとえば、数日ごとに増分変更をダウンロードして、月に 1 回完全なレポートをリクエストできます。
属性の変更がレポートに反映されるまでのタイミング
検索広告 360 で行われた属性の変更が、API を使用してダウンロードしたレポートに表示されるまでに 1 分ほどかかります。検索広告 360 ではなく、外部エンジンで直接行った変更は、まずインバウンド同期を使って検索広告 360 にインポートする必要があります。
属性が変更されたエンティティを特定するため、変更されたデータのみを返すことをおすすめします。
アトリビューションのない広告とキーワードとは
検索広告 360 では指標を特定の広告に関連付けることができない場合があります。たとえば、サポートされていない形式の広告やクリックサーバー URL にエラーがあると、検索広告 360 で指標を広告に結び付けられなくなることがあります。検索広告 360 では、各広告グループについて、アトリビューションのない指標は「アトリビューションのない広告」に属するものとしてレポートされます。レポートでこれらの指標をリクエストするには、includeRemovedEntities を true に設定します。アトリビューションのない広告を簡単に確認できるようにするには、リクエストに isUnattributedAd 列を含めます。
同様に、検索広告 360 では指標を特定のキーワードに関連付けることができない場合もあります。これは、レポートに差異が生じると発生します。このような場合、アトリビューションなしキーワードの keywordId 列は 0 に設定されます。
レポートにスケーリングされたコンバージョンは含まれますか？
ブラウザの設定などの要因により、広告クリックに関する情報を保存するウェブサイトの Cookie を利用できない場合など、コンバージョンの測定が困難な場合があります。このような場合、Floodlight ではスケーリングを使用して、直接測定できないコンバージョン データが考慮されます。つまり Floodlight は過去のデータに機械学習を適用して、測定できないコンバージョン数とコンバージョン収益の量をモデル化します。その後 Floodlight では、算出された推定値をコンバージョン指標に追加することで、広告がどのようにコンバージョンにつながったかを包括的に把握することができます。
Floodlight では、常に以下のレポートの列にスケーリングが適用されます。
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- Floodlight アクティビティをレポートする保存済みの列
conversion レポートには、スケーリングされたコンバージョンは含まれません。直接測定されたコンバージョンのみが表示されます。conversion レポートのコンバージョン数と収益額は、上記の列でレポートされているコンバージョン数と収益と一致するとは限りません。
未処理のコンバージョンが集計された指標 XX として合わないのはなぜですか？
集計された指標と検索広告 360 の元のイベントの間に不一致が生じる場合は、集計された指標を信頼してください。指標の集計の計算時、検索広告 360 は、重複と思われるコンバージョンを削除することで、データソースのサニタイズを試みます。
ここで回答が見つからない場合はどうすればよいですか？
このサイトのリソースをご覧になっても、問題が解決しない場合は、次の情報を用意してサポートにお問い合わせください。
アクセスしようとしている検索広告 360 の代理店 ID と広告主 ID
Google API Console のプロジェクト番号
API へのアクセスに使用している Google アカウントのユーザー名。
このアカウントは、検索広告 360 へのアクセス権限が付与されているアカウントです。このアカウントは、承認を設定するときに使用するアカウントと同じです。リクエストのコード スニペット
JSON レスポンス
レスポンスがエラーの場合は、数値のエラーコードだけでなく、エラー メッセージも含めてください。