- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- CampaignDuration
- FrequencyCap
- EffectiveFrequencyLimit
- Hedefleme
- AudienceTargeting
- PlannedProduct
- AdvancedProductTargeting
- TargetFrequencySettings
- YouTubeSelectSettings
- ForecastMetricOptions
- OnTargetAudienceMetrics
- ReachCurve
- ReachForecast
- Tahmin
- EffectiveFrequencyBreakdown
- PlannedProductReachForecast
- PlannedProductForecast
- Deneyin.
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/v16/customers/{customerId}:generateReachForecast
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
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 ( |
Alanlar | |
---|---|
campaignDuration |
Zorunlu. Kampanya süresi. |
cookieFrequencyCapSetting |
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 |
Ü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[] |
Zorunlu. Tahmin edilecek ürünler. En fazla 15 planlanmış ürün olabilir. |
forecastMetricOptions |
Yanıtta döndürülen tahmin metriklerini kontrol eder. |
currencyCode |
Para birimi kodu. Üç karakterli ISO 4217 para birimi kodu. |
cookieFrequencyCap |
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 |
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 |
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 |
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 ( |
Alanlar | |
---|---|
onTargetAudienceMetrics |
Bu eğri için hedef kitlelere referans verin. |
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 ( |
Alanlar | |
---|---|
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 |
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 ( |
Alanlar | |
---|---|
impressions |
Zorunlu. Gösterim sayısı (dahil). |
timeUnit |
Zorunlu. Zaman biriminin türü. |
EffectiveFrequencyLimit
Etkin sıklık sınırı.
JSON gösterimi |
---|
{ "effectiveFrequencyBreakdownLimit": integer } |
Alanlar | |
---|---|
effectiveFrequencyBreakdownLimit |
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 ( |
Alanlar | |
---|---|
plannableLocationIds[] |
Bu tahminle hedeflenecek planlanabilir konum kimliklerinin listesi. Birden fazla kimlik sağlanırsa tüm kimlikler aynı İstekler bu alanı veya |
ageRange |
Hedeflenen yaş grubu. Ayarlanmamış bir değer, tüm yaşları hedeflemeye eşdeğerdir. |
genders[] |
Hedeflenen cinsiyetler. Ayarlanmamış bir değer, MALE ve FEMALE için hedeflemeye eşdeğerdir. |
devices[] |
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 |
network |
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 |
audienceTargeting |
Hedeflenen kitleler. Belirtilmezse belirli bir kitleyi hedeflemez. |
plannableLocationId |
Seçilen konumun kimliği. Planlanabilir yer kimlikleri İstekler bu alanı veya 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 |
AudienceTargeting
Erişim tahmini için kitle hedefleme.
JSON gösterimi |
---|
{
"userInterest": [
{
object ( |
Alanlar | |
---|---|
userInterest[] |
Kullanıcı ilgi alanlarına dayalı hedeflenecek kitle listesi. |
PlannedProduct
Erişim için planlanan bir ürün.
JSON gösterimi |
---|
{
"advancedProductTargeting": {
object ( |
Alanlar | |
---|---|
advancedProductTargeting |
Seçilen ürünün hedefleme ayarları. Her ürün için kullanılabilir hedeflemeyi listelemek için |
plannableProductCode |
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 |
budgetMicros |
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 |
---|
{ "surfaceTargetingSettings": { object ( |
Alanlar | |
---|---|
surfaceTargetingSettings |
Bu ürün için yüzey hedefleme ayarları. |
targetFrequencySettings |
Hedef sıklık kampanyası ayarları. TARGET_FREQUENCY ürünü seçilirken ayarlanmalıdır. Hedef Sıklık kampanyaları hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/12400225 adresini ziyaret edin. |
Birleştirme alanı advanced_targeting . Bu ürün için hedefleme seçenekleri. advanced_targeting şunlardan yalnızca biri olabilir: |
|
youtubeSelectSettings |
YouTube Select hedeflemesi ayarları. |
TargetFrequencySettings
Desteklenen bir ürün için Hedef Sıklık ayarları.
JSON gösterimi |
---|
{
"timeUnit": enum ( |
Alanlar | |
---|---|
timeUnit |
Zorunlu. targetFrequency'ın zaman aralığını açıklamak için kullanılan zaman birimi. |
targetFrequency |
Zorunlu. Seçilen zaman birimi başına hedef sıklık hedefi. |
YouTubeSelectSettings
YouTube Select kanal listeleri için ayar isteği
JSON gösterimi |
---|
{ "lineupId": string } |
Alanlar | |
---|---|
lineupId |
YouTube Select hedefleme için kanal listesi. |
ForecastMetricOptions
Döndürülecek tahmin metriklerini kontrol eder.
JSON gösterimi |
---|
{ "includeCoview": boolean } |
Alanlar | |
---|---|
includeCoview |
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 |
YouTube için dikkate alınan hedeflemeyle eşleşen referans kitle boyutu. |
censusAudienceSize |
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 ( |
Alanlar | |
---|---|
reachForecasts[] |
Erişim eğrisindeki tüm noktalar. |
ReachForecast
Erişim eğrisinde bir nokta.
JSON gösterimi |
---|
{ "costMicros": string, "forecast": { object ( |
Alanlar | |
---|---|
costMicros |
Mikro cinsinden maliyet. |
forecast |
Bu nokta için tahmini trafik metrikleri. |
plannedProductReachForecasts[] |
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 ( |
Alanlar | |
---|---|
effectiveFrequencyBreakdowns[] |
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 |
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 |
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 |
Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı. |
totalImpressions |
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 |
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 |
Birlikte izleyenler dahil olmak üzere, Hedefleme ile tam olarak eşleşen ulaşılan benzersiz kullanıcıların sayısı. |
totalCoviewReach |
Birlikte izleyenler dahil, ulaşılan benzersiz kullanıcıların sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir. |
onTargetCoviewImpressions |
Birlikte izleyen kullanıcılar da dahil olmak üzere, Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı. |
totalCoviewImpressions |
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. |
views |
Belirtilen ürün ve hedefleme için tahmin edilen reklam görüntüleme sayısı. Görüntüleyen kişi, bir reklamın gösterimden daha büyük bir bölümünü veya tamamını görüntülediğinde, bir görüntüleme sayılır. Görüntülemeler hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/2375431 adresini inceleyin. |
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 |
Etkili sıklık [1-10]. |
onTargetReach |
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 |
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 |
İlişkilendirilmiş etkiliFrequency değeri için ulaşılan kullanıcıların (birlikte izleyen kullanıcılar dahil) sayısı. |
onTargetEffectiveCoviewReach |
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 ( |
Alanlar | |
---|---|
plannableProductCode |
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 |
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 |
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, "averageFrequency": number, "views": string } |
Alanlar | |
---|---|
onTargetReach |
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 |
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 |
Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı. |
totalImpressions |
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 |
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 |
Birlikte izleyenler dahil olmak üzere, Hedefleme ile tam olarak eşleşen ulaşılan benzersiz kullanıcıların sayısı. |
totalCoviewReach |
Birlikte izleyenler dahil, ulaşılan benzersiz kullanıcıların sayısı. Buna, belirtilen Hedeflemenin dışında kalabilecek kişiler dahildir. |
onTargetCoviewImpressions |
Birlikte izleyen kullanıcılar da dahil olmak üzere, Hedefleme ile tam olarak eşleşen reklam gösterimlerinin sayısı. |
totalCoviewImpressions |
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. |
averageFrequency |
Seçilen zaman birimi başına bir kullanıcının bir reklamı görme sayısı. Tahmin uzunluğundaki zaman birimlerinin sayısıyla ortalaması alınır. Bu alan yalnızca hedef sıklık kampanyaları için doldurulur. Hedef Sıklık kampanyaları hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/12400225 adresini ziyaret edin. |
views |
Belirtilen ürün ve hedefleme için tahmin edilen reklam görüntüleme sayısı. Görüntüleyen kişi, bir reklamın gösterimden daha büyük bir bölümünü veya tamamını görüntülediğinde, bir görüntüleme sayılır. Görüntülemeler hakkında daha fazla bilgi için https://support.google.com/google-ads/answer/2375431 adresini inceleyin. |