- Kaynak: Reklam öğesi
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- Öğe
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- Kod dönüştürme
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- Yöntemler
Kaynak: Reklam öğesi
Tek bir reklam öğesi.
JSON gösterimi |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Reklam öğesinin kaynak adı. |
advertiserId |
Yalnızca çıkış. Reklam öğesinin ait olduğu reklamverenin benzersiz kimliği. |
creativeId |
Yalnızca çıkış. Reklam öğesinin benzersiz kimliği. Sistem tarafından atanır. |
cmPlacementId |
Yalnızca çıkış. Reklam öğesiyle ilişkilendirilmiş Campaign Manager 360 yerleşiminin benzersiz kimliği. Bu alan yalnızca Campaign Manager'dan senkronize edilen reklam öğeleri için geçerlidir. |
displayName |
Zorunlu. Reklam öğesinin görünen adı. Maksimum 240 bayt boyutunda ve UTF-8 kodlu olmalıdır. |
entityStatus |
Zorunlu. Reklam öğesinin yayınlanıp yayınlanamayacağını kontrol eder. Kabul edilen değerler şunlardır:
|
updateTime |
Yalnızca çıkış. Reklam öğesinin kullanıcı veya sistem (ör. reklam öğesi incelemesi) tarafından en son güncellendiği zaman damgası. Sistem tarafından atanır. 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: |
createTime |
Yalnızca çıkış. Reklam öğesinin oluşturulduğu zamanı gösteren zaman damgası. Sistem tarafından atanır. 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: |
creativeType |
Zorunlu. Değişmez. Reklam öğesinin türü. |
hostingSource |
Zorunlu. Reklam öğesinin nerede barındırıldığını gösterir. |
dynamic |
Yalnızca çıkış. Reklam öğesinin dinamik olup olmadığını gösterir. |
dimensions |
Zorunlu. Reklam öğesinin birincil boyutları. Tüm reklam öğesi türleri için geçerlidir.
|
additionalDimensions[] |
İsteğe bağlıdır. Ek boyutlar.
Bu alan belirtilmişse hem |
mediaDuration |
Yalnızca çıkış. Reklam öğesinin medya süresi.
En fazla dokuz kesirli basamak içeren ve " |
creativeAttributes[] |
Yalnızca çıkış. Sistem tarafından oluşturulan reklam öğesinin özelliklerinin listesi. |
reviewStatus |
Yalnızca çıkış. Reklam öğesi inceleme sürecinin mevcut durumu. |
assets[] |
Zorunlu. Bu reklam öğesiyle ilişkili öğeler. |
exitEvents[] |
Zorunlu. Bu reklam öğesi için çıkış etkinlikleri. Bir çıkış (tıklama etiketi olarak da bilinir), reklam öğenizde kullanıcıların reklamverenin açılış sayfasını açmak için tıklayabileceği veya dokunabileceği herhangi bir alandır. Her reklam öğesi en az bir çıkış içermelidir. Reklam öğenize, aşağıdaki yollardan biriyle çıkış ekleyebilirsiniz:
|
timerEvents[] |
İsteğe bağlıdır. Rich media reklam öğesi için zamanlayıcı özel etkinlikleri. Kronometreler, kullanıcının rich media reklam öğesinin belirli bir bölümünü görüntülediği ve belirli bir bölümüyle etkileşim kurduğu süreyi izler. Bir reklam öğesinin, bağımsız olarak zamanlanmış birden çok zamanlayıcı etkinliği olabilir. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın veya ayarlamayın. |
counterEvents[] |
İsteğe bağlıdır. Rich media reklam öğesi için sayaç etkinlikleri. Sayaçlar, kullanıcının belirtilen şekilde (fareyle üzerine gelerek, fareyi üzerinden çekerek, tıklayarak, dokunarak, veri yükleyerek, klavye girişi yaparak vb.) rich media reklam öğesinin herhangi bir bölümüyle etkileşimde bulunma sayısını izler. Reklam öğesinde yakalanabilecek her etkinlik sayaç olarak kaydedilebilir. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın veya ayarlamayın. |
appendedTag |
İsteğe bağlıdır. Reklam öğesi etiketine eklenecek üçüncü taraf HTML izleme etiketi. |
integrationCode |
İsteğe bağlıdır. Bu reklam öğesini harici bir sisteme bağlamak için kullanılan kimlik bilgileri. 10.000 karakteri aşmayan bir uzunlukta UTF-8 kodlu olmalıdır. |
notes |
İsteğe bağlıdır. Bu reklam öğesiyle ilgili kullanıcı notları. UTF-8 kodlu olmalı ve uzunluğu 20.000 karakteri geçmemelidir. |
iasCampaignMonitoring |
İsteğe bağlıdır. Integral Ad Science (IAS) kampanya izlemenin etkin olup olmadığını gösterir. Reklam öğesi için bu özelliği etkinleştirmek istiyorsanız |
companionCreativeIds[] |
İsteğe bağlıdır. Video reklam öğesinin tamamlayıcı reklam öğelerinin kimlikleri. Mevcut görüntülü reklam öğelerini (resim veya HTML5 öğelerine sahip), yayıncının video oynatıcısının çevresinde sunulacak şekilde atayabilirsiniz. Tamamlayıcılar, video oynatılırken video oynatıcının etrafında görünür ve video tamamlandıktan sonra kalır.
Bu alan yalnızca aşağıdaki
|
skippable |
İsteğe bağlıdır. Kullanıcının video reklam öğesini atlayıp atlayamayacağı. Bu alan yalnızca aşağıdaki
|
skipOffset |
İsteğe bağlıdır. Atla düğmesi görünmeden önce videonun oynatılacağı süre.
Bu alan yalnızca aşağıdaki
|
progressOffset |
İsteğe bağlıdır. Görüntülemenin sayılması için videonun oynatılması gereken süre.
Bu alan yalnızca aşağıdaki
|
universalAdId |
İsteğe bağlıdır. Tüm platformlarda benzersiz olan, kayıt kuruluşu tarafından sağlanan isteğe bağlı bir reklam öğesi tanımlayıcısı. Evrensel Reklam Kimliği, VAST 4.0 standardının bir parçasıdır. Reklam öğesi oluşturulduktan sonra değiştirilebilir. Bu alan yalnızca aşağıdaki
|
thirdPartyUrls[] |
İsteğe bağlıdır. Video reklam öğesiyle etkileşimleri izlemek için üçüncü tarafların izleme URL'leri. Bu alan yalnızca aşağıdaki
|
transcodes[] |
Yalnızca çıkış. Ses/video transkodları. Display & Video 360, ana öğenin kodunu her biri belirli video oynatıcılar ya da bant genişlikleri için tasarlanmış, farklı biçimler kullanan veya farklı özelliklere (çözünürlük, ses bit hızı ve video bit hızı) sahip çeşitli alternatif sürümlere dönüştürür. Bu kod dönüştürmeler, videonuzdaki her bir gösterim için yayıncının sistemine aralarından seçim yapabileceği daha fazla seçenek sunar ve görüntüleyenin bağlantısına ve ekran boyutuna göre uygun dosyanın sunulmasını sağlar. Bu alan yalnızca aşağıdaki
|
trackerUrls[] |
İsteğe bağlıdır. Analiz sağlayıcıların veya üçüncü taraf reklam teknolojisi tedarikçi firmalarının izleme URL'leri. URL'ler Yalnızca standart URL'ler desteklenir; IMG veya SCRIPT etiketleri desteklenmez. Bu alan yalnızca aşağıdaki
|
jsTrackerUrl |
İsteğe bağlıdır. Desteklenen üçüncü taraf doğrulama sağlayıcılarından (ComScore, DoubleVerify, IAS, Moat) alınan JavaScript ölçüm URL'si. HTML komut dosyası etiketleri desteklenmez. Bu alan yalnızca aşağıdaki
|
cmTrackingAd |
İsteğe bağlıdır. Reklam öğesiyle ilişkili Campaign Manager 360 izleme reklamı. Hem Campaign Manager 360'ı hem de üçüncü taraf reklam sunumunu kullanan bir reklamveren tarafından oluşturulduğunda aşağıdaki
Diğer durumlarda yalnızca çıkış. |
obaIcon |
İsteğe bağlıdır. Bir video reklam öğesi için OBA simgesini belirtir. Bu alan yalnızca aşağıdaki
|
thirdPartyTag |
İsteğe bağlıdır. Reklam öğesi için kullanılan orijinal üçüncü taraf etiketi. Zorunludur ve yalnızca üçüncü taraf etiket reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
requireMraid |
İsteğe bağlıdır. Reklam öğesinin MRAID (Mobil Rich Media Reklam Arayüz Tanımları sistemi) gerektirdiğini belirtir. Reklam öğesiyle etkileşim kurulabilmesi için kaydırma veya dokunma gibi mobil hareketler gerekiyorsa bu ayarı etkinleştirin. İsteğe bağlıdır ve yalnızca üçüncü taraf etiket reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
requireHtml5 |
İsteğe bağlıdır. Reklam öğesinin düzgün şekilde oluşturulması için HTML5'e bağlı olduğunu gösterir. İsteğe bağlıdır ve yalnızca üçüncü taraf etiket reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
requirePingForAttribution |
İsteğe bağlıdır. Reklam öğesinin ilişkilendirme için bir geri dönüş ping'i bekleyeceğini belirtir. Yalnızca üçüncü taraf reklam sunucusu parametresi ve ${DC_DBM_TOKEN} makrosunu içeren bir Campaign Manager 360 izleme reklamı kullanıldığında geçerlidir. İsteğe bağlıdır ve yalnızca üçüncü taraf etiket reklam öğeleri veya üçüncü taraf VAST etiket reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklam öğeleri, aşağıdaki
aşağıdaki
Üçüncü taraf VAST etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
expandingDirection |
İsteğe bağlıdır. Reklam öğesinin genişleme yönünü belirtir. Gerekli ve yalnızca üçüncü taraf genişletilebilir reklam öğeleri için geçerlidir. Üçüncü taraf genişletilebilir reklam öğeleri, aşağıdaki barındırma kaynağına sahip reklam öğeleridir:
aşağıdaki
|
expandOnHover |
İsteğe bağlıdır. Reklam öğesinin fareyle üzerine gelindiğinde otomatik olarak genişleyeceğini gösterir. İsteğe bağlıdır ve yalnızca üçüncü taraf genişletilebilir reklam öğeleri için geçerlidir. Üçüncü taraf genişletilebilir reklam öğeleri, aşağıdaki barındırma kaynağına sahip reklam öğeleridir:
aşağıdaki
|
vastTagUrl |
İsteğe bağlıdır. Üçüncü taraf VAST etiketi reklam öğesi için VAST etiketinin URL'si. Zorunludur ve yalnızca üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
vpaid |
Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesinin VPAID (Dijital Video Oynatıcı Reklam Arayüzü) gerektirdiğini gösterir. Yalnızca çıkış ve yalnızca üçüncü taraf VAST etiket reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
html5Video |
Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesinin HTML5 Video desteği gerektirdiğini gösterir. Yalnızca çıkış ve yalnızca üçüncü taraf VAST etiket reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiket reklam öğeleri, aşağıdaki
aşağıdaki
|
lineItemIds[] |
Yalnızca çıkış. Bu reklam öğesinin ilişkilendirildiği satır öğelerinin kimlikleri. Bir reklam öğesini satır öğesiyle ilişkilendirmek için bunun yerine |
mp3Audio |
Yalnızca çıkış. Üçüncü taraf sesli reklam öğesinin MP3'ü desteklediğini gösterir. Yalnızca çıkış ve yalnızca üçüncü taraf sesli reklam öğeleri için geçerlidir. Üçüncü taraf işitsel reklam öğeleri, aşağıdaki
aşağıdaki
|
oggAudio |
Yalnızca çıkış. Üçüncü taraf sesli reklam öğesinin OGG'yi desteklediğini gösterir. Yalnızca çıkış ve yalnızca üçüncü taraf sesli reklam öğeleri için geçerlidir. Üçüncü taraf işitsel reklam öğeleri, aşağıdaki
aşağıdaki
|
HostingSource
Reklam öğesi için olası barındırma kaynakları. Reklam öğesinin nerede oluşturulduğunu ve barındırıldığını gösterir.
Sıralamalar | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
Barındırma kaynağı belirtilmemiş veya bu sürümde bilinmiyor. |
HOSTING_SOURCE_CM |
Campaign Manager 360'tan senkronize edilen bir reklam öğesi. Bu barındırma türü için oluşturma ve güncelleme yöntemleri desteklenmez. |
HOSTING_SOURCE_THIRD_PARTY |
Üçüncü taraf reklam sunucusu (3PAS) tarafından barındırılan bir reklam öğesi.
|
HOSTING_SOURCE_HOSTED |
DV360'ta oluşturulan ve Campaign Manager 360 tarafından barındırılan bir reklam öğesi.
|
HOSTING_SOURCE_RICH_MEDIA |
Studio'da oluşturulan ve Campaign Manager 360 tarafından barındırılan bir rich media reklam öğesi. Bu barındırma türü için oluşturma ve güncelleme yöntemleri desteklenmez. |
CreativeAttribute
Bir reklam öğesinin olası özellikleri.
Sıralamalar | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
Reklam öğesi özelliği belirtilmemiş veya bu sürümde bilinmiyor. |
CREATIVE_ATTRIBUTE_VAST |
Reklam öğesi bir VAST reklam öğesidir. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
Reklam öğesi, doğrusal bir VPAID reklam öğesidir. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
Reklam öğesi, doğrusal olmayan bir VPAID reklam öğesidir. |
ReviewStatusInfo
Reklam öğesinin durumlarını inceleyin.
JSON gösterimi |
---|
{ "approvalStatus": enum ( |
Alanlar | |
---|---|
approvalStatus |
Reklam öğesinin yayınlanmaya başlaması için gerekli temel onayı gösterir. |
creativeAndLandingPageReviewStatus |
Reklam öğesinin reklam öğesi ve açılış sayfası inceleme durumu. |
contentAndPolicyReviewStatus |
Reklam öğesinin içerik ve politika incelemesi durumu. |
exchangeReviewStatuses[] |
Reklam öğesinin exchange inceleme durumları. |
publisherReviewStatuses[] |
Reklam öğesi için yayıncı inceleme durumları. |
Onay Durumu
Olası onay durumu türleri. creativeAndLandingPageReviewStatus
ve contentAndPolicyReviewStatus
dosyalarının özetidir.
Sıralamalar | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
Tür değeri belirtilmemiş veya bu sürümde bilinmiyor. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
Reklam öğesi hâlâ inceleniyor ve yayınlanamıyor. |
APPROVAL_STATUS_PENDING_SERVABLE |
Reklam öğesi, reklam öğesi ve açılış sayfası incelemesinden geçti ve yayınlanabilir ancak ek içerik ve politika incelemesi bekleniyor. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Hem reklam öğesi ve açılış sayfası incelemesi hem de içerik ve politika incelemesi onaylanmış olmalıdır. Reklam öğesi yayınlanabilir. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
Reklam öğesi yayınlanmadan önce çözülmesi gereken bir sorun vardır. |
ReviewStatus
Olası yorum durumu türleri.
Sıralamalar | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
Tür değeri belirtilmemiş veya bu sürümde bilinmiyor. |
REVIEW_STATUS_APPROVED |
Reklam öğesi onaylandı. |
REVIEW_STATUS_REJECTED |
Reklam öğesi reddedilir. |
REVIEW_STATUS_PENDING |
Reklam öğesi incelenmeyi bekliyor. |
ExchangeReviewStatus
Reklam öğesinin exchange inceleme durumu.
JSON gösterimi |
---|
{ "exchange": enum ( |
Alanlar | |
---|---|
exchange |
Reklam öğesini inceleyen exchange |
status |
Exchange incelemesinin durumu. |
PublisherReviewStatus
Reklam öğesinin yayıncı inceleme durumu.
JSON gösterimi |
---|
{
"publisherName": string,
"status": enum ( |
Alanlar | |
---|---|
publisherName |
Reklam öğesini inceleyen yayıncı. |
status |
Yayıncı incelemesinin durumu. |
AssetAssociation
Reklam öğesi için öğe ilişkilendirmesi.
JSON gösterimi |
---|
{ "asset": { object ( |
Alanlar | |
---|---|
asset |
İsteğe bağlıdır. İlişkilendirilmiş öğe. |
role |
İsteğe bağlıdır. Bu öğenin reklam öğesi için rolü. |
Öğe
Tek bir öğe.
JSON gösterimi |
---|
{ "mediaId": string, "content": string } |
Alanlar | |
---|---|
mediaId |
Yüklenen öğenin medya kimliği. Bu, öğenin benzersiz tanımlayıcısıdır. Bu kimlik, öğeyi bir reklam öğesiyle ilişkilendirmek için Medya kimliği alanı 5 Nisan 2023'te güncellendi. 5 Nisan 2023'ten önce önbelleğe alınan medya kimliklerini, ilişkili reklam öğesi kaynaklarından yeni medya kimliğini alarak veya öğeyi yeniden yükleyerek güncelleyin. |
content |
Öğe içeriği. Yüklenen öğeler için içerik, yayınlama yoludur. |
AssetRole
Bu öğenin reklam öğesi için rolü.
Sıralamalar | |
---|---|
ASSET_ROLE_UNSPECIFIED |
Öğe rolü belirtilmemiş veya bu sürümde bilinmiyor. |
ASSET_ROLE_MAIN |
Öğe, reklam öğesinin ana öğesidir. |
ASSET_ROLE_BACKUP |
Öğe, reklam öğesinin yedek öğesidir. |
ASSET_ROLE_POLITE_LOAD |
Öğe, reklam öğesinin nazik yükleme öğesidir. |
ASSET_ROLE_HEADLINE |
Doğal reklam öğesinin başlığı.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_LONG_HEADLINE |
Yerel reklam öğesinin uzun başlığı.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_BODY |
Yerel reklam öğesinin gövde metni.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_LONG_BODY |
Bir doğal reklam öğesinin uzun gövde metni.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_CAPTION_URL |
Reklam öğesinde gösterilecek açılış sayfası URL'sinin kısa ve kolay okunabilen bir sürümü. Bu URL, kullanıcılara reklam öğesini tıkladıktan sonra nereye yönlendirilecekleriyle ilgili fikir verir.
Örneğin, açılış sayfası URL'si "http://www.example.com/page" ise başlık URL'si "example.com" olabilir. Protokol (http://) isteğe bağlıdır ancak URL boşluk veya özel karakter içeremez. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_CALL_TO_ACTION |
Yerel reklam öğesinin harekete geçirici mesaj düğmesinde kullanılacak metin.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_ADVERTISER_NAME |
Reklamvereni veya marka adını belirten metin.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_PRICE |
Uygulamanızın Google Play Store veya iOS App Store'daki satın alma fiyatı (örneğin, 5,99 ABD doları). Bu değerin, mağazada listelenen gerçek değerle otomatik olarak senkronize edilmediğini unutmayın. Bu değer, reklam öğesi kaydedilirken her zaman sağlanan değerdir.
Bu role ait öğeler salt okunurdur. |
ASSET_ROLE_ANDROID_APP_ID |
Google Play Store'daki bir Android uygulamasının kimliği. Bu kimliği, uygulamanın Google Play Store URL'sinde "id"den sonra bulabilirsiniz. Örneğin, Bu role ait öğeler salt okunurdur. |
ASSET_ROLE_IOS_APP_ID |
Apple App Store'daki bir iOS uygulamasının kimliği. Bu kimlik numarası, Apple App Store URL'sinde doğrudan "id"den sonra gelen sayı dizisi olarak bulunabilir. Örneğin, Bu role ait öğeler salt okunurdur. |
ASSET_ROLE_RATING |
Bir uygulamanın Google Play Store veya iOS App Store'daki puanı. Bu değerin, mağazadaki gerçek puanla otomatik olarak senkronize edilmediğini unutmayın. Bu değer, reklam öğesi kaydedilirken her zaman sağlanan değerdir. Bu role ait öğeler salt okunurdur. |
ASSET_ROLE_ICON |
Reklam öğesinin simgesi. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_COVER_IMAGE |
Yerel video reklam öğesinin kapak resmi. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_BACKGROUND_COLOR |
Reklam öğesinde kullanılacak ana renk. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_ACCENT_COLOR |
Reklam öğesinde kullanılacak vurgu rengi. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_REQUIRE_LOGO |
Reklam öğesinin logo öğesi kullanması gerekip gerekmediği. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_REQUIRE_IMAGE |
Reklam öğesinin resim öğesi kullanması gerekip gerekmediği. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS |
Öğe geliştirmelerinin reklam öğesine uygulanıp uygulanamayacağı. Bu rol yalnızca aşağıdaki
|
ExitEvent
Reklam öğesinin çıkış etkinliği.
JSON gösterimi |
---|
{
"type": enum ( |
Alanlar | |
---|---|
type |
Zorunlu. Çıkış etkinliğinin türü. |
url |
Zorunlu. Çıkış etkinliğinin tıklama URL'si. Bu,
|
name |
İsteğe bağlıdır. Çıkış etkinliğinin tıklama etiketinin adı. Ad, bir reklam öğesi içinde benzersiz olmalıdır. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın veya ayarlamayın. |
reportingName |
İsteğe bağlıdır. Bu etkinliği raporlarda tanımlamak için kullanılan ad. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın veya ayarlamayın. |
ExitEventType
Bir çıkış etkinliğinin türü.
Sıralamalar | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
Çıkış etkinliği türü belirtilmemiş veya bu sürümde bilinmiyor. |
EXIT_EVENT_TYPE_DEFAULT |
Çıkış etkinliği varsayılan etkinliktir. |
EXIT_EVENT_TYPE_BACKUP |
Çıkış etkinliği, yedek çıkış etkinliğidir. Bir reklam öğesinde birden fazla yedek çıkış etkinliği olabilir. |
TimerEvent
Reklam öğesinin zamanlayıcı etkinliği.
JSON gösterimi |
---|
{ "name": string, "reportingName": string } |
Alanlar | |
---|---|
name |
Zorunlu. Zamanlayıcı etkinliğinin adı. |
reportingName |
Zorunlu. Bu zamanlayıcı etkinliğini raporlarda tanımlamak için kullanılan ad. |
CounterEvent
Reklam öğesinin sayaç etkinliği.
JSON gösterimi |
---|
{ "name": string, "reportingName": string } |
Alanlar | |
---|---|
name |
Zorunlu. Sayaç etkinliğinin adı. |
reportingName |
Zorunlu. Bu sayaç etkinliğini raporlarda tanımlamak için kullanılan ad. |
AudioVideoOffset
Bir ses veya videonun oynatılma süresi.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
offset birleşik alanı. Ofsetin değeri. offset aşağıdakilerden yalnızca biri olabilir: |
|
percentage |
İsteğe bağlıdır. Ses veya video süresinin yüzde cinsinden ofseti. |
seconds |
İsteğe bağlıdır. Ses veya videonun başlangıcından itibaren saniye cinsinden göreli konum. |
UniversalAdId
Tüm platformlarda benzersiz olan, kayıt kuruluşu tarafından sağlanan bir reklam öğesi tanımlayıcısı. Bu, VAST 4.0 standardının bir parçasıdır.
JSON gösterimi |
---|
{
"id": string,
"registry": enum ( |
Alanlar | |
---|---|
id |
İsteğe bağlıdır. Benzersiz reklam öğesi tanımlayıcısı. |
registry |
İsteğe bağlıdır. Tescil kurumu, benzersiz reklam öğesi tanımlayıcıları sağlar. |
UniversalAdRegistry
Kayıt, evrensel reklam kimliğinde benzersiz reklam öğesi tanımlayıcıları sağlar.
Sıralamalar | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
Evrensel reklam kaydı bu sürümde belirtilmemiş veya bilinmiyor. |
UNIVERSAL_AD_REGISTRY_OTHER |
Evrensel reklam kimliğini sağlamak için özel bir sağlayıcı kullanın. |
UNIVERSAL_AD_REGISTRY_AD_ID |
Evrensel reklam kimliğini sağlamak için Ad-ID'yi kullanın. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
Evrensel reklam kimliğini sağlamak için clearcast.co.uk'u kullanın. |
UNIVERSAL_AD_REGISTRY_DV360 |
Evrensel Reklam Kimliği'ni sağlamak için Display & Video 360'ı kullanın. |
UNIVERSAL_AD_REGISTRY_CM |
Evrensel Reklam Kimliği'ni sağlamak için Campaign Manager 360'ı kullanın. |
ThirdPartyUrl
Bir ses veya video reklam öğesiyle etkileşimleri izlemek için üçüncü tarafların izleme URL'leri.
JSON gösterimi |
---|
{
"type": enum ( |
Alanlar | |
---|---|
type |
İsteğe bağlıdır. Etkileşim türü, izleme URL'si tarafından izlenmelidir. |
url |
İsteğe bağlıdır. Etkileşimi izlemek için kullanılan izleme URL'si.
|
ThirdPartyUrlType
Etkileşim türü, üçüncü taraf izleme URL'si tarafından izlenmelidir.
Sıralamalar | |
---|---|
THIRD_PARTY_URL_TYPE_UNSPECIFIED |
Üçüncü taraf URL'sinin türü belirtilmemiş veya bu sürümde bilinmiyor. |
THIRD_PARTY_URL_TYPE_IMPRESSION |
İşitsel veya video arabelleğe alma işlemi tamamlandıktan sonra reklam öğesinin gösterimlerini saymak için kullanılır. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
Kullanıcının ses veya video üzerindeki tıklamalarını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Kullanıcının sesi veya videoyu kaç kez başlattığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
Ses veya videonun, uzunluğunun% 25'ine kadar oynatılma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
Ses veya videonun, uzunluğunun% 50'sine kadar oynatılma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
Ses veya videonun, uzunluğunun% 75'ine kadar oynatılma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
Ses veya videonun sonuna kadar oynatılma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
Kullanıcının ses veya videoyu kaç defa sessize aldığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
Kullanıcının sesi veya videoyu duraklatma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
Kullanıcının sesi veya videoyu kaç defa yeniden oynattığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
Kullanıcının oynatıcıyı kaç defa tam ekran boyutuna getirdiğini izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
Kullanıcının sesi veya videoyu durdurma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
Kullanıcının video etkin noktasını tıklamak gibi özel bir tıklama işlemi gerçekleştirme sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
Ses veya videonun kaç kez atlandığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
Ses veya videonun, progressOffset ile belirlenen bir ofsete kadar kaç defa oynatıldığını izlemek için kullanılır. |
Kod dönüştürme
Dönüştürülmüş ses veya video dosyasıyla ilgili bilgileri gösterir.
JSON gösterimi |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
Alanlar | |
---|---|
name |
İsteğe bağlıdır. Dönüştürülmüş dosyanın adı. |
mimeType |
İsteğe bağlıdır. Dönüştürülen dosyanın MIME türü. |
transcoded |
İsteğe bağlıdır. Kod dönüştürme işleminin başarılı olup olmadığını gösterir. |
dimensions |
İsteğe bağlıdır. Kod dönüştürme işlemi uygulanan videonun boyutları. |
bitRateKbps |
İsteğe bağlıdır. Kod dönüştürme işlemi uygulanan videonun kod dönüştürme bit hızı (kilobit/saniye). |
frameRate |
İsteğe bağlıdır. Dönüştürülen videonun kare hızı (saniyedeki kare sayısı). |
audioBitRateKbps |
İsteğe bağlıdır. Dönüştürülen videonun ses akışının bit hızı veya dönüştürülen sesin bit hızı (kilobit/saniye). |
audioSampleRateHz |
İsteğe bağlıdır. Dönüştürülmüş videonun ses akışının örnek hızı veya dönüştürülmüş sesin örnek hızı (hertz cinsinden). |
fileSizeBytes |
İsteğe bağlıdır. Dönüştürülen dosyanın bayt cinsinden boyutu. |
CmTrackingAd
Campaign Manager 360 izleme reklamı
JSON gösterimi |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Alanlar | |
---|---|
cmPlacementId |
İsteğe bağlıdır. Campaign Manager 360 izleme reklamının yerleşim kimliği. |
cmCreativeId |
İsteğe bağlıdır. Campaign Manager 360 izleme reklamının reklam öğesi kimliği. |
cmAdId |
İsteğe bağlıdır. Campaign Manager 360 izleme reklamının reklam kimliği. |
ObaIcon
Reklam öğesi için OBA simgesi
JSON gösterimi |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
Alanlar | |
---|---|
resourceUrl |
İsteğe bağlıdır. OBA simgesi kaynağının URL'si. |
resourceMimeType |
İsteğe bağlıdır. OBA simgesi kaynağının MIME türü. |
position |
İsteğe bağlıdır. OBA simgesinin reklam öğesindeki konumu. |
dimensions |
İsteğe bağlıdır. OBA simgesinin boyutları. |
program |
İsteğe bağlıdır. OBA simgesinin programı. Örneğin: "Reklam Seçenekleri". |
landingPageUrl |
Zorunlu. OBA simgesinin açılış sayfası URL'si. Yalnızca aşağıdaki alanların URL'lerine izin verilir:
|
clickTrackingUrl |
Zorunlu. OBA simgesinin tıklama izleme URL'si. Yalnızca aşağıdaki alanların URL'lerine izin verilir:
|
viewTrackingUrl |
Zorunlu. OBA simgesinin görüntüleme izleme URL'si. Yalnızca aşağıdaki alanların URL'lerine izin verilir:
|
ObaIconPosition
OBA simgesinin reklam öğesindeki konumu.
Sıralamalar | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
OBA simgesi konumu belirtilmemiş. |
OBA_ICON_POSITION_UPPER_RIGHT |
Reklam öğesinin sağ üst tarafında. |
OBA_ICON_POSITION_UPPER_LEFT |
Reklam öğesinin sol üst tarafında. |
OBA_ICON_POSITION_LOWER_RIGHT |
Reklam öğesinin sağ alt tarafında. |
OBA_ICON_POSITION_LOWER_LEFT |
Reklam öğesinin sol alt tarafında. |
ExpandingDirection
Üçüncü taraf genişletilebilir reklam öğesinin genişleme yönü.
Sıralamalar | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
Genişleme yönü belirtilmemiş. |
EXPANDING_DIRECTION_NONE |
Hiçbir yönde genişlemez. |
EXPANDING_DIRECTION_UP |
Yukarı doğru genişler. |
EXPANDING_DIRECTION_DOWN |
Aşağı doğru genişler. |
EXPANDING_DIRECTION_LEFT |
Sola doğru genişler. |
EXPANDING_DIRECTION_RIGHT |
Sağa doğru genişletir. |
EXPANDING_DIRECTION_UP_AND_LEFT |
Yukarı ve sol tarafa doğru genişler. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
Yukarı ve sağ tarafa doğru genişler. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
Aşağıya ve sol tarafa doğru genişler. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
Aşağı ve sağ tarafa doğru genişler. |
EXPANDING_DIRECTION_UP_OR_DOWN |
Yukarı veya aşağı doğru genişler. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
Sola veya sağa doğru genişler. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
Tüm yönlerde çaprazlamasına genişletilebilir. |
Yöntemler |
|
---|---|
|
Yeni bir reklam öğesi oluşturur. |
|
Reklam öğesini siler. |
|
Reklam öğesi alır. |
|
Bir reklamverendeki reklam öğelerini listeler. |
|
Mevcut bir reklam öğesini günceller. |