REST Resource: advertisers.creatives

Kaynak: Creative

Tek bir Reklam Öğesi.

JSON gösterimi 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
Alanlar
name

string

Yalnızca çıkış. Reklam öğesinin kaynak adı.
advertiserId

string (int64 format)

Yalnızca çıkış. Reklam öğesinin ait olduğu reklamverenin benzersiz kimliği.
creativeId

string (int64 format)

Yalnızca çıkış. Reklam öğesinin benzersiz kimliği. Sistem tarafından atanır.
cmPlacementId

string (int64 format)

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

string

Zorunlu. Reklam öğesinin görünen adı.

Maksimum 240 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.
entityStatus

enum (EntityStatus)

Zorunlu. Reklam öğesinin sunulup sunulamayacağını kontrol eder.

Kabul edilen değerler şunlardır:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Yalnızca çıkış. Reklam öğesinin kullanıcı veya sistem tarafından en son güncellendiği zaman damgası (ör. reklam öğesi incelemesi). Sistem tarafından atanır.

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Yalnızca çıkış. Reklam öğesinin oluşturulduğu zaman damgası. Sistem tarafından atanır.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
creativeType

enum (CreativeType)

Zorunlu. Sabit. Reklam öğesinin türü.
hostingSource

enum (HostingSource)

Zorunlu. Reklam öğesinin barındırıldığı yeri belirtir.
dynamic

boolean

Yalnızca çıkış. Reklam öğesinin dinamik olup olmadığını belirtir.
dimensions

object (Dimensions)

Zorunlu. Reklam öğesinin birincil boyutları. Tüm reklam öğesi türleri için geçerlidir. creativeType aşağıdakilerden biri olduğunda widthPixels ve heightPixels değerleri varsayılan olarak 0 olur:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Ek boyutlar. creativeType şunlardan biri olduğunda geçerlidir:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Bu alan belirtilirse hem widthPixels hem de heightPixels zorunludur ve 0'dan büyük veya 0'a eşit olmalıdır.
mediaDuration

string (Duration format)

Yalnızca çıkış. Reklam öğesinin medya süresi. creativeType aşağıdakilerden biri olduğunda geçerlidir:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Yalnızca çıkış. Reklam öğesinin sistem tarafından oluşturulan özelliklerinin listesi.
reviewStatus

object (ReviewStatusInfo)

Yalnızca çıkış. Reklam öğesi inceleme sürecinin mevcut durumu.
assets[]

object (AssetAssociation)

Zorunlu. Bu reklam öğesiyle ilişkilendirilen öğeler.
exitEvents[]

object (ExitEvent)

Zorunlu. Bu reklam öğesi için çı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 yöntemlerden biriyle çıkış ekleyebilirsiniz:

  • Google Web Designer'ın dokunma alanını kullanın.
  • "clickTag" adlı bir JavaScript değişkeni tanımlayın.
  • Rich media biçimlerinde çıkışları izlemek için Etkinleştirici'yi (Enabler.exit()) kullanın.
timerEvents[]

object (TimerEvent)

Rich media reklam öğesi için zamanlayıcı özel etkinlikleri. Kronometreler, bir 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 ayarını kaldırın.
counterEvents[]

object (CounterEvent)

Rich media reklam öğesi için sayaç etkinlikleri. Sayaçlar, kullanıcının bir rich media reklam öğesinin herhangi bir bölümüyle belirtilen şekilde (fareyle üzerine gelme, fareyi üzerinden çekme, tıklama, dokunma, veri yükleme, klavye girişi vb.) etkileşimde bulunma sayısını izler. Reklam öğesinde yakalanabilecek her etkinlik bir sayaç olarak kaydedilebilir. Bu alanı, yalnızca resim öğeleri içeren reklam öğeleri için boş veya ayarlanmamış olarak bırakın.
appendedTag

string

Reklam öğesi etiketine eklenecek üçüncü taraf HTML izleme etiketi.
integrationCode

string

