REST Resource: advertisers.creatives

{
  "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
}

string

Hanya output. Nama resource materi iklan.

string (int64 format)

Hanya output. ID unik pengiklan yang memiliki materi iklan.

string (int64 format)

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

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.

string

Wajib. Nama tampilan materi iklan.

Harus dienkode UTF-8 dengan ukuran maksimum 240 byte.

enum (EntityStatus)

Wajib. Mengontrol apakah materi iklan dapat ditayangkan atau tidak.

Nilai yang diterima adalah:

• ENTITY_STATUS_ACTIVE
• ENTITY_STATUS_ARCHIVED
• ENTITY_STATUS_PAUSED

string (Timestamp format)

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

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

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

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

enum (CreativeType)

Wajib. Tidak dapat diubah. Jenis materi iklan.

enum (HostingSource)

Wajib. Menunjukkan tempat materi iklan dihosting.

boolean

Hanya output. Menunjukkan apakah materi iklan bersifat dinamis.

object (Dimensions)

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

• CREATIVE_TYPE_VIDEO
• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_NATIVE_VIDEO

object (Dimensions)

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 bersifat wajib dan harus lebih besar dari atau sama dengan 0.

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 paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

enum (CreativeAttribute)

Hanya output. Daftar atribut materi iklan yang dihasilkan oleh sistem.

object (ReviewStatusInfo)

Hanya output. Status proses peninjauan materi iklan saat ini.

object (AssetAssociation)

Wajib. Aset yang terkait dengan materi iklan ini.

object (ExitEvent)

Wajib. Peristiwa keluar untuk materi iklan ini. Area keluar (disebut juga tag klik) adalah setiap area dalam materi iklan Anda yang dapat diklik atau diketuk oleh seseorang untuk membuka halaman landing pengiklan. Setiap materi iklan harus menyertakan minimal satu exit. Anda dapat menambahkan exit 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 dalam format multimedia.

object (TimerEvent)

Peristiwa kustom timer untuk materi iklan multimedia. Penghitung waktu melacak waktu saat pengguna melihat dan berinteraksi dengan bagian tertentu pada 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.

object (CounterEvent)

