- Kaynak: Ürün
- CreativeConfig
- CreativeType
- DimensionCreativeConfig
- DurationCreativeConfig
- DurationMatchType
- SkippableMatchType
- MakegoodDetails
- CreativeSource
- AudienceTargetingConfig
- AudienceType
- TargetingCriteria
- SelectedTargetingOption
- TargetingType
- AudienceSelection
- OrGroup
- TargetingSelection
- ForecastResult
- Tahmin
- ForecastCategory
- CpmRange
- ForecastBreakdownData
- ForecastBreakdown
- ErrorDetails
- InstantDealErrorStatus
- FrequencyCap
- TimeUnit
- Yöntemler
Kaynak: Ürün
Ürün
JSON gösterimi |
---|
{ "name": string, "displayName": string, "externalDealId": string, "transactionType": enum ( |
Alanlar | |
---|---|
name |
Ürünün göreli rota adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/orders/5678/products/abc". Yalnızca çıkış. |
displayName |
Ürünün görünen adı. Maksimum 240 bayt boyutunda ve UTF-8 kodlu olmalıdır. Zorunlu. |
externalDealId |
Harici kimlik. Bu, exchange sistemindeki anlaşma kimliğidir. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır. Tüm ürünler arasında benzersiz olmalıdır. Zorunlu. |
transactionType |
Ürün işlem türü. Zorunlu. |
pricingType |
Ürünün fiyatlandırma türü. Zorunlu. |
updateTime |
Ürünün en son güncellendiği zaman damgası. Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
startTime |
Bu ürünün etkinleşeceği zaman. endTime değerinden önce olmalıdır. Başlangıç saati, 1 yıldan daha uzun bir süre sonra olamaz. Zorunlu. Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
endTime |
Bu ürünün devre dışı kalacağı zaman. Şu anda 2036 yılından sonra olamaz. Zorunlu. Oluşturulan çıkışın her zaman Z ile normalleştirildiği ve 0, 3, 6 veya 9 kesirli basamak kullandığı RFC 3339'u kullanır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
rateDetails |
Fiyat ayrıntıları. Zorunlu. |
creativeConfig[] |
Bir ürünün reklam öğesi koşulları. Ayrılmış işlem türü ürün için gereklidir. |
makegood |
Bir ürünün telafi ürünü olup olmadığını gösterir. |
makegoodDetails |
Bir ürünün telafi ayrıntıları. Ürün telafi amaçlıysa zorunludur. |
creativeSource |
Bir ürünün reklam öğesi kaynağı. İsteğe bağlıdır, varsayılan olarak CREATIVE_SOURCE_ADVERTISER değerine ayarlanır. Ürün oluşturulduktan sonra değiştirilemez. |
mediumType |
Ürünün ortam türü. Geriye dönük uyumluluk için belirtilmezse varsayılan olarak DIGITAL değerine ayarlanır. Ürün oluşturulduktan sonra değiştirilemez. |
audienceTargetingConfig |
İsteğe bağlıdır. Seçilen kitle hedefleme yapılandırması, Exchange'de anlaşma düzeyinde uygulanır. |
targetingCriteria |
Yalnızca çıkış. Ürün hedefleme ölçütleri referansları. Yalnızca Anlık Fırsat Senaryoları için geçerlidir. |
forecastResult |
Ürün tahmini sonuçları. Hedefleme ölçütleri boş olmadığında ve tahmin sağlanmadığında gereklidir. Yalnızca Anlık Fırsat Senaryoları için geçerlidir. |
errorDetails |
Belirli ürün alanları güncellenemediğinde hata ayrıntıları belirtilmelidir. Hedefleme ölçütü nedeniyle tahmin sonucu sağlanamadığında veya üründe güncelleme yapılamadığında gereklidir. Yalnızca Anlık Fırsat Senaryoları için geçerlidir. |
frequencyCap |
Yalnızca çıkış. Alıcı tarafından seçilen sıklık sınırı. Yalnızca Anlık Fırsat Senaryoları için geçerlidir. |
etag |
Bir ürünü güncellerken belirtilmesi gereken bir etiket. Yalnızca etag alanı boş değilse güncelleme için belirtilmesi gerekir. Yalnızca Anlık Fırsat Senaryoları için geçerlidir. |
CreativeConfig
Bir ürün için reklam öğesi koşulları yapılandırması.
JSON gösterimi |
---|
{ "creativeType": enum ( |
Alanlar | |
---|---|
creativeType |
Reklam öğesi türü. Zorunlu. |
dimensionCreativeConfig |
Görüntülü reklam öğelerinin yapılandırması. Bu alan, doğal reklam öğeleri (CREATIVE_TYPE_NATIVE) için desteklenmez. |
durationCreativeConfig |
Video reklam öğelerinin yapılandırması. |
CreativeType
Olası reklam öğesi türleri.
Sıralamalar | |
---|---|
CREATIVE_TYPE_UNSPECIFIED |
Reklam öğesi türü belirtilmedi. Geçerli bir giriş değeri değil. |
CREATIVE_TYPE_DISPLAY |
Görüntülü reklam öğesinin türü. |
CREATIVE_TYPE_VIDEO |
Videonun reklam öğesi türü. |
CREATIVE_TYPE_AUDIO |
Sesli reklam öğesinin türü. |
CREATIVE_TYPE_NATIVE |
Doğal reklam öğesinin reklam öğesi türü. |
DimensionCreativeConfig
Piksel cinsinden görüntülü reklam öğesi boyutu.
JSON gösterimi |
---|
{ "width": integer, "height": integer } |
Alanlar | |
---|---|
width |
Görüntülü reklam öğesi genişliği. Zorunlu. |
height |
Görüntülü reklam öğesi yüksekliği. Zorunlu. |
DurationCreativeConfig
Reklam öğesinin süre içindeki yapılandırması.
JSON gösterimi |
---|
{ "duration": string, "durationMatchType": enum ( |
Alanlar | |
---|---|
duration |
Video reklam öğesinin saniye cinsinden süresi. Zorunlu En fazla dokuz kesirli basamak içeren ve " |
durationMatchType |
Süre eşleşme ölçütleri. |
skippableMatchType |
Video reklam öğesinin atlanabilir türü. |
DurationMatchType
Süre eşleşmesi ölçütü için olası biçimler.
Sıralamalar | |
---|---|
DURATION_MATCH_TYPE_UNSPECIFIED |
Süre eşleme ölçütü belirtilmemiş veya bu sürümde bilinmiyor. Geçerli bir giriş değeri değil. |
DURATION_MATCH_TYPE_EQUAL_TO |
Reklam öğesi süresi, gerekli süreyle aynı olmalıdır. |
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO |
Reklam öğesi süresi, gerekli süreyle aynı veya daha az olmalıdır. |
SkippableMatchType
Bir ürün için olası biçimler.
Sıralamalar | |
---|---|
SKIPPABLE_MATCH_TYPE_UNSPECIFIED |
Atlanabilir türü belirtilmemiş veya bu sürümde bilinmiyor. Geçerli bir giriş değeri değil. |
SKIPPABLE_MATCH_TYPE_SKIPPABLE |
Reklam öğesinin atlanabilir olması gerekir. |
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE |
Reklam öğesi atlanabilir olmamalıdır. |
SKIPPABLE_MATCH_TYPE_ANY |
Reklam öğesi atlanabilir veya atlanamayan türde olabilir. |
MakegoodDetails
Telafi ayrıntılarının yapılandırması.
JSON gösterimi |
---|
{ "originalExternalDealId": string, "reason": string } |
Alanlar | |
---|---|
originalExternalDealId |
İyileştirme isteğinde bulunan orijinal harici anlaşma kimliği. En fazla 100 karakter. İzin verilen karakterler alfanümerik, alt çizgi, kısa çizgi ve noktadır. Zorunlu. |
reason |
Satıcı tarafından başlatılan iyileştirme nedeni. Maks. 250 karakter. Zorunlu. |
CreativeSource
Reklam öğesi kaynağı: Reklam öğelerinin yayınlanacağı yer.
Sıralamalar | |
---|---|
CREATIVE_SOURCE_UNSPECIFIED |
Reklam öğesi kaynağı bu sürümde belirtilmemiş veya bilinmiyor. Geçerli bir giriş değeri değil. |
CREATIVE_SOURCE_ADVERTISER |
Reklam öğeleri DV3 tarafından yayınlanır. |
CREATIVE_SOURCE_PUBLISHER |
Reklam öğeleri yayıncı tarafından yayınlanır. Yayıncı tarafından barındırılan reklam öğeleri şu anda desteklenmemektedir. Reklam öğesi kaynağını CREATIVE_SOURCE_PUBLISHER olarak ayarlamaya çalışan tüm istekler başarısız olur. |
AudienceTargetingConfig
Kitle hedefleme için yapılandırma.
JSON gösterimi |
---|
{
"audienceType": enum ( |
Alanlar | |
---|---|
audienceType |
Kitle türü. Zorunlu. |
AudienceType
Kitle türü.
Sıralamalar | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
Belirtilmemiş kitle türü. Giriş için geçerli değil. |
AUDIENCE_TYPE_COMMERCE |
Ticari kitle türü. |
TargetingCriteria
Belirtilen hedefleme ölçütleri.
JSON gösterimi |
---|
{
"selectedTargetingOptions": [
{
object ( |
Alanlar | |
---|---|
selectedTargetingOptions[] |
Seçilen seçenekler. |
SelectedTargetingOption
Tek bir hedefleme türü için seçilen hedefleme seçeneği veya seçenekleri.
JSON gösterimi |
---|
{ "type": enum ( |
Alanlar | |
---|---|
type |
Seçilen seçeneklerle ilişkili hedefleme türü. |
value birleşik alanı. Yalnızca bir seçim türü eklenebilir. Seçilen seçenek, "tür" alanı için seçilen TargetingType ile eşleşmelidir. value aşağıdakilerden yalnızca biri olabilir: |
|
audienceSelection |
Seçilen kitle. |
targetingSelection |
Seçili seçenek kimliklerinin genel kümesi. |
TargetingType
Hedefleme türleri.
Sıralamalar | |
---|---|
TARGETING_TYPE_UNSPECIFIED |
Belirtilmeyen hedefleme türü, giriş için geçerli değil. |
TARGETING_TYPE_AUDIENCE |
Hedefleme türü kitle. |
TARGETING_TYPE_COUNTRY |
Hedefleme türü ülke. |
TARGETING_TYPE_DMA |
Hedefleme türü dma. |
TARGETING_TYPE_PROGRAMMER |
Hedefleme türü programcı. |
TARGETING_TYPE_BRAND |
Hedefleme türü markası. |
TARGETING_TYPE_CONTENT_GENRE |
Hedefleme türü içerik türü. |
TARGETING_TYPE_DEVICE |
Hedefleme türü cihaz. |
TARGETING_TYPE_OPERATING_SYSTEM |
Hedefleme türü işletim sistemi. |
TARGETING_TYPE_RATING |
Hedefleme türü derecelendirmesi. |
TARGETING_TYPE_ENVIRONMENT |
Hedefleme türü ortamı. |
TARGETING_TYPE_LANGUAGE |
Hedefleme türü dili. |
TARGETING_TYPE_GEO |
Hedefleme türü coğrafya. |
TARGETING_TYPE_AGE |
Hedefleme türü yaş. |
TARGETING_TYPE_GENDER |
Hedefleme türü cinsiyet. |
TARGETING_TYPE_CONTEXTUAL_SEGMENT |
Hedefleme türü içerik segmenti. |
TARGETING_TYPE_REQUEST_FORMAT |
Hedefleme türü istek biçimi. |
TARGETING_TYPE_PUBLISHER |
Hedefleme türü yayıncı. |
TARGETING_TYPE_INVENTORY_SIZE |
Hedefleme türü boyutu. |
TARGETING_TYPE_NETWORK |
Hedefleme türü ağı. |
TARGETING_TYPE_PLATFORM |
Hedefleme türü platformu. |
TARGETING_TYPE_VIDEO_DELIVERY_TYPE |
Hedefleme türü video yayınlama türü. |
TARGETING_TYPE_VIDEO_MINIMUM_PLAYER_SIZE |
Hedefleme türü video minimum oynatıcı boyutu. |
AudienceSelection
Seçilen kitle hedefleme seçenekleri.
JSON gösterimi |
---|
{
"includedOrGroups": [
{
object ( |
Alanlar | |
---|---|
includedOrGroups[] |
Dahil edilen seçenekler VE ile birleştirilir. Her dahil edilen seçenek, tek bir seçenek veya VEYA ile birleştirilmiş bir seçenek grubu olabilir. |
excludedOptionIds[] |
Hariç tutulan seçenekler OR ile birleştirilir. |
OrGroup
OR ile birleştirilmiş bir grup seçili seçenek.
JSON gösterimi |
---|
{ "optionIds": [ string ] } |
Alanlar | |
---|---|
optionIds[] |
Seçilen seçenek kimlikleri. |
TargetingSelection
Çoğu hedefleme türü için geçerli olan, seçilmiş bir veya daha fazla seçenek kimliğinden oluşan bir grup.
JSON gösterimi |
---|
{ "optionIds": [ string ] } |
Alanlar | |
---|---|
optionIds[] |
Seçilen seçenek kimlikleri. |
ForecastResult
Tahmin sonucu belirtildi.
JSON gösterimi |
---|
{
"forecasts": [
{
object ( |
Alanlar | |
---|---|
forecasts[] |
Tahmin. "forecastCategory", belirtilen her öğe için benzersiz olmalıdır. |
Tahmin
Belirtilen tahmin kategorisinin tahmini.
JSON gösterimi |
---|
{ "forecastCategory": enum ( |
Alanlar | |
---|---|
forecastCategory |
Tahmin istatistiğinin temsil ettiği belirtilen tahmin kategorisi. |
forecast_data birleşik alanı. Yalnızca bir tür istatistik verisi eklenebilir. Doldurulan veriler "forecastCategory" alanına karşılık gelmelidir. forecast_data aşağıdakilerden yalnızca biri olabilir: |
|
number |
Sayı verileri. |
percentage |
Yüzde verileri. |
cpmPrice |
BGBM fiyatı verileri. |
cpmRange |
BGBM fiyat aralığı verileri. |
forecastBreakdownData |
Tahmin dökümü verileri. |
ForecastCategory
Tahmin kategorisi.
Sıralamalar | |
---|---|
FORECAST_CATEGORY_UNSPECIFIED |
Belirtilmemiş kategori. Giriş için geçerli değil. |
FORECAST_CATEGORY_TOTAL_OPPORTUNITIES |
Toplam fırsat sayısı. Sayı verileri. |
FORECAST_CATEGORY_TOTAL_AUDIENCE |
Toplam kitle. Sayı verileri. |
FORECAST_CATEGORY_DIGITAL_TRP |
Dijital hedef kitlede gösterim puanları. Yüzde verileri. |
FORECAST_CATEGORY_SUGGESTED_CPM |
Önerilen BGBM fiyatı. BGBM aralığı veya BGBM fiyatı verileri. |
FORECAST_CATEGORY_UNIQUE_REACH |
Tekil erişimi tahmin edin. Sayı verileri. |
FORECAST_CATEGORY_FORECAST_BREAKDOWN |
Tahmin dökümü. Tahmin dökümü verileri. |
CpmRange
BGBM aralığı, BGBM'nin minimum ve maksimum değerlerini içerir.
JSON gösterimi |
---|
{ "minCpm": { object ( |
Alanlar | |
---|---|
minCpm |
BGBM aralığının alt sınırı. |
maxCpm |
BGBM aralığının üst sınırı. |
ForecastBreakdownData
Tahmin dökümü verileri, tahmin dökümünün listesini içerir.
JSON gösterimi |
---|
{
"forecastBreakdowns": [
{
object ( |
Alanlar | |
---|---|
forecastBreakdowns[] |
Tahmin dökümlerinin listesi. |
ForecastBreakdown
Seçilen hedefleme seçeneğinin tahmin dökümü.
JSON gösterimi |
---|
{ "selectedTargetingOption": { object ( |
Alanlar | |
---|---|
selectedTargetingOption |
Tek bir hedefleme türü için seçilen hedefleme seçeneği veya seçenekleri. |
breakdown_data birleşik alanı. Yalnızca bir tür döküm verisi eklenebilir. breakdown_data aşağıdakilerden yalnızca biri olabilir: |
|
impressions |
Tahmini gösterim sayısı. |
ErrorDetails
Güncellemede hatalar olduğunda belirtilen hata ayrıntıları.
JSON gösterimi |
---|
{
"message": string,
"instantDealErrorStatus": enum ( |
Alanlar | |
---|---|
message |
Güncelleme hataları olduğunda belirtilen mesaj. |
instantDealErrorStatus |
Anlık fırsatlar için güncellemede hatalar olduğunda belirtilen hata durumu. |
InstantDealErrorStatus
Anlık fırsat güncellemesinde hatalar olduğunda belirtilen hata durumu.
Sıralamalar | |
---|---|
INSTANT_DEAL_ERROR_STATUS_UNSPECIFIED |
Belirtilmemiş hata durumu. |
INSTANT_DEAL_ERROR_STATUS_INVENTORY_UNAVAILABLE |
Hata durumu, envanterin kullanılamadığını gösteriyor. |
INSTANT_DEAL_ERROR_STATUS_FORECAST_UNAVAILABLE |
Hata durumu, tahminin kullanılamadığını gösterir. |
INSTANT_DEAL_ERROR_STATUS_INVALID_INPUT |
Hata durumu, geçersiz giriş alanları olduğunu gösterir. |
FrequencyCap
Belirli bir dönemde bir kullanıcıya aynı reklamın gösterilme sayısı
JSON gösterimi |
---|
{
"timeUnit": enum ( |
Alanlar | |
---|---|
timeUnit |
Sıklık sınırının uygulanacağı zaman birimi. |
maxImpressions |
Bu dönemde bir kullanıcının aynı reklamla karşılaşabileceği maksimum sayı. |
TimeUnit
Sıklık sınırının uygulanacağı zaman birimi.
Sıralamalar | |
---|---|
TIME_UNIT_UNSPECIFIED |
Belirtilmemiş zaman birimi. |
TIME_UNIT_LIFETIME |
Sıklık sınırı, tüm kullanım ömrü boyunca uygulanır. |
TIME_UNIT_MONTHS |
Sıklık sınırı birkaç ay boyunca uygulanır. |
TIME_UNIT_WEEKS |
Sıklık sınırı, belirli bir hafta sayısı için uygulanır. |
TIME_UNIT_DAYS |
Sıklık sınırı belirli bir gün sayısına uygulanır. |
Yöntemler |
|
---|---|
|
Ürün oluşturur. |
|
Ürünü alır. |
|
Ürünü listeler. |
|
Bir ürünü günceller. |