Method: customers.generateSuggestedTargetingInsights

Menampilkan kumpulan insight penargetan (mis. audiens yang dapat ditargetkan) yang relevan dengan audiens yang diminta.

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

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
Kolom
audience

object (InsightsAudience)

Wajib. Audiens minat yang analisisnya diminta.
baselineAudience

object (InsightsAudience)

Opsional. Audiens dasar. Jika tidak ditentukan, defaultnya adalah semua orang yang berada di negara yang sama dengan audiens minat.
dataMonth

string

Opsional. Rentang data historis selama satu bulan yang akan digunakan untuk insight, dalam format "yyyy-mm". Jika tidak disetel, insight akan ditampilkan untuk data tiga puluh hari terakhir.
customerInsightsGroup

string

Opsional. Nama pelanggan yang direncanakan. Nilai ini adalah nilai yang ditentukan pengguna.

Isi respons

Pesan respons untuk AudienceInsightsService.GenerateSuggestedTargetingInsights.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Kolom
suggestions[]

object (TargetingSuggestionMetrics)

Insight yang disarankan untuk audiens yang dapat ditargetkan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

TargetingSuggestionMetrics

Saran audiens yang dapat ditargetkan yang relevan dengan audiens yang diminta.

Representasi JSON 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Kolom
locations[]

object (AudienceInsightsAttributeMetadata)

Penargetan lokasi yang disarankan. Semua atribut ini memiliki dimensi GEO_TARGET_COUNTRY atau SUB_COUNTRY_LOCATION
ageRanges[]

object (AgeRangeInfo)

Penargetan usia yang disarankan; mungkin kosong yang menunjukkan tidak ada penargetan usia.
gender

object (GenderInfo)

Penargetan gender yang disarankan. Jika ada, atribut ini memiliki dimensi GENDER.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Segmen audiens yang disarankan untuk ditargetkan. Semua atribut ini memiliki dimensi AFFINITY_USER_ menarik atau IN_MARKET_USER_ menarik
coverage

number

Bagian (dari 0 hingga 1 inklusif) dari audiens yang diminta yang dapat dijangkau menggunakan penargetan yang disarankan.
index

number

Rasio cakupan terhadap cakupan audiens dasar pengukuran atau nol jika rasio ini tidak ditentukan atau tidak berarti.
potentialYoutubeReach

string (int64 format)

Perkiraan jumlah orang yang dapat dijangkau di YouTube menggunakan penargetan ini.