- 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 kaynak adı. Sunucu tarafından oluşturulur. Örnek: "exchanges/1234/orders/5678/products/abc". Yalnızca çıkış. |
displayName |
Ürünün görünen adı. UTF-8 olarak kodlanmış ve maksimum 240 bayt boyutunda 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 genelinde 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ı. Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
startTime |
Bu ürünün etkinleştiği zaman. endTime'dan önce olmalıdır. Başlangıç zamanı, şu andan en fazla 1 yıl sonraya ait olabilir. Zorunlu. Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
endTime |
Bu ürünün etkin olmadığı zaman. 2036 yılından sonra olamaz. Zorunlu. Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: |
rateDetails |
Fiyat ayrıntıları. Zorunlu. |
creativeConfig[] |
Bir ürün için reklam öğesi koşulları. Ayrılmış işlem türü ürün için zorunludur. |
makegood |
Bir ürünün telafi ürünü olup olmadığını belirtir. |
makegoodDetails |
Bir ürünün telafi ayrıntıları. Ürün iyileştirme olduğunda 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. Exchange'de anlaşma düzeyinde uygulanan kitle hedefleme yapılandırması. |
targetingCriteria |
Yalnızca çıkış. Ürün hedefleme ölçütleri referansları. Yalnızca anında anlaşma 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 anında anlaşma senaryoları için geçerlidir. |
errorDetails |
Belirli ürün alanları güncellenemediğinde hata ayrıntıları belirtilmelidir. Bir hedefleme ölçütü nedeniyle tahmin sonucu sağlanamadığında veya üründe güncelleme yapılamadığında gereklidir. Yalnızca anında anlaşma senaryoları için geçerlidir. |
frequencyCap |
Yalnızca çıkış. Alıcı tarafından seçilen sıklık sınırı. Yalnızca anında anlaşma senaryoları için geçerlidir. |
program |
Yalnızca çıkış. Alıcının anında anlaşmayı oluşturduğu program. Exchange'in normal akışı için boş bırakın. Yalnızca anında anlaşma senaryoları için geçerlidir. |
buyerCustomParameters |
Yalnızca çıkış. Anında anlaşma isteğinde alıcı tarafından ayarlanan özel anahtar/değer parametreleri. Yalnızca anında anlaşma senaryoları için geçerlidir.
|
etag |
Bir ürün güncellenirken belirtilmesi gereken bir etag. Yalnızca etag alanı boş değilse bir güncelleme için belirtilmesi gerekir. Yalnızca anında anlaşma 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 desteklenmiyor. |
durationCreativeConfig |
Video reklam öğelerinin yapılandırması. |
CreativeType
Olası reklam öğesi türleri.
| Sıralamalar | |
|---|---|
CREATIVE_TYPE_UNSPECIFIED |
Reklam öğesi türü belirtilmedi. Geçersiz giriş değeri. |
CREATIVE_TYPE_DISPLAY |
Görüntülü reklam öğesi türü. |
CREATIVE_TYPE_VIDEO |
Video reklam öğesi türü. |
CREATIVE_TYPE_AUDIO |
İşitsel reklam öğesi türü. |
CREATIVE_TYPE_NATIVE |
Doğal reklam öğesi türü. Bu özellik, RESERVED işlem türündeki ürünler için desteklenmez. |
DimensionCreativeConfig
Görüntülü reklam öğesi boyutunu piksel cinsinden gösterir.
| 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
Süre içindeki reklam öğesinin 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
Video reklam öğesi süresi için eşleşme ölçütleri.
| Sıralamalar | |
|---|---|
DURATION_MATCH_TYPE_UNSPECIFIED |
Süre eşleşme ölçütü belirtilmemiş veya bu sürümde bilinmiyor. Geçersiz giriş değeri. |
DURATION_MATCH_TYPE_EQUAL_TO |
Reklam öğesi süresinin, gerekli süreyle aynı olması gerekir. |
DURATION_MATCH_TYPE_LESS_THAN_OR_EQUAL_TO |
Reklam öğesi süresi, gerekli süreyle aynı veya daha az olmalıdır. |
SkippableMatchType
Video reklam öğesinin atlanabilir olup olmadığına ilişkin eşleşme ölçütleri.
| Sıralamalar | |
|---|---|
SKIPPABLE_MATCH_TYPE_UNSPECIFIED |
Atlanabilir türü belirtilmemiş veya bu sürümde bilinmiyor. Geçersiz giriş değeri. |
SKIPPABLE_MATCH_TYPE_SKIPPABLE |
Reklam öğesinin atlanabilir olması gerekir. |
SKIPPABLE_MATCH_TYPE_NOT_SKIPPABLE |
Reklam öğesinin atlanabilir olmaması gerekir. |
SKIPPABLE_MATCH_TYPE_ANY |
Reklam öğesi atlanabilir veya atlanamayan türde olabilir. |
MakegoodDetails
Telafi ayrıntıları için yapılandırma.
| 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 telafi nedeni. Maksimum 250 karakter. Zorunlu. |
CreativeSource
Reklam öğesi kaynağı: Reklam öğelerinin nereden yayınlanacağı.
| Sıralamalar | |
|---|---|
CREATIVE_SOURCE_UNSPECIFIED |
Reklam öğesi kaynağı bu sürümde belirtilmemiş veya bilinmiyor. Geçersiz giriş değeri. |
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 yapılandırması.
| 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
Hedefleme ölçütleri belirtildi.
| JSON gösterimi |
|---|
{
"selectedTargetingOptions": [
{
object ( |
| Alanlar | |
|---|---|
selectedTargetingOptions[] |
Seçenekler belirlendi. |
SelectedTargetingOption
Tek bir hedefleme türü için seçilen hedefleme seçenekleri.
| JSON gösterimi |
|---|
{ "type": enum ( |
| Alanlar | |
|---|---|
type |
Seçilen seçeneklerle ilişkili hedefleme türü. |
Yalnızca bir seçim türü dahil edilebilir. Seçilen değer, type alanı için seçilen TargetingType ile eşleşmelidir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır: |
|
audienceSelection |
Seçili kitle. |
targetingSelection |
Seçilen seçenek kimliklerinin genel grubu. |
| Birbirini hariç tutan alanların sonu. | |
TargetingType
Hedefleme türleri.
| Sıralamalar | |
|---|---|
TARGETING_TYPE_UNSPECIFIED |
Belirtilmemiş 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ısı. |
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ü bağlamsal segment. |
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. |
TARGETING_TYPE_VIDEO_COMPLETION |
Hedefleme türü video yerleşimi. |
TARGETING_TYPE_VIEWABILITY |
Hedefleme türü görüntülenebilirliği. |
TARGETING_TYPE_REWARDED |
Hedefleme türü ödüllü. |
TARGETING_TYPE_VIDEO_AD_DURATION_THRESHOLD_SEC |
Hedefleme türü video reklam süresi eşiği (sn.) |
TARGETING_TYPE_VIDEO_PLACEMENT |
Hedefleme türü video yerleşimi. |
TARGETING_TYPE_VIDEO_PLAYBACK_METHOD |
Hedefleme türü video oynatma yöntemi. |
TARGETING_TYPE_APP_ID |
Hedefleme türü uygulama kimliği. |
TARGETING_TYPE_DOMAIN_URL |
Hedefleme türü alan adı URL'si. |
TARGETING_TYPE_CTR |
Hedefleme türü tıklama oranı. |
TARGETING_TYPE_DEMOGRAPHICS |
Hedefleme türü demografidir. |
TARGETING_TYPE_RESTRICTED_CATEGORY |
Hedefleme türü kısıtlanmış kategori. |
TARGETING_TYPE_AD_POSITION |
Hedefleme türü reklam konumu. |
TARGETING_TYPE_DAY_AND_TIME |
Hedefleme türü gün ve saat. |
TARGETING_TYPE_RETAIL_MEDIA_AUDIENCE |
Hedefleme türü perakende medya kitlesi. |
AudienceSelection
Seçilen kitle hedefleme seçenekleri.
| JSON gösterimi |
|---|
{
"includedOrGroups": [
{
object ( |
| Alanlar | |
|---|---|
includedOrGroups[] |
Dahil edilen seçenekler VE ile birleştirilir. Dahil edilen her seçenek, tek bir seçenek veya VEYA ile birleştirilmiş bir seçenek grubu olabilir. |
excludedOptionIds[] |
Hariç tutulan seçenekler VEYA ile birleştirilir. |
OrGroup
VEYA 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çili ve hariç tutulan hedefleme seçenekleri.
| JSON gösterimi |
|---|
{ "optionIds": [ string ], "externalIds": [ string ], "excludedOptionIds": [ string ], "excludedExternalIds": [ string ] } |
| Alanlar | |
|---|---|
optionIds[] |
Yalnızca çıkış. Seçilen DV3 hedefleme seçeneği kimlikleri exchange ile paylaşılır. İki liste çakışmadığı sürece |
externalIds[] |
Yalnızca çıkış. Exchange tarafından sağlanan seçili hedefleme seçeneği kimlikleri. İki liste çakışmadığı sürece |
excludedOptionIds[] |
Yalnızca çıkış. Exchange ile paylaşılan hariç tutulan DV3 hedefleme seçeneği kimlikleri. İki liste çakışmadığı sürece |
excludedExternalIds[] |
Yalnızca çıkış. Exchange tarafından sağlanan hariç tutulan hedefleme seçeneği kimlikleri. İki liste çakışmadığı sürece |
ForecastResult
Tahmin sonucu belirtildi.
| JSON gösterimi |
|---|
{
"forecasts": [
{
object ( |
| Alanlar | |
|---|---|
forecasts[] |
Tahmin. |
Tahmin
Belirtilen tahmin kategorisinin tahmini.
| JSON gösterimi |
|---|
{ "forecastCategory": enum ( |
| Alanlar | |
|---|---|
forecastCategory |
Tahmin istatistiğinin temsil ettiği belirtilen tahmin kategorisi. |
Yalnızca bir tür istatistik verisi dahil edilebilir. Doldurulan veriler forecastCategory alanına karşılık gelmelidir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır: |
|
number |
Sayı verileri. |
percentage |
Yüzde verileri. |
cpmPrice |
BGBM fiyat verileri. |
cpmRange |
BGBM fiyat aralığı verileri. |
forecastBreakdownData |
Tahmin dökümü verileri. |
| Birbirini hariç tutan alanların sonu. | |
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 puanı. Yüzde verileri. |
FORECAST_CATEGORY_SUGGESTED_CPM |
Önerilen BGBM fiyatı. BGBM aralığı veya BGBM fiyat verileri. |
FORECAST_CATEGORY_UNIQUE_REACH |
Unique Reach'i tahmin etme 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çenekleri. |
| Yalnızca bir tür döküm verisi dahil edilebilir. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır: | |
impressions |
Gösterimleri tahmin etme |
| Birbirini hariç tutan alanların sonu. | |
ErrorDetails
Güncellemede hata olduğunda belirtilen hata ayrıntıları.
| JSON gösterimi |
|---|
{
"message": string,
"instantDealErrorStatus": enum ( |
| Alanlar | |
|---|---|
message |
Güncellemede hata olduğunda belirtilen mesaj. |
instantDealErrorStatus |
Anında fırsatlarla ilgili güncellemede hata olduğunda belirtilen hata durumu. |
InstantDealErrorStatus
Anında anlaşma güncellemesinde hata 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österir. |
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ıya aynı reklamın gösterilebileceğ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üne uygulanır. |
TIME_UNIT_MONTHS |
Sıklık sınırı belirli bir ay sayısı için uygulanır. |
TIME_UNIT_WEEKS |
Sıklık sınırı belirli bir hafta sayısına 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. |
|
Bir ürün alır. |
|
Ürünleri listeler. |
|
Bir ürünü günceller. |