Method: advertisers.reachForecast.generateReachForecast

Belirli bir reklamveren ve hedefleme yapılandırması için erişim tahmini oluşturur.

HTTP isteği

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/reachForecast:generateReachForecast

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

Yol parametreleri

Parametreler
advertiserId

string (int64 format)

Zorunlu. Planlanan kampanyayı yayınlayacak reklamverenin kimliği.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "targeting": {
    object (Targeting)
  },
  "campaignDuration": {
    object (CampaignDuration)
  },
  "currencyCode": string,
  "plannedProducts": [
    {
      object (PlannedProduct)
    }
  ],
  "minEffectiveFrequency": integer
}
Alanlar
targeting

object (Targeting)

Zorunlu. Planlanan kampanyanın hedefleme parametreleri.
campaignDuration

object (CampaignDuration)

Zorunlu. Planlanan kampanyanın süresi.
currencyCode

string

Zorunlu. Planın ISO 4217 biçimindeki para birimi kodu.
plannedProducts[]

object (PlannedProduct)

Zorunlu. Tahmine dahil edilecek satır öğelerinin listesi.
minEffectiveFrequency

integer

İsteğe bağlıdır. Bildirilen erişim metrikleri için minimum etkili sıklık. Bu, bir müşterinin reklamla karşılaşması gereken minimum sayıdır. Bu ayar yalnızca raporlamayı etkiler.

1 ile 10 (her iki değer de dahil) arasında olmalıdır. Belirtilmezse varsayılan olarak 1 değeri uygulanır.

Yanıt metni

ReachForecastService.GenerateReachForecast için 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)

Hedeflenen coğrafi konumun tahmini kitle boyutları.
reachCurve

object (ReachCurve)

Oluşturulan tahmin eğrisi.

Yetkilendirme kapsamları

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

  • https://www.googleapis.com/auth/display-video

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

Hedefleme

Planlanmış bir kampanyanın hedefleme ayarları.

JSON gösterimi 
{
  "plannableLocationIds": [
    string
  ],
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ]
}
Alanlar
plannableLocationIds[]

string (int64 format)

Zorunlu. Hedeflenecek planlanabilir konumların kimlikleri.

Planlanabilir konumlar, reachForecast.retrievePlannableLocations yöntemi kullanılarak alınabilir.
ageRange

enum (PlannableAgeRange)

İsteğe bağlıdır. Hedeflenecek yaş grubu.
genders[]

enum (Gender)

İsteğe bağlıdır. Hedeflenecek cinsiyet seçenekleri.
devices[]

enum (DeviceType)

İsteğe bağlıdır. Hedeflenecek cihazlar.

CampaignDuration

Erişim planının süresi.

JSON gösterimi 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of mutually exclusive fields.
}
Alanlar
Kampanya süresi seçimi. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
durationDays

integer

Zorunlu. Planın kapsadığı gün sayısı.
dateRange

object (DateRange)

Zorunlu. Planın kapsadığı tarih aralığı.
Birbirini dışlayan alanların sonu.

PlannedProduct

Plana dahil belirli bir ürünün yapılandırması.

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

string

Zorunlu. Ürünün kodu (ör. "VIDEO_REACH_CAMPAIGN").
budgetMicros

string (int64 format)

Zorunlu. Bu ürünün mikro cinsinden bütçesi.
advancedProductTargeting

object (AdvancedProductTargeting)

İsteğe bağlıdır. İsteğe bağlı satır öğesi düzeyinde hedefleme geçersiz kılmaları.

AdvancedProductTargeting

Ürüne özel hedefleme geçersiz kılmaları.

