Bermigrasi dari v2 ke v3

Terakhir diperbarui: 31-10-2023

Memigrasikan aplikasi Anda

Migrasi dari v2 ke v3 memerlukan update URL endpoint untuk memanggil v3 dan memperbarui aplikasi untuk memperhitungkan perubahan yang dapat menyebabkan gangguan.

Mengupdate panggilan API dari v2 ke v3

Untuk menggunakan v3, bukan v2, Anda harus memperbarui permintaan agar dapat menggunakan v3 baru endpoint.

Misalnya, untuk memanggil metode advertisers.get dengan v2, Anda akan gunakan URL berikut:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

Untuk v3, perbarui URL menjadi berikut:

GET https://displayvideo.googleapis.com/v3/advertisers/advertiserId

Jika Anda menggunakan library klien untuk membuat permintaan ke API, gunakan pustaka klien versi terbaru dan perbarui konfigurasi Anda untuk menggunakan v3.

Membuat perubahan yang diperlukan

Kami memperkenalkan sejumlah perubahan yang dapat menyebabkan gangguan di v3. Tinjau hal berikut dan membuat perubahan yang diperlukan relevan dengan penggunaan Anda atas Layar & Video 360 API.

Memperbarui panggilan yang mengambil referensi YouTube dan penargetan terkaitnya

• Resource YoutubeAdGroup dan YoutubeAdGroupAd telah diganti dengan Referensi AdGroup dan AdGroupAd. Sumber daya baru ini menyediakan informasi yang hampir sama dengan resource v2, tetapi dapat menggunakan kolom yang diupdate atau jenis enum. Dalam integrasi Anda, ganti penggunaan YoutubeAdGroup atau YoutubeAdGroupAd resource dengan AdGroup dan Resource AdGroupAd dan perbarui panggilan ke layanan v2 berikut untuk layanan v3 yang sesuai:
  • advertisers.youtubeAdGroupAds hingga advertisers.adGroupAds
  • advertisers.youtubeAdGroups hingga advertisers.adGroups
  • advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions hingga advertisers.adGroups.targetingTypes.assignedTargetingOptions
• Referensi ke objek YoutubeAndPartnersBiddingStrategy telah dipindahkan ke kolom youtubeAndPartnersBid baru dalam objek BiddingStrategy umum. Tujuan Kolom biddingStrategy telah dihapus dari Objek YoutubeAndPartnersSettings. Perbarui integrasi Anda ke mengambil strategi bidding untuk item baris atau grup iklan YouTube dari Objek BiddingStrategy di kolom bidStrategy di Referensi LineItem atau AdGroup.
• Kolom thirdPartyMeasurementSettings telah diganti namanya menjadi thirdPartyMeasurementConfigs di YoutubeAndPartnersSettings dan Objek YoutubeAndPartnersThirdPartyMeasurementSettings telah diganti namanya menjadi ThirdPartyMeasurementConfigs. Perbarui integrasi Anda ke mengambil informasi konfigurasi pengukuran pihak ketiga menggunakan kolom baru dan objek.

Menyertakan konfigurasi penagihan yang diperlukan saat membuat pengiklan

billingConfig sekarang menjadi kolom wajib diisi di Resource Advertiser. Mengupdate advertisers.create Anda yang digunakan untuk memverifikasi bahwa kolom ini telah ditetapkan. Informasi penagihan default dapat diambil untuk partner induk melalui Partner yang baru resource billingConfig.

Gunakan kolom baru untuk mengontrol penargetan yang dioptimalkan

Kolom boolean enableOptimizedTargeting baru telah menggantikan Kolom targetingExpansionLevel di TargetingExpansionConfig .

Memperbarui integrasi pesanan pemasangan iklan untuk menggunakan kolom KPI baru

Kolom kpi baru telah menggantikan kolom performanceGoal di resource InsertionOrder. Kolom baru ini menggunakan Kpi sebagai pengganti objek PerformanceGoal dan menggunakan kolom dan enum baru.

Menghapus referensi ke layanan dan kolom yang tidak digunakan lagi

Berbagai entity telah dihapus di v3 agar selaras dengan fitur sebelumnya penghentian layanan:

• Layanan advertisers.manualTriggers telah dihapus sebagai pemicu manual tidak digunakan lagi.
• Kolom billableOutcome telah dihapus dari Referensi InsertionOrder sebagai pembelian berbasis hasil telah tidak digunakan lagi.

Perubahan lainnya

Selain perubahan yang dapat menyebabkan gangguan yang tercantum di atas, v3 juga memperkenalkan baru.

Fitur yang ditambahkan ke v3 setelah peluncuran awal dapat ditemukan di rilis catatan.

Pengelolaan daftar lokasi kedekatan

Di v3 Anda dapat sepenuhnya mengelola daftar lokasi kedekatan, sehingga memungkinkan Anda menggunakan layanan advertisers.locationLists.assignedLocations untuk membuat dan menghapus lokasi yang ditetapkan ke TARGETING_LOCATION_TYPE_PROXIMITY LocationList. Lokasi diidentifikasi menggunakan ID dari Referensi TARGETING_TYPE_POI TargetingOption. Dapat berupa diambil menggunakan targetingTypes.targetingOptions.search.

Kemampuan untuk membuat algoritma bidding kustom berbasis aturan

Di v3, Anda dapat membuat dan mengambil algoritma bidding kustom berbasis aturan menggunakan customBiddingAlgorithms, media, Layanan customBiddingAlgorithms.rules.

Fitur ini masih dalam versi beta dan hanya tersedia untuk partner yang diizinkan. Jika partner tidak diizinkan, permintaan Anda akan menampilkan error.