Method: customers.generateSuggestedTargetingInsights

İstenen kitleyle alakalı hedefleme analizlerinin (ör. hedeflenebilir kitleler) bir koleksiyonunu döndürür.

Atılan hataların listesi: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "audience": {
    object (InsightsAudience)
  },
  "baselineAudience": {
    object (InsightsAudience)
  },
  "dataMonth": string,
  "customerInsightsGroup": string
}
Alanlar
audience

object (InsightsAudience)

Zorunlu. Analizlerin istendiği ilgili kitle.
baselineAudience

object (InsightsAudience)

İsteğe bağlı. Temel kitle. Belirtilmemişse varsayılan değer, ilgili kitleyle aynı ülkede bulunan tüm kullanıcılardır.
dataMonth

string

İsteğe bağlı. "yyyy-aa" biçiminde, analizler için kullanılacak bir aylık geçmiş veri aralığı. Politika ayarlanmadan bırakılırsa son otuz güne ait verilere ait analizler döndürülür.
customerInsightsGroup

string

İsteğe bağlı. Planlanan müşterinin adı. Bu, kullanıcı tanımlı bir değerdir.

Yanıt gövdesi

AudienceInsightsService.GenerateSuggestedTargetingInsights için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "suggestions": [
    {
      object (TargetingSuggestionMetrics)
    }
  ]
}
Alanlar
suggestions[]

object (TargetingSuggestionMetrics)

Hedeflenebilir kitleler için önerilen analizler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

TargetingSuggestionMetrics

İstenen kitleyle alakalı, önerilen bir hedeflenebilir kitle.

JSON gösterimi 
{
  "locations": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "userInterests": [
    {
      object (AudienceInsightsAttributeMetadata)
    }
  ],
  "coverage": number,
  "index": number,
  "potentialYoutubeReach": string
}
Alanlar
locations[]

object (AudienceInsightsAttributeMetadata)

Önerilen yer hedefleme. Bu özelliklerin hepsi GEO_TARGET_COUNTRY veya SUB_COUNTRY_LOCATION boyutuna sahip
ageRanges[]

object (AgeRangeInfo)

Önerilen yaş hedefleme; yaş hedefleme olmadığını belirtmek için boş olabilir.
gender

object (GenderInfo)

Önerilen cinsiyet hedefleme. Bu özellik, varsa GENDER GENDER'a sahiptir.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Hedeflenmesi önerilen kitle segmentleri. Bu özelliklerin tümünün boyutu AFFINITY_USER_INTEREST veya IN_MARKET_USER_INTEREST
coverage

number

Önerilen hedefleme kullanılarak ulaşılabilecek, istenen kitlenin oranı (0 ile 1 dahil olmak üzere).
index

number

Temel kitlenin kapsama oranı veya bu oran tanımlanmamışsa ya da anlamlı değilse sıfır.
potentialYoutubeReach

string (int64 format)

Bu hedefleme kullanılarak YouTube'da ulaşılabilecek tahmini kullanıcı sayısı.