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/v15/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

İstek gövdesi, aşağıdaki yapıyla birlikte 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 kişilerdir.
dataMonth

string

İsteğe bağlı. Analizler için kullanılacak, "yyyy-aa" biçimindeki bir aylık geçmiş veri aralığı. Politika ayarlanmazsa son otuz güne ait verilerle ilgili 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 konum hedefleme. Bu özelliklerin hepsi GEO_TARGET_COUNTRY veya SUB_COUNTRY_LOCATION boyutuna sahip
ageRanges[]

object (AgeRangeInfo)

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

object (GenderInfo)

Önerilen cinsiyet hedefleme. Varsa bu özelliğin GENDER boyutu vardır.
userInterests[]

object (AudienceInsightsAttributeMetadata)

Hedeflenmesi önerilen kitle segmentleri. Bu özelliklerin hepsinde AFFINITY_USER_INTEREST veya IN_MARKET_USER_INTEREST boyutu var
coverage

number

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

number

Kapsamın temel kitlenin kapsamına 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ı.