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
Kolom berikut telah ditambahkan:
Objek Kolom Adloox
crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent
deathInjuryMilitaryConflictContent
debatedSensitiveSocialIssueContent
hateSpeechActsAggressionContent
Nilai enum berikut telah ditambahkan:
Enum Nilai DeviceType
DEVICE_TYPE_CONNECTED_DEVICE
PerformanceGoalType
PERFORMANCE_GOAL_TYPE_CPV
SdfVersion
SDF_VERSION_8
Nilai yang tidak digunakan lagi
Menghapus dukungan untuk SDF v5.5 karena penghentiannya pada 3 Oktober 2024.
v3
Nilai enum berikut tidak digunakan lagi:
Enum Nilai SdfVersion
SDF_VERSION_5_5
15 Agustus 2024
Fitur Baru
Menambahkan dukungan untuk jenis Exchange
Netflix.
v3
Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange EXCHANGE_NETFLIX
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai 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
Kolom berikut telah ditambahkan:
Resource Kolom IdFilter Nilai enum berikut telah ditambahkan:
Enum Nilai FileType FILE_TYPE_AD_GROUP_QA
FILE_TYPE_LINE_ITEM_QA
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
Kolom berikut telah ditambahkan:
Resource Kolom InsertionOrder Metode berikut kini mendukung jenis penargetan berikut:
Jenis Penargetan Metode TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
v2
Metode berikut kini mendukung jenis penargetan berikut:
Jenis Penargetan Metode TARGETING_TYPE_KEYWORD advertisers.editAssignedTargetingOptions
advertisers.listAssignedTargetingOptions
advertisers.targetingType.assignedTargetingOptions.create
advertisers.targetingType.assignedTargetingOptions.delete
30 Mei 2024
Fitur Baru
Menambahkan dukungan untuk File Data Terstruktur (SDF) versi 7.1.
v3
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_7_1
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai 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:
Resource Kolom Kpi Nilai enum berikut telah ditambahkan:
Enum Nilai 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
Nilai enum berikut telah ditambahkan:
Enum Nilai AppPlatform APP_PLATFORM_LG_TV
APP_PLATFORM_VIZIO_TV
Exchange EXCHANGE_DRAX
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM
28 Februari 2024
Fitur Baru
Menambahkan kemampuan untuk menghapus anggota secara eksplisit dari audiens Customer Match.
Menambahkan dukungan untuk menargetkan bursa baru.
v3
Kolom berikut telah ditambahkan:
Resource Kolom firstAndThirdPartyAudiences.editCustomerMatchMembers Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
v2
Kolom berikut telah ditambahkan:
Resource Kolom firstAndThirdPartyAudiences.editCustomerMatchMembers Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange EXCHANGE_ADMOST_GBID
EXCHANGE_APPLOVIN_GBID
EXCHANGE_CHARTBOOST_GBID
EXCHANGE_FYBER_GBID
EXCHANGE_TOPON_GBID
EXCHANGE_UNITY_GBID
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
Metode berikut telah ditambahkan:
Layanan Metode floodlightGroups.floodlightActivities Kolom berikut telah ditambahkan:
Resource Kolom Pengguna YoutubeAndPartnersInventorySourceConfig
v2
Metode berikut telah ditambahkan:
Layanan Metode floodlightGroups.floodlightActivities Kolom berikut telah ditambahkan:
Resource Kolom Pengguna YoutubeAndPartnersInventorySourceConfig
14 November 2023
Fitur Baru
Menambahkan dukungan untuk meneruskan izin pengguna akhir saat mengupload anggota audiens Match Pelanggan di semua versi aktif.
v3
Kolom berikut telah ditambahkan:
Resource Kolom ContactInfoList MobileDeviceIdList
v2
Kolom berikut telah ditambahkan:
Resource Kolom ContactInfoList MobileDeviceIdList
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:
Enum Nilai AdGroupFormat AD_GROUP_FORMAT_ACTION
Nilai enum berikut telah ditambahkan:
Enum Nilai AdGroupFormat AD_GROUP_FORMAT_RESPONSIVE
SdfVersion SDF_VERSION_7
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion SDF_VERSION_7
2 Oktober 2023
Fitur Baru
Merilis v3 dalam versi beta publik, yang mencakup perubahan berikut:
- Kemampuan untuk mengelola daftar lokasi kedekatan sepenuhnya, yang memungkinkan penggunaan layanan
advertisers.locationLists.assignedLocations
untuk membuat dan menghapus lokasi yang ditetapkan ke resourceTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
. - Kolom
enableOptimizedTargeting
boolean baru, yang menggantikan kolomtargetingExpansionLevel
dalam objekTargetingExpansionConfig
. - Persyaratan kolom
billingConfig
di resourceAdvertiser
, yang harus disertakan saat membuat permintaanadvertisers.create
, dan kolombillingConfig
baru di resourcePartner
. - Resource
AdGroup
danAdGroupAd
baru yang mengganti resourceYoutubeAdGroup
danYoutubeAdGroupAd
di v2.
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
Metode berikut telah ditambahkan:
Layanan Metode advertisers.adGroupAds advertisers.adGroups advertisers.adGroups.targetingTypes.assignedTargetingOptions customBiddingAlgorithms customBiddingAlgorithms.rules Metode berikut telah dihapus:
Layanan Metode advertisers.manualTriggers aktifkan
create
nonaktifkan
get
list
patch
advertisers.youtubeAdGroupAds get
list
advertisers.youtubeAdGroups bulkListAdGroupAssignedTargetingOptions
get
list
advertiser.youtubeAdGroups.targetingTypes.assignedTargetingOptions get
list
Perilaku metode berikut telah berubah:
Metode Perubahan advertisers.locationLists.create Kini mendukung pembuatan resource TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.patch Kini mendukung pembaruan resource TARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.bulkEdit Sekarang mendukung pengeditan massal resource AssignedLocation
di resourceTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.advertisers.locationLists.assignedLocations.create Kini mendukung pembuatan resource AssignedLocation
di resourceTARGETING_LOCATION_TYPE_PROXIMITY
LocationList
.Parameter kueri berikut telah ditambahkan:
Metode Parameter inventorySources.get Kolom berikut telah diwajibkan:
Resource Kolom Pengiklan Kolom berikut telah ditambahkan:
Resource Kolom BiddingStrategy InsertionOrder Partner TargetingExpansionConfig YoutubeAndPartnersSettings YoutubeAndPartnersInventorySourceConfig Kolom berikut telah dihapus:
Resource Kolom InsertionOrder performanceGoal
billableOutcome
TargetingExpansionConfig excludeFirstPartyAudience
targetingExpansionLevel
YoutubeAndPartnersSettings biddingStrategy
thirdPartyMeasurementSettings
YoutubeAndPartnersInventorySourceConfig includeYoutubeSearch
includeYoutubeVideos
Nilai enum berikut telah ditambahkan:
Enum Nilai CustomBiddingAlgorithmType RULE_BASED
LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
ReadinessState READINESS_STATE_EVALUATION_FAILURE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
Nilai enum berikut telah dihapus:
Enum Nilai LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v2
Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemType LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
PartnerCostType PARTNER_COST_TYPE_SCIBIDS_FEE
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV
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
Kolom berikut telah ditambahkan:
Resource Kolom YoutubeAndPartnersSettings Kolom berikut telah dihapus:
Resource Kolom InventorySource subSitePropertyId
Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange EXCHANGE_HIVESTACK
EXCHANGE_RESET_DIGITAL
YoutubeAndPartnersBiddingStrategyType YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_MAXIMIZE_CONVERSION_VALUE
YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_ROAS
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:
Enum Nilai SdfVersion SDF_VERSION_6
v1
Nilai enum berikut telah ditambahkan:
Enum Nilai 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:
Enum Nilai LineItemWarningMessage DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION
v1
Nilai enum berikut telah ditambahkan:
Enum Nilai 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
Metode berikut telah ditambahkan:
Layanan Metode advertisers.youtubeAdGroupAds advertisers.youtubeAdGroups advertisers.youtubeAdGroups.targetingTypes.assignedTargetingOptions Kolom berikut telah ditambahkan:
Layanan Metode AssignedTargetingOption YoutubeAndPartnersSettings Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange EXCHANGE_APPLOVIN
EXCHANGE_CONNATIX
EXCHANGE_JCD
EXCHANGE_PLACE_EXCHANGE
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY
TargetingType TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
v1
Nilai enum berikut telah ditambahkan:
Enum Nilai 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
Kolom berikut telah ditambahkan:
Resource Kolom Pengiklan AssignedTargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
v1
Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
Masalah umum
Update ini memperbaiki masalah umum berikut di v2:
- Opsi penargetan yang ditetapkan dari jenis penargetan yang ditetapkan menggunakan nilai enum di v2 tidak dapat dihapus atau diambil menggunakan
assignedTargetingOptionId
, dan sebagai gantinya, pengguna diharapkan menggunakan nilai enum. Dengan update ini, opsi penargetan yang ditetapkan ini dapat dihapus atau diambil menggunakanassignedTargetingOptionId
atau nilai enum, yang diidentifikasi oleh kolomassignedTargetingOptionIdAlias
baru di resourceAssignedTargetingOption
. - Permintaan item baris
bulkUpdate
tidak menggunakan parameter permintaanadvertisersId
dengan benar, sehingga menampilkan error. Dengan update ini, metode telah diperbaiki dan parameter permintaan telah diganti namanya dariadvertisersId
menjadiadvertiserId
.
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
Metode berikut telah ditambahkan:
Layanan Metode advertisers.insertionOrders.targetingTypes.assignedTargetingOptions advertisers.lineItems
v1
Tidak ada fitur baru yang ditambahkan ke v1.
20 September 2022
Merilis v2 dalam versi beta publik, yang mencakup perubahan berikut:
- Kemampuan untuk mengambil item baris YouTube & Partners dan setelan penargetan
mereka menggunakan metode
get
danlist
di layananadvertisers.lineItems
danadvertisers.lineItems.targetingTypes.assignedTargetingOptions
. - Dua metode penargetan massal baru di layanan
advertisers.lineItems
yang memungkinkan pengeditan dan pengambilan penargetan yang ditetapkan di beberapa item baris dengan satu permintaan. - Metode
bulkUpdate
baru yang memungkinkan pengguna memperbaruientityStatus
beberapa item baris dalam satu permintaan. - Logika penargetan baru yang mengharuskan resource
AssignedTargetingOption
dari subkumpulan jenis penargetan untuk ditetapkan dan diambil menggunakan nilai enum, bukan ID opsi penargetan yang diambil menggunakan layanantargetingTypes.targetingOptions
.
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:
Metode berikut telah ditambahkan di v2:
Layanan Metode advertisers.lineItems bulkEditAssignedTargetingOptions
Metode berikut telah dihapus di v2:
Layanan Metode advertisers.lineItems bulkEditLineItemAssignedTargetingOptions
bulkListLineItemAssignedTargetingOptions
Metode berikut telah diganti namanya di v2:
Layanan Nama Metode Lama Nama Metode Baru advertisers bulkEditAdvertiserAssignedTargetingOptions
bulkListAdvertiserAssignedTargetingOptions
advertisers.campaigns bulkListCampaignAssignedTargetingOptions listAssignedTargetingOptions advertisers.insertionOrders bulkListInsertionOrderAssignedTargetingOptions listAssignedTargetingOptions partners bulkEditPartnerAssignedTargetingOptions editAssignedTargetingOptions Resource
AssignedTargetingOption
dari jenis penargetan berikut menggunakan enum untuk penetapan penargetan di v2. KolomassignedTargetingOptionId
untuk resourceAssignedTargetingOption
dari jenis penargetan ini juga telah diperbarui di v2 untuk menggunakan versi string dari nilai enum:Jenis Penargetan Jenis Enum TARGETING_TYPE_AGE_RANGE AgeRange TARGETING_TYPE_CONTENT_INSTREAM_POSITION ContentInstreamPosition TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION ContentOutstreamPosition TARGETING_TYPE_DEVICE_TYPE DeviceType TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION ContentRatingTier TARGETING_TYPE_ENVIRONMENT Lingkungan TARGETING_TYPE_EXCHANGE Exchange TARGETING_TYPE_GENDER Gender TARGETING_TYPE_HOUSEHOLD_INCOME HouseholdIncome TARGETING_TYPE_NATIVE_CONTENT_POSITION NativeContentPosition TARGETING_TYPE_OMID Omid TARGETING_TYPE_PARENTAL_STATUS ParentalStatus TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION SensitiveCategory TARGETING_TYPE_VIDEO_PLAYER_SIZE VideoPlayerSize TARGETING_TYPE_VIEWABILITY Visibilitas Kolom berikut telah ditambahkan di v2:
Kolom berikut telah dihapus di v2:
Kolom berikut telah diwajibkan di v2:
Nilai enum berikut telah ditambahkan di v2:
Enum Nilai AgeRange AGE_RANGE_18_20
AGE_RANGE_21_24
AGE_RANGE_25_29
AGE_RANGE_30_34
AGE_RANGE_35_39
AGE_RANGE_40_44
AGE_RANGE_45_49
AGE_RANGE_50_54
AGE_RANGE_55_59
AGE_RANGE_60_64
ContentRatingTier CONTENT_RATING_TIER_FAMILIES
Exchange EXCHANGE_DAX
EXCHANGE_FYBER
EXCHANGE_VISTAR
LineItemType LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE
ReservationType RESERVATION_TYPE_INSTANT_RESERVE
RESERVATION_TYPE_PETRA_VIRAL
SensitiveCategory SENSITIVE_CATEGORY_EMBEDDED_VIDEO
SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO
Nilai enum berikut telah dihapus di v2:
Enum Nilai LineItemFlightDateType LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER
LineItemWarningMessage APP_INSTALL_NO_CONVERSION_PIXEL
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
NO_CREATIVE_FOR_TARGETED_DEALS
NO_POSITIVE_AUDIENCE_LIST_TARGETED
TARGETING_DEPRECATED_GEO_TARGET
TARGETING_REVOKED_OR_CLOSED_USER_LIST
v1
Nilai enum berikut telah ditambahkan di v1:
Enum Nilai 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
Metode berikut telah ditambahkan:
Layanan Metode guaranteedOrders inventorySources Kolom berikut telah ditambahkan:
Resource Kolom CustomBiddingAlgorithm InventorySource Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion Metode daftar berikut kini dapat difilter berdasarkan properti berikut:
Metode Kolom advertisers.creatives.list
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
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption InsertionOrder MaximizeSpendBidStrategy TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai TargetingType
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
Metode berikut telah ditambahkan:
Layanan Metode firstAndThirdPartyAudiences Kolom berikut telah ditambahkan:
Resource Kolom FirstAndThirdPartyAudience InsertionOrder ItemBaris
8 Desember 2021
Menambahkan dukungan untuk penargetan jenis konten audio pada jenis penargetan
TARGETING_TYPE_AUDIO_CONTENT_TYPE
.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai TargetingType
8 November 2021
Menambahkan dukungan penuh untuk mengelola algoritma bidding kustom dan skripnya. Hal ini mencakup:
- Fungsi untuk create
customBiddingAlgorithms
baru dan memperbaruicustomBiddingAlgorithms
yang ada. - Kemampuan untuk mengupload skrip melalui proses mengambil lokasi resource yang tersedia, lalu mengupload file ke lokasi tersebut.
- Layanan
customBiddingAlgorithms.scripts
baru untuk mengambil dan createcustomBiddingScripts
.
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
Metode berikut telah ditambahkan:
Layanan Metode customBiddingAlgorithms customBiddingAlgorithms.scripts media Nilai enum berikut telah ditambahkan:
Enum Nilai SdfVersion
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
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption CustomBiddingAlgorithm TargetingOption Isi Permintaan TargetingOptions.search Nilai enum berikut telah ditambahkan:
Enum Nilai CustomBiddingAlgorithmType Exchange TargetingType Metode daftar berikut kini dapat difilter berdasarkan properti berikut:
Metode Kolom customBiddingAlgorithms.list
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
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai TargetingType Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
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
Metode berikut telah ditambahkan:
Layanan Metode advertisers.invoices Kolom berikut telah ditambahkan:
Resource Kolom Pengiklan AssignedTargetingOption TargetingOption Nilai enum berikut telah ditambahkan:
Enum Nilai AssignedTargetingOption.Recency Exchange TargetingType Nilai enum berikut kini valid untuk kolom berikut:
Resource Kolom Nilai Pengiklan entityStatus ENTITY_STATUS_PAUSED
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
Kolom berikut telah ditambahkan:
Resource Kolom Kanal Metode daftar berikut kini dapat difilter berdasarkan properti berikut:
Metode Kolom advertisers.lineItems.list targetedChannelId
targetedNegativeKeywordListId
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
ataucreatedNegativeKeywords
dari permintaan pengeditan massal. - Peningkatan jumlah maksimum item yang dapat ditampilkan di satu halaman respons daftar situs atau daftar kata kunci negatif.
Fitur Baru
Metode berikut telah ditambahkan:
Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption.AppAssignedTargetingOptionDetails Ukuran halaman maksimum telah ditingkatkan untuk metode daftar berikut:
Metode Ukuran Halaman Maksimum Lama Ukuran Halaman Maksimum Baru advertisers.channels.sites.list 100 10000 advertisers.negativeKeywordLists.negativeKeywords.list 100 1000 partners.channels.sites.list 100 10000
Penghentian penggunaan
Nilai enum berikut tidak dapat lagi ditetapkan ke resource baru atau yang sudah ada:
Enum Nilai PartnerRevenueModelMarkupType PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP
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
Metode berikut telah ditambahkan:
Layanan Metode advertisers.insertionOrders advertisers.insertionOrders.targetingTypes.assignedTargetingOptions Kolom berikut telah ditambahkan:
Resource Kolom Materi iklan Nilai enum berikut telah ditambahkan:
Enum Nilai ContentInstreamPosition PerformanceGoalType PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
PERFORMANCE_GOAL_TYPE_CLICK_CVR
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
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
Kolom berikut telah ditambahkan:
Resource Kolom InsertionOrder LineItem Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange GoogleAudienceType LineItemType SdfVersion Metode daftar berikut kini dapat diurutkan dan difilter berdasarkan kolom berikut:
Metode Kolom pengiklan
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
Metode berikut telah ditambahkan:
Layanan Metode targetingTypes.targetingOptions Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange LineItemWarningMessage Metode daftar berikut kini dapat diurutkan dan difilter berdasarkan kolom berikut:
Metode Kolom advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list
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
Layanan berikut telah ditambahkan:
Layanan Metode advertisers.manualTriggers Kolom berikut telah ditambahkan:
Resource Kolom AssignedTargetingOption.DoubleVerify AssignedTargetingOption.IntegralAdScience LineItem LineItemFlight Nilai enum berikut telah ditambahkan:
Enum Nilai LineItemFlightDateType Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:
Metode Kolom advertisers.lineItems.list
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
Kolom berikut telah ditambahkan:
Resource Kolom LineItem Nilai enum berikut telah ditambahkan:
Enum Nilai PerformanceGoalType Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:
Metode Kolom advertisers.lineItems.list
28 Agustus 2020
Menambahkan kolom baru ke respons metode audit pengiklan dan kolom baru yang dapat difilter ke berbagai metode daftar.
Fitur Baru
Kolom berikut telah ditambahkan:
Resource Kolom Isi Respons Advertisers.Audit Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:
Metode Kolom advertisers.list advertisers.campaigns.list advertisers.insertionOrders.list advertisers.lineItems.list targetingTypes.targetingOptions.list
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
Layanan berikut telah ditambahkan:
Layanan Metode customBiddingAlgorithms partner partners.targetingTypes.assignedTargetingOptions pengguna Metode berikut telah ditambahkan:
Layanan Metode pengiklan Kolom berikut telah ditambahkan:
Resource Kolom MaximizeSpendBidStrategy PerformanceGoalBidStrategy Nilai enum berikut telah ditambahkan:
Enum Nilai BiddingStrategyPerformanceGoalType LineItemType Metode daftar berikut kini dapat diurutkan dan difilter berdasarkan kolom berikut:
Metode Kolom advertisers.lineItems.list Cakupan berikut telah ditambahkan untuk digunakan untuk layanan berikut:
Cakupan Layanan https://www.googleapis.com/auth/display-video-user-management
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
Layanan berikut telah ditambahkan:
Layanan Metode advertisers.channels partners.channels Kolom berikut telah ditambahkan:
Resource Kolom FirstAndThirdPartyAudience Nilai enum berikut telah ditambahkan:
Enum Nilai Exchange Metode daftar berikut kini dapat difilter berdasarkan kolom berikut:
Metode Kolom advertisers.creatives.list
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
Layanan berikut telah ditambahkan:
Metode berikut telah ditambahkan:
Layanan Metode pengiklan advertisers.channels advertisers.locationLists advertisers.negativeKeywordLists inventorySourceGroups partners.channels Kolom berikut telah ditambahkan:
Resource Kolom pengiklan materi iklan insertionOrder.insertionOrderBudgetSegment
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:
9 Maret 2020
Meluncurkan Display & Video 360 API v1. Ini adalah versi awal API.
Masalah umum
Tidak ada.