- 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şkilendirilen 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 UTF-8 olarak kodlanmış olmalıdır. |
entityStatus |
Zorunlu. Reklam öğesinin sunulup sunulamayacağını kontrol eder. Kabul edilen değerler şunlardır:
|
updateTime |
Yalnızca çıkış. Reklam öğesinin kullanıcı veya sistem (ör. reklam incelemesi) tarafından en son güncellendiği zaman damgası. Sistem tarafından atanır. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
createTime |
Yalnızca çıkış. Reklam öğesinin oluşturulduğu zaman damgası. Sistem tarafından atanır. Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: |
creativeType |
Zorunlu. Sabit. 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[] |
Ek boyutlar.
Bu alan belirtilirse |
mediaDuration |
Yalnızca çıkış. Reklam öğesinin medya süresi.
" |
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 reklamla ilişkilendirilen öğeler. |
exitEvents[] |
Zorunlu. Bu reklam öğesine ilişkin çıkış etkinlikleri. Çı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[] |
Rich media reklam öğesi için zamanlayıcı özel etkinlikleri. Kronometreler, bir kullanıcının bir 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, her biri bağımsız olarak zamanlanmış birden çok kronometre etkinliği olabilir. Yalnızca resim öğeleri içeren reklam öğeleri için bu alanı boş bırakın veya ayarlamadan bırakın. |
counterEvents[] |
Rich media reklam öğesi için sayaç etkinlikleri. Sayaçlar, bir kullanıcının belirtilen şekilde (fareyle üzerine gelerek, fareyi üzerinden çekerek, tıklama, dokunarak, veri yükleme, klavye girişleri vb.) bir rich media reklam öğesinin herhangi bir bölümüyle kaç kez etkileşimde bulunduğunu izler. Reklam öğesinde yakalanabilecek herhangi bir etkinlik sayaç olarak kaydedilebilir. Yalnızca resim öğeleri içeren reklam öğeleri için bu alanı boş bırakın veya ayarlamadan bırakın. |
appendedTag |
Reklam öğesi etiketine eklenecek üçüncü taraf HTML izleme etiketi. |
integrationCode |
Bu reklam öğesini harici bir sisteme bağlamak için kullanılan kimlik bilgileri. En fazla 10.000 karakter uzunluğunda olan UTF-8 kodlu olmalıdır. |
notes |
Bu reklam öğesi için kullanıcı notları. En fazla 20.000 karakter uzunluğunda olan UTF-8 kodlu olmalıdır. |
iasCampaignMonitoring |
Integral Ad Science (IAS) kampanya izleme özelliğinin etkin olup olmadığını belirtir. Reklam öğesinde bunu etkinleştirmek için |
companionCreativeIds[] |
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 şu
|
skippable |
Kullanıcının bir video reklam öğesini atlamayı seçip seçemeyeceği. Bu alan yalnızca aşağıdaki
|
skipOffset |
Atla düğmesi görüntüleninceye kadar videonun oynatılacağı süredir.
Bu alan yalnızca aşağıdaki
|
progressOffset |
Görüntüleme sayısı sayılmadan önce videonun oynatılması için geçmesi gereken süre.
Bu alan yalnızca aşağıdaki
|
universalAdId |
İsteğe bağlı. Bir kayıt tarafından sağlanan, 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[] |
Bir video reklam öğesiyle olan etkileşimleri izlemek için üçüncü taraflardan gelen URL'leri izleme. 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[] |
Analiz sağlayıcıları veya üçüncü taraf reklam teknolojisi sağlayıcıları için izleme URL'leri. URL'ler https ile başlamalıdır (SSL uyumluluğu gerektirmeyen envanter hariç). URL'nizde makro kullanıyorsanız yalnızca Display & Video 360 tarafından desteklenen makroları kullanın. Yalnızca standart URL'ler; IMG veya SCRIPT etiketleri kullanılamaz. Bu alan yalnızca şu
|
jsTrackerUrl |
Desteklenen üçüncü taraf doğrulama sağlayıcılarına (ComScore, DoubleVerify, IAS, Moat) ait JavaScript ölçüm URL'si. HTML komut dosyası etiketleri desteklenmez. Bu alan yalnızca şu
|
cmTrackingAd |
Reklam öğesiyle ilişkilendirilen Campaign Manager 360 izleme reklamı. Hem Campaign Manager 360 hem de üçüncü taraf reklam sunmayı kullanan bir reklamveren tarafından oluşturulduğunda aşağıdaki
Yalnızca diğer durumlar için çıkış yapın. |
obaIcon |
Video reklam öğesi için OBA simgesini belirtir. Bu alan yalnızca aşağıdaki
|
thirdPartyTag |
İsteğe bağlı. Reklam öğesi için kullanılan orijinal üçüncü taraf etiketi. Gerekli ve yalnızca üçüncü taraf etiketi reklamları için geçerlidir. Üçüncü taraf etiketi reklam öğeleri, şu
şu
|
requireMraid |
İsteğe bağlı. 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 bunu ayarlayın. İsteğe bağlıdır ve yalnızca üçüncü taraf etiketi reklam öğeleri için geçerlidir. Üçüncü taraf etiketi reklam öğeleri, şu
şu
|
requireHtml5 |
İsteğe bağlı. 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 etiketi reklam öğeleri için geçerlidir. Üçüncü taraf etiketi reklam öğeleri, şu
şu
|
requirePingForAttribution |
İsteğe bağlı. Reklam öğesinin, ilişkilendirme için dönüş ping'i bekleyeceğini belirtir. Yalnızca üçüncü taraf reklam sunucusu parametresi ve ${DC_DBM_TOKEN} makrosuyla Campaign Manager 360 izleme reklamı kullanılırken geçerlidir. İsteğe bağlıdır ve yalnızca üçüncü taraf etiketi reklam öğeleri veya üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir. Üçüncü taraf etiketi reklam öğeleri, şu
şu
Üçüncü taraf VAST etiketi reklam öğeleri, şu
şu
|
expandingDirection |
İsteğe bağlı. 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:
şu
|
expandOnHover |
İsteğe bağlı. Reklam öğesinin fareyle üzerine gelindiğinde otomatik olarak genişleyeceğini belirtir. İ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ı. Üçüncü taraf VAST etiketi reklam öğesi için VAST etiketinin URL'si. Yalnızca üçüncü taraf VAST etiketi reklam öğeleri için gereklidir ve geçerlidir. Üçüncü taraf VAST etiketi reklam öğeleri, şu
şu
|
vpaid |
Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesinin VPAID (Dijital Video Oynatıcı-Reklam Arayüzü) gerektirdiğini belirtir. Yalnızca çıkış ve yalnızca üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiketi reklam öğeleri, şu
şu
|
html5Video |
Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesi için HTML5 Video desteği gerektiğini belirtir. Yalnızca çıkış ve yalnızca üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir. Üçüncü taraf VAST etiketi reklam öğeleri, şu
şu
|
lineItemIds[] |
Yalnızca çıkış. Bu reklam öğesinin ilişkili olduğu satır öğelerinin kimlikleri. Reklam öğesini bir satır öğesiyle ilişkilendirmek için bunun yerine |
mp3Audio |
Yalnızca çıkış. Üçüncü taraf işitsel reklam öğesinin MP3'ü desteklediğini belirtir. Yalnızca çıkış yap ve yalnızca üçüncü taraf işitsel reklam öğeleri için geçerlidir. Üçüncü taraf işitsel reklam öğeleri, şu
şu
|
oggAudio |
Yalnızca çıkış. Üçüncü taraf işitsel reklam öğesinin OGG'yi desteklediğini gösterir. Yalnızca çıkış yap ve yalnızca üçüncü taraf işitsel reklam öğeleri için geçerlidir. Üçüncü taraf işitsel reklam öğeleri, şu
şu
|
HostingSource
Reklam öğesi için olası barındırma kaynakları. Bir 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 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ın olası özellikleri.
Sıralamalar | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
Bu sürümde reklam öğesi özelliği belirtilmemiş veya 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ı inceleme.
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 öğesi için içerik ve politika incelemesi durumu. |
exchangeReviewStatuses[] |
Reklam öğesi için inceleme durumlarını değiştirin. |
publisherReviewStatuses[] |
Reklam öğesi için yayıncı inceleme durumları. Uyarı: Bu alan 26 Haziran 2024'te kullanımdan kaldırılacak. Bu tarihten sonra bu alan boş olacaktır. Daha fazla bilgi için özelliklerin kullanımdan kaldırılmasıyla ilgili duyurumuzu okuyun. |
ApprovalStatus
Olası onay durumu türleri. Bu, creativeAndLandingPageReviewStatus
ve contentAndPolicyReviewStatus
öğelerinin ö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ı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 incelemesini bekliyor. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Hem reklam öğesi hem de açılış sayfası incelemesi ile 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 reddedilir. |
REVIEW_STATUS_PENDING |
Reklam öğesi incelenmeyi bekliyor. |
ExchangeReviewStatus
Reklam öğesi için exchange inceleme durumu.
JSON gösterimi |
---|
{ "exchange": enum ( |
Alanlar | |
---|---|
exchange |
Reklam öğesini inceleyen exchange. |
status |
Exchange incelemesinin durumu. |
PublisherReviewStatus
Reklam öğesi için 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 |
İlişkilendirilmiş öğe. |
role |
Reklam için bu öğenin rolü. |
Öğe
Tek bir öğe.
JSON gösterimi |
---|
{ "mediaId": string, "content": string } |
Alanlar | |
---|---|
mediaId |
Yüklenen öğenin medya kimliği. Bu, öğe için benzersiz bir tanımlayıcı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. İlişkili reklam öğesi kaynaklarından yeni medya kimliğini alarak veya öğeyi yeniden yükleyerek 5 Nisan 2023'ten önce önbelleğe alınan medya kimliklerini güncelleyin. |
content |
Öğe içeriği. Yüklenen öğeler için içerik, sunma yoludur. |
AssetRole
Reklam için bu öğenin rolü.
Sıralamalar | |
---|---|
ASSET_ROLE_UNSPECIFIED |
Öğe rolü bu sürümde belirtilmemiş veya bilinmiyor. |
ASSET_ROLE_MAIN |
Öğe, reklam öğesinin ana öğesidir. |
ASSET_ROLE_BACKUP |
Öğe, reklam öğesinin yedek öğesidir. |
ASSET_ROLE_POLITE_LOAD |
Öğe, reklam öğesinin bir yükleme bekleme öğesidir. |
ASSET_ROLE_HEADLINE |
Yerel 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 |
Yerel 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 basit bir sürümü. Bu URL, kullanıcılara reklamı tıkladıklarında ulaşacakları sayfa konusunda 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ı 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ış 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, her zaman reklam öğesini kaydederken sağlanan öğe olacaktır.
Bu role sahip öğeler salt okunurdur. |
ASSET_ROLE_ANDROID_APP_ID |
Bir Android uygulamasının Google Play Store'daki kimliği. Bu kimliği, Uygulamanın Google Play Store URL'sinde "id" ifadesinden sonra bulabilirsiniz. Örneğin, https://play.google.com/store/apps/details?id=com.company.appname URL'sindeki tanımlayıcı com.company.appname'dir. Bu role sahip öğeler salt okunurdur. |
ASSET_ROLE_IOS_APP_ID |
Bir iOS uygulamasının Apple App Store'daki kimliği. Bu kimlik numarası, Apple App Store URL'sinde "id" ifadesinden hemen sonra gelen bir sayı dizesi olarak bulunabilir. Örneğin, https://apps.apple.com/us/app/gmail-email-by-google/id422689480 adresindeki kimlik 422689480'dir. Bu role sahip öğ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, her zaman reklam öğesini kaydederken sağlanan öğe olacaktır. Bu role sahip öğ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
|
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 |
Çıkış etkinliğinin tıklama etiketinin adı. Ad, tek bir reklam öğesinde benzersiz olmalıdır. Yalnızca resim öğeleri içeren reklam öğeleri için bu alanı boş bırakın veya ayarlamadan bırakın. |
reportingName |
Raporlarda bu etkinliği tanımlamak için kullanılan ad. Yalnızca resim öğeleri içeren reklam öğeleri için bu alanı boş bırakın veya ayarlamadan bırakı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, bir 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 sesin veya videonun oynatıldığı süre.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı offset . Ofset değeri. offset şunlardan yalnızca biri olabilir: |
|
percentage |
Ses veya video süresinin yüzdesi cinsinden ofset. |
seconds |
Ses veya videonun başlangıcından itibaren saniye cinsinden uzaklık. |
UniversalAdId
Bir kayıt tarafından sağlanan, 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 |
Benzersiz reklam öğesi tanımlayıcısı. |
registry |
Kayıt otoritesi, benzersiz reklam öğesi tanımlayıcıları sağlar. |
UniversalAdRegistry
Kayıt otoritesi, bir Evrensel Reklam Kimliği içinde benzersiz reklam öğesi tanımlayıcıları sağlar.
Sıralamalar | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
Bu sürümde Evrensel Reklam kaydı belirtilmemiş veya bilinmiyor. |
UNIVERSAL_AD_REGISTRY_OTHER |
Evrensel Reklam Kimliği sağlamak için bir özel sağlayıcı kullanın. |
UNIVERSAL_AD_REGISTRY_AD_ID |
Evrensel Reklam Kimliği sağlamak için Ad-ID kullanın. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
Evrensel Reklam Kimliği sağlamak için clearcast.co.uk'yi kullanın. |
UNIVERSAL_AD_REGISTRY_DV360 |
Evrensel Reklam Kimliği sağlamak için Display & Video 360'ı kullanın. |
UNIVERSAL_AD_REGISTRY_CM |
Evrensel Reklam Kimliği sağlamak için Campaign Manager 360'ı kullanın. |
ThirdPartyUrl
Bir ses veya video reklam öğesiyle olan etkileşimleri izlemek için üçüncü taraflardan gelen URL'leri izleme.
JSON gösterimi |
---|
{
"type": enum ( |
Alanlar | |
---|---|
type |
Etkileşim türünün, izleme URL'si tarafından izlenmesi gerekir |
url |
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 |
Ses veya videodaki kullanıcı tıklamalarını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Bir kullanıcının ses veya videoyu kaç defa başlattığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
Sesin 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 |
Sesin 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 |
Sesin veya videonun, sonuna kadar kaç defa oynatıldığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
Bir 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 |
Bir kullanıcının sesi veya videoyu kaç defa duraklattığını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
Bir kullanıcının sesi veya videoyu tekrar oynatma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
Bir kullanıcının oynatıcıyı tam ekran boyutuna genişletme sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
Bir kullanıcının ses 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 atlanma sayısını izlemek için kullanılır. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
Sesin veya videonun, progressOffset tarafından belirlenen bir ofsette oynatılma sayısı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 |
Kodu dönüştürülmüş dosyanın adı. |
mimeType |
Kodu dönüştürülmüş dosyanın MIME türü. |
transcoded |
Kod dönüştürme işleminin başarılı olup olmadığını gösterir. |
dimensions |
Kodu dönüştürülmüş videonun boyutları. |
bitRateKbps |
Kodu dönüştürülmüş videonun kod dönüştürme bit hızı (kilobit/saniye). |
frameRate |
Kodu dönüştürülmüş videonun saniyedeki kare sayısı cinsinden kare hızı. |
audioBitRateKbps |
Kodu dönüştürülmüş videonun ses akışı için bit hızı veya kodu dönüştürülen sesin bit hızı (kilobit/saniye). |
audioSampleRateHz |
Kodu dönüştürülmüş videonun ses akışı için örnek hızı veya kodu dönüştürülmüş sesin hertz cinsinden örnek hızı. |
fileSizeBytes |
Kodu dönüştürülmüş dosyanın bayt cinsinden boyutu. |
CmTrackingAd
Campaign Manager 360 izleme reklamı.
JSON gösterimi |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Alanlar | |
---|---|
cmPlacementId |
Kampanya yöneticisi 360 izleme reklamının yerleşim kimliği. |
cmCreativeId |
Kampanya yöneticisi 360 izleme reklamının reklam öğesi kimliği. |
cmAdId |
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 |
OBA simgesi kaynağının URL'si. |
resourceMimeType |
OBA simgesi kaynağının MIME türü. |
position |
Reklam öğesindeki OBA simgesinin konumu. |
dimensions |
OBA simgesinin boyutları. |
program |
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
Reklam öğesindeki OBA simgesinin 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 |
Herhangi 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 genişler. |
EXPANDING_DIRECTION_RIGHT |
Sağa genişler. |
EXPANDING_DIRECTION_UP_AND_LEFT |
Yukarı ve sol tarafa genişler. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
Yukarı ve sağ tarafa genişler. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
Aşağı ve sol tarafa genişler. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
Aşağı ve sağ tarafa genişler. |
EXPANDING_DIRECTION_UP_OR_DOWN |
Yukarı veya aşağı doğru genişler. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
Sola veya sağ tarafa genişler. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
Herhangi bir çapraz yönde genişletilebilir. |
Yöntemler |
|
---|---|
|
Yeni bir reklam öğesi oluşturur. |
|
Reklam öğesini siler. |
|
Yaratıcı bir fikir üretir. |
|
Bir reklamverendeki reklam öğelerini listeler. |
|
Mevcut bir reklam öğesini günceller. |