Catatan Rilis

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

Versi API terbaru: v3

22 Oktober 2024

Fitur Baru

Menambahkan dukungan untuk sasaran performa biaya per penayangan.

Menambahkan kemampuan untuk menetapkan dan mengambil penargetan perangkat yang terhubung.

Menambahkan setelan keamanan merek Adloox baru di bagian penargetan verifier pihak ketiga.

Menambahkan dukungan untuk mendownload File Data Terstruktur v8, yang saat ini dalam versi beta tertutup.

v3

Nilai yang tidak digunakan lagi

Menghapus dukungan untuk SDF v5.5 karena penghentiannya pada 3 Oktober 2024.

v3

  • Nilai enum berikut tidak digunakan lagi:

    EnumNilai
    SdfVersion

    SDF_VERSION_5_5

15 Agustus 2024

Fitur Baru

Menambahkan dukungan untuk jenis Exchange Netflix.

v3

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    Exchange

    EXCHANGE_NETFLIX

v2

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    Exchange

    EXCHANGE_NETFLIX

15 Juli 2024

Fitur Baru

Menambahkan dukungan untuk mendownload File Data Terstruktur Item Baris dan Grup Iklan dalam format QA di v3.

v3

17 Juni 2024

Fitur Baru

Menambahkan dukungan untuk mengelola penargetan kata kunci yang ditetapkan di tingkat pengiklan.

Menambahkan kolom optimizationObjective baru ke resource perjanjian pemasangan iklan. optimizationObjective hanya tersedia untuk pelanggan dalam daftar yang disetujui.

v3

v2

30 Mei 2024

Fitur Baru

Menambahkan dukungan untuk File Data Terstruktur (SDF) versi 7.1.

v3

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    SdfVersion

    SDF_VERSION_7_1

v2

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    SdfVersion

    SDF_VERSION_7_1

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

    Exchange

    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 menginformasikan apakah item baris YouTube & Partners menyertakan inventaris Google TV dalam penargetan.

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

v3

v2

14 November 2023

Fitur Baru

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

v3

v2

31 Oktober 2023

Fitur Baru

Memindahkan v3 dari versi beta publik ke ketersediaan umum.

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

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

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

Ikuti langkah-langkah dalam panduan migrasi kami 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 & Partner 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 tersebut memiliki kolom excludeFirstPartyAudience yang tidak digunakan lagi dan 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 tentang cara mengambil referensi YouTube & Partner untuk mengetahui informasi selengkapnya.

Menambahkan dukungan untuk empat pertukaran tambahan di v1 dan v2.

v2

v1

  • Nilai enum berikut telah ditambahkan:

    EnumNilai
    Exchange

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

6 Desember 2022

Fitur Baru

Memindahkan v2 dari versi 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.

Meningkatkan ukuran halaman maksimum 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 InsertionOrder induk.

Memperkenalkan dukungan penulisan penargetan pesanan pemasangan 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

Merilis v2 dalam versi beta publik, yang mencakup perubahan berikut:

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

Menambahkan dukungan untuk tiga pertukaran baru di v1.

Fitur Baru

v2

Berikut adalah daftar perubahan antara v1 dan v2:

v1

  • Nilai enum berikut telah ditambahkan di v1:

    EnumNilai
    Exchange

    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 Pencocokan Pelanggan tertentu. Halaman Upload Audiens Customer Match dalam panduan Menggunakan Audiens baru kami menjelaskan cara menggunakan fitur baru ini.

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

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

Selain fitur baru, batas kuota default telah digandakan.

Fitur Baru

8 Desember 2021

Menambahkan dukungan untuk penargetan jenis konten audio pada jenis penargetan TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Fitur Baru

8 November 2021

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

Halaman Menerapkan 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 kedekatan berdasarkan 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 tidak dapat diambil melalui metode targetingTypes.targetingOptions.get atau targetingTypes.targetingOptions.list.

Memperkenalkan kolom sharedAdvertiserIds dan customBiddingAlgorithmState baru ke resource Algoritme Bidding Kustom dan menambahkan dukungan untuk jenis algoritme 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 dalam satu halaman dari berbagai metode daftar opsi penargetan yang ditetapkan pengiklan, kampanye, pesanan pemasangan, dan item baris menggunakan parameter metode pageSize.

