REST Resource: advertisers.creatives

Kaynak: Reklam öğesi

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ş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

string

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

UTF-8 kodlu olmalı ve en fazla 240 bayt boyutunda olmalıdır.
entityStatus

enum (EntityStatus)

Zorunlu. Reklam öğesinin yayınlanıp yayınlanamayacağı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 (ör. reklam öğesi incelemesi) en son güncellendiği zaman damgası. 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" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
creativeType

enum (CreativeType)

Zorunlu. Değişmez. 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 şunlardan biri olduğunda geçerlidir:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

En fazla dokuz kesirli basamak içeren 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şkili öğ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, kullanıcının bir rich media reklam öğesinin belirli bir bölümünü görüntüleyip etkileşim kurduğu süreyi izler. Bir reklam öğesinin, her biri bağımsız olarak zamanlanmış birden fazla zamanlayıcı etkinliği olabilir. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın veya ayarlanmamış olarak bırakı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. Yalnızca resim öğeleri içeren reklam öğeleri için boş bırakın 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 kodlu olmalı 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. Bu özelliği reklam öğesi için etkinleştirmek üzere Advertiser.creative_config.ias_client_id değerinin 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 öğesi 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)

Atla düğmesi görüntüleninceye kadar videonun oynatılacağı süredir.

skippable doğru olduğunda bu alan doldurulmalıdır.

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

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Görüntüleme sayılmadan önce videonun oynatılacağı süredir.

skippable doğru olduğunda bu alan doldurulmalıdır.

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.

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ü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.

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

Bu alan yalnızca şu creativeType içinde yazılabilir:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Desteklenen üçüncü taraf doğrulama sağlayıcılardan (ComScore, DoubleVerify, IAS, Moat) JavaScript ölçüm URL'si. HTML komut dosyası etiketleri desteklenmez.

Bu alana yalnızca aşağıdaki creativeType'lerde 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ış.
obaIcon

object (ObaIcon)

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

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

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

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

Zorunlu 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
requireMraid

boolean

İ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 hareketlere ihtiyaç duyuyorsa 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 kullandığını 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 bir geri ping bekleyeceğini belirtir.

Yalnızca üçüncü taraf reklam sunucusu parametresi ve ${DC_DBM_TOKEN} makrosu içeren bir Campaign Manager 360 izleme reklamı kullanırken 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 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

Üçü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.

Zorunlu 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

Aşağıdaki creativeType ile birlikte:

  • 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

Aşağıdaki creativeType ile birlikte:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

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

Zorunlu 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_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Yalnızca çıkış. Üçüncü taraf VAST etiketi reklam öğesi için VPAID (Dijital Video Oynatıcı Reklam Arayüzü) gerektiğini belirtir.

Yalnızca çıkış ve sadece üçü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_VIDEO
html5Video

boolean

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

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
lineItemIds[]

string (int64 format)

Yalnızca çıkış. Bu reklam öğesinin ilişkili olduğu satır öğelerinin kimlikleri.

Bir reklam öğesini 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 içeren 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ış 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

şu creativeType ile birleştirilir:

  • CREATIVE_TYPE_AUDIO

HostingSource

Bir reklam öğesi için olası barındırma kaynakları. Bir reklam öğesinin oluşturulduğu ve barındırıldığı yeri belirtir.

Sıralamalar
HOSTING_SOURCE_UNSPECIFIED Barındırma kaynağı bu sürümde belirtilmemiş veya 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.

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.

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

CreativeAttribute

Bir reklam öğesinin 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 öğesinin 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 tarihlerinin özeti.

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ı incelemesini geçti ve yayınlanabilir durumda 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 onaylandı. Reklam öğesi yayınlanabilir durumdadır.
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 (Exchange),
  "status": enum (ReviewStatus)
}
Alanlar
exchange

enum (Exchange)

Reklam öğesini inceleyen exchange.
status

enum (ReviewStatus)

Değişim incelemesinin durumu.

PublisherReviewStatus

