Method: customers.generateReachForecast

Belirli bir hedefleme / ürün karışımı için erişim tahmini oluşturur.

Verilen hataların listesi: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError ReachPlanError RequestError

HTTP isteği

POST https://googleads.googleapis.com/v14/customers/{customerId}:generateReachForecast

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 
{
  "campaignDuration": {
    object (CampaignDuration)
  },
  "cookieFrequencyCapSetting": {
    object (FrequencyCap)
  },
  "targeting": {
    object (Targeting)
  },
  "plannedProducts": [
    {
      object (PlannedProduct)
    }
  ],
  "forecastMetricOptions": {
    object (ForecastMetricOptions)
  },
  "currencyCode": string,
  "cookieFrequencyCap": integer,
  "minEffectiveFrequency": integer,
  "effectiveFrequencyLimit": {
    object (EffectiveFrequencyLimit)
  },
  "customerReachGroup": string
}
Alanlar
campaignDuration

object (CampaignDuration)

Zorunlu. Kampanya süresi.
cookieFrequencyCapSetting

object (FrequencyCap)

Planlanan her bir ürüne uygulanacak seçili çerez sıklık sınırı. Kampanya oluştururken Google Ads'de gösterilen sıklık sınırıyla eşdeğer olan bu sıklık, bir reklamın belirli bir zaman aralığında aynı kullanıcıya gösterilebileceği maksimum sayıyı ifade eder. Belirtilmezse varsayılan değer olarak 0 (sınır yok) uygulanır.

Bu alan, kullanımdan kaldırılan cookieFrequencyCap alanının yerini alır.
targeting

object (Targeting)

Ürün karışımında seçilen tüm ürünlere uygulanacak hedefleme.

Bu, planlı hedeflemedir: yürütme ayrıntıları reklamcılık ürününe göre değişebilir. Bir uygulama uzmanına danışın.

Hedeflemenin bunları nasıl etkilediğiyle ilgili ayrıntılar için belirli metriklere bakın.
plannedProducts[]

object (PlannedProduct)

Zorunlu. Tahmin edilecek ürünler. En fazla 15 planlanmış ürün olabilir.
forecastMetricOptions

object (ForecastMetricOptions)

Yanıtta döndürülen tahmin metriklerini kontrol eder.
currencyCode

string

Para birimi kodu. Üç karakterli ISO 4217 para birimi kodu.
cookieFrequencyCap

integer

Planlanan her bir ürüne uygulanacak seçili çerez sıklık sınırı. Bu değer, kampanya oluştururken Google Ads'de gösterilen sıklık sınırıyla eşdeğerdir. Bir reklamın aynı kullanıcıya gösterilebileceği maksimum sayıyı ifade eder. Belirtilmezse sınır uygulanmaz.

Bu alan v4 sürümünde kullanımdan kaldırıldı ve bir süre sonra silinecek. Bunun yerine cookieFrequencyCapSetting'i kullanın.
minEffectiveFrequency

integer

Bildirilen erişim metrikleri [1-10] için seçilen minimum etkili sıklık (bir kullanıcının reklamla karşılaşma sayısı). Bu işlem hedeflemeyi değil, yalnızca raporlamayı etkiler. Bir ayar belirtilmezse varsayılan değer olarak 1 uygulanır.

Bu alan, etkiliFrequencyLimit alanıyla birleştirilemez.
effectiveFrequencyLimit

object (EffectiveFrequencyLimit)

Forecast.effective_frequency_breakdowns kapsamında dahil edilecek en yüksek minimum etkili sıklık (bir kullanıcının reklamla karşılaşma sayısı) değeri [1-10]. Belirtilmezse Forecast.effective_frequency_breakdowns sağlanmaz.

Burada sağlanan etkili sıklık değeri, raporlanan erişim metrikleri için minimum etkili sıklık olarak da kullanılır.

Bu alan, minEffectiveFrequency alanıyla birleştirilemez.
customerReachGroup

string

Planlanan müşterinin adı. Bu, kullanıcı tanımlı bir değerdir.

Yanıt gövdesi

Oluşturulan erişim eğrisini içeren yanıt mesajı.

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