Fitur Baru

26 Mei 2021

Meluncurkan layanan advertisers.invoices, yang memungkinkan pengguna:

  • mengambil invoice yang dikeluarkan kepada 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, yang membatasi jumlah anggaran segmen terkait dengan jumlah total anggaran kampanye.

Menambahkan dukungan untuk penargetan posisi konten native berdasarkan 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 yang menggunakan resource untuk penargetan. Mengaktifkan properti filter baru untuk metode daftar item baris yang memungkinkan pengguna hanya mengambil item baris yang menggunakan saluran tertentu atau daftar kata kunci negatif dalam penargetan mereka.

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 diberikan, serta setelan dan penargetan yang ditetapkan untuk pesanan pemasangan 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.

Melakukan beberapa perubahan pada layanan advertisers.channels.sites, partners.channels.sites, dan advertisers.negativeKeywordLists.negativeKeywords untuk mempermudah pengelolaan konten channel dan daftar kata kunci negatif. Perubahan ini mencakup:

  • Penambahan metode replace, yang memungkinkan pengguna menimpa sepenuhnya konten yang ada di channel atau daftar kata kunci negatif.
  • Penghapusan persyaratan bahwa tidak ada item yang ada yang disertakan dalam kolom createdSites atau createdNegativeKeywords dari permintaan pengeditan massal.
  • Peningkatan jumlah maksimum item yang dapat ditampilkan di satu halaman respons daftar situs atau 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 oleh resource pesanan pemasangan dan kampanye.

Fitur Baru

27 Januari 2021

Mengaktifkan pengambilan dan pengelolaan perjanjian pemasangan iklan TV dan item baris over-the-top melalui pengenalan kolom InsertionOrderType baru dan nilai enum LineItemType baru. Menambahkan dukungan untuk item baris aplikasi seluler melalui kolom item baris mobileApp. Dukungan bursa, audiens google, dan SDF yang diperluas melalui nilai enum tambahan. Memperkenalkan kemampuan untuk memfilter dan mengurutkan nilai advertisers.list berdasarkan waktu pembaruan terakhir.

Fitur Baru

4 Desember 2020

Menambahkan kemampuan untuk menelusuri opsi penargetan Wilayah Geografis dan memfilter beberapa hasil metode daftar resource menurut waktu pembaruan terakhirnya. Memperkenalkan LineItemWarningMessage baru untuk memberi tahu pengguna kapan 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 pembelanjaan item baris terkait. Memperkenalkan opsi perluasan penargetan yang, jika ditetapkan, dapat memperluas penargetan item baris untuk menyertakan pengguna yang mirip dengan pengguna dalam audiens yang ditargetkan. 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 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 kini berlaku dan dokumentasi baru tentang menggunakan permintaan batch tersedia.

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 batas entitas akun. Menambahkan dukungan untuk item baris audio dan penggunaan algoritma bidding kustom dalam strategi bidding item baris dan perjanjian pemasangan iklan.

Fitur Baru

24 Juni 2020

Meluncurkan update kecil yang menambahkan metode pembuatan untuk saluran partner dan pengiklan, kolom FirstAndThirdPartyAudience baru, dan nilai enum exchange tambahan.

Fitur Baru

02 Juni 2020

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

Fitur Baru

27 April 2020

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

Fitur Baru

Layanan berikut telah ditambahkan:

LayananMetode
pengiklan

create

delete

get

list

patch

advertisers.assets

upload

advertisers.campaigns

create

delete

get

list

patch

advertisers.channels

get

list

advertisers.creatives

create

delete

get

list

patch

advertisers.insertionOrders

create

delete

get

list

patch

advertisers.lineItems

bulkEditLineItemAssignedTargetingOptions

bulkListLineItemAssignedTargetingOptions

create

delete

get

list

patch

advertisers.lineItems.targetingTypes.assignedTargetingOptions

create

delete

get

list

advertisers.locationLists

get

list

advertisers.negativeKeywordLists

get

list

combinedAudiences

get

list

customLists

get

list

firstAndThirdPartyAudiences

get

list

floodlightGroups

get

patch

googleAudiences

get

list

inventorySourceGroups

get

list

inventorySources

get

list

partners.channels

get

list

partners.channels

get

list

9 Maret 2020

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

Masalah umum

Tidak ada.