JSON gösterimi 
{
  "surfaceTargetingSettings": {
    object (SurfaceTargetingSettings)
  },
  "targetFrequency": {
    object (TargetFrequency)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "ageRange": enum (PlannableAgeRange),
  "genders": [
    enum (Gender)
  ],
  "devices": [
    enum (DeviceType)
  ],
  "userInterestIds": [
    string
  ],
  "userListIds": [
    string
  ],
  "youtubeSelectSettings": {
    object (YouTubeSelectSettings)
  },
  "dateRange": {
    object (DateRange)
  },
  "plannableLocationIds": [
    string
  ],
  "network": enum (PlannableNetwork)
}
Alanlar
surfaceTargetingSettings

object (SurfaceTargetingSettings)

İsteğe bağlıdır. Hedeflenebilecek planlanabilir alanlar.
targetFrequency

object (TargetFrequency)

İsteğe bağlıdır. Reklamların belirli bir süre içinde aynı kullanıcıya ortalama gösterilme sayısıdır.
frequencyCap

object (FrequencyCap)

İsteğe bağlıdır. Belirli ürün için sıklık sınırı.
ageRange

enum (PlannableAgeRange)

İsteğe bağlıdır. Hedeflenecek yaş grubu.
genders[]

enum (Gender)

İsteğe bağlıdır. Hedeflenecek cinsiyet seçenekleri.
devices[]

enum (DeviceType)

İsteğe bağlıdır. Hedeflenecek cihazlar.
userInterestIds[]

string

İsteğe bağlıdır. Hedeflenecek kullanıcı ilgi alanı kimlikleri.

Planlanabilir kullanıcı ilgi alanları, reachForecast.retrievePlannableUserInterests yöntemi kullanılarak alınabilir.
userListIds[]

string

İsteğe bağlıdır. Hedeflenecek kullanıcı listesi kimlikleri.

Planlanabilir kullanıcı listeleri, reachForecast.retrievePlannableUserInterests yöntemi kullanılarak alınabilir.
youtubeSelectSettings

object (YouTubeSelectSettings)

İsteğe bağlıdır. YouTube Select ayarları
dateRange

object (DateRange)

İsteğe bağlıdır. Hedeflenecek tarih aralığı.
plannableLocationIds[]

string (int64 format)

İsteğe bağlıdır. Hedeflenecek planlanabilir yer kimlikleri.
network

enum (PlannableNetwork)

İsteğe bağlıdır. Hedeflenecek ağ.

SurfaceTargetingSettings

Yüzey hedefleme seçimi.

JSON gösterimi 
{
  "surfaces": [
    enum (PlannableSurface)
  ]
}
Alanlar
surfaces[]

enum (PlannableSurface)

İsteğe bağlıdır. Hedeflenecek yüzeyler.

YouTubeSelectSettings

YouTube Select kanal listeleri ayarları.

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

string (int64 format)

İsteğe bağlıdır. YouTube Select kanal listesinin kimliği.

OnTargetAudienceMetrics

Hedeflenen coğrafi konum için tahmini kitle boyutları.

JSON gösterimi 
{
  "youtubeAudienceSize": string,
  "censusAudienceSize": string
}
Alanlar
youtubeAudienceSize

string (int64 format)

YouTube kitlesinin tahmini boyutu.
censusAudienceSize

string (int64 format)

Hedeflenen coğrafyanın nüfus sayımı verilerine göre kitlenin boyutu.

ReachCurve

Oluşturulan erişim eğrisi.

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

object (ReachForecast)

Eğri üzerindeki noktalar maliyete göre sıralanır.

ReachForecast

Erişim eğrisindeki tek bir nokta.

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

string (int64 format)

Bu noktanın toplam maliyeti (mikro cinsinden).
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

Bu maliyet noktasında tek tek ürünlerin dökümü.
forecast

object (PlannedProductForecast)

Planın tamamı için toplu tahmin.

PlannedProductReachForecast

Belirli bir ürünün performans tahmini.

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

string (int64 format)

Bu ürünün mikro cinsinden maliyeti.
plannableProductCode

string

Ürünün kodu.
plannedProductForecast

object (PlannedProductForecast)

Ürünün performans metrikleri.

PlannedProductForecast

Bir tahmin noktası için performans metrikleri.

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

string (int64 format)

Hedeflenen erişim tanımına uyan, erişilen tekil kullanıcıların sayısı.
onTargetImpressions

string (int64 format)

Hedeflenen gösterim sayısı.
trueviewViews

string (int64 format)

TrueView görüntüleme sayısı.
totalReach

string (int64 format)

Erişilen benzersiz kişilerin toplam sayısı.
totalImpressions

string (int64 format)

Toplam gösterim sayısı.
viewableImpressions

string (int64 format)

Görüntülenebilir gösterimlerin sayısı.
onTargetCoviewReach

string (int64 format)

Birlikte izleyenler de dahil olmak üzere, hedeflenen tanımına uyan erişilen tekil kullanıcı sayısı.
totalCoviewReach

string (int64 format)

Birlikte izleyenler de dahil olmak üzere ulaşılan tekil kullanıcıların toplam sayısı.
onTargetCoviewImpressions

string (int64 format)

Birlikte izleyenler de dahil olmak üzere hedeflenen gösterim sayısı.
totalCoviewImpressions

string (int64 format)

Birlikte izleyenler dahil olmak üzere toplam gösterim sayısı.