JSON gösterimi 
{
  "onTargetAudienceMetrics": {
    object (OnTargetAudienceMetrics)
  },
  "reachCurve": {
    object (ReachCurve)
  }
}
Alanlar
onTargetAudienceMetrics

object (OnTargetAudienceMetrics)

Bu eğri için hedef kitlelere referans verin.
reachCurve

object (ReachCurve)

Planlanan ürün karışımı için oluşturulan erişim eğrisi.

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.

CampaignDuration

Planlanan bir kampanyanın süresi.

JSON gösterimi 
{
  "dateRange": {
    object (DateRange)
  },
  "durationInDays": integer
}
Alanlar
dateRange

object (DateRange)

Kampanyanın tarih aralığı. Tarihler yyyy-aa-gg biçimindedir ve bu değerler dahildir. Bitiş tarihi en fazla 1 yıl sonrası olmalı ve tarih aralığı en az 92 gün olmalıdır.

Bu alan, timeInDays alanıyla birleştirilemez.
durationInDays

integer

Gün cinsinden süre değeri.

Bu alan, dateRange alanıyla birleştirilemez.

FrequencyCap

Bir reklamın belirli bir dönem boyunca bir kullanıcıya maksimum kaç kez gösterilebileceğini belirten bir kuraldır.

JSON gösterimi 
{
  "impressions": integer,
  "timeUnit": enum (FrequencyCapTimeUnit)
}
Alanlar
impressions

integer

Zorunlu. Gösterim sayısı (dahil).
timeUnit

enum (FrequencyCapTimeUnit)

Zorunlu. Zaman biriminin türü.

EffectiveFrequencyLimit

Etkin sıklık sınırı.

JSON gösterimi 
{
  "effectiveFrequencyBreakdownLimit": integer
}
Alanlar
effectiveFrequencyBreakdownLimit

integer

Forecast.effective_frequency_breakdowns kapsamında dahil edilecek en yüksek etkili sıklık değeri. Bu alan 1-10 arasındaki frekansları destekler (bu değerler dahil).

Hedefleme

Trafik metriklerinin raporlanacağı hedefleme.

JSON gösterimi 
{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (ReachPlanAgeRange),
  "genders": [
    {
      object (GenderInfo)
    }
  ],
  "devices": [
    {
      object (DeviceInfo)
    }
  ],
  "network": enum (ReachPlanNetwork),
  "audienceTargeting": {
    object (AudienceTargeting)
  },
  "plannableLocationId": string
}
Alanlar
plannableLocationIds[]

string

Bu tahminle hedeflenecek planlanabilir konum kimliklerinin listesi.

Birden fazla kimlik sağlanırsa tüm kimlikler aynı parentCountryId değerine sahip olmalıdır. parent_county üzeri için planlama desteklenmiyor. Planlanabilir yer kimlikleri ve bunların parentCountryId, ReachPlanService.ListPlannableLocations adresinden edinilebilir.

İstekler bu alanı veya plannableLocationId alanını ayarlamalıdır.
ageRange

enum (ReachPlanAgeRange)

Hedeflenen yaş grubu. Ayarlanmamış bir değer, tüm yaşları hedeflemeye eşdeğerdir.
genders[]

object (GenderInfo)

Hedeflenen cinsiyetler. Ayarlanmamış bir değer, MALE ve FEMALE için hedeflemeye eşdeğerdir.
devices[]

object (DeviceInfo)

Hedeflenen cihazlar. Belirtilmezse, geçerli tüm cihazları hedefler. Geçerli cihazlar ürüne ve bölgeye göre değişiklik gösterir ve ReachPlanService.ListPlannableProducts adresinden edinilebilir.
network

enum (ReachPlanNetwork)

Reklam ürünü için hedeflenebilir ağ. Belirtilmezse geçerli tüm ağları hedefler. Geçerli ağlar ürüne ve bölgeye göre değişiklik gösterir ve ReachPlanService.ListPlannableProducts adresinden edinilebilir.
audienceTargeting

object (AudienceTargeting)

Hedeflenen kitleler. Belirtilmezse belirli bir kitleyi hedeflemez.
plannableLocationId

string

Seçilen konumun kimliği. Planlanabilir yer kimlikleri ReachPlanService.ListPlannableLocations adresinden edinilebilir.

