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ı. Bildirilen erişim metrikleri için minimum etkili sıklık. Bu, bir müşterinin reklamla etkili olarak değerlendirilmesi için karşılaşması gereken en düşük 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 bölge için 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

Planlanan 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ı. Hedeflenecek yaş grubu.
genders[]

enum (Gender)

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

enum (DeviceType)

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

CampaignDuration

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

JSON gösterimi 
{

  // Union field duration can be only one of the following:
  "durationDays": integer,
  "dateRange": {
    object (DateRange)
  }
  // End of list of possible types for union field duration.
}
Alanlar
duration birleşik alanı. Kampanya süresi seçimi. duration aşağıdakilerden yalnızca biri olabilir:
durationDays

integer

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

object (DateRange)

Zorunlu. Planın kapsadığı tarih aralığı.

PlannedProduct

Plandaki 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ı. İ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ı. Hedeflenecek planlanabilir alanlar.
targetFrequency

object (TargetFrequency)

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

object (FrequencyCap)

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

enum (PlannableAgeRange)

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

enum (Gender)

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

enum (DeviceType)

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

string

İsteğe bağlı. 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ı. Hedeflenecek kullanıcı listesi kimlikleri.

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

object (YouTubeSelectSettings)

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

object (DateRange)

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

string (int64 format)

İsteğe bağlı. Hedeflenecek planlanabilir konum kimlikleri.
network

enum (PlannableNetwork)

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

SurfaceTargetingSettings

Yüzey hedefleme seçimi.

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

enum (PlannableSurface)

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

YouTubeSelectSettings

YouTube Select kanal listeleri ayarları.

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

string (int64 format)

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

OnTargetAudienceMetrics

Hedeflenen bir 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ğrafi bölgenin 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 nokta için toplam maliyet (mikro cinsinden).
plannedProductReachForecasts[]

object (PlannedProductReachForecast)

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

object (PlannedProductForecast)

Planın tamamı için toplu tahmin.

PlannedProductReachForecast

Belirli bir ürünün performans öngörüsü.

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 tanımına uyan ve 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 toplam tekil kişi 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 benzersiz kullanıcı sayısı.
totalCoviewReach

string (int64 format)

Birlikte izleyenler de dahil olmak üzere erişilen 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ı.