- Kaynak: Reklam öğesi
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- 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şkili 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ı. UTF-8 olarak kodlanmış ve maksimum 240 bayt boyutunda olmalıdır. |
entityStatus |
Zorunlu. Reklam öğesinin yayınlanıp yayınlanamayacağını kontrol eder. Kabul edilen değerler:
|
updateTime |
Yalnızca çıkış. Reklam öğesinin kullanıcı veya sistem tarafından (ör. reklam öğesi incelemesi) 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 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ştirilemez. 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 belirtilirse |
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 öğesi ö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. Çıkış (tıklama etiketi olarak da bilinir), reklam öğenizde bir kullanıcını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 yöntemlerden herhangi birini kullanarak çıkış ekleyebilirsiniz:
|
timerEvents[] |
İsteğe bağlıdır. Rich media reklam öğesi için zamanlayıcı özel etkinlikleri. Zamanlayıcılar, bir kullanıcının rich media reklam öğesinin belirli bir bölümünü görüntülediği ve bu bölümle 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, bir kullanıcının belirtilen şekilde (fareyle üzerine gelerek, fareyi üzerinden çekerek, tıklayarak, dokunarak, veri yükleyerek, klavye girişleriyle vb.) rich media reklam öğesinin herhangi bir bölümüyle etkileşimde bulunma sayısını izler. Reklam öğesinde yakalanabilen her etkinlik bir 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. UTF-8 olarak kodlanmış olmalı ve en fazla 10.000 karakter içermelidir. |
notes |
İsteğe bağlıdır. Bu reklam öğesi için kullanıcı notları. UTF-8 olarak kodlanmış olmalı ve uzunluğu 20.000 karakteri aşmamalıdır. |
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. Bir video reklam öğesi için 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 bir video reklam öğesini atlamayı seçip seçemeyeceği. Bu alan yalnızca aşağıdaki
|
skipOffset |
İsteğe bağlıdır. Atla düğmesi görününceye kadar videonun oynatılacağı süredir.
Bu alan yalnızca aşağıdaki
|
progressOffset |
İsteğe bağlıdır. Bir görüntüleme sayılmadan önce videonun oynatılacağı süre.
Bu alan yalnızca aşağıdaki
|
universalAdId |
İsteğe bağlıdır. Bir kayıt defteri tarafından sağlanan ve tüm platformlarda benzersiz olan 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ü taraflardan alınan izleme URL'leri. Bu alan yalnızca aşağıdaki
|
transcodes[] |
Yalnızca çıkış. Ses/video kod dönüştürmeleri. 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 komut dosyası 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) 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 sunma hizmetini kullanan bir reklamveren tarafından oluşturulduğunda aşağıdaki
Diğer durumlarda yalnızca çıkış. |
obaIcon |
İsteğe bağlıdır. 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 reklamlar, aşağıdaki
şu
|
requireMraid |
İsteğe bağlıdır. Reklam öğesinin MRAID (Mobil Rich Media Reklam Arayüz Tanımları sistemi) gerektirdiğini belirtir. Reklam öğesi, etkileşim için kaydırma veya dokunma gibi mobil hareketleri kullanıyorsa bu seçeneği belirleyin. İsteğe bağlıdır ve yalnızca üçüncü taraf etiket reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklamlar, aşağıdaki
şu
|
requireHtml5 |
İsteğe bağlıdır. Reklam öğesinin düzgün şekilde oluşturulması için HTML5 kullanıldığını gösterir. İsteğe bağlıdır ve yalnızca üçüncü taraf etiket reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklamlar, aşağıdaki
şu
|
requirePingForAttribution |
İsteğe bağlıdır. Reklam öğesinin ilişkilendirme için bir geri dönüş ping'i bekleyeceğini gösterir. Yalnızca üçüncü taraf reklam sunucusu parametresi ve ${DC_DBM_TOKEN} makrosu 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 etiketi reklam öğeleri için geçerlidir. Üçüncü taraf etiket reklamlar, aşağıdaki
şu
Üçüncü taraf VAST etiketi reklam öğeleri, aşağıdaki
şu
|
expandingDirection |
İsteğe bağlıdır. Reklam öğesinin genişleme yönünü belirtir. Zorunludur 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:
şu
|
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:
şu
|
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 etiketi reklam öğeleri, aşağıdaki
şu
|
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 etiketi reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiketi reklam öğeleri, aşağıdaki
şu
|
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 etiketi reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiketi reklam öğeleri, aşağıdaki
şu
|
lineItemIds[] |
Yalnızca çıkış. Bu reklam öğesinin ilişkilendirildiği satır öğelerinin kimlikleri. Bir reklam öğesini satır öğesiyle ilişkilendirmek için |
mp3Audio |
Yalnızca çıkış. Üçüncü taraf işitsel reklam öğesinin MP3'ü desteklediğini gösterir. Yalnızca çıkış ve yalnızca üçüncü taraf işitsel reklam öğeleri için geçerlidir. Üçüncü taraf işitsel reklam öğeleri, aşağıdaki
şu
|
oggAudio |
Yalnızca çıkış. Üçüncü taraf işitsel reklam öğesinin OGG'yi desteklediğini gösterir. Yalnızca çıkış ve yalnızca üçüncü taraf işitsel reklam öğeleri için geçerlidir. Üçüncü taraf işitsel reklam öğeleri, aşağıdaki
şu
|
syntheticContentAttestationStatus |
İsteğe bağlıdır. Yerel yapay zeka etiketleme tüzüklerinin geçerli olduğu bölgelerde yayınlandığında reklam öğesine yapay zeka ile oluşturulmuş veya düzenlenmiş olarak etiket eklenip eklenmeyeceği. |
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 reklam öğesi.
|
HOSTING_SOURCE_HOSTED |
DV360'ta oluşturulan ve Campaign Manager 360 tarafından barındırılan 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 inceleme durumları.
| JSON gösterimi |
|---|
{ "approvalStatus": enum ( |
| Alanlar | |
|---|---|
approvalStatus |
Bir reklam öğesinin yayınlanmaya başlaması için gereken temel onayı temsil eder. |
creativeAndLandingPageReviewStatus |
Reklam öğesi için reklam öğesi ve açılış sayfası inceleme durumu. |
contentAndPolicyReviewStatus |
Reklam öğesinin içerik ve politika incelemesi durumu. |
exchangeReviewStatuses[] |
Reklam öğesi için exchange inceleme durumları. |
Onay Durumu
Olası onay durumu türleri. creativeAndLandingPageReviewStatus ve contentAndPolicyReviewStatus için geçerlidir.
| 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ınlanamaz. |
APPROVAL_STATUS_PENDING_SERVABLE |
Reklam öğesi, reklam öğesi ve açılış sayfası incelemesini geçti ve yayınlanabilir ancak ek içerik ve politika incelemesi bekliyor. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Hem reklam öğesi ve açılış sayfası incelemesi hem de içerik ve politika incelemesi onaylanır. Reklam öğesi yayınlanabilir. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
Reklam öğesi yayınlanmadan önce çözülmesi gereken bir sorun vardır. |
ReviewStatus
Olası inceleme 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 reddedildi. |
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. |
AssetAssociation
Reklam öğesi için öğe ilişkilendirmesi.
| JSON gösterimi |
|---|
{ "asset": { object ( |
| Alanlar | |
|---|---|
asset |
İsteğe bağlıdır. İlişkili öğe. |
role |
İsteğe bağlıdır. Bu öğenin reklam öğesindeki 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 diğer API çağrılarına (ör. 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 öğesindeki 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 yükleme bekleme öğesidir. |
ASSET_ROLE_HEADLINE |
Doğal reklam öğesinin başlığı.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_LONG_HEADLINE |
Doğal reklam öğesinin uzun başlığı.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_BODY |
Doğal reklam öğesinin gövde metni.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_LONG_BODY |
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ısaltılmış ve daha kolay okunan 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/sayfa" ise başlık URL'si "example.com" olabilir. Protokol (http://) isteğe bağlıdır ancak URL'de boşluk veya özel karakter bulunamaz. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_CALL_TO_ACTION |
Doğal 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ı tanımlayan metin.
Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_PRICE |
Uygulamanızın Google Play Store veya iOS uygulama mağazasındaki satın alma fiyatı (ör.5, 99 TL). Bu değerin, mağazada listelenen gerçek değerle otomatik olarak senkronize edilmediğini unutmayın. Her zaman reklam öğesini kaydederken sağlanan ad kullanılır.
Bu rolün öğeleri 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 rolün öğeleri salt okunurdur. |
ASSET_ROLE_IOS_APP_ID |
Apple uygulama mağazasındaki bir iOS uygulamasının kimliği. Bu kimlik numarası, Apple uygulama mağazası URL'sinde "id"den hemen sonra gelen sayı dizesi olarak bulunabilir. Örneğin, Bu rolün öğeleri salt okunurdur. |
ASSET_ROLE_RATING |
Bir uygulamanın Google Play Store veya iOS uygulama mağazasındaki puanı. Bu değerin, mağazadaki gerçek puanla otomatik olarak senkronize edilmediğini unutmayın. Bu, her zaman reklam öğesini kaydederken sağlanan ad olur. Bu rolün öğeleri salt okunurdur. |
ASSET_ROLE_ICON |
Reklam öğesinin simgesi. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_COVER_IMAGE |
Doğal 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 bir resim öğesi kullanması gerekip gerekmediği. Bu rol yalnızca aşağıdaki
|
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS |
Reklam öğesine öğe geliştirmelerinin 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.
|
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
Çı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. Raporlarda bu zamanlayıcı etkinliğini 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. Raporlarda bu sayaç etkinliğini tanımlamak için kullanılan ad. |
AudioVideoOffset
Bir ses veya videonun oynatılma 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: "percentage": string, "seconds": string // End of mutually exclusive fields. } |
| Alanlar | |
|---|---|
| Uzaklığın değeri. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta alanlardan en fazla biri ayarlanır: | |
percentage |
İsteğe bağlıdır. Ses veya video süresinin yüzdesi olarak fark. |
seconds |
İsteğe bağlıdır. Ses veya videonun başlangıcından itibaren saniye cinsinden uzaklık. |
| Birbirini hariç tutan alanların sonu. | |
UniversalAdId
Bir kayıt defteri tarafından sağlanan ve tüm platformlarda benzersiz olan 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. Kayıt defteri, benzersiz reklam öğesi tanımlayıcıları sağlar. |
UniversalAdRegistry
Kayıt, Evrensel Reklam Kimliği'nde benzersiz reklam öğesi tanımlayıcıları sağlar.
| Sıralamalar | |
|---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
Evrensel reklam kaydı belirtilmemiş veya bu sürümde bilinmiyor. |
UNIVERSAL_AD_REGISTRY_OTHER |
Evrensel Reklam Kimliği'ni 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 adresini kullanın. |
UNIVERSAL_AD_REGISTRY_DV360 |
Evrensel reklam kimliğini 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
Ses veya video reklam öğesiyle etkileşimleri izlemek için üçüncü taraflardan gelen izleme URL'leri.
| JSON gösterimi |
|---|
{
"type": enum ( |
| Alanlar | |
|---|---|
type |
İsteğe bağlıdır. Etkileşim türünün izleme URL'si tarafından izlenmesi gerekir. |
url |
İsteğe bağlıdır. Etkileşimi izlemek için kullanılan izleme URL'si.
|
ThirdPartyUrlType
Etkileşim türünün üçüncü taraf izleme URL'si tarafından izlenmesi gerekir.
| 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 |
Ses 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 videoyu tıklama sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Kullanıcının ses 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 kaç defa oynatıldığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
Ses veya videonun, uzunluğunun% 50'sine kadar kaç defa oynatıldığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
Ses veya videonun, uzunluğunun% 75'ine kadar kaç defa oynatıldığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
Ses veya videonun sonuna kadar kaç defa oynatıldığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
Kullanıcının ses veya videonun sesini kaç defa kapattığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
Kullanıcının ses veya videoyu kaç defa duraklattığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
Kullanıcının ses veya videoyu kaç kez tekrar 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 ekrana genişlettiğini izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
Bir kullanıcının sesi veya videoyu kaç defa durdurduğunu 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 tarafından belirlenen bir ofsete kadar kaç kez oynatıldığını izlemek için kullanılır. |
Kod dönüştürme
Kodu dönüştürülmüş ses veya video dosyasıyla ilgili bilgileri temsil eder.
| JSON gösterimi |
|---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
| Alanlar | |
|---|---|
name |
İsteğe bağlıdır. Kodu dönüştürülen dosyanın adı. |
mimeType |
İsteğe bağlıdır. Kodu 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 saniye başına kilobit cinsinden kod dönüştürme bit hızı. |
frameRate |
İsteğe bağlıdır. Kod dönüştürme işlemi uygulanan videonun saniyedeki kare sayısı (FPS) cinsinden kare hızı. |
audioBitRateKbps |
İsteğe bağlıdır. Kodu dönüştürülen videonun ses akışının bit hızı veya kodu dönüştürülen sesin bit hızı (kilobit/saniye cinsinden). |
audioSampleRateHz |
İsteğe bağlıdır. Kodu dönüştürülen videonun ses akışı için örnek hızı veya kodu dönüştürülen ses için hertz cinsinden örnek hızı. |
fileSizeBytes |
İsteğe bağlıdır. Kodu 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 alan adlarının URL'lerine izin verilir:
|
clickTrackingUrl |
Zorunlu. OBA simgesinin tıklama izleme URL'si. Yalnızca aşağıdaki alan adlarının URL'lerine izin verilir:
|
viewTrackingUrl |
Zorunlu. OBA simgesinin görüntüleme izleme URL'si. Yalnızca aşağıdaki alan adlarının URL'lerine izin verilir:
|
ObaIconPosition
OBA simgesinin reklam öğesindeki konumu.
| Sıralamalar | |
|---|---|
OBA_ICON_POSITION_UNSPECIFIED |
OBA simgesinin 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ı genişler. |
EXPANDING_DIRECTION_DOWN |
Aşağı doğru genişler. |
EXPANDING_DIRECTION_LEFT |
Sola genişler. |
EXPANDING_DIRECTION_RIGHT |
Sağa genişler. |
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ğı 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 |
Herhangi bir çapraz yönde genişleyebilir. |
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. |