Reklam öğesinin yayıncı inceleme durumu.

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

string

Reklam öğesini inceleyen yayıncı.
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şkili reklam öğesi kaynaklarından yeni medya kimliğini alarak veya öğeyi yeniden yükleyerek 5 Nisan 2023'ten önce önbelleğe alınmış medya kimliklerini güncelleyin.
content

string

Öğ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ü 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, 50 karakterden uzun olmamak üzere UTF-8 olarak kodlanmış 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_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

Doğal reklam öğesinin uzun gövde metni.

content, UTF-8 kodlu ve en fazla 150 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_CAPTION_URL

Reklam öğesinde gösterilecek açılış sayfası URL'sinin kısa ve kullanımı kolay bir biçimi. Bu URL, kullanıcılara reklam öğesini tıkladıktan sonra nereye yönlendirilecekleriyle ilgili fikir verir.

content, UTF-8 kodlu ve en fazla 30 karakter uzunluğunda 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'de boşluk veya özel karakter bulunamaz.

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, en fazla 15 karakter uzunluğunda olacak şekilde UTF-8 olarak kodlanmış 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, en fazla 25 karakter uzunluğunda olacak şekilde UTF-8 olarak kodlanmış 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_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 uygulama mağazasındaki bir iOS uygulamasının kimliği.

Bu kimlik numarası, Apple App Store URL'sinde "id"den hemen sonraki sayı dizisi olarak bulunabilir. Örneğin, https://apps.apple.com/us/app/gmail-email-by-google/id422689480 sayfasında kimlik 422689480'dir.

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

Bir reklam öğesinin simgesi.

Bu rol yalnızca aşağıdaki creativeType'lerde 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'lerde 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. type şu durumlarda gereklidir:

  • 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 ayarlanmamış olarak bırakı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 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

string

Zorunlu. Karşı etkinliğin adı.
reportingName

string

Zorunlu. Raporlarda bu karşı etkinlik adını tanımlamak için kullanılan ad.

AudioVideoOffset

Bir ses veya videonun oynatılma süresi.

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
Birlik alanı offset. Ofsetin değeri. offset yalnızca aşağıdakilerden biri olabilir:
percentage

string (int64 format)

Ses veya video süresinin yüzde cinsinden ofseti.
seconds

string (int64 format)

Ses veya videonun başlangıcından itibaren saniye cinsinden göreli konum.

UniversalAdId

Bir sicil dairesi tarafından sağlanan ve tüm platformlarda benzersiz olan 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 (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 defteri, 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ğ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 adresini kullanın.
UNIVERSAL_AD_REGISTRY_DV360 Universal Ad ID'yi sağlamak için Display & Video 360'ı kullanın.
UNIVERSAL_AD_REGISTRY_CM Universal Ad ID'yi sağlamak için Campaign Manager 360'ı kullanın.

ThirdPartyUrl

Ses veya video reklam öğesiyle etkileşimleri izlemek için üçüncü taraflardan alınan 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.

https: ile başlayan, isteğe bağlı yol veya sorgu dizesi içeren bir URL girin. Ö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 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 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 Kullanıcının ses veya videoyu kaç kez duraklattığı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 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 Kullanıcının ses veya videoyu kaç kez 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ç defa 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 (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

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

boolean

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

object (Dimensions)

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

string (int64 format)

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

number

Kod dönüştürülmüş videonun kare hızı (saniye başına kare).
audioBitRateKbps

string (int64 format)

Kod dönüştürülmüş videonun ses akışının bit hızı veya kod dönüştürülmüş 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)

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

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: “Reklam Seçenekleri”.
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 alanları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 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 Herhangi 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şler.
EXPANDING_DIRECTION_UP_AND_LEFT Yukarı ve sol tarafa doğru genişler.
EXPANDING_DIRECTION_UP_AND_RIGHT Yukarı ve sağ tarafa 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ğı doğru genişler.
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

 Reklamverendeki reklam öğelerini listeler.

patch

 Mevcut bir reklam öğesini günceller.