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 baytlık bir boyutla kodlanmış UTF-8 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 (ör. reklam incelemesi) en son güncellendiği zaman damgası. Sistem tarafından atanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, 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üğe ve en fazla dokuz kesir basamağına sahip, 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ğ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 en az 0 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ğı içeren ve "s" ile biten 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 reklam öğesiyle 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. Aşağıdaki yöntemlerden birini kullanarak reklam öğenize çıkış ekleyebilirsiniz:

  • Google Web Designer'ın dokunma alanını kullanın.
  • "clickTag" adı verilen bir JavaScript değişkeni tanımlayın.
  • Rich media biçimlerindeki çı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 zengin medya içerikli bir 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 gelme, fareyi üzerinden çekme, tıklama, dokunma, veri yükleme, klavye girişleri vb.) rich media reklam öğesinin herhangi bir bölümüyle kaç kez etkileşimde bulunduğunu izler. Reklam öğesinde yakalanabilecek tüm etkinlikler 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 olacak şekilde UTF-8 olarak kodlanmış olmalıdır.
notes

string

Bu reklam öğesi için kullanıcı notları. En fazla 20.000 karakter uzunluğunda kodlu UTF-8 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 öğesinin 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 yayınlanacak ş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 olarak sayılmadan önce videonun oynatılacağı süre.

skippable doğru olduğunda bu alan gereklidir.

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

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

İsteğe bağlı. Kayıt otoritesinin sağladığı, tüm platformlarda benzersiz olan isteğe bağlı 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 olan 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.

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 şu creativeType ürünlerinde 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; IMAGE veya script etiketleri kabul edilmez.

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ına (ComScore, DoubleClickVerify, IAS, Moat) ait 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ş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ıdır:

  • 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 şu creativeType ürünlerinde desteklenir:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

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

Zorunludur ve yalnızca üçüncü taraf etiketi reklamları için geçerlidir.

Üçüncü taraf etiketi reklam öğeleri, aşağıdaki 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 öğesiyle etkileşim 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, aşağıdaki 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'ten yararlandığını belirtir.

İsteğe bağlıdır ve yalnızca üçüncü taraf etiketi reklam öğeleri için geçerlidir. Üçüncü taraf etiketi reklam öğeleri, aşağıdaki 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, aşağıdaki 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, aşağıdaki 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şletme yönünü belirtir.

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

şu creativeType ile birlikte:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Yalnızca çıkış. VPAID (Dijital Video Oynatıcı Reklam Arayüzü) kullanılmasını gerektiren üçüncü taraf VAST etiketi reklam öğesini gösterir.

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

Üçüncü taraf VAST etiketi reklam öğeleri, aşağıdaki 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, aşağıdaki 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 LineItem.creative_ids bunun yerine kullanın.
mp3Audio

boolean

Yalnızca çıkış. MP3'ü destekleyen üçüncü taraf işitsel reklam öğesini gösterir.

Yalnızca çıkış ve yalnızca üçü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 birlikte:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Yalnızca çıkış. OGG'yi destekleyen üçüncü taraf işitsel reklam öğesini gösterir.

Yalnızca çıkış ve yalnızca üçü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 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 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 şunlardan 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 şunlardan 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 öğesinin 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 öğesi.

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ı 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 belirtilmedi 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 incelemesi bekliyor.
APPROVAL_STATUS_APPROVED_SERVABLE Hem reklam öğesi hem de açılış sayfası incelemesi ile içerik ve politika incelemesi onaylanmıştı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 belirtilmedi 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)

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

Medya kimliği alanı, 5 Nisan 2023'te güncellendi. 5 Nisan 2023'ten önce önbelleğe alınan medya kimliklerini, ilişkili reklam öğesi kaynaklarından alarak veya öğeyi yeniden yükleyerek 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ü belirtilmemiş 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 aşağıdaki creativeType kullanıcıları 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 olacak şekilde UTF-8 olarak kodlanmış olmalıdır.

Bu rol yalnızca aşağıdaki creativeType kullanıcıları 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 olacak şekilde UTF-8 olarak kodlanmış olmalıdır.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Yerel bir 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 aşağıdaki creativeType kullanıcıları 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 kullanımı kolay 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 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 aşağıdaki creativeType kullanıcıları 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 olacak şekilde UTF-8 olarak kodlanmış olmalıdır.

Bu rol yalnızca aşağıdaki creativeType kullanıcıları 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 olacak şekilde UTF-8 olarak kodlanmış olmalıdır.

Bu rol yalnızca aşağıdaki creativeType kullanıcıları 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ı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. Reklam öğesi kaydedildiğinde her zaman sağlanan bu olacaktır.

content, en fazla 15 karakter uzunluğunda olacak şekilde UTF-8 olarak kodlanmış 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

Apple App Store'daki bir iOS uygulamasının 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. Reklam öğesi kaydedildiğinde her zaman sağlanan bu olacaktır.

Bu role sahip öğeler salt okunurdur.
ASSET_ROLE_ICON

Reklam öğesinin simgesi.

Bu rol yalnızca aşağıdaki creativeType koşullarında 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 koşullarında 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 aşağıdaki durumlarda zorunludur:

  • 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ü 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
offset alanı. 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 ofset.

UniversalAdId

Kayıt otoritesi tarafından sağlanan ve 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, Evrensel Reklam Kimliği içinde benzersiz reklam öğesi tanımlayıcıları sağlar.

Sıralamalar
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Evrensel Reklam kayıt defteri bu sürümde belirtilmemiş veya bilinmiyor.
UNIVERSAL_AD_REGISTRY_OTHER Evrensel Reklam Kimliğini sağlamak için bir özel 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 Evrensel Reklam Kimliği'ni sağlamak için Display & Video 360'ı kullanın.
UNIVERSAL_AD_REGISTRY_CM Evrensel Reklam Kimliğini sağlamak için Campaign Manager 360'ı kullanın.

ThirdPartyUrl

Bir işitsel veya video reklam öğesiyle 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.

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 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 Ses veya videonun, sonuna kadar kaç defa oynatıldığını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Kullanıcının ses veya videonun sesini kaç kez 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 çalma 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 sesi veya videoyu kaç defa durdurduğunu izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Bir 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 Sesin veya videonun atlanma sayısını izlemek için kullanılır.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Ses veya videonun, progressOffset tarafından belirlenen bir ofsete göre 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ülen videonun kare hızı (saniyedeki kare sayısı).
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 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)

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)

Campaign Manager 360 izleme reklamının reklam kimliği.

ObaIcon

Bir 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 köşesinde.
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şletme 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ğıya 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 Sol veya sağ tarafa genişler.
EXPANDING_DIRECTION_ANY_DIAGONAL Herhangi bir çapraz 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.