Method: customers.generateAudienceOverlapInsights

Menampilkan kumpulan atribut audiens beserta estimasi tumpang-tindih antara potensi jangkauan YouTube mereka dan jangkauan atribut input tertentu.

Daftar error yang ditampilkan: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "countryLocation": {
    object (LocationInfo)
  },
  "primaryAttribute": {
    object (AudienceInsightsAttribute)
  },
  "dimensions": [
    enum (AudienceInsightsDimension)
  ],
  "customerInsightsGroup": string
}
Kolom
countryLocation

object (LocationInfo)

Wajib. Negara tempat penghitungan ukuran dan tumpang-tindih audiens.
primaryAttribute

object (AudienceInsightsAttribute)

Wajib. Atribut audiens yang harus berpotongan dengan semua audiens lain yang memenuhi syarat. Ini harus berupa Minat Pengguna Minat atau Berniat Beli, Rentang Usia, atau Gender.
dimensions[]

enum (AudienceInsightsDimension)

Wajib. Jenis atribut yang akan menghitung tumpang-tindih dengan primaryAttribute. Nilai harus merupakan subkumpulan dari AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST, AGE_RANGE, dan GENDER.
customerInsightsGroup

string

Nama pelanggan yang menjadi target perencanaan. Ini adalah nilai yang ditentukan pengguna.

Isi respons

Pesan respons untuk AudienceInsightsService.GenerateAudienceOverlapInsights.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "primaryAttributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "dimensionResults": [
    {
      object (DimensionOverlapResult)
    }
  ]
}
Kolom
primaryAttributeMetadata

object (AudienceInsightsAttributeMetadata)

Metadata untuk atribut utama, termasuk potensi jangkauan YouTube.
dimensionResults[]

object (DimensionOverlapResult)

Daftar atribut dan tumpang-tindih atribut tersebut dengan atribut utama, satu daftar per dimensi yang diminta.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

DimensionOverlapResult

Daftar atribut audiens dari satu dimensi, termasuk tumpang-tindih dengan atribut utama, yang ditampilkan sebagai bagian dari GenerateAudienceOverlapInsightsResponse.

Representasi JSON 
{
  "dimension": enum (AudienceInsightsDimension),
  "items": [
    {
      object (AudienceOverlapItem)
    }
  ]
}
Kolom
dimension

enum (AudienceInsightsDimension)

Dimensi semua atribut di bagian ini.
items[]

object (AudienceOverlapItem)

Atribut dan tumpang-tindih atribut tersebut dengan atribut utama.

AudienceOverlapItem

Atribut audiens, dengan metadata yang mencakup tumpang-tindih antara potensi jangkauan YouTube atribut ini dan atribut utama.

Representasi JSON 
{
  "attributeMetadata": {
    object (AudienceInsightsAttributeMetadata)
  },
  "potentialYoutubeReachIntersection": string
}
Kolom
attributeMetadata

object (AudienceInsightsAttributeMetadata)

Atribut dan metadatanya, termasuk potensi jangkauan YouTube.
potentialYoutubeReachIntersection

string (int64 format)

Perkiraan ukuran persimpangan atribut audiens ini dengan atribut utama, yaitu jumlah pengguna YouTube yang dapat dijangkau yang cocok DENGAN atribut utama dan atribut ini.