Catatan Rilis

Halaman ini menyediakan catatan rilis untuk Display & Video 360 API.

Versi API terbaru: v3

23 April 2024

Fitur Baru

Menambahkan dukungan untuk jenis KPI, bursa, dan platform aplikasi baru.

v3

  • Kolom berikut telah ditambahkan:

    ResourceKolom
    Kpi

    kpiAlgorithmId

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV

    Bursa

    EXCHANGE_DRAX

    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10

    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

28 Februari 2024

Fitur Baru

Menambahkan kemampuan untuk menghapus anggota secara eksplisit dari audiens Customer Match.

Menambahkan dukungan untuk menargetkan bursa baru.

v3

v2

29 Januari 2024

Fitur Baru

Menambahkan kemampuan untuk mengambil aktivitas Floodlight melalui layanan floodlightGroups.floodlightActivities baru.

Menambahkan kolom baru yang memberitahukan apakah item baris YouTube & Partners menyertakan inventaris Google TV dalam penargetannya.

Menambahkan kolom baru untuk meneruskan waktu login terakhir untuk pengguna Display & Video 360.

v3

v2

14 November 2023

Fitur Baru

Menambahkan dukungan untuk meneruskan izin pengguna akhir saat mengupload anggota audiens Customer Match dalam semua versi aktif.

v3

v2

31 Oktober 2023

Fitur Baru

Memindahkan v3 dari beta publik ke ketersediaan umum.

Mengganti nama nilai enum AdGroupFormat di v3 untuk mencerminkan format yang relevan dengan lebih akurat.

Menambahkan dukungan untuk File Data Terstruktur v7 dengan penambahan nilai enum SDF_VERSION_7 di v2 dan v3.

v3

  • Nilai enum berikut telah dihapus:

    EnumNilai
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE

    SdfVersion

    SDF_VERSION_7

v2

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    SdfVersion

    SDF_VERSION_7

2 Oktober 2023

Fitur Baru

Dirilis v3 dalam versi beta publik, yang mencakup perubahan berikut:

Ikuti langkah-langkah dalam panduan migrasi untuk bermigrasi dari v2 ke v3.

Menambahkan dukungan untuk 3 nilai LineItemType baru, satu YoutubeAndPartnersBiddingStrategyType baru, dan satu PartnerCostType baru di v2 dan v3.

v3

v2

25 Agustus 2023

Fitur Baru

Menambahkan dukungan untuk dua bursa dan dua jenis strategi bidding YouTube & Partner baru.

Menambahkan kolom effectiveContentCategory baru ke item baris YouTube & Partners untuk menampilkan YoutubeAndPartnersContentCategory yang digunakan oleh item baris saat mempertimbangkan nilai yang ditetapkan di tingkat pengiklan dan item baris.

v2

5 Juni 2023

Fitur Baru

Menambahkan nilai SdfVersion baru untuk File Data Terstruktur (SDF) v6 di v1 dan v2.

v2

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    SdfVersion

    SDF_VERSION_6

v1

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    SdfVersion

    SDF_VERSION_6

9 Maret 2023

Fitur Baru

Menambahkan nilai LineItemWarningMessage baru yang akan ditetapkan ke kolom warningMessages item baris jika kolom excludeFirstPartyAudience yang tidak digunakan lagi ditetapkan ke true. Kolom excludeFirstPartyAudience akan dihentikan dan ditetapkan ke false setelah 25 Maret 2023.

v2

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

8 Februari 2023

Fitur Baru

Menambahkan kemampuan untuk mengambil resource YouTubeAdGroup dan YouTubeAdGroupAd, serta penargetan resource Grup Iklan YouTube. Selain itu, kami juga telah menambahkan jenis penargetan baru yang dapat diambil dan digunakan di tingkat Grup Iklan YouTube. Baca halaman panduan baru kami tentang cara mengambil resource YouTube & Partner untuk mengetahui informasi lebih lanjut.

Penambahan dukungan untuk empat bursa tambahan di v1 dan v2.

v2

v1

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    Bursa

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 Desember 2022

Fitur Baru

Memindahkan v2 dari beta publik ke ketersediaan umum.

Menambahkan kolom assignedTargetingOptionIdAlias baru ke resource AssignedTargetingOption, yang dapat digunakan sebagai pengganti assignedTargetingOptionId saat mengambil dan menghapus penargetan. Kolom ini hanya ditetapkan untuk opsi penargetan yang ditetapkan dari jenis penargetan yang ditetapkan melalui enum. Nilai alias adalah nilai enum yang relevan sebagai string.

Menambahkan kolom billingConfig baru ke resource Advertiser.

Menambahkan dukungan untuk mengambil item baris over-the-top YouTube & Partner, yang diidentifikasi oleh tiga nilai LineItemType baru.

Ukuran halaman maksimum ditingkatkan menjadi 200 untuk berbagai metode list di v1 dan v2. Ukuran halaman default tidak berubah.

v2

v1

Masalah umum

Update ini memperbaiki masalah umum berikut di v2:

27 Oktober 2022

Menambahkan kemampuan untuk menduplikasi item baris yang ada dalam induk InsertionOrder.

Memperkenalkan dukungan tulis yang menargetkan pesanan pemasangan iklan sebagian untuk sebagian jenis penargetan dengan penambahan metode create dan delete ke layanan advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.

Fitur Baru

v2

v1

Tidak ada fitur baru yang ditambahkan ke v1.

20 September 2022

Dirilis v2 dalam beta publik, yang mencakup perubahan berikut:

Ikuti langkah-langkah dalam panduan migrasi untuk bermigrasi dari v1 ke v2.

Menambahkan dukungan untuk tiga bursa baru di v1.

Fitur Baru

v2

Berikut adalah daftar perubahan antara v1 dan v2:

v1

  • Nilai enum berikut telah ditambahkan di v1:

    EnumNilai
    Bursa

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

26 Mei 2022

Menambahkan kemampuan untuk membuat resource InventorySource dan mengelola resource GuaranteedOrder melalui metode penulisan layanan inventorySources baru dan layanan guaranteedOrders baru.

Memperkenalkan kolom modelReadiness di resource CustomBiddingAlgorithm. Kolom ini mencantumkan kesiapan model algoritma untuk setiap pengiklan yang dapat mengaksesnya.

Mengaktifkan fungsi parameter kueri filter baru untuk metode advertisers.creatives.list yang memungkinkan pengguna hanya mengambil materi iklan dengan updateTime sebelum atau setelah stempel waktu tertentu.

Menambahkan dukungan untuk versi SDF terbaru, v5.5, melalui penambahan nilai enum SdfVersion.

Fitur Baru

31 Maret 2022

Menambahkan dukungan untuk mengambil dan menetapkan penargetan pada durasi konten, jenis streaming, dan genre.

Menambahkan kolom billableOutcome ke objek InsertionOrder.

Memperkenalkan kolom raiseBidForDeals ke objek MaximizeSpendBidStrategy, yang memungkinkan pengguna menetapkan apakah strategi bidding menerapkan harga minimum pengiklan untuk transaksi yang ditargetkan.

Fitur Baru

2 Februari 2022

Menambahkan dukungan untuk membuat, memperbarui, dan mengedit anggota resource FirstAndThirdPartyAudience Customer Match tertentu. Halaman Upload Audiens Customer Match di panduan Gunakan Audiens baru menjelaskan cara menggunakan fitur baru ini.

Memperkenalkan kolom reservationType baru di resource InsertionOrder dan LineItem yang mengidentifikasi apakah resource berstatus Dijamin oleh Tag, Dijamin Terprogram, atau tidak dijamin.

Menambahkan kemampuan untuk mengambil dan menetapkan apakah item baris otomatis menargetkan pertukaran baru melalui kolom excludeNewExchanges baru.

Selain fitur baru, batas kuota default telah ditingkatkan dua kali lipat.

Fitur Baru

8 Desember 2021

Menambahkan dukungan untuk penargetan jenis konten audio di bagian jenis penargetan TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Fitur Baru

8 November 2021

Penambahan dukungan penuh untuk mengelola algoritma bidding kustom dan skripnya. Hal ini mencakup:

Halaman Terapkan Bidding Kustom baru telah ditambahkan ke panduan Mengelola Item Baris kami yang menjelaskan proses pembuatan algoritma bidding kustom, mengupload skrip, dan menetapkan algoritma bidding kustom sebagai strategi bidding item baris.

Menambahkan dukungan untuk versi SDF terbaru, v5.4, melalui penambahan nilai enum SdfVersion.

Fitur Baru

14 September 2021

Menambahkan dukungan untuk penargetan jarak di bagian jenis penargetan TARGETING_TYPE_BUSINESS_CHAIN dan TARGETING_TYPE_POI.

Menambahkan kemampuan untuk menelusuri opsi penargetan TARGETING_TYPE_BUSINESS_CHAIN dan TARGETING_TYPE_POI yang tersedia menggunakan targetingTypes.targetingOptions.search, karena opsi tersebut tidak dapat diambil melalui metode targetingTypes.targetingOptions.get atau targetingTypes.targetingOptions.list.

Memperkenalkan kolom sharedAdvertiserIds dan customBiddingAlgorithmState baru ke resource Algoritma Bidding Kustom dan menambahkan dukungan untuk jenis algoritma bidding kustom GOAL_BUILDER_BASED.

Menambahkan dua nilai baru ke enum Exchange.

Fitur Baru

4 Agustus 2021

Menambahkan dukungan untuk penargetan inventaris yang mengaktifkan Pengukuran Terbuka di bagian jenis penargetan TARGETING_TYPE_OMID.

Meningkatkan jumlah maksimum opsi penargetan yang ditetapkan yang dapat ditampilkan di satu halaman dari berbagai metode daftar opsi penargetan yang ditetapkan menggunakan parameter metode pageSize, yaitu pengiklan, kampanye, pesanan pemasangan iklan, dan item baris.

Fitur Baru

26 Mei 2021

Meluncurkan layanan advertisers.invoices, yang memungkinkan pengguna:

  • mengambil invoice yang dikeluarkan untuk pengiklan selama bulan tertentu.
  • mencari kode mata uang yang digunakan oleh pengiklan selama bulan tertentu.

Menambahkan kolom campaignBudgets ke resource kampanye. Segmen anggaran pesanan pemasangan iklan dapat ditautkan ke anggaran kampanye, sehingga membatasi jumlah anggaran segmen terkait hingga total jumlah anggaran kampanye.

Menambahkan dukungan untuk penargetan posisi konten native di bagian jenis penargetan baru TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Memperkenalkan kolom prismaEnabled baru ke resource pengiklan, yang memungkinkan pengguna mengaktifkan integrasi dengan alat Prisma Mediaocean.

Mengaktifkan dukungan untuk nilai enum ENTITY_STATUS_PAUSED ke kolom entityStatus Pengiklan.

Fitur Baru

29 April 2021

Menambahkan kolom baru ke resource Saluran dan Daftar Kata Kunci Negatif yang menampilkan jumlah item baris menggunakan resource untuk penargetan. Mengaktifkan properti filter baru untuk metode daftar item baris yang memungkinkan pengguna hanya mengambil item baris yang menggunakan saluran atau daftar kata kunci negatif tertentu dalam penargetannya.

Fitur Baru

30 Maret 2021

Menambahkan metode baru ke layanan item baris yang menghasilkan item baris dengan konfigurasi default. Nilai default ini didasarkan pada jenis item baris yang ditentukan, serta setelan dan penargetan urutan pemasangan iklan induk.

Mengaktifkan pengambilan penargetan kampanye melalui layanan penargetan kampanye baru dan metode daftar massal tambahan.

Memperluas penargetan aplikasi untuk memungkinkan penargetan aplikasi di lebih banyak platform.

Membuat beberapa perubahan pada layanan advertisers.channels.sites, partners.channels.sites, dan advertisers.negativeKeywordLists.negativeKeywords agar pengelolaan konten saluran dan daftar kata kunci negatif lebih mudah. Perubahan ini mencakup:

  • Penambahan metode replace, yang memungkinkan pengguna menimpa sepenuhnya konten saluran atau daftar kata kunci negatif yang ada.
  • Penghapusan persyaratan bahwa tidak ada item yang ada yang disertakan dalam kolom createdSites atau createdNegativeKeywords dari permintaan edit massal.
  • Peningkatan jumlah maksimum item yang dapat ditampilkan di satu halaman respons situs daftar atau respons daftar kata kunci negatif.

Fitur Baru

Penghentian Penggunaan

24 Februari 2021

Memperkenalkan layanan penargetan pesanan pemasangan iklan baru dan metode daftar massal tambahan yang memungkinkan pengambilan penargetan yang ditetapkan ke pesanan pemasangan iklan. Memperluas resource materi iklan, dengan menambahkan kolom materi iklan khusus output untuk digunakan oleh materi iklan audio pihak ketiga. Menambahkan jenis sasaran performa baru untuk digunakan melalui resource pesanan pemasangan iklan dan kampanye.

Fitur Baru

27 Januari 2021

Mengaktifkan pengambilan dan pengelolaan pesanan pemasangan iklan TV dan item baris over-the-top melalui pengenalan kolom penyisipanOrderType baru dan nilai enum LineItemType baru. Menambahkan dukungan untuk item baris aplikasi seluler melalui kolom item baris mobileApp. Perluasan dukungan bursa, audiens google, dan SDF melalui nilai enum tambahan. Memperkenalkan kemampuan untuk memfilter dan mengurutkan nilai advertisers.list menurut waktu terakhir diperbarui.

Fitur Baru

4 Desember 2020

Penambahan kemampuan untuk menelusuri opsi penargetan Wilayah Geo dan memfilter beberapa hasil metode daftar resource berdasarkan waktu terakhirnya diperbarui. Memperkenalkan LineItemWarningMessage baru untuk memberi tahu pengguna saat item baris menggunakan penargetan geografis yang tidak digunakan lagi.

Fitur Baru

5 November 2020

Menambahkan kemampuan untuk membuat, menetapkan, dan mengaktifkan pemicu manual yang memulai pengeluaran item baris terkait. Memperkenalkan opsi perluasan penargetan yang, jika ditetapkan, dapat memperluas penargetan item baris untuk menyertakan pengguna yang serupa dengan pengguna di target audiens. Menambahkan kolom ID segmen kustom ke objek DoubleVerify dan Integral Ad Science yang digunakan dalam penargetan verifikasi pihak ketiga.

Fitur Baru

12 Oktober 2020

Memperkenalkan pesan peringatan yang dapat diambil kembali ke resource item baris dan jenis sasaran performa rasio klik-tayang (CTR). Menambahkan warningMessages sebagai kolom yang dapat difilter saat mencantumkan item baris.

Selain fitur baru, batas kuota baru sekarang telah berlaku dan tersedia dokumentasi baru tentang penggunaan permintaan batch.

Fitur Baru

28 Agustus 2020

Menambahkan kolom baru ke respons metode audit pengiklan dan kolom baru yang dapat difilter ke berbagai metode daftar.

Fitur Baru

4 Agustus 2020

Meluncurkan layanan pengelolaan pengguna, partner, dan penargetan partner baru. Memperkenalkan alat untuk membantu pengguna secara proaktif menghindari tercapainya batas entitas akun. Menambahkan dukungan untuk item baris audio dan penggunaan algoritma bidding kustom di strategi bidding item baris dan pesanan pemasangan iklan.

Fitur Baru

24 Juni 2020

Meluncurkan update kecil yang menambahkan metode create untuk channel partner dan pengiklan, kolom FirstAndThirdPartyAudience baru, dan nilai enum bursa tambahan.

Fitur Baru

2 Juni 2020

Memperkenalkan kemampuan untuk membuat, menerapkan patch, dan mengisi subkumpulan entitas yang dapat ditargetkan serta menambahkan kemampuan untuk mengubah penargetan tingkat pengiklan untuk tiga jenis penargetan: channel, pengecualian label konten digital, dan pengecualian kategori sensitif.

Fitur Baru

27 April 2020

Meluncurkan set fitur berukuran besar, yang memperluas cakupan API di luar SDF. Menambahkan pengelolaan resource inti yang memungkinkan Anda membuat, mengambil, memperbarui, dan menghapus entity seperti pengiklan, kampanye, perjanjian pemasangan iklan, item baris, dan materi iklan. Kemampuan baru juga memungkinkan pengeditan penargetan di tingkat item baris.

Fitur Baru

Layanan berikut telah ditambahkan:

LayananMetode
pengiklan

buat

hapus

dapatkan

daftar

patch

advertisers.assets

upload

advertisers.campaigns

buat

hapus

dapatkan

daftar

patch

advertisers.channels

dapatkan

daftar

advertisers.creatives

buat

hapus

dapatkan

daftar

patch

advertisers.insertionOrders

buat

hapus

dapatkan

daftar

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

buat

hapus

dapatkan

daftar

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

buat

hapus

dapatkan

daftar

advertisers.locationLists

dapatkan

daftar

advertisers.negativeKeywordLists

dapatkan

daftar

combinedAudiences

dapatkan

daftar

customLists

dapatkan

daftar

firstAndThirdPartyAudiences

dapatkan

daftar

floodlightGroups

dapatkan

patch

googleAudiences

dapatkan

daftar

inventorySourceGroups

dapatkan

daftar

inventorySources

dapatkan

daftar

partners.channels

dapatkan

daftar

partners.channels

dapatkan

daftar

9 Maret 2020

Meluncurkan Display & Video 360 API v1. Ini adalah versi awal API.

Masalah umum

Tidak ada.