İstekler bu alanı veya plannableLocationIds alanını ayarlamalıdır.

Bu alan V12 sürümünden itibaren kullanımdan kaldırılmıştır ve gelecekteki bir sürümde kaldırılacaktır. Bunun yerine plannableLocationIds politikasını kullanın.

AudienceTargeting

Erişim tahmini için kitle hedefleme.

JSON gösterimi 
{
  "userInterest": [
    {
      object (UserInterestInfo)
    }
  ]
}
Alanlar
userInterest[]

object (UserInterestInfo)

Kullanıcı ilgi alanlarına dayalı hedeflenecek kitle listesi.

PlannedProduct

Erişim için planlanan bir ürün.

JSON gösterimi 
{
  "advancedProductTargeting": {
    object (AdvancedProductTargeting)
  },
  "plannableProductCode": string,
  "budgetMicros": string
}
Alanlar
advancedProductTargeting

object (AdvancedProductTargeting)

Seçilen ürünün hedefleme ayarları. Her ürün için kullanılabilir hedeflemeyi listelemek için ReachPlanService.ListPlannableProducts değerini kullanın.
plannableProductCode

string

Zorunlu. Planlama için seçilen ürün. Reklam ürünüyle ilişkilendirilen kod (ör. TrueView, Bumper). Kullanılabilir planlanabilir ürün kodlarını listelemek için ReachPlanService.ListPlannableProducts özelliğini kullanın.
budgetMicros

string (int64 format)

Zorunlu. Seçilen ürün için mikro cinsinden maksimum bütçe ayırması. Değer, seçilen planlama currencyCode'unda belirtilir. Örneğin: 1 000 000 ABD doları = 1 000 000 000 000 mikro.

AdvancedProductTargeting

Ürünler için gelişmiş hedefleme ayarları.

JSON gösterimi 
{

  // Union field advanced_targeting can be only one of the following:
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  }
  // End of list of possible types for union field advanced_targeting.
}
Alanlar
Birleştirme alanı advanced_targeting. Bu ürün için hedefleme seçenekleri. advanced_targeting şunlardan yalnızca biri olabilir:
youtubeSelectSettings

object (YouTubeSelectSettings)

YouTube Select hedeflemesi ayarları.

YouTubeSelectSettings

YouTube Select kanal listeleri için ayar isteği

JSON gösterimi 
{
  "lineupId": string
}
Alanlar
lineupId

string (int64 format)

YouTube Select hedefleme için kanal listesi.

ForecastMetricOptions

Döndürülecek tahmin metriklerini kontrol eder.

JSON gösterimi 
{
  "includeCoview": boolean
}
Alanlar
includeCoview

boolean

Yanıt tahminine birlikte izleme metriklerinin dahil edilip edilmeyeceğini belirtir.

OnTargetAudienceMetrics

Planlanan ürünler için kitle metrikleri. Bu metrikler aşağıdaki hedefleme boyutlarını dikkate alır:

  • Konum
  • PlannableAgeRange
  • Cinsiyet
  • Kitle Hedefleme (yalnızca youtubeAudienceSize için)
JSON gösterimi 
{
  "youtubeAudienceSize": string,
  "censusAudienceSize": string
}
Alanlar
youtubeAudienceSize

string (int64 format)

YouTube için dikkate alınan hedeflemeyle eşleşen referans kitle boyutu.
censusAudienceSize

string (int64 format)

Census için dikkate alınan hedeflemeyle eşleşen referans kitle boyutu.

ReachCurve

Planlanan ürünler için erişim eğrisi.

JSON gösterimi 
{
  "reachForecasts": [
    {
      object (ReachForecast)
    }
  ]
}
Alanlar
reachForecasts[]

object (ReachForecast)

Erişim eğrisindeki tüm noktalar.

ReachForecast

Erişim eğrisinde bir nokta.

JSON gösterimi 
{
  "costMicros": string,
  "forecast": {
    object (Forecast)
  },
  "plannedProductReachForecasts": [
    {
      object (PlannedProductReachForecast)
    }
  ]
}
Alanlar
costMicros

string (int64 format)

Mikro cinsinden maliyet.
forecast

object (Forecast)

Bu nokta için tahmini trafik metrikleri.
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

Erişim eğrisinde bu noktada planlanan her bir ürün için öngörülen ayırma ve trafik metrikleri.

Tahmin

Planlanan ürünler ve hedefleme için öngörülen trafik metrikleri.

JSON gösterimi 
{
  "effectiveFrequencyBreakdowns": [
    {
      object (EffectiveFrequencyBreakdown)
    }
  ],
  "onTargetReach": string,
  "totalReach": string,
  "onTargetImpressions": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
Alanlar
effectiveFrequencyBreakdowns[]

object (EffectiveFrequencyBreakdown)

Etkili sıklık tahminleri listesi. Liste, 1+ ile başlayıp GenerateReachForecastRequest.effective_frequency_limit parametresinde ayarlanan değerle sona erecek şekilde sıralanır. etkin Sıklık Sınırı ayarlanmadıysa bu liste boş olur.
onTargetReach

string (int64 format)

Hedefleme ile tam olarak eşleşen en az GenerateReachForecastRequest.min_effective_frequency veya GenerateReachForecastRequest.effective_frequency_limit kez ulaşılan benzersiz kullanıcıların sayısı.

Verilerin raporlanabilmesi için minimum sayıda benzersiz kullanıcıya ulaşılması gerektiğini unutmayın. Minimum sayı karşılanmazsa onTargetReach değeri 0'a yuvarlanır.
totalReach

string (int64 format)

En az GenerateReachForecastRequest.min_effective_frequency veya GenerateReachForecastRequest.effective_frequency_limit kez ulaşılan tekil kullanıcıların toplam sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir.

Verilerin raporlanabilmesi için minimum sayıda benzersiz kullanıcıya ulaşılması gerektiğini unutmayın. Minimum sayı karşılanmazsa totalReach değeri 0'a yuvarlanır.
onTargetImpressions

string (int64 format)

Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı.
totalImpressions

string (int64 format)

Reklam gösterimlerinin toplam sayısı. Buna, oturum açmış kullanıcılar hakkında yetersiz bilgi bulunması nedeniyle belirtilen Hedeflemenin dışında kalabilecek gösterimler dahildir.
viewableImpressions

string (int64 format)

Reklam gösterimlerinin görüntülenebilir olarak kabul edilme sayısı. Bir reklamı görüntülenebilir yapan şeyler ve görüntülenebilirliğin nasıl ölçüldüğü hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/7029393 adresini ziyaret edin.
onTargetCoviewReach

string (int64 format)

Birlikte izleyenler dahil olmak üzere, Hedefleme ile tam olarak eşleşen ulaşılan benzersiz kullanıcıların sayısı.
totalCoviewReach

string (int64 format)

Birlikte izleyenler dahil, ulaşılan benzersiz kullanıcıların sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir.
onTargetCoviewImpressions

string (int64 format)

Birlikte izleyen kullanıcılar da dahil olmak üzere, Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı.
totalCoviewImpressions

string (int64 format)

Birlikte izleyen kullanıcılar dahil toplam reklam gösterimi sayısı. Buna, oturum açmış kullanıcılar hakkında yetersiz bilgi bulunması nedeniyle belirtilen Hedeflemenin dışında kalabilecek gösterimler dahildir.

EffectiveFrequencyBreakdown

Belirli bir etkili sıklıkta erişilen benzersiz kullanıcı sayısının dökümü.

JSON gösterimi 
{
  "effectiveFrequency": integer,
  "onTargetReach": string,
  "totalReach": string,
  "effectiveCoviewReach": string,
  "onTargetEffectiveCoviewReach": string
}
Alanlar
effectiveFrequency

integer

Etkili sıklık [1-10].
onTargetReach

string (int64 format)

Hedefleme ile tam olarak eşleşen en az etkiliSıklık sürelerine ulaşan tekil kişi sayısı.

Verilerin raporlanabilmesi için minimum sayıda benzersiz kullanıcıya ulaşılması gerektiğini unutmayın. Minimum sayı karşılanmazsa onTargetReach değeri 0'a yuvarlanır.
totalReach

string (int64 format)

En az etkiliSıklık sürelerine ulaşan benzersiz kullanıcıların toplam sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir.

Verilerin raporlanabilmesi için minimum sayıda benzersiz kullanıcıya ulaşılması gerektiğini unutmayın. Minimum sayı karşılanmazsa totalReach değeri 0'a yuvarlanır.
effectiveCoviewReach

string (int64 format)

İlişkilendirilmiş etkiliFrequency değeri için ulaşılan kullanıcıların (birlikte izleyen kullanıcılar dahil) sayısı.
onTargetEffectiveCoviewReach

string (int64 format)

Belirtilen plan demografisinde ilişkili etkiliFrequency değeri için erişilen kullanıcı sayısı (birlikte izleyen kullanıcılar dahil).

PlannedProductReachForecast

Erişim eğrisi üzerindeki bir noktada belirli bir ürün için tahmini ayırma ve trafik metrikleri.

JSON gösterimi 
{
  "plannableProductCode": string,
  "costMicros": string,
  "plannedProductForecast": {
    object (PlannedProductForecast)
  }
}
Alanlar
plannableProductCode

string

Planlama için seçilen ürün. Döndürülen ürün kodları, aynı konum kimliğini kullanan ListPlannableProducts tarafından döndürülen kodlarla aynıdır.
costMicros

string (int64 format)

Mikro cinsinden maliyet. Planlanan bir veya daha fazla ürün, sınırlı envanter nedeniyle bütçeyi karşılayamıyorsa bu oran, ürünün giriş tahsisinden farklı olabilir.
plannedProductForecast

object (PlannedProductForecast)

Bu ürün için öngörülen trafik metrikleri.

PlannedProductForecast

Planlanan bir ürün için öngörülen trafik metrikleri.

JSON gösterimi 
{
  "onTargetReach": string,
  "totalReach": string,
  "onTargetImpressions": string,
  "totalImpressions": string,
  "viewableImpressions": string,
  "onTargetCoviewReach": string,
  "totalCoviewReach": string,
  "onTargetCoviewImpressions": string,
  "totalCoviewImpressions": string
}
Alanlar
onTargetReach

string (int64 format)

Hedefleme ile tam olarak eşleşen ulaşılan benzersiz kullanıcıların sayısı.

Verilerin raporlanabilmesi için minimum sayıda benzersiz kullanıcıya ulaşılması gerektiğini unutmayın. Minimum sayı karşılanmazsa onTargetReach değeri 0'a yuvarlanır.
totalReach

string (int64 format)

Ulaşılan benzersiz kullanıcı sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir.

Verilerin raporlanabilmesi için minimum sayıda benzersiz kullanıcıya ulaşılması gerektiğini unutmayın. Minimum sayı karşılanmazsa totalReach değeri 0'a yuvarlanır.
onTargetImpressions

string (int64 format)

Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı.
totalImpressions

string (int64 format)

Reklam gösterimlerinin toplam sayısı. Buna, oturum açmış kullanıcılar hakkında yetersiz bilgi bulunması nedeniyle belirtilen Hedeflemenin dışında kalabilecek gösterimler dahildir.
viewableImpressions

string (int64 format)

Reklam gösterimlerinin görüntülenebilir olarak kabul edilme sayısı. Bir reklamı görüntülenebilir yapan şeyler ve görüntülenebilirliğin nasıl ölçüldüğü hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/7029393 adresini ziyaret edin.
onTargetCoviewReach

string (int64 format)

Birlikte izleyenler dahil olmak üzere, Hedefleme ile tam olarak eşleşen ulaşılan benzersiz kullanıcıların sayısı.
totalCoviewReach

string (int64 format)

Birlikte izleyenler dahil, ulaşılan benzersiz kullanıcıların sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir.
onTargetCoviewImpressions

string (int64 format)

Birlikte izleyen kullanıcılar da dahil olmak üzere, Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı.
totalCoviewImpressions

string (int64 format)

Birlikte izleyen kullanıcılar dahil toplam reklam gösterimi sayısı. Buna, oturum açmış kullanıcılar hakkında yetersiz bilgi bulunması nedeniyle belirtilen Hedeflemenin dışında kalabilecek gösterimler dahildir.