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.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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 nerede barındırıldığını gösterir.

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 şunlardan 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 widthPixels ve heightPixels alanlarının her ikisi de 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 kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

creativeAttributes[]

enum (CreativeAttribute)

Yalnızca çıkış. Sistem tarafından oluşturulan reklam öğesi ö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.
  • "GTIN" adında 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, her biri bağımsız olarak zamanlanmış birden fazla zamanlayıcı etkinliği olabilir. Bu alanı, yalnızca resim öğeleri içeren reklam öğeleri için boş veya ayarlanmamış olarak 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ıklayarak, dokunarak, veri yükleyerek, klavye girişleriyle) rich media reklam öğesinin herhangi bir bölümüyle kaç kez etkileşimde bulunduğunu izler. Reklam öğesinde yakalanabilecek etkinlikler 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ı. En fazla 20.000 karakter uzunluğunda,UTF-8 olarak kodlanmış olmalıdır.

iasCampaignMonitoring

boolean

Integral Ad Science (IAS) kampanya izlemesinin etkinleştirilip etkinleştirilmediğini 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 öğeleriyle), yayıncının video oynatıcısının etrafında yayınlanacak şekilde atayabilirsiniz. Tamamlayıcılar, video oynatılırken video oynatıcının etrafında görüntülenir ve video tamamlandıktan sonra kalır.

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

Bu alan yalnızca 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ılmadan önce 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
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ürmeleri.

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

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • 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 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
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_GIVEN_TOKEN} makrosu içeren bir Campaign Manager 360 izleme reklamı kullanılırken geçerlidir.

İsteğe bağlı 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 birleştirilir:

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birleştirilir:

  • 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 içeren 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 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.

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 Reklam öğesi özelliği belirtilmemiş veya bu sürümde bilinmiyor.
CREATIVE_ATTRIBUTE_VAST Reklam öğesi bir VAST reklam öğesidir.
CREATIVE_ATTRIBUTE_VPAID_LINEAR Reklam öğesi, doğrusal bir VPAID reklam öğesidir.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR Reklam öğesi, doğrusal olmayan bir VPAID reklam öğesidir.

ReviewStatusInfo

Reklam öğesinin 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)

Bir reklam öğesinin yayınlanmaya başlaması için gereken 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 incelemesi durumu.

exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Reklam öğesinin inceleme durumlarını değiştirin.

publisherReviewStatuses[]

object (PublisherReviewStatus)

Reklam öğesinin yayıncı inceleme durumlarını gösterir.

Onay Durumu

Olası onay durumu türleri. creativeAndLandingPageReviewStatus ve contentAndPolicyReviewStatus tarihlerinin ö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ı inceleme durumu türleri.

Sıralamalar
REVIEW_STATUS_UNSPECIFIED Bu sürümde tür değeri belirtilmemiş veya bilinmiyor.
REVIEW_STATUS_APPROVED Reklam öğesi onaylandı.
REVIEW_STATUS_REJECTED Reklam öğesi reddedildi.
REVIEW_STATUS_PENDING Reklam öğesi incelenmeyi bekliyor.

ExchangeReviewStatus

Reklam öğesinin exchange inceleme durumu.

JSON gösterimi
{
  "exchange": enum (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

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 diğer API çağrılarına iletilebilir (ör. Öğeyi bir reklam öğesiyle ilişkilendirmek için creatives.create tuşlarına basın.

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ü belirtilmedi veya bu sürümde bilinmiyor.
ASSET_ROLE_MAIN Öğe, reklam öğesinin ana öğesidir.
ASSET_ROLE_BACKUP Öğe, reklam öğesinin yedek öğesidir.
ASSET_ROLE_POLITE_LOAD Öğe, reklam öğesinin bir yükleme bekleme öğesidir.
ASSET_ROLE_HEADLINE

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

content, en fazla 25 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_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 ş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, en fazla 90 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_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/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 şu creativeType rollerinde 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 şu creativeType rollerinde 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 ş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, en fazla 15 karakter uzunluğunda olacak şekilde UTF-8 olarak kodlanmış 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 adresinde tanımlayıcı, com.sirket.uygulamaadi'dir.

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 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 asıl 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 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 şu durumlarda gereklidir:

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

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. Bu alanı, yalnızca resim öğeleri içeren reklam öğeleri için boş veya ayarlanmamış olarak bırakın.

ExitEventType

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

Sıralamalar
EXIT_EVENT_TYPE_UNSPECIFIED Çıkış etkinliği türü belirtilmedi 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 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. 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. Ofsetin 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)

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ı belirtilmemiş veya bu sürümde bilinmiyor.
UNIVERSAL_AD_REGISTRY_OTHER Evrensel Reklam Kimliği'ni sağlamak için özel bir sağlayıcı kullanın.
UNIVERSAL_AD_REGISTRY_AD_ID Evrensel Reklam Kimliğini sağlamak için 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 Görüntülü Reklam ve Video 360: Evrensel Reklam Kimliği.
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şimin türünün üçüncü taraf izleme URL'si tarafından izlenmesi gerekir.

Sıralamalar
THIRD_PARTY_URL_TYPE_UNSPECIFIED Üçüncü taraf URL'sinin türü belirtilmemiş veya bu sürümde bilinmiyor.
THIRD_PARTY_URL_TYPE_IMPRESSION Ses veya video arabelleğe alma işlemi tamamlandıktan sonra reklam öğesinin gösterimlerini saymak için kullanılır.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Kullanıcıların ses veya video tıklamalarını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Bir kullanıcının sesi veya videoyu başlatma sayısını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Ses 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 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 kapatma sayısı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 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ı 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 belirli bir ofsete kadar 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ürmenin 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ışı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ışının örnek hızı veya kodu dönüştürülmüş sesin ö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 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şletme yönü.

Sıralamalar
EXPANDING_DIRECTION_UNSPECIFIED Genişleme yönü belirtilmemiş.
EXPANDING_DIRECTION_NONE Herhangi bir yönde genişleyemez.
EXPANDING_DIRECTION_UP Yukarı genişler.
EXPANDING_DIRECTION_DOWN Aşağı doğru genişler.
EXPANDING_DIRECTION_LEFT Sola genişler.
EXPANDING_DIRECTION_RIGHT Sağa genişler.
EXPANDING_DIRECTION_UP_AND_LEFT Yukarı ve sol tarafa genişler.
EXPANDING_DIRECTION_UP_AND_RIGHT Yukarı ve sağ tarafa genişler.
EXPANDING_DIRECTION_DOWN_AND_LEFT Aşağıya 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 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 oluşturur.

list

Bir reklamverendeki reklam öğelerini listeler.

patch

Mevcut bir reklam öğesini günceller.