キャンペーンと広告グループのターゲットに関するレポートを作成する

新しい Search Ads 360 Reporting API をご利用いただけるようになりました。新しい API では、柔軟性の向上により、カスタム レポートを作成し、レポート作成のアプリケーションやプロセスにデータを統合することができます。詳しくは、新しい Search Ads 360 Reporting API への移行と使用についての記事をご覧ください。

ターゲットとは、場所、ユーザー属性、検索クエリのその他の特性に基づいて広告を表示するための条件です。たとえば、広告主はキャンペーンの広告をニューヨーク、ボストン、シカゴのみに表示できます。また、特定の広告オーディエンスからの検索に対する入札単価を高く設定することで、そのオーディエンスに広告が表示される可能性を高めることもできます。

ターゲットのタイプには、キャンペーンにのみ適用できるターゲットもあれば、広告グループにのみ適用できるターゲットもあります。各レベルで使用可能なターゲットについては、campaignTarget レポートと adGroupTarget レポートのドキュメントをご覧ください。

特定のタイプのターゲットについてパフォーマンス指標を表示するレポートをリクエストできます。たとえば、広告主がキャンペーンのターゲットを地域に設定している場合は、campaignTarget リクエストに locationTargetName 列を含めます。生成されたレポートを取得すると、各対象地域でのキャンペーンのパフォーマンスを確認できます。

除外ターゲット

除外ターゲットを使用すると、指定した条件に一致する検索に対して広告が表示されなくなります。 ターゲットと同様に、除外ターゲットには、キャンペーンのみに適用できるものと、広告グループのみに適用できるものがあります。詳しくは、negativeCampaignTarget と negativeAdGroupTarget をご覧ください。

レポートをリクエストして、除外ターゲットが広告を除外するために使用する条件を確認できます。たとえば、広告主が除外ターゲットを使用して、特定の地域でキャンペーンの広告を表示しないようにする場合は、negativeCampaignTarget リクエストに locationTargetName 列を含めます。生成されたレポートを取得すると、キャンペーンから除外されている地域のリストを確認できます。

リクエストの例

さまざまなタイプのターゲットに対するリクエストの例を次に示します。

キャンペーンの対象地域に関するレポートを作成する

次の非同期リクエストの例では、対象地域のクリック数やインプレッション数などのデータが返されます（対象地域に関するレポートを利用できるのは、Google 広告の広告キャンペーンに限られます）。 検索広告 360 は、地域ターゲティング、近隣ターゲット、Google 広告の住所表示オプションの半径を指定したターゲットなど、いくつかのタイプの地域ターゲティングに対応しています。対象地域のレポートには、レポート範囲内に適用されるすべてのタイプの地域ターゲティングのデータが含まれます。

リクエストの例

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

サンプル レポート

以下に campaignTarget レポートの例を示します。このレポートには、地域ターゲティングが「US」、近隣ターゲットが「100.0 マイル（37.4220041,-122.0862462）」と指定されている近隣地域ターゲティングと、米国の郵便番号（90210）が指定された別の地域ターゲティングのパフォーマンスが表示されます。

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147

アカウント内のすべての広告グループのリマーケティング ターゲット

次の非同期リクエストの例では、特定の Google 広告 キャンペーンの広告グループに対して定義されているすべてのリマーケティング ターゲットのクリック数やインプレッション数などのデータが返されます。

リクエストの例

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

サンプル レポート

以下に adGroupTarget レポートの例を示します。レポートには、「アクセサリ」キャンペーンの 3 つの広告グループでリマーケティング ターゲットが定義されていることが示されます。各リマーケティング ターゲットのパフォーマンス指標も含まれます。

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2

アカウント内のすべての広告グループの動的広告ターゲット

動的広告ターゲットでは、動的検索広告を使用して広告を掲載するサイトのページを定義します。（動的広告ターゲットは、Google 広告エンジン アカウントでのみ使用でき、特定の広告グループで常に作成されます）。Google は検索インデックスを使用して、ユーザーの検索が動的広告ターゲットと一致するページに関連するかどうかを判断します。検索語句との関連性が高い場合は、ターゲットと同じ広告グループで定義されている動的検索広告が表示されます。

次の非同期リクエストの例では、エンジン アカウント内の広告グループに対して定義されているすべての動的広告ターゲットのクリック数やインプレッション数などのデータが返されます。

リクエストの例

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

サンプル レポート

以下に adGroupTarget レポートの例を示します。このレポートでは、「Google ストア」キャンペーンの 1 つの広告グループで動的広告ターゲットが定義されていることがわかります。ターゲットのパフォーマンス指標も含まれます。

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2

キャンペーンの除外対象地域に関するレポートを作成する

次の非同期リクエストの例では、エンジン アカウント内のキャンペーンから除外された地域が返されます（除外地域ターゲティングのレポートは、Google 広告の広告キャンペーンでのみ利用できます）。除外対象地域では、条件として地域ターゲティングのみが使用されます（近隣ターゲットや半径を指定したターゲットを指定することはできません）。そのため、除外対象地域のレポートには、レポート範囲内のキャンペーンから除外された地域のリストのみが含まれます。

除外ターゲット レポートのリクエストで期間を指定する必要はありません。除外レポートは常に現在の設定を返します。たとえば、前四半期で使用されていた除外ターゲットを表示するレポートをリクエストすることはできません。

リクエストの例

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

サンプル レポート

以下に negativeCampaignTarget レポートの例を示します。このレポートによると、「新規開業 - NE」キャンペーンではメイン州が除外され、「開業 - 西」キャンペーンではカリフォルニア州が除外されています。

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA