REST Resource: advertisers.creatives

Resource: Materi Iklan

Satu Materi Iklan.

Representasi JSON 
{
  "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
}
Kolom
name

string

Hanya output. Nama resource materi iklan.
advertiserId

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki materi iklan.
creativeId

string (int64 format)

Hanya output. ID unik materi iklan. Ditetapkan oleh sistem.
cmPlacementId

string (int64 format)

Hanya output. ID unik penempatan Campaign Manager 360 yang terkait dengan materi iklan. Kolom ini hanya berlaku untuk materi iklan yang disinkronkan dari Campaign Manager.
displayName

string

Wajib. Nama tampilan materi iklan.

Harus berenkode UTF-8 dengan ukuran maksimum 240 byte.
entityStatus

enum (EntityStatus)

Wajib. Mengontrol apakah materi iklan dapat ditayangkan atau tidak.

Nilai yang diterima adalah:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat materi iklan terakhir diperbarui, baik oleh pengguna maupun sistem (misalnya, peninjauan materi iklan). Ditetapkan oleh sistem.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
createTime

string (Timestamp format)

Hanya output. Stempel waktu saat materi iklan dibuat. Ditetapkan oleh sistem.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
creativeType

enum (CreativeType)

Wajib. Tidak dapat diubah. Jenis materi iklan.
hostingSource

enum (HostingSource)

Wajib. Menunjukkan tempat materi iklan dihosting.
dynamic

boolean

Hanya output. Menunjukkan apakah materi iklan bersifat dinamis.
dimensions

object (Dimensions)

Wajib. Dimensi utama materi iklan. Berlaku untuk semua jenis materi iklan. Nilai widthPixels dan heightPixels secara default adalah 0 jika creativeType adalah salah satu dari:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Opsional. Dimensi tambahan. Berlaku jika creativeType adalah salah satu dari:

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

Jika kolom ini ditentukan, widthPixels dan heightPixels keduanya wajib diisi dan harus lebih besar dari atau sama dengan 0.
mediaDuration

string (Duration format)

Hanya output. Durasi media materi iklan. Berlaku jika creativeType adalah salah satu dari:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Hanya output. Daftar atribut materi iklan yang dibuat oleh sistem.
reviewStatus

object (ReviewStatusInfo)

Hanya output. Status saat ini dari proses peninjauan materi iklan.
assets[]

object (AssetAssociation)

Wajib. Aset yang terkait dengan materi iklan ini.
exitEvents[]

object (ExitEvent)

Wajib. Peristiwa keluar untuk materi iklan ini. Exit (juga dikenal sebagai tag klik) adalah area apa pun dalam materi iklan yang dapat diklik atau diketuk seseorang untuk membuka halaman landing pengiklan. Setiap materi iklan harus menyertakan minimal satu pintu keluar. Anda dapat menambahkan pintu keluar ke materi iklan dengan salah satu cara berikut:

  • Gunakan area ketuk Google Web Designer.
  • Tentukan variabel JavaScript yang disebut "clickTag".
  • Gunakan Pengaktif (Enabler.exit()) untuk melacak keluar di format multimedia.
timerEvents[]

object (TimerEvent)

Opsional. Peristiwa kustom timer untuk materi iklan multimedia. Timer melacak durasi waktu pengguna melihat dan berinteraksi dengan bagian tertentu dari materi iklan multimedia. Materi iklan dapat memiliki beberapa peristiwa timer, masing-masing diatur waktunya secara terpisah. Biarkan kosong atau tidak disetel untuk materi iklan yang hanya berisi aset gambar.
counterEvents[]

object (CounterEvent)

Opsional. Peristiwa penghitung untuk materi iklan multimedia. Penghitung melacak frekuensi pengguna berinteraksi dengan bagian materi iklan multimedia mana pun dengan cara tertentu (gerakan mouse, mouse-lepas, klik, ketukan, pemuatan data, entri keyboard, dll.). Setiap peristiwa yang dapat ditangkap dalam materi iklan dapat dicatat sebagai penghitung. Biarkan kosong atau tidak disetel untuk materi iklan yang hanya berisi aset gambar.
appendedTag

string

Opsional. Tag pelacakan HTML pihak ketiga yang akan ditambahkan ke tag materi iklan.
integrationCode

string

Opsional. Informasi ID yang digunakan untuk menautkan materi iklan ini ke sistem eksternal. Harus berenkode UTF-8 dengan panjang tidak lebih dari 10.000 karakter.
notes

string

Opsional. Catatan pengguna untuk materi iklan ini. Harus berenkode UTF-8 dengan panjang tidak lebih dari 20.000 karakter.
iasCampaignMonitoring

boolean

Opsional. Menunjukkan apakah pemantauan kampanye Integral Ad Science (IAS) diaktifkan atau tidak. Untuk mengaktifkannya bagi materi iklan, pastikan Advertiser.creative_config.ias_client_id telah ditetapkan ke ID klien IAS Anda.
companionCreativeIds[]

string (int64 format)

Opsional. ID materi iklan pengiring untuk materi iklan video.

Anda dapat menetapkan materi iklan display yang ada (dengan aset gambar atau HTML5) untuk ditayangkan di sekitar pemutar video penayang. Pendamping ditampilkan di sekitar pemutar video saat video diputar dan tetap ada setelah video selesai.

Materi iklan yang berisi additional dimensions tidak dapat menjadi materi iklan pengiring.

Kolom ini hanya didukung untuk creativeType berikut:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Opsional. Apakah pengguna dapat memilih untuk melewati materi iklan video.

Kolom ini hanya didukung untuk creativeType berikut:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Opsional. Jumlah waktu untuk memutar video sebelum tombol lewati muncul.

Kolom ini wajib diisi jika skippable benar.

Kolom ini hanya didukung untuk creativeType berikut:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Opsional. Jumlah waktu untuk memutar video sebelum menghitung penayangan.

Kolom ini wajib diisi jika skippable benar.

Kolom ini hanya didukung untuk creativeType berikut:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Opsional. ID materi iklan opsional yang disediakan oleh registry yang unik di semua platform.

ID Iklan Universal adalah bagian dari standar VAST 4.0. Setelan ini dapat diubah setelah materi iklan dibuat.

Kolom ini hanya didukung untuk creativeType berikut:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

Opsional. URL pelacakan dari pihak ketiga untuk melacak interaksi dengan materi iklan video.

Kolom ini hanya didukung untuk creativeType berikut:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Hanya output. Transkode audio/video.

Display & Video 360 melakukan transcoding aset utama ke dalam sejumlah versi alternatif yang menggunakan format file berbeda atau memiliki properti berbeda (resolusi, kecepatan bit audio, dan kecepatan bit video), yang masing-masing dirancang untuk pemutar video atau bandwidth tertentu.

Transkode ini memberi sistem penayang lebih banyak opsi untuk dipilih bagi setiap tayangan iklan di video Anda dan memastikan bahwa file yang sesuai ditayangkan berdasarkan koneksi dan ukuran layar penonton.

Kolom ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

Opsional. URL pelacakan untuk penyedia analisis atau vendor teknologi iklan pihak ketiga.

URL harus dimulai dengan https: (kecuali pada inventaris yang tidak memerlukan kepatuhan SSL). Jika menggunakan makro di URL, gunakan hanya makro yang didukung oleh Display & Video 360.

Hanya URL standar, tanpa tag IMG atau SCRIPT.

Kolom ini hanya dapat ditulis di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

Opsional. URL pengukuran JavaScript dari penyedia verifikasi pihak ketiga yang didukung (ComScore, DoubleVerify, IAS, Moat). Tag skrip HTML tidak didukung.

Kolom ini hanya dapat ditulis di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

Opsional. Iklan pelacakan Campaign Manager 360 yang terkait dengan materi iklan.

Opsional untuk creativeType berikut saat dibuat oleh pengiklan yang menggunakan penayangan iklan pihak ketiga dan Campaign Manager 360:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Hanya output untuk kasus lainnya.
obaIcon

object (ObaIcon)

Opsional. Menentukan ikon OBA untuk materi iklan video.

Kolom ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

Opsional. Tag pihak ketiga asli yang digunakan untuk materi iklan.

Wajib dan hanya valid untuk materi iklan tag pihak ketiga.

Materi iklan tag pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

Opsional. Menunjukkan bahwa materi iklan memerlukan MRAID (sistem Mobile Rich Media Ad Interface Definitions).

Tetapkan ini jika materi iklan mengandalkan gestur seluler untuk interaktivitas, seperti menggeser atau mengetuk.

Opsional dan hanya valid untuk materi iklan tag pihak ketiga.

Materi iklan tag pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Opsional. Menunjukkan bahwa materi iklan mengandalkan HTML5 agar dapat dirender dengan benar.

Opsional dan hanya valid untuk materi iklan tag pihak ketiga. Materi iklan tag pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Opsional. Menunjukkan bahwa materi iklan akan menunggu ping kembali untuk atribusi.

Hanya valid saat menggunakan iklan pelacakan Campaign Manager 360 dengan parameter server iklan pihak ketiga dan makro ${DC_DBM_TOKEN}.

Opsional dan hanya valid untuk materi iklan tag pihak ketiga atau materi iklan tag VAST pihak ketiga.

Materi iklan tag pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Materi iklan tag VAST pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Opsional. Menentukan arah perluasan materi iklan.

Wajib dan hanya valid untuk materi iklan yang dapat diluaskan pihak ketiga.

Materi iklan yang dapat diperluas pihak ketiga adalah materi iklan dengan sumber hosting berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Opsional. Menunjukkan bahwa materi iklan akan otomatis diperluas saat kursor diarahkan ke atasnya.

Opsional dan hanya valid untuk materi iklan yang dapat diperluas pihak ketiga. Materi iklan yang dapat diperluas pihak ketiga adalah materi iklan dengan sumber hosting berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Opsional. URL tag VAST untuk materi iklan tag VAST pihak ketiga.

Wajib dan hanya valid untuk materi iklan tag VAST pihak ketiga.

Materi iklan tag VAST pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Hanya output. Menunjukkan bahwa materi iklan tag VAST pihak ketiga memerlukan VPAID (Digital Video Player-Ad Interface).

Output saja dan hanya valid untuk materi iklan tag VAST pihak ketiga.

Materi iklan tag VAST pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Hanya output. Menunjukkan bahwa materi iklan tag VAST pihak ketiga memerlukan dukungan Video HTML5.

Output saja dan hanya valid untuk materi iklan tag VAST pihak ketiga.

Materi iklan tag VAST pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Hanya output. ID item baris yang terkait dengan materi iklan ini.

Untuk mengaitkan materi iklan ke item baris, gunakan LineItem.creative_ids sebagai gantinya.
mp3Audio

boolean

Hanya output. Menunjukkan bahwa materi iklan audio pihak ketiga mendukung MP3.

Hanya output dan hanya valid untuk materi iklan audio pihak ketiga.

Materi iklan audio pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Hanya output. Menunjukkan bahwa materi iklan audio pihak ketiga mendukung OGG.

Hanya output dan hanya valid untuk materi iklan audio pihak ketiga.

Materi iklan audio pihak ketiga adalah materi iklan dengan hostingSource berikut:

  • HOSTING_SOURCE_THIRD_PARTY

digabungkan dengan creativeType berikut:

  • CREATIVE_TYPE_AUDIO

HostingSource

Kemungkinan sumber hosting untuk materi iklan. Menunjukkan tempat materi iklan dibuat dan dihosting.

Enum
HOSTING_SOURCE_UNSPECIFIED Sumber hosting tidak ditentukan atau tidak diketahui dalam versi ini.
HOSTING_SOURCE_CM

Materi iklan yang disinkronkan dari Campaign Manager 360.

Metode pembuatan dan pembaruan tidak didukung untuk jenis hosting ini.
HOSTING_SOURCE_THIRD_PARTY

Materi iklan yang dihosting oleh server iklan pihak ketiga (3PAS).

Metode pembuatan dan pembaruan didukung untuk jenis hosting ini jika creativeType adalah salah satu dari berikut ini:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Materi iklan yang dibuat di DV360 dan dihosting oleh Campaign Manager 360.

Metode pembuatan dan pembaruan didukung untuk jenis hosting ini jika creativeType adalah salah satu dari berikut ini:

  • 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

Materi iklan multimedia yang dibuat di Studio dan dihosting oleh Campaign Manager 360.

Metode pembuatan dan pembaruan tidak didukung untuk jenis hosting ini.

CreativeAttribute

Kemungkinan atribut materi iklan.

Enum
CREATIVE_ATTRIBUTE_UNSPECIFIED Atribut materi iklan tidak ditentukan atau tidak diketahui dalam versi ini.
CREATIVE_ATTRIBUTE_VAST Materi iklan adalah materi iklan VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR Materi iklan adalah materi iklan VPAID linear.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR Materi iklan adalah materi iklan VPAID non-linear.

ReviewStatusInfo

Meninjau status materi iklan.

Representasi JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ]
}
Kolom
approvalStatus

enum (ApprovalStatus)

Mewakili persetujuan dasar yang diperlukan agar materi iklan mulai ditayangkan. Ringkasan creativeAndLandingPageReviewStatus dan contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Status peninjauan materi iklan dan halaman landing untuk materi iklan.
contentAndPolicyReviewStatus

enum (ReviewStatus)

Status peninjauan konten dan kebijakan untuk materi iklan.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Status peninjauan Exchange untuk materi iklan.

StatusPersetujuan

Kemungkinan jenis status persetujuan. Ini adalah ringkasan creativeAndLandingPageReviewStatus dan contentAndPolicyReviewStatus.

Enum
APPROVAL_STATUS_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
APPROVAL_STATUS_PENDING_NOT_SERVABLE Materi iklan masih dalam peninjauan dan tidak dapat ditayangkan.
APPROVAL_STATUS_PENDING_SERVABLE Materi iklan telah lulus peninjauan materi iklan & halaman landing dan dapat ditayangkan, tetapi sedang menunggu peninjauan konten & kebijakan tambahan.
APPROVAL_STATUS_APPROVED_SERVABLE Peninjauan materi iklan & halaman landing dan peninjauan konten & kebijakan disetujui. Materi iklan dapat ditayangkan.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Ada masalah pada materi iklan yang harus diperbaiki sebelum dapat ditayangkan.

ReviewStatus

Kemungkinan jenis status ulasan.

Enum
REVIEW_STATUS_UNSPECIFIED Nilai jenis tidak ditentukan atau tidak diketahui dalam versi ini.
REVIEW_STATUS_APPROVED Materi iklan disetujui.
REVIEW_STATUS_REJECTED Materi iklan ditolak.
REVIEW_STATUS_PENDING Materi iklan sedang menunggu peninjauan.

ExchangeReviewStatus

Status peninjauan Exchange untuk materi iklan.

Representasi JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Kolom
exchange

enum (Exchange)

Exchange yang meninjau materi iklan.
status

enum (ReviewStatus)

Status peninjauan bursa.

AssetAssociation

Pengaitan aset untuk materi iklan.

Representasi JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Kolom
asset

object (Asset)

Opsional. Aset terkait.
role

enum (AssetRole)

Opsional. Peran aset ini untuk materi iklan.

Aset

Satu aset.

Representasi JSON 
{
  "mediaId": string,
  "content": string
}
Kolom
mediaId

string (int64 format)

ID media aset yang diupload. Ini adalah ID unik untuk aset. ID ini dapat diteruskan ke panggilan API lain, misalnya creatives.create untuk mengaitkan aset dengan materi iklan.

Ruang ID Media diperbarui pada 5 April 2023. Perbarui ID media yang di-cache sebelum 5 April 2023 dengan mengambil ID media baru dari resource materi iklan terkait atau mengupload ulang aset.
content

string

Konten aset. Untuk aset yang diupload, kontennya adalah jalur penayangan.

AssetRole

Peran aset ini untuk materi iklan.

Enum
ASSET_ROLE_UNSPECIFIED Peran aset tidak ditentukan atau tidak diketahui dalam versi ini.
ASSET_ROLE_MAIN Aset adalah aset utama materi iklan.
ASSET_ROLE_BACKUP Aset adalah aset cadangan materi iklan.
ASSET_ROLE_POLITE_LOAD Aset adalah aset pemuatan sopan dari materi iklan.
ASSET_ROLE_HEADLINE

Judul materi iklan native.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 25 karakter.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Judul panjang materi iklan native.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 50 karakter.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Teks isi materi iklan native.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 90 karakter.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Teks isi panjang materi iklan native.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 150 karakter.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Versi singkat dan mudah diingat dari URL halaman landing untuk ditampilkan di materi iklan. URL ini memberikan gambaran kepada orang-orang tentang konten yang akan mereka lihat setelah mengklik materi iklan.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 30 karakter.

Misalnya, jika URL halaman landing adalah 'http://www.example.com/page', URL teks dapat berupa 'example.com'. Protokol (http://) bersifat opsional, tetapi URL tidak boleh berisi spasi atau karakter khusus.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Teks yang akan digunakan pada tombol pesan ajakan (CTA) materi iklan native.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 15 karakter.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Teks yang menunjukkan nama pengiklan atau merek.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 25 karakter.

Peran ini hanya didukung di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Harga pembelian aplikasi Anda di Google Play Store atau App Store iOS (misalnya, Rp59.900).

Perhatikan bahwa nilai ini tidak otomatis disinkronkan dengan nilai sebenarnya yang tercantum di toko. Nilai ini akan selalu menjadi nilai yang diberikan saat menyimpan materi iklan.

content harus berenkode UTF-8 dengan panjang tidak lebih dari 15 karakter.

Aset peran ini bersifat hanya baca.
ASSET_ROLE_ANDROID_APP_ID

ID aplikasi Android di Google Play Store.

Anda dapat menemukan ID ini di URL Google Play Store Aplikasi setelah 'id'. Misalnya, di https://play.google.com/store/apps/details?id=com.company.appname, ID-nya adalah com.company.appname.

Aset peran ini bersifat hanya baca.
ASSET_ROLE_IOS_APP_ID

ID aplikasi iOS di Apple App Store.

Nomor ID ini dapat ditemukan di URL Apple App Store sebagai string angka tepat setelah "id". Misalnya, di https://apps.apple.com/us/app/gmail-email-by-google/id422689480, ID-nya adalah 422689480.

Aset peran ini bersifat hanya baca.
ASSET_ROLE_RATING

Rating aplikasi di Google Play Store atau App Store iOS.

Perhatikan bahwa nilai ini tidak disinkronkan secara otomatis dengan rating sebenarnya di toko. Nilai ini akan selalu menjadi nilai yang diberikan saat menyimpan materi iklan.

Aset peran ini bersifat hanya baca.
ASSET_ROLE_ICON

Ikon materi iklan.

Peran ini hanya didukung dan diperlukan di creativeType berikut:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

Gambar sampul materi iklan video native.

Peran ini hanya didukung dan diperlukan di creativeType berikut:

  • CREATIVE_TYPE_VIDEO
ASSET_ROLE_BACKGROUND_COLOR

Warna utama yang akan digunakan dalam materi iklan.

Peran ini hanya didukung dan diperlukan di creativeType berikut:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ACCENT_COLOR

Warna aksen yang akan digunakan dalam materi iklan.

Peran ini hanya didukung dan diperlukan di creativeType berikut:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_REQUIRE_IMAGE

Apakah materi iklan harus menggunakan aset gambar.

Peran ini hanya didukung dan diperlukan di creativeType berikut:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE
ASSET_ROLE_ENABLE_ASSET_ENHANCEMENTS

Apakah peningkatan kualitas aset dapat diterapkan ke materi iklan.

Peran ini hanya didukung dan diperlukan di creativeType berikut:

  • CREATIVE_TYPE_ASSET_BASED_CREATIVE

ExitEvent

Peristiwa keluar dari materi iklan.

Representasi JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Kolom
type

enum (ExitEventType)

Wajib. Jenis peristiwa keluar.
url

string

Wajib. URL klik-tayang peristiwa keluar. Ini wajib diisi jika type adalah:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Opsional. Nama tag klik peristiwa keluar.

Nama harus unik dalam satu materi iklan.

Biarkan kosong atau tidak disetel untuk materi iklan yang hanya berisi aset gambar.
reportingName

string

Opsional. Nama yang digunakan untuk mengidentifikasi peristiwa ini dalam laporan. Biarkan kosong atau tidak disetel untuk materi iklan yang hanya berisi aset gambar.

ExitEventType

Jenis peristiwa keluar.

Enum
EXIT_EVENT_TYPE_UNSPECIFIED Jenis peristiwa keluar tidak ditentukan atau tidak diketahui dalam versi ini.
EXIT_EVENT_TYPE_DEFAULT Peristiwa keluar adalah peristiwa default.
EXIT_EVENT_TYPE_BACKUP Peristiwa keluar adalah peristiwa keluar cadangan. Mungkin ada beberapa peristiwa keluar cadangan dalam materi iklan.

TimerEvent

Peristiwa timer materi iklan.

Representasi JSON 
{
  "name": string,
  "reportingName": string
}
Kolom
name

string

Wajib. Nama peristiwa pewaktu.
reportingName

string

Wajib. Nama yang digunakan untuk mengidentifikasi peristiwa timer ini dalam laporan.

CounterEvent

Peristiwa berlawanan dari materi iklan.

Representasi JSON 
{
  "name": string,
  "reportingName": string
}
Kolom
name

string

Wajib. Nama peristiwa penghitung.
reportingName

string

Wajib. Nama yang digunakan untuk mengidentifikasi peristiwa penghitung ini dalam laporan.

AudioVideoOffset

Durasi audio atau video telah diputar.

Representasi JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Kolom
Kolom union offset. Nilai offset. offset hanya dapat berupa salah satu dari berikut:
percentage

string (int64 format)

Opsional. Offset dalam persentase durasi audio atau video.
seconds

string (int64 format)

Opsional. Offset dalam detik dari awal audio atau video.

UniversalAdId

ID materi iklan yang disediakan oleh registri yang unik di semua platform. Ini adalah bagian dari standar VAST 4.0.

Representasi JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Kolom
id

string

Opsional. ID materi iklan yang unik.
registry

enum (UniversalAdRegistry)

Opsional. Registri menyediakan ID materi iklan yang unik.

UniversalAdRegistry

Registry ini menyediakan ID materi iklan unik dalam ID Iklan Universal.

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Registry Iklan Universal tidak ditentukan atau tidak diketahui dalam versi ini.
UNIVERSAL_AD_REGISTRY_OTHER Gunakan penyedia kustom untuk memberikan ID Iklan Universal.
UNIVERSAL_AD_REGISTRY_AD_ID Gunakan Ad-ID untuk memberikan ID Iklan Universal.
UNIVERSAL_AD_REGISTRY_CLEARCAST Gunakan clearcast.co.uk untuk memberikan ID Iklan Universal.
UNIVERSAL_AD_REGISTRY_DV360 Gunakan Display & Video 360 untuk memberikan ID Iklan Universal.
UNIVERSAL_AD_REGISTRY_CM Gunakan Campaign Manager 360 untuk memberikan ID Iklan Universal.

ThirdPartyUrl

URL pelacakan dari pihak ketiga untuk melacak interaksi dengan materi iklan audio atau video.

Representasi JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Kolom
type

enum (ThirdPartyUrlType)

Opsional. Jenis interaksi harus dilacak oleh URL pelacakan
url

string

Opsional. URL pelacakan yang digunakan untuk melacak interaksi.

Berikan URL dengan jalur atau string kueri opsional, yang diawali dengan https:. Misalnya, https://www.example.com/path

ThirdPartyUrlType

Jenis interaksi harus dilacak oleh URL pelacakan pihak ketiga.

Enum
THIRD_PARTY_URL_TYPE_UNSPECIFIED Jenis URL pihak ketiga tidak ditentukan atau tidak diketahui dalam versi ini.
THIRD_PARTY_URL_TYPE_IMPRESSION Digunakan untuk menghitung tayangan materi iklan setelah buffering audio atau video selesai.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Digunakan untuk melacak klik pengguna pada audio atau video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Digunakan untuk melacak frekuensi pengguna memulai audio atau video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Digunakan untuk melacak frekuensi audio atau video diputar hingga 25% dari durasinya.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Digunakan untuk melacak frekuensi audio atau video diputar hingga 50% dari durasinya.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Digunakan untuk melacak frekuensi audio atau video diputar hingga 75% dari durasinya.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Digunakan untuk melacak frekuensi pemutaran audio atau video hingga akhir.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Digunakan untuk melacak frekuensi pengguna membisukan audio atau video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Digunakan untuk melacak frekuensi pengguna menjeda audio atau video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Digunakan untuk melacak frekuensi pengguna memutar ulang audio atau video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Digunakan untuk melacak frekuensi pengguna meluaskan pemutar ke ukuran layar penuh.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Digunakan untuk melacak frekuensi pengguna menghentikan audio atau video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Digunakan untuk melacak frekuensi pengguna melakukan klik kustom, seperti mengklik hot spot video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Digunakan untuk melacak frekuensi audio atau video dilewati.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Digunakan untuk melacak frekuensi audio atau video diputar ke offset yang ditentukan oleh progressOffset.

Transkode

Menampilkan informasi tentang file audio atau video yang ditranskode.

Representasi JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Kolom
name

string

Opsional. Nama file yang ditranskode.
mimeType

string

Opsional. Jenis MIME file yang ditranskode.
transcoded

boolean

Opsional. Menunjukkan apakah transkode berhasil.
dimensions

object (Dimensions)

Opsional. Dimensi video yang di-transcoding.
bitRateKbps

string (int64 format)

Opsional. Kecepatan bit transcoding video yang di-transcoding, dalam kilobit per detik.
frameRate

number

Opsional. Kecepatan frame video yang ditranskode, dalam frame per detik.
audioBitRateKbps

string (int64 format)

Opsional. Kecepatan bit untuk streaming audio video yang ditranskode, atau kecepatan bit untuk audio yang ditranskode, dalam kilobit per detik.
audioSampleRateHz

string (int64 format)

Opsional. Frekuensi sampel untuk streaming audio video yang ditranskode, atau frekuensi sampel untuk audio yang ditranskode, dalam hertz.
fileSizeBytes

string (int64 format)

Opsional. Ukuran file yang ditranskode, dalam byte.

CmTrackingAd

Iklan pelacakan Campaign Manager 360.

Representasi JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Kolom
cmPlacementId

string (int64 format)

Opsional. ID penempatan Iklan pelacakan Campaign Manager 360.
cmCreativeId

string (int64 format)

Opsional. ID materi iklan Iklan pelacakan Campaign Manager 360.
cmAdId

string (int64 format)

Opsional. ID iklan pelacakan Campaign Manager 360.

ObaIcon

Ikon OBA untuk Materi Iklan

Representasi JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Kolom
resourceUrl

string

Opsional. URL resource ikon OBA.
resourceMimeType

string

Opsional. Jenis MIME resource ikon OBA.
position

enum (ObaIconPosition)

Opsional. Posisi ikon OBA pada materi iklan.
dimensions

object (Dimensions)

Opsional. Dimensi ikon OBA.
program

string

Opsional. Program ikon OBA. Misalnya: “AdChoices”.
landingPageUrl

string

Wajib. URL halaman landing ikon OBA.

Hanya URL dari domain berikut yang diizinkan:

  • https://info.evidon.com
  • https://l.betrad.com
clickTrackingUrl

string

Wajib. URL pelacakan klik ikon OBA.

Hanya URL dari domain berikut yang diizinkan:

  • https://info.evidon.com
  • https://l.betrad.com
viewTrackingUrl

string

Wajib. URL pelacakan tampilan ikon OBA.

Hanya URL dari domain berikut yang diizinkan:

  • https://info.evidon.com
  • https://l.betrad.com

ObaIconPosition

Posisi ikon OBA pada materi iklan.

Enum
OBA_ICON_POSITION_UNSPECIFIED Posisi ikon OBA tidak ditentukan.
OBA_ICON_POSITION_UPPER_RIGHT Di sisi kanan atas materi iklan.
OBA_ICON_POSITION_UPPER_LEFT Di sisi kiri atas materi iklan.
OBA_ICON_POSITION_LOWER_RIGHT Di sisi kanan bawah materi iklan.
OBA_ICON_POSITION_LOWER_LEFT Di sisi kiri bawah materi iklan.

ExpandingDirection

Arah perluasan materi iklan yang dapat diperluas pihak ketiga.

Enum
EXPANDING_DIRECTION_UNSPECIFIED Arah perluasan tidak ditentukan.
EXPANDING_DIRECTION_NONE Tidak meluas ke arah mana pun.
EXPANDING_DIRECTION_UP Meluas ke atas.
EXPANDING_DIRECTION_DOWN Meluas ke bawah.
EXPANDING_DIRECTION_LEFT Meluas ke kiri.
EXPANDING_DIRECTION_RIGHT Meluas ke kanan.
EXPANDING_DIRECTION_UP_AND_LEFT Meluas ke atas dan ke sisi kiri.
EXPANDING_DIRECTION_UP_AND_RIGHT Meluas ke atas dan ke sisi kanan.
EXPANDING_DIRECTION_DOWN_AND_LEFT Meluas ke bawah dan ke sisi kiri.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Meluas ke bawah dan ke sisi kanan.
EXPANDING_DIRECTION_UP_OR_DOWN Meluas ke atas atau ke bawah.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Meluas ke sisi kiri atau kanan.
EXPANDING_DIRECTION_ANY_DIAGONAL Dapat meluas ke arah diagonal mana pun.

Metode

create

 Membuat materi iklan baru.

delete

 Menghapus materi iklan.

get

 Mendapatkan materi iklan.

list

 Mencantumkan materi iklan di pengiklan.

patch

 Memperbarui materi iklan yang ada.