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ş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 boyutunda 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 (ö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: "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.

Nanosaniye çözünürlük ve en fazla dokuz kesir basamağı olan, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Ö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 nerede barındırıldığını gösterir.
dynamic

boolean

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

object (Dimensions)

Zorunlu. Reklam öğesinin birincil boyutları. Tüm reklam öğesi türleri için geçerlidir. creativeType şunlardan biri olduğunda widthPixels ve heightPixels değeri 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 widthPixels ve heightPixels alanlarının her ikisi de zorunludur ve 0'dan büyük ya da 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

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

enum (CreativeAttribute)

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

object (ReviewStatusInfo)

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

object (AssetAssociation)

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

object (ExitEvent)

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:

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

object (CounterEvent)

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

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. En fazla 10.000 karakter uzunluğunda olan UTF-8 kodlu olmalıdır.
notes

string

Bu reklam öğesi için kullanıcı notları. En fazla 20.000 karakter uzunluğunda olan UTF-8 kodlu 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 değerinin IAS istemci kimliğinize ayarlandığından emin olun.
companionCreativeIds[]

string (int64 format)

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 şu 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 gereklidir.

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

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Görüntüleme sayısı sayılmadan önce videonun oynatılması için geçmesi 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 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)

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

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ü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 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çin 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ına (ComScore, DoubleVerify, IAS, Moat) ait JavaScript ölçüm URL'si. HTML komut dosyası etiketleri desteklenmez.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (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 creativeType için isteğe bağlı:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

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

object (ObaIcon)

Video reklam öğesi için OBA simgesini belirtir.

Bu alan yalnızca aşağıdaki 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 reklamları için geçerlidir.

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

  • HOSTING_SOURCE_THIRD_PARTY

şu 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 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 hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu 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 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 hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • 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 birlikte:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

İ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:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

İ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 hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu 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 belirtir.

Yalnızca çıkış 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

şu creativeType ile birlikte:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

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 hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

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 LineItem.creative_ids kullanın.
mp3Audio

boolean

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 hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

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 hostingSource içeren reklam öğeleridir:

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • CREATIVE_TYPE_AUDIO

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.

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 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 (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
Alanlar
approvalStatus

enum (ApprovalStatus)

Bir reklam öğesinin yayınlanmaya başlaması için gereken temel onayı temsil eder. creativeAndLandingPageReviewStatus ve contentAndPolicyReviewStatus özeti.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

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

enum (ReviewStatus)

Reklam öğesi için içerik ve politika incelemesi durumu.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Reklam öğesi için inceleme durumlarını değiştirin.
publisherReviewStatuses[]

object (PublisherReviewStatus)

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

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

enum (Exchange)

Reklam öğesini inceleyen exchange.
status

enum (ReviewStatus)

Exchange incelemesinin durumu.

PublisherReviewStatus

Reklam öğesi için 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)

Reklam için bu öğenin 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 diğer API çağrılarına (ör. creatives.create) aktarılabilir.

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

string

Öğ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ığı.

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

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

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Yerel reklam öğesinin gövde metni.

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

Bu rol yalnızca aşağıdaki creativeType için 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 olan UTF-8 kodlu olmalıdır.

Bu rol yalnızca aşağıdaki creativeType için 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ı tıkladıklarında ulaşacakları sayfa konusunda fikir verir.

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

Ö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 creativeType için 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 olan UTF-8 kodlu olmalıdır.

Bu rol yalnızca aşağıdaki creativeType için 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 olan UTF-8 kodlu olmalıdır.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
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.

content, en fazla 15 karakter uzunluğunda olan UTF-8 kodlu olmalıdı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 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. type:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Çı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

string

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

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. Sayaç etkinliğinin 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. Ofset değeri. offset şunlardan yalnızca biri olabilir:
percentage

string (int64 format)

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

string (int64 format)

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

string

Kodu 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ürme işleminin başarılı olup olmadığını gösterir.
dimensions

object (Dimensions)

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

string (int64 format)

Kodu dönüştürülmüş 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ışı için 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 kodu dönüştürülmüş sesin hertz cinsinden örnek hızı.
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)

Kampanya yöneticisi 360 izleme reklamının yerleşim kimliği.
cmCreativeId

string (int64 format)

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

string (int64 format)

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 (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)

Reklam öğesindeki OBA simgesinin 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 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

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

create

 Yeni bir reklam öğesi oluşturur.

delete

 Reklam öğesini siler.

get

 Yaratıcı bir fikir üretir.

list

 Bir reklamverendeki reklam öğelerini listeler.

patch

 Mevcut bir reklam öğesini günceller.