Bu reklam öğesini harici bir sisteme bağlamak için kullanılan kimlik bilgileri. UTF-8 olarak kodlanmış ve en fazla 10.000 karakter uzunluğunda olmalıdır.
notes

string

Bu reklam öğesi için kullanıcı notları. UTF-8 kodlu olmalı ve en fazla 20.000 karakter uzunluğunda olmalıdır.
iasCampaignMonitoring

boolean

Integral Ad Science (IAS) kampanya izleme özelliğinin etkin olup olmadığını belirtir. Reklam öğesinde bunu etkinleştirmek için Advertiser.creative_config.ias_client_id öğesinin IAS istemci kimliğinize ayarlandığından emin olun.
companionCreativeIds[]

string (int64 format)

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.

additional dimensions içeren reklam öğeleri tamamlayıcı reklam öğeleri olamaz.

Bu alan yalnızca aşağıdaki creativeType için desteklenir:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Kullanıcının bir video reklam öğesini atlamayı seçip seçemeyeceği.

Bu alan yalnızca aşağıdaki creativeType için desteklenir:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Atlama düğmesi gösterilmeden önce videonun oynatılacağı süre.

skippable doğru olduğunda bu alan gereklidir.

Bu alan yalnızca aşağıdaki creativeType için desteklenir:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Görüntüleme olarak sayılmadan önce videonun oynatılması gereken süre.

skippable doğru olduğunda bu alan gereklidir.

Bu alan yalnızca aşağıdaki creativeType için desteklenir:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

İsteğe bağlı. Bir kayıt otoritesi 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 creativeType için desteklenir:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Video reklam öğesiyle etkileşimleri izlemek için üçüncü taraflardan gelen izleme URL'leri.

Bu alan yalnızca aşağıdaki creativeType için desteklenir:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Yalnızca çıkış. Ses/video kod dönüştürme işlemleri.

Görüntülü Reklam ve 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ürmeleri, videonuzdaki her bir gösterim için yayıncının sistemine aralarından seçim yapabileceği daha fazla seçenek sunar ve izleyicinin bağlantısına ve ekran boyutuna göre uygun dosyanın sunulmasını sağlar.

Bu alan yalnızca creativeType için desteklenir:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

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 Video 360.

Yalnızca standart URL'ler; IMG veya SCRIPT etiketleri kullanılamaz.

Bu alana yalnızca aşağıdaki creativeType'lerde yazılabilir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

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 şu creativeType içinde yazılabilir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Reklam öğesiyle ilişkilendirilmiş 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 creativeType için isteğe bağlıdır:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Yalnızca diğer durumlar için çıkış yap.
obaIcon

object (ObaIcon)

Bir video reklam öğesi için OBA simgesini belirtir.

Bu alan yalnızca creativeType için desteklenir:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

İsteğe bağlı. Reklam öğesi için kullanılan orijinal üçüncü taraf etiketi.

Gerekli ve yalnızca üçüncü taraf etiketi reklam öğeleri için geçerlidir.

Üçüncü taraf etiketi reklam öğeleri, şu hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

İsteğe bağlı. Reklam öğesinin MRAID (Mobil Rich Media Reklam Arayüz Tanımları sistemi) gerektirdiğini belirtir.

Reklam öğesinde etkileşimler için kaydırma veya dokunma gibi mobil hareketler gerekiyorsa bunu ayarlayın.

İsteğe bağlıdır ve yalnızca üçüncü taraf etiketi reklam öğeleri için geçerlidir.

Üçüncü taraf etiket reklam öğeleri, aşağıdaki hostingSourceözelliklerine sahip reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

İsteğe bağlı. Reklam öğesinin düzgün şekilde oluşturulması için HTML5'e ihtiyaç duyduğ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 hostingSourceözelliklerine sahip reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