Peristiwa penghitung untuk materi iklan multimedia. Penghitung melacak frekuensi pengguna berinteraksi dengan bagian materi iklan multimedia mana pun dengan cara tertentu (mouse-over, mouse-out, 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.

string

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

string

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

string

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

boolean

Menunjukkan apakah pemantauan kampanye Integral Ad Science (IAS) diaktifkan atau tidak. Guna mengaktifkannya untuk materi iklan, pastikan Advertiser.creative_config.ias_client_id telah ditetapkan ke client ID IAS Anda.

string (int64 format)

ID materi iklan pengiring untuk materi iklan video.

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

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

Kolom ini hanya didukung untuk creativeType berikut:

• CREATIVE_TYPE_AUDIO
• CREATIVE_TYPE_VIDEO

boolean

Apakah pengguna dapat memilih untuk melewati materi iklan video.

Kolom ini hanya didukung untuk creativeType berikut:

• CREATIVE_TYPE_VIDEO

object (AudioVideoOffset)

Durasi untuk memutar video sebelum tombol lewati muncul.

Kolom ini wajib diisi jika skippable benar.

Kolom ini hanya didukung untuk creativeType berikut:

• CREATIVE_TYPE_VIDEO

object (AudioVideoOffset)

Durasi untuk memutar video sebelum menghitung penayangan.

Kolom ini wajib diisi jika skippable benar.

Kolom ini hanya didukung untuk creativeType berikut:

• CREATIVE_TYPE_VIDEO

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. Nama ini dapat diubah setelah materi iklan dibuat.

Kolom ini hanya didukung untuk creativeType berikut:

• CREATIVE_TYPE_VIDEO

object (ThirdPartyUrl)

Melacak URL 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

object (Transcode)

Hanya output. Transcoding Audio/Video.

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

Transcoding ini memberi sistem penayang lebih banyak opsi yang dapat dipilih untuk setiap tayangan video Anda dan memastikan 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

string

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

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

Hanya URL standar, tanpa tag IMG atau SKRIP.

Kolom ini hanya dapat ditulis di creativeType berikut:

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE
• CREATIVE_TYPE_NATIVE_VIDEO

string

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

object (CmTrackingAd)

Iklan pelacakan Campaign Manager 360 yang terkait dengan materi iklan.

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

• CREATIVE_TYPE_NATIVE
• CREATIVE_TYPE_NATIVE_SITE_SQUARE

Output hanya untuk kasus lain.

object (ObaIcon)

Menentukan ikon OBA untuk materi iklan video.

Kolom ini hanya didukung di creativeType berikut:

• CREATIVE_TYPE_VIDEO

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

boolean

Opsional. Menunjukkan bahwa materi iklan memerlukan MRAID (sistem Definisi Antarmuka Iklan Multimedia Seluler).

Tetapkan setelan 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

boolean

Opsional. Menunjukkan bahwa materi iklan mengandalkan HTML5 untuk 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

boolean

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

Hanya valid jika 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

enum (ExpandingDirection)

Opsional. Menentukan arah perluasan materi iklan.

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

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

boolean

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

Opsional dan hanya valid untuk materi iklan pihak ketiga yang dapat diperluas. 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

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

boolean

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

Hanya output 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

boolean

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

Hanya output 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

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.

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

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

{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}

enum (ApprovalStatus)

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

enum (ReviewStatus)

Status peninjauan materi iklan dan halaman landing untuk materi iklan.

enum (ReviewStatus)

Status pemeriksaan konten dan kebijakan untuk materi iklan.

object (ExchangeReviewStatus)

Status peninjauan bursa untuk materi iklan.

object (PublisherReviewStatus)

Status peninjauan penayang untuk materi iklan.

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

enum (Exchange)

Bursa yang meninjau materi iklan.

enum (ReviewStatus)

Status peninjauan bursa.

{
  "publisherName": string,
  "status": enum (ReviewStatus)
}

string

Penayang yang meninjau materi iklan.

enum (ReviewStatus)

Status peninjauan penayang.

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

object (Asset)

Aset terkait.

enum (AssetRole)

Peran aset ini untuk materi iklan.

{
  "mediaId": string,
  "content": string
}

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.

string

Konten aset. Untuk aset yang diupload, konten berada di jalur penayangan.

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

enum (ExitEventType)

Wajib. Jenis peristiwa keluar.

string

Wajib. URL klik-tayang dari peristiwa keluar. Wajib diisi saat type:

• EXIT_EVENT_TYPE_DEFAULT
• EXIT_EVENT_TYPE_BACKUP

string

Nama tag klik dari peristiwa keluar.

Nama harus unik dalam satu materi iklan.

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

string

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

{
  "name": string,
  "reportingName": string
}

string

Wajib. Nama peristiwa timer.

string

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

{
  "name": string,
  "reportingName": string
}

string

Wajib. Nama peristiwa penghitung.

string

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

{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}

string (int64 format)

Offset dalam persentase durasi audio atau video.

string (int64 format)

Offset dalam hitungan detik dari awal audio atau video.

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

string

ID materi iklan unik.

enum (UniversalAdRegistry)

Registry memberikan ID materi iklan yang unik.

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

enum (ThirdPartyUrlType)

Jenis interaksi harus dilacak oleh URL pelacakan

string

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

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

string

Nama file yang di-transcoding.

string

Jenis MIME dari file yang di-transcoding.

boolean

Menunjukkan apakah transcoding berhasil.

object (Dimensions)

Dimensi video yang di-transcoding.

string (int64 format)

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

number

Kecepatan frame video yang di-transcoding, dalam frame per detik.

string (int64 format)

Kecepatan bit untuk streaming audio pada video yang di-transcoding, atau kecepatan bit untuk audio yang di-transcoding, dalam kilobit per detik.

string (int64 format)

Frekuensi sampel untuk streaming audio dari video yang di-transcoding, atau frekuensi sampel untuk audio yang di-transcoding, dalam hertz.

string (int64 format)

Ukuran file yang di-transcoding, dalam byte.

{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}

string (int64 format)

ID penempatan Iklan pelacakan Campaign Manager 360.

string (int64 format)

ID materi iklan Iklan pelacakan Campaign Manager 360.

string (int64 format)

ID iklan Iklan pelacakan Campaign Manager 360.

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

string

URL resource ikon OBA.

string

Jenis MIME resource ikon OBA.

enum (ObaIconPosition)

Posisi ikon OBA di materi iklan.

object (Dimensions)

Dimensi ikon OBA.

string

Program ikon OBA. Misalnya: “AdChoices”.

string

Wajib. URL halaman landing ikon OBA.

Hanya URL domain berikut yang diizinkan:

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

string

Wajib. URL pelacakan klik ikon OBA.

Hanya URL domain berikut yang diizinkan:

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

string

Wajib. URL pelacakan tampilan ikon OBA.

Hanya URL domain berikut yang diizinkan:

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