Method: customers.generateAudienceOverlapInsights

一連のオーディエンス属性と、YouTube の潜在的なリーチと指定された入力属性の重複の推定値を返します。

スローされるエラーのリスト: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP リクエスト

POST https://googleads.googleapis.com/v17/customers/{customerId}:generateAudienceOverlapInsights

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

必須。顧客の ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
フィールド
countryLocation

object (LocationInfo)

必須。オーディエンスのサイズと重複を計算する国。
primaryAttribute

object (AudienceInsightsAttribute)

必須。他のすべての対象オーディエンスと交差する必要があるオーディエンス属性。必ず、[アフィニティ] または [購買意向の強いオーディエンス] の [関心]、[年齢層]、または [性別] を指定します。
dimensions[]

enum (AudienceInsightsDimension)

必須。primaryAttribute との重複を計算する属性のタイプ。値は、AFFINITY_USER_INTEREST、IN_MARKET_USER_INTEREST、AGE_RANGE、GENDER のサブセットにする必要があります。
customerInsightsGroup

string

計画対象のお客様の名前。これはユーザー定義の値です。

レスポンスの本文

AudienceInsightsService.GenerateAudienceOverlapInsights に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
フィールド
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

主な属性のメタデータ（YouTube の潜在的なリーチなど）。
dimensionResults[]

object (DimensionOverlapResult)

属性のリストと、プライマリ属性と重複する属性のリスト（リクエストされたディメンションごとに 1 つのリスト）。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/adwords

詳しくは、OAuth 2.0 の概要をご覧ください。

DimensionOverlapResult

GenerateAudienceOverlapInsightsResponse の一部として返される、単一ディメンションのオーディエンス属性のリスト（プライマリ属性との重複を含む）。

JSON 表現 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
フィールド
dimension

enum (AudienceInsightsDimension)

このセクションのすべての属性のディメンション。
items[]

object (AudienceOverlapItem)

属性とその重複がプライマリ属性と重複しています。

AudienceOverlapItem

視聴者属性と、この属性の YouTube リーチの可能性とメイン属性のリーチの可能性の重複を含むメタデータ。

JSON 表現 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
フィールド
attributeMetadata

object (AudienceInsightsAttributeMetadata)

属性とそのメタデータ（YouTube の潜在的なリーチなど）。
potentialYoutubeReachIntersection

string (int64 format)

このオーディエンス属性とメイン属性の交差部分の推定サイズ（メイン属性とこの属性の両方に一致するリーチ可能な YouTube ユーザーの数）。