İ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} 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 etiketi reklam öğeleri, şu hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Üçüncü taraf VAST etiketi reklam öğeleri, aşağıdaki hostingSourceözelliklerine sahip reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (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:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

İsteğe bağlı. Fareyle üzerine gelindiğinde reklam öğesinin 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:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

İsteğe bağlı. Üçüncü taraf VAST etiketi reklam öğesi için VAST etiketinin URL'si.

Gerekli ve yalnızca üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir.

Üçüncü taraf VAST etiketi reklam öğeleri, aşağıdaki hostingSourceözelliklerine sahip reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesinin VPAID (Dijital Video Oynatıcı-Reklam Arayüzü) gerektirdiğini gösterir.

Yalnızca çıkış içindir ve yalnızca üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir.

Üçüncü taraf VAST etiketi reklam öğeleri, şu hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesinin HTML5 Video desteği gerektirdiğini belirtir.

Yalnızca çıkış ve sadece üçüncü taraf VAST etiketi reklam öğeleri için geçerlidir.

Üçüncü taraf VAST etiketi reklam öğeleri, şu hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Yalnızca çıkış. Bu reklam öğesinin ilişkilendirildiği satır öğelerinin kimlikleri.

Reklam öğesini bir satır öğesiyle ilişkilendirmek için bunun yerine LineItem.creative_ids kullanın.
mp3Audio

boolean

Yalnızca çıkış. Üçüncü taraf işitsel reklam öğesinin MP3'ü desteklediğini gösterir.

Yalnızca çıkış içindir ve yalnızca üçüncü taraf sesli reklam öğeleri için geçerlidir.

Üçüncü taraf işitsel reklam öğeleri, aşağıdaki hostingSourceözelliklerine sahip reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Yalnızca çıkış. Üçüncü taraf işitsel reklam öğesinin OGG'yi desteklediğini belirtir.

Yalnızca çıkış ve sadece üçüncü taraf işitsel reklam öğeleri için geçerlidir.

Üçüncü taraf işitsel reklam öğeleri, aşağıdaki hostingSourceözelliklerine sahip reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_AUDIO

HostingSource

Bir 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 Bu sürümde barındırma kaynağı belirtilmedi veya bilinmiyor.
HOSTING_SOURCE_CM

Campaign Manager 360'tan senkronize edilen bir reklam öğesi.

Oluşturma ve güncelleme yöntemleri bu barındırma türü için desteklenmez.
HOSTING_SOURCE_THIRD_PARTY

Üçüncü taraf reklam sunucusu (3PAS) tarafından barındırılan bir reklam öğesi.

creativeType aşağıdakilerden biriyse bu barındırma türü için oluşturma ve güncelleme yöntemleri desteklenir:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

DV360'ta oluşturulan ve Campaign Manager 360 tarafından barındırılan bir reklam öğesi.

creativeType aşağıdakilerden biriyse bu barındırma türü için oluşturma ve güncelleme yöntemleri desteklenir:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
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 Reklam öğesi özelliği bu sürümde 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ı inceleyin.

JSON gösterimi 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
Alanlar
approvalStatus

enum (ApprovalStatus)

Reklam öğesinin yayınlanmaya başlaması için gerekli temel onayı gösterir. creativeAndLandingPageReviewStatus ve contentAndPolicyReviewStatus özeti.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Reklam öğesi ve açılış sayfası inceleme durumu.
contentAndPolicyReviewStatus

enum (ReviewStatus)

Reklam öğesinin içerik ve politika inceleme durumu.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Reklam öğesinin inceleme durumlarını değiştirin.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Reklam öğesi için yayıncı inceleme durumları.

Onay Durumu

Olası onay durumu türleri. creativeAndLandingPageReviewStatus ve contentAndPolicyReviewStatus'un özetidir.

Sıralamalar
APPROVAL_STATUS_UNSPECIFIED Bu sürümde tür değeri belirtilmemiş veya bilinmiyor.
APPROVAL_STATUS_PENDING_NOT_SERVABLE Reklam öğesi hâlâ inceleniyor ve yayınlanamaz.
APPROVAL_STATUS_PENDING_SERVABLE Reklam öğesi, reklam öğesi ayarlarından açılış sayfası incelemesine tabi tutuluyor ve yayınlanabilir ancak ek içerik bekleniyor ve politika incelemesi.
APPROVAL_STATUS_APPROVED_SERVABLE Hem kreatif hem de açılış sayfası incelemesi, içeriği ve onaylanması gerekir. Reklam öğesi yayınlanabilir.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Reklam öğesi yayınlanmadan önce düzeltilmesi gereken bir sorun var.

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 (Exchange),
  "status": enum (ReviewStatus)
}
Alanlar
exchange

enum (Exchange)

Reklam öğesini inceleyen exchange.
status

enum (ReviewStatus)

Değişim incelemesinin durumu.

PublisherReviewStatus

Reklam öğesi için yayıncı inceleme durumu.

JSON gösterimi 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
Alanlar
publisherName

string

Yayıncı, reklam öğesini inceliyor.
status

enum (ReviewStatus)

Yayıncı incelemesinin durumu.

AssetAssociation

Reklam öğesi için öğe ilişkilendirmesi.

JSON gösterimi 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Alanlar
asset

object (Asset)

İlişkilendirilmiş öğe.
role

enum (AssetRole)

Bu öğenin reklam öğesi için rolü.

Öğe

Tek bir öğe.

JSON gösterimi 
{
  "mediaId": string,
  "content": string
}
Alanlar
mediaId

string (int64 format)

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 creatives.create gibi diğer API çağrılarına iletilebilir.

Medya Kimliği alanı 5 Nisan 2023 tarihinde güncellendi. İlişkilendirilmiş 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

string

Öğe içeriği. Yüklenen öğeler için içerik, sunma yoludur.

AssetRole

Bu öğenin reklam öğesi için 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 kibar yükleme öğesidir.
ASSET_ROLE_HEADLINE

Doğal reklam öğesinin başlığı.

content, UTF-8 kodlu ve en fazla 25 karakter uzunluğunda olmalıdır.

Bu rol yalnızca şu creativeType rollerinde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Yerel reklam öğesinin uzun başlığı.

content, UTF-8 kodlu ve en fazla 50 karakter uzunluğunda olmalıdır.

Bu rol yalnızca şu creativeType rollerinde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Yerel reklam öğesinin gövde metni.

content, UTF-8 kodlu ve en fazla 90 karakter uzunluğunda olmalıdır.

Bu rol yalnızca aşağıdaki creativeType'lerde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Yerel reklam öğesinin uzun gövde metni.

content, en fazla 150 karakter uzunluğunda olacak şekilde UTF-8 olarak kodlanmış olmalıdır.

Bu rol yalnızca şu creativeType rollerinde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
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 öğesini tıkladıklarında ulaşacakları sayfa konusunda fikir verir.

content, en fazla 30 karakter uzunluğunda olacak şekilde UTF-8 olarak kodlanmış olmalıdır.

Örneğin, açılış sayfası URL'si "http://www.example.com/sayfa" ise altyazı 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 creativeType'lerde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Yerel reklam öğesinin harekete geçirici mesaj düğmesinde kullanılacak metin.

content, UTF-8 kodlu ve en fazla 15 karakter uzunluğunda olmalıdır.

Bu rol yalnızca aşağıdaki creativeType'lerde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Reklamvereni veya marka adını tanımlayan metin.

content, UTF-8 kodlu ve en fazla 25 karakter uzunluğunda olmalıdır.

Bu rol yalnızca şu creativeType rollerinde desteklenir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
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, reklam öğesi kaydedildiğinde her zaman sağlanan ayar olacaktır.

content, UTF-8 kodlu ve en fazla 15 karakter uzunluğunda olmalıdı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" ifadesinden sonra bulabilirsiniz. Örneğin, https://play.google.com/store/apps/details?id=com.company.appname URL'sinde tanımlayıcı com.company.appname şeklindedir.

Bu rolün öğeleri 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 "id" ifadesinden hemen sonra gelen sayı dizesi olarak bulunabilir. Örneğin, https://apps.apple.com/us/app/gmail-email-by-google/id422689480 URL'sinde kimlik 422689480'dır.

Bu rolün öğeleri 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, reklam öğesi kaydedildiğinde her zaman sağlanan ayar olacaktır.

Bu rolün öğeleri salt okunurdur.
ASSET_ROLE_ICON

Reklam öğesinin simgesi.

Bu rol yalnızca aşağıdaki creativeType için desteklenir ve gereklidir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Yerel video reklam öğesinin kapak resmi.

Bu rol yalnızca aşağıdaki creativeType için desteklenir ve gereklidir:

  • CREATIVE_TYPE_VIDEO

ExitEvent

Reklam öğesinin çıkış etkinliği.

JSON gösterimi 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Alanlar
type

enum (ExitEventType)

Zorunlu. Çıkış etkinliğinin türü.
url

string

Zorunlu. Çıkış etkinliğinin tıklama URL'si. Bu, type aşağıdaki durumlarda zorunludur:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Çıkış etkinliğinin tıklama etiketinin adı.

Ad, bir reklam öğesi içinde benzersiz olmalıdır.

Bu alanı, yalnızca resim öğeleri içeren reklam öğeleri için boş veya ayarlanmamış olarak bırakın.
reportingName

string

Raporlarda bu etkinliği tanımlamak için kullanılan ad. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın veya ayarını kaldırın.

ExitEventType

Çıkış etkinliğinin türü.

Sıralamalar
EXIT_EVENT_TYPE_UNSPECIFIED Çıkış etkinliği türü bu sürümde belirtilmemiş veya bilinmiyor.
EXIT_EVENT_TYPE_DEFAULT Çıkış etkinliği varsayılan etkinliktir.
EXIT_EVENT_TYPE_BACKUP Çıkış etkinliği, yedek bir çı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

string

Zorunlu. Zamanlayıcı etkinliğinin adı.
reportingName

string

Zorunlu. Raporlarda bu kronometre etkinliğini tanımlamak için kullanılan ad.

CounterEvent

Reklam öğesinin sayaç etkinliği.

JSON gösterimi 
{
  "name": string,
  "reportingName": string
}
Alanlar
name

string

Zorunlu. Karşı etkinlik adı.
reportingName

string

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 offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Alanlar
Birleştirme alanı offset. Ofsetin değeri. offset yalnızca aşağıdakilerden biri olabilir:
percentage

string (int64 format)

Ses veya video süresinin yüzdesi cinsinden ofset.
seconds

string (int64 format)

Sesin veya videonun başlangıcından itibaren saniye cinsinden ofset.

UniversalAdId

Tüm platformlarda benzersiz olan, kayıt otoritesi tarafından sağlanan 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 (UniversalAdRegistry)
}
Alanlar
id

string

Benzersiz reklam öğesi tanımlayıcısı.
registry

enum (UniversalAdRegistry)

Kayıt otoritesi, benzersiz reklam öğesi tanımlayıcıları sağlar.

UniversalAdRegistry

Kayıt otoritesi, bir 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ğ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 Reklam Kimliğini kullanın.
UNIVERSAL_AD_REGISTRY_CLEARCAST Evrensel Reklam Kimliğini sağlamak için clearcast.co.uk adresini kullanın.
UNIVERSAL_AD_REGISTRY_DV360 Universal Ad ID'yi sağlamak için Display & Video 360'ı kullanın.
UNIVERSAL_AD_REGISTRY_CM Evrensel Reklam Kimliğini sağlamak için Campaign Manager 360'ı kullanın.

ThirdPartyUrl

İşitsel veya video reklam öğesi ile etkileşimleri izlemek için üçüncü taraflardan gelen izleme URL'leri.

JSON gösterimi 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Alanlar
type

enum (ThirdPartyUrlType)

Etkileşim türünün izleme URL'si tarafından izlenmesi gerekir
url

string

Etkileşimi izlemek için kullanılan izleme URL'si.

İsteğe bağlı yol veya sorgu dizesi içeren ve https: ile başlayan bir URL sağlayın. Örneğin, https://www.example.com/path

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ü bu sürümde belirtilmemiş veya 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 videoyu tıklamalarını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START 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 Ses veya video öğesinin, süresinin %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 oynatılma sayısını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Ses veya video öğesinin, süresinin %75'ine kadar kaç defa oynatıldığını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Sesin 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 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 duraklatma sayısını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Kullanıcının ses veya videoyu kaç kez yeniden oynattığını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Bir kullanıcının oynatıcıyı kaç kez tam ekran boyutuna genişlettiğini izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Bir 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ıklama 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 Sesin veya videonun, progressOffset tarafından belirlenen bir ofsete kadar oynatılma sayısını izlemek için kullanılır.

Kod dönüştürme

Kod 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 (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Alanlar
name

string

Kod dönüştürülmüş dosyanın adı.
mimeType

string

Kodu dönüştürülmüş dosyanın MIME türü.
transcoded

boolean

Kod dönüştürmenin başarılı olup olmadığını gösterir.
dimensions

object (Dimensions)

Kod dönüştürülmüş videonun boyutları.
bitRateKbps

string (int64 format)

Kodu dönüştürülen videonun kod dönüştürme bit hızı (kilobit/saniye).
frameRate

number

Kodu dönüştürülmüş videonun saniyedeki kare sayısı cinsinden kare hızı.
audioBitRateKbps

string (int64 format)

Kodu dönüştürülmüş videonun ses akışının bit hızı veya kodu dönüştürülen sesin bit hızı (kilobit/saniye).
audioSampleRateHz

string (int64 format)

Kodu dönüştürülmüş videonun ses akışı için örnek hızı veya kod dönüştürülmüş ses için örnek hızı (hertz cinsinden).
fileSizeBytes

string (int64 format)

Kod 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

string (int64 format)

Campaign Manager 360 izleme reklamının yerleşim kimliği.
cmCreativeId

string (int64 format)

Campaign Manager 360 izleme reklamının reklam öğesi kimliği.
cmAdId

string (int64 format)

Kampanya yöneticisi 360 izleme reklamının reklam kimliği.

ObaIcon

Reklam Öğesi için OBA Simgesi

JSON gösterimi 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Alanlar
resourceUrl

string

OBA simgesi kaynağının URL'si.
resourceMimeType

string

OBA simgesi kaynağının MIME türü.
position

enum (ObaIconPosition)

OBA simgesinin reklam öğesindeki konumu.
dimensions

object (Dimensions)

OBA simgesinin boyutları.
program

string

OBA simgesinin programı. Örneğin: "AdChoices".
landingPageUrl

string

Zorunlu. OBA simgesinin açılış sayfası URL'si.

Yalnızca aşağıdaki alan adlarının URL'lerine izin verilir:
clickTrackingUrl

string

Zorunlu. OBA simgesinin tıklama izleme URL'si.

Yalnızca aşağıdaki alan adlarının URL'lerine izin verilir:
viewTrackingUrl

string

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ı doğru genişler.
EXPANDING_DIRECTION_DOWN Aşağı genişletir.
EXPANDING_DIRECTION_LEFT Sola genişler.
EXPANDING_DIRECTION_RIGHT Sağa genişletir.
EXPANDING_DIRECTION_UP_AND_LEFT Yukarı ve sol tarafa doğru genişler.
EXPANDING_DIRECTION_UP_AND_RIGHT Yukarı ve sağa 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 genişler.
EXPANDING_DIRECTION_UP_OR_DOWN Yukarı veya aşağı genişletir.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Sol veya sağ tarafa genişler.
EXPANDING_DIRECTION_ANY_DIAGONAL Çapraz yönde herhangi bir yönde genişleyebilir.

Yöntemler

create

 Yeni bir reklam öğesi oluşturur.

delete

 Reklam öğesini siler.

get

 Reklam öğesi alır.

list

 Bir reklamverendeki reklam öğelerini listeler.

patch

 Mevcut bir reklam öğesini günceller.