Method: customers.generateAudienceCompositionInsights

対象のオーディエンスに含まれる属性のコレクションを返します。各属性のオーディエンスの割合とベースライン オーディエンスのシェアを比較する指標が含まれます。

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

HTTP リクエスト

POST https://googleads.googleapis.com/v15/customers/{customerId}:generateAudienceCompositionInsights

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

パスパラメータ

パラメータ
customerId

string

必須。顧客の ID。

リクエスト本文

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

JSON 表現 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
フィールド
audience

object (InsightsAudience)

必須。インサイトがリクエストされている対象オーディエンス。
baselineAudience

object (InsightsAudience)

関心のあるオーディエンスと比較されるベースライン オーディエンスです。
dataMonth

string

分析情報に使用する過去のデータの 1 か月範囲（「yyyy-mm」形式）。未設定のままにすると、過去 30 日間のデータに関する分析情報が返されます。
dimensions[]

enum (AudienceInsightsDimension)

必須。楽曲に関する分析情報を返すオーディエンス ディメンション。
customerInsightsGroup

string

予定されているお客様の名前。これはユーザー定義の値です。

レスポンスの本文

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

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "sections": [
    {
      object (AudienceCompositionSection)
    }
  ]
}
フィールド
sections[]

object (AudienceCompositionSection)

セクション別に整理されたインサイト レポートの内容。各セクションは、リクエスト内の AudienceInsightsDimension 値の 1 つに関連付けられます。1 つのディメンションに複数のセクションが存在することがあります。

認可スコープ

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

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

詳細については、OAuth 2.0 の概要をご覧ください。

AudienceCompositionSection

オーディエンス構成の分析レポートに含まれる、同じ種類の関連属性のコレクションです。

JSON 表現 
{
  "dimension": enum (AudienceInsightsDimension),
  "topAttributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ],
  "clusteredAttributes": [
    {
      object (AudienceCompositionAttributeCluster)
    }
  ]
}
フィールド
dimension

enum (AudienceInsightsDimension)

このセクションの属性のタイプ。
topAttributes[]

object (AudienceCompositionAttribute)

このオーディエンスと最も関連性の高いセグメントです。ディメンションが GENDER、AGE_RANGE、または PARENTAL_STATUS の場合、この属性のリストは網羅的です。
clusteredAttributes[]

object (AudienceCompositionAttributeCluster)

このオーディエンスの追加属性（クラスタにグループ化）。ディメンションが YOUTUBE_CHANNEL の場合にのみ入力されます。

AudienceCompositionAttribute

メタデータと指標を含むオーディエンス属性。

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

object (AudienceInsightsAttributeMetadata)

属性とそのメタデータ。
metrics

object (AudienceCompositionMetrics)

属性の指標を共有し、インデックスに登録します。

AudienceCompositionMetrics

オーディエンス構成の分析レポートで、属性に関連付けられているシェアとインデックスの指標。

JSON 表現 
{
  "baselineAudienceShare": number,
  "audienceShare": number,
  "index": number,
  "score": number
}
フィールド
baselineAudienceShare

number

ベースライン オーディエンスで属性に一致する割合（0 ～ 1）。
audienceShare

number

この属性に一致する特定のオーディエンスの割合（0 ～ 1）。
index

number

manifestAudienceShare に対する AudienceShare の比率。この比率が定義されていない場合、または有意でない場合にはゼロになります。
score

number

0 ～ 1 の関連性スコア。

AudienceCompositionAttributeCluster

オーディエンス構成の分析レポートに含まれる、関連する属性のコレクション（メタデータと指標を含む）。

JSON 表現 
{
  "clusterDisplayName": string,
  "clusterMetrics": {
    object (AudienceCompositionMetrics)
  },
  "attributes": [
    {
      object (AudienceCompositionAttribute)
    }
  ]
}
フィールド
clusterDisplayName

string

この属性のクラスタの名前
clusterMetrics

object (AudienceCompositionMetrics)

このクラスタに関連付けられているディメンションが YOUTUBE_CHANNEL の場合、clusterMetrics はクラスタ全体に関連付けられている指標です。他のディメンションの場合、このフィールドは設定されません。
attributes[]

object (AudienceCompositionAttribute)

このクラスタを構成する個々の属性（メタデータと指標を含む）。