v17 (05-06-2024)
Fitur dan perubahan berikut ditambahkan di v17.
Iklan
AdService.getAd
dihapus. Tindakan ini menjadikanAdService
sejajar dengan layanan lain di Google Ads API. Baca bagian Mengambil objek untuk mengetahui cara yang direkomendasikan dalam mengambil iklan dan jenis resource lainnya.- Menambahkan lebih banyak validasi untuk
ImageAdInfo.image_asset
terkait dimensi dan format. Error berikut dapat ditampilkan jika gambar tidak valid:
Aset
- Menambahkan enum baru:
ClickType.AD_IMAGE
- Menambahkan laporan baru berikut dengan metrik baru untuk kampanye Performa Maksimal dan Penelusuran:
Audiens
Tugas Batch
- Menambahkan
BatchJobError.REQUEST_TOO_LARGE
, yang akan ditampilkan saatAddBatchJobOperationsRequest
yang dikirimkan lebih besar dari 10484504 byte. - Menambahkan dukungan untuk menyetel
MutateOperation.asset_group_operation
saat menggunakanBatchJobService
. Dengan begitu, Anda dapat menggunakan batch processing untuk membuat dan mengelola seluruh kampanye Performa Maksimal. Lihat panduan khusus kami yang baru.
Kampanye
- Mengganti nama Discovery menjadi Peningkat Permintaan di semua kolom, enum, error untuk semua
resource di seluruh Google Ads API, seperti kampanye, iklan, dan aset. Misalnya,
AdvertisingChannelType.DISCOVERY
sekarang menjadiAdvertisingChannelType.DEMAND_GEN
. - Menambahkan
Campaign.keyword_match_type
agar Anda dapat menetapkan jenis pencocokan kata kunci untuk semua kata kunci dalam kampanye.
Konversi
- Untuk konversi SKAdNetwork,
- Mengganti nama
segments.sk_ad_network_conversion_value
menjadisegments.sk_ad_network_fine_conversion_value
. - Menambahkan
segments.sk_ad_network_redistributed_fine_conversion_value
.
- Mengganti nama
- Metrik berikut kini ditampilkan dengan respons meskipun bernilai nol. Hal ini membuatnya konsisten dengan metrik lainnya.
Kriteria
- Ditambahkan ke kolom berikut ke
AdGroupCriterion
untuk menunjukkan apakah kriteria grup iklan ditayangkan atau alasannya tidak ditayangkan:primary_status
primary_status_reasons
- Menambahkan dukungan
metrics.search_impression_share
untukgender_view
- Menambahkan dukungan
metrics.phone_calls
untukkeyword_view
Jasa dan Servis
- Menambahkan
LocalServicesLeadService.AppendLeadConversation()
yang digunakan untuk menambahkanLocalServicesLeadConversation
baru keLocalServicesLead
, yang mengirimkan pesan kepada pengguna melalui saluran yang sesuai seperti SMS, bergantung pada cara prospek dibuat.- Ukuran
AppendLeadConversationRequest.conversations
dibatasi hingga 1.000. - Hanya
LocalServicesLead
denganlead_type
yang ditetapkan keLeadType.MESSAGE
yang dapat ditentukan diConversation.local_services_lead
.
- Ukuran
- Menambahkan nilai enum baru ke
ConversationType
:WHATSAPP
untuk mewakili percakapan yang diperkenalkan melalui WhatsApp.ADS_API
untuk merepresentasikan percakapan yang diperkenalkan menggunakan metodeLocalServicesLeadService.AppendLeadConversation()
baru.
- Menambahkan kolom baru berikut ke
local_services_verification_artifact
:local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
Pelaporan
- Sekarang Anda hanya dapat memilih kolom yang terkait dengan satu produk tertaut
saat membuat kueri
product_link
. Memilih beberapa kolom dari beberapa produk tertaut akan menampilkanQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Misalnya,product_link.advertising_partner.customer
danproduct_link.data_partner.data_partner_id
tidak dapat dipilih dalam kueri yang sama. - Meneruskan
page_size
keGoogleAdsService.Search
akan menghasilkan errorRequestError.PAGE_SIZE_NOT_SUPPORTED
.
Shopping
- Menambahkan laporan baru
shopping_product
yang sesuai dengan halaman Produk pada UI Google Ads. Alat ini mendukung ditampilkannya data yang terkait dengan status produk saat ini dari akun Google Merchant Center yang ditautkan ke akun Google Ads.- Anda dapat memfilter metrik dari
laporan
shopping_product
menggunakansegments.date
saat menggunakanGoogleAdsService.Search
atauGoogleAdsService.SearchStream
. Segmentasi menurut tanggal tidak diizinkan dan akan menampilkan errorShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Anda dapat memfilter metrik dari
laporan
Sasaran Terpadu
- Menambahkan
UserListCustomerTypeService.MutateUserListCustomerTypes()
untuk mengonfigurasi jenis pelanggan audiens. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
dihapus. Untuk mengonfigurasi setelan audiens sasaran siklus proses pelanggan, gunakanUserListCustomerTypeService.MutateUserListCustomerTypes()
.- Lampirkan atau batalkan lampiran daftar pengguna dengan menetapkan
UserListCustomerType.customer_type_category
keUserListCustomerTypeCategory.PURCHASERS
untuk menyertakannya ke dalam atau mengecualikannya dari definisi pelanggan yang ada untuk sasaran siklus proses pelanggan. Buka menyegmentasikan audiens Anda untuk mengetahui detail selengkapnya.
- Lampirkan atau batalkan lampiran daftar pengguna dengan menetapkan
Video
- Menambahkan nilai berikut ke
ContentLabelType
. Anda dapat mengecualikanContentLabelTypes
ini di tingkat pelanggan:BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
- Menambahkan
AdVideoAsset.ad_video_asset_info
untuk mendukung preferensi inventaris untuk aset video saat membuatDemandGenVideoResponsiveAdInfo
. - (Khusus akun yang diizinkan) Membuat
Campaign.video_brand_safety_suitability
dapat diubah.
v16.1.0 (24-04-2024)
Fitur dan perubahan berikut ditambahkan di v16.1.
Pengelolaan Akun
CustomerNegativeCriterion.ip_block
yang mendukung penambahan IP sebagai kriteria negatif di tingkat pelanggan.- Nilai enum baru:
ProductLinkError.LINK_EXISTS
. - Nilai enum baru:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
.
Aset
- Dukungan untuk aset yang terkait dengan Peningkat Permintaan untuk
ad_group_ad_asset_view
danasset_field_type_view
. - Nilai enum baru:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
.
Audiens
- Nilai enum baru:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
yang membatasi jumlah daftar pengguna yang mirip yang dapat dimiliki pelanggan hingga 1.000.
Kampanye
- Dukungan untuk menampilkan simulasi bid kampanye Target ROAS untuk kampanye Aplikasi menggunakan laporan
campaign_simulation
. - Nilai enum baru:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
. - Nilai enum baru:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
. - Nilai enum baru:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
.
Konversi
SkAdNetworkConversionValueSchema.postback_mappings
yang mendukung fitur SKAdNetwork 4.0.- Menambahkan dukungan untuk peringatan
CustomerSkAdNetworkConversionValueSchemaService
sebagaiMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Jika ditetapkan ketrue
, error non-pemblokiran yang terkait dengan kegagalan operasi akan ditampilkan sebagaiMutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
. - Nilai enum baru di
CustomerSkAdNetworkConversionValueSchemaError
:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
Kriteria
- Kolom baru di
BrandInfo
:display_name
primary_url
rejection_reason
status
- Enum baru:
BrandRequestRejectionReason
. - Nilai enum baru:
CriterionType.LIFE_EVENT
.
Eksperimen
- Nilai enum baru:
ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT
.
Jasa dan Servis
local_services_lead.credit_details.credit_state
danlocal_services_lead.credit_details.credit_state_last_update_date_time
yang menampilkan status kredit dan stempel waktu saat status kredit diperbarui.local_services_lead_conversation.message_details.attachment_urls
yang menampilkan URL yang dapat digunakan untuk mendownload konten lampiran.
Video
customer.video_brand_safety_suitability
danBrandSafetySuitability
yang mendukung pengambilan kesesuaian keamanan merek video di tingkat pelanggan.- Nilai enum baru:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
.
v16 (21-02-2024)
Fitur dan perubahan berikut ditambahkan di v16.
Pengelolaan Akun
- Memigrasikan
advertising_partner
dariAccountLink
keProductLink
danProductLinkInvitation
. - Menghapus
data_partner
dangoogle_ads
dariAccountLink
. - Menambahkan
IdentityVerificationService
untuk mengelola verifikasi pengiklan.StartIdentityVerification()
digunakan untuk memulai sesi verifikasi menggunakanverification_program
yang disediakan. Tindakan ini akan membuat sesi verifikasi baru dan menampilkan respons kosong untuk verifikasi yang berhasil dibuat.GetIdentityVerification()
dapat digunakan untuk mengambil informasi verifikasi, yang menampilkan beberapa objekIdentityVerification
. SetiapIdentityVerification
mencakup:verification_program
yang merupakan jenis program verifikasi identitasidentity_verification_requirement
yang berisi detail terkait batas waktu bagi pengiklan harus menyelesaikan verifikasiverification_progress
yang berisi detail terkait sesi verifikasi, termasuk:program_status
mewakili status sesi verifikasi saat iniaction_url
mengarahkan pelanggan ke URL untuk menyelesaikan verifikasi.invitation_link_expiration_time
menunjukkan tanggal habis masa berlaku untukaction_url
- Enum:
- Error:
- Menambahkan
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
.
Aset
- Perubahan pada
asset_group
:- Menambahkan dukungan untuk segmen terkait waktu, seperti
segments.year
dansegments.month
. - Membuat
campaign
sebagai resource yang diatribusikan, bukan menyegmentasikan resource.
- Menambahkan dukungan untuk segmen terkait waktu, seperti
Kampanye
- Perubahan pada kampanye Peningkat Permintaan:
- Menambahkan dukungan untuk menetapkan
Campaign.shopping_setting
ke kampanye Peningkat Permintaan yang ada. - Menambahkan
ShoppingSetting.disable_product_feed
untuk menonaktifkan feed produk opsional kampanye Peningkat Permintaan. - Menambahkan
Ad.demand_gen_product_ad
danDemandGenProductAdInfo
yang sesuai, yang tersedia untuk kampanye Peningkat Permintaan denganCampaign.shopping_setting
non-null.
- Menambahkan dukungan untuk menetapkan
- Ditambahkan ke kolom berikut ke
AdGroup
untuk menunjukkan apakah grup iklan ditayangkan atau alasan grup iklan tidak ditayangkan:primary_status
primary_status_reasons
- Menambahkan kolom berikut ke
AdGroupAd
untuk menunjukkan apakah iklan grup iklan ditayangkan atau alasan iklan tidak ditayangkan:primary_status
primary_status_reasons
- Menambahkan nilai berikut ke
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
Eksperimen
- Menambahkan
Experiment.sync_enabled
untuk menentukan apakah sinkronisasi harus diaktifkan dalam eksperimen. Jika sinkronisasi diaktifkan, perubahan yang dibuat pada kampanye asli saat eksperimen Anda berjalan, akan secara otomatis disalin ke kampanye eksperimen. - Menambahkan
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
. - Menambahkan
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
.
Hotel & Perjalanan
- Menambahkan kolom berikut ke
ListingDimensionInfo
untuk iklan Rekomendasi aktivitas agar dapat membuat grup listingan berdasarkan negara bagian dan kota tempat aktivitas perjalanan tersedia: - Menambahkan dukungan untuk segmen berikut ke
travel_activity_performance_view
:
Jasa dan Servis
- Menambahkan
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
danBusinessRegistrationCheckArtifact
agar pengiklan dapat memantau progres proses verifikasi pendaftaran bisnis. - Menambahkan resource baru
local_services_employee
agar pengiklan dapat mengambil informasi karyawan yang telah mereka tambahkan.
Perencanaan
- Menghapus
score
dariAudienceInsightsAttributeMetadata
.
Rekomendasi
- Menambahkan
RecommendationService.GenerateRecommendations()
yang menampilkan rekomendasi berdasarkan setelan yang ditentukan, seperti jenis rekomendasi dan jenis saluran iklan. Hal ini sangat membantu selama pembuatan kampanye. - Menambahkan
RecommendationMetrics.conversions_value
. - Kata kunci yang direkomendasikan dengan jenis pencocokan kata kunci yang tidak ditetapkan kini memiliki
recommended_match_type
ditetapkan keUNSPECIFIED
, bukanUNKNOWN
. - Menambahkan jenis rekomendasi berikut:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
yang merekomendasikan penggunaan strategi bidding Maksimalkan nilai konversiIMPROVE_GOOGLE_TAG_COVERAGE
yang merekomendasikan deployment Tag Google di lebih banyak halamanPERFORMANCE_MAX_FINAL_URL_OPT_IN
yang merekomendasikan pengaktifan perluasan URL Final untuk kampanye Performa Maksimal AndaREFRESH_CUSTOMER_MATCH_LIST
yang merekomendasikan pembaruan daftar pelanggan yang belum diperbarui dalam 90 hari terakhirCUSTOM_AUDIENCE_OPT_IN
yang merekomendasikan pembuatan audiens kustomLEAD_FORM_ASSET
yang merekomendasikan penambahan aset formulir prospek di tingkat kampanye atau pelangganIMPROVE_DEMAND_GEN_AD_STRENGTH
yang merekomendasikan peningkatan daya iklan di kampanye Peningkat Permintaan
Shopping
- Menambahkan
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
danCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
untuk menampilkan error yang lebih mendetail terkait kampanye Shopping yang ditautkan ke akun Comparison Shopping Service Center. - Menambahkan nilai berikut ke
AssetGroupListingGroupFilterError
:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
Sasaran Siklus Proses
- Menambahkan
update
keCustomerLifecycleGoalOperation
danCampaignLifecycleGoalOperation
agar jenis operasi ini konsisten dengan jenis operasi lain di API.
v15 (18-10-2023)
Fitur dan update baru berikut diperkenalkan pada v15.
Pengelolaan Akun
- Jika akun Anda ditangguhkan karena aktivitas akun
yang tidak sah,
customer.status
dancustomer_client.status
kini ditampilkan sebagaiSUSPENDED
. Sebelumnya, keduanya ditampilkan sebagaiENABLED
. - Menambahkan dukungan untuk menambahkan dan menghapus penautan antara akun Google Ads dan akun Merchant Center:
- Menambahkan
ProductLink.merchant_center
danMerchantCenterIdentifier
. - Menambahkan
LinkedProductType.MERCHANT_CENTER
.
- Menambahkan
- Menambahkan
ProductLinkInvitationService
danProductLinkInvitation
untuk mendukung pembaruan undangan penautan yang dikirim dari produk lain, yang tersedia untuk akun Pusat Pengelolaan Hotel dan Merchant Center. MerchantCenterLinkService
dihapus.- Untuk menautkan akun Google Ads dengan akun Merchant Center, gunakan
ProductLinkInvitationService
danProductLinkService
.
- Untuk menautkan akun Google Ads dengan akun Merchant Center, gunakan
- Menghapus
AccountLink.hotel_center
dan dukungan untuk memperbarui undangan penautan dari akun Pusat Pengelolaan Hotel menggunakanAccountLinkService
.- Untuk memperbarui undangan penautan dari akun Pusat Pengelolaan Hotel, gunakan
ProductLinkInvitationService
.
- Untuk memperbarui undangan penautan dari akun Pusat Pengelolaan Hotel, gunakan
Aset
- Mengganti
ImageAdInfo.media_file
denganImageAdInfo.image_asset
untuk mendukung penambahan dan penghapusan gambar menggunakan aset. Akibatnya, kami juga menghapusMediaFileService
, yang tidak lagi diperlukan. - Menambahkan
ListingGroupFilterDimension.webpage
untuk mendukung pembuatan filter grup listingan berdasarkan label kustom dan substring URL.- Juga mengganti
AssetGroupListingGroupFilter.vertical
denganAssetGroupListingGroupFilter.listing_source
danListingGroupFilterListingSource
- Juga mengganti
- Menambahkan
asset_group_asset.source
untuk menampilkan sumber aset grup aset. - Menambahkan
ad_group_ad_asset_view.source
untuk menampilkan sumber aset iklan grup iklan.
Audiens
- Untuk Customer Match, menambahkan
CustomerMatchUserListMetadata.consent
untuk mendukung pemberian izin. Mulai 6 Maret 2024 jika tidak ada izin untuk pengguna EEA, nilai izin akan ditentukan sebagai tidak ada izin. Data dari pengguna EEA tanpa izin cookie tidak akan diproses dan tidak dapat digunakan untuk personalisasi iklan menggunakan Customer Match. Lihat panduan Customer Match kami untuk mengetahui detail selengkapnya. - Untuk Penjualan Toko, menambahkan
UserData.consent
untuk mendukung pemberian izin. Lihat panduan Penjualan Toko untuk detail selengkapnya. Jika Anda menggunakan Customer Match dengan penjualan toko, tinjau FAQ untuk mendapatkan informasi tambahan. - Menambahkan
UserList.lookalike_user_list
untuk mendukung pembuatan Segmen mirip, audiens yang dibuat berdasarkan audiens awal yang sudah ada. Segmen mirip hanya dapat digunakan di kampanye Peningkat Permintaan.
Kampanye
Perubahan pada kampanye Performa Maksimal:
AssetGroupSignal
kini mendukung dua jenis sinyal yang dapat disertakan ke grup aset untuk penargetan yang ditingkatkan:AssetGroupSignal.audience
- Menambahkan
Audience.scope
danAudience.asset_group
untuk membatasi penggunaan audiens ke grup aset tertentu.Audience.asset_group
harus ditetapkan jika dan hanya jikaAudience.scope
adalahASSET_GROUP
.
- Menambahkan
AssetGroupSignal.search_theme
- Menambahkan
CriterionType.SEARCH_THEME
untuk mendukung jenis kriteria baru ini. Jenis kriteria baru ini hanya dapat digunakan di kampanye Performa Maksimal untuk membuatAssetGroupSignal
dengan mengisiAssetGroupSignal.search_theme
dengan kriteriaSearchThemeInfo
.
- Menambahkan
- Menambahkan
AssetGroupSignalOperation.exempt_policy_violation_keys
untuk mendukung permintaan pengecualian saat menambahkan sinyal grup aset. - Menambahkan
asset_group_top_combination_view
baru untuk melaporkan aset berperforma terbaik di tingkat grup aset. asset_group
kini dapat dikueri dengan kolom metrik untuk mendukung pengambilan performa kampanye Performa Maksimal.- Di
PerformanceMaxUpgradeStatus
, mengganti namaUPGRADE_ELIGIBLE
menjadiUPGRADE_ELIGIBLE
.
Untuk kampanye Target CPA Peningkat Permintaan dan Discovery, simulasi bid Target CPA tingkat kampanye (
campaign_simulation.target_cpa_point_list.points
) kini menampilkanTargetCpaSimulationPoint.interactions
, bukanTargetCpaSimulationPoint.clicks
.Menambahkan
BrandSuggestionService
yang dapat menyarankan merek berdasarkan awalan merek yang diberikan dan daftar merek yang dikecualikan. Merek ini dapat digunakan untuk membuat kriteriaBRAND
, ditambahkan ke kumpulan bersamaBRANDS
, lalu disertakan ke kampanye dengan membuatCampaignCriterion
denganbrand_list
ditetapkan ke kumpulan bersama. Kriteria kampanye dapat ditargetkan di kampanye Penelusuran dan dikecualikan di kampanye Performa Maksimal.Menambahkan
Campaign.asset_automation_settings[]
untuk menampilkan status otomatisasi setiap jenis aset.Menambahkan nilai berikut ke enum
CampaignPrimaryStatusReason
:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Konversi
- Menambahkan
CallConversion.consent
danClickConversion.consent
untuk mendukung pemberian izin. Lihat panduan konversi panggilan dan panduan konversi klik untuk mengetahui detail lebih lanjut. - Menambahkan kolom berikut yang terkait dengan konversi SKAdNetwork, yang tersedia saat membuat kueri dengan
customer
ataucampaign
: metrics.sk_ad_network_conversions
diganti denganmetrics.sk_ad_network_installs
.- Menambahkan dukungan untuk mendiagnosis upload konversi offline
- Memindahkan
offline_conversion_upload_client_summary
dari kolom di resourcecustomer
ke laporan tingkat atas. Gunakan laporan ini untuk mendapatkan detail tentang status upload konversi yang berguna, seperti jumlah peristiwa berhasil, tingkat keberhasilan, dan persentase error.- Peringatan: Konversi yang diupload, tetapi menghasilkan error
ConversionUploadError.CLICK_NOT_FOUND
tetap dianggap berhasil, tetapi juga ditandai sebagaiOfflineConversionAlert
.
- Peringatan: Konversi yang diupload, tetapi menghasilkan error
- Menambahkan
job_id
sebagai parameter opsional untuk jenis permintaan berikut sehingga Anda dapat secara logis mengelompokkan beberapa permintaan upload ke dalam satu tugas konseptual: - Menambahkan
INVALID_JOB_ID
ke error berikut: - Mengganti
INVALID_CONVERSION_ACTION
denganNO_CONVERSION_ACTION_FOUND
danINVALID_CONVERSION_ACTION_TYPE
pada error berikut:
- Memindahkan
- Menambahkan tiga laporan untuk mendukung atribusi Lintas jaringan Android Privacy Sandbox
tanpa
pengalihan:
android_privacy_shared_key_google_campaign
yang berisishared_campaign_key
dan beberapa kolom yang membantu mengenkode kunci.android_privacy_shared_key_google_ad_group
yang berisishared_ad_group_key
dan beberapa kolom yang membantu mengenkode kunci.android_privacy_shared_key_google_network_type
yang berisishared_network_type_key
dan beberapa kolom yang membantu mengenkode kunci.
- Menambahkan
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
.ConversionActionOperation
yang mencoba menggunakan salah satu model atribusi berbasis aturan yang tidak digunakan lagi sekarang gagal dengan error ini. Sebelumnya, operasi akan gagal dengan errorUNKNOWN
.
Hotel & Perjalanan
- Menambahkan dukungan untuk kolom berikut di
travel_activity_group_view
dantravel_activity_performance_view
:- Segmen:
- Metrik:
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
Iklan Jasa dan Servis
- Menambahkan
LocalServicesSettings
dan kolomnya ke laporancustomer
untuk menampilkan status asuransi dan lisensi terperinci pengiklan Jasa dan Servis. - Menambahkan laporan baru berikut untuk Jasa
Lokal:
local_services_lead
berisi semua detail yang berkaitan dengan prospek Iklan Jasa dan Servis sepertilead_charged
,lead_type
,lead_status
.- Enum:
local_services_lead_conversation
berisi detail pesan dan percakapan telepon seperticonversation_channel
,call_duration_millis
,call_recording_url
.- URL perekaman panggilan telepon diautentikasi terhadap akun pelanggan target dan akun pengelolanya.
local_services_verification_artifact
menampilkan artefak pengiklan Jasa dan Servis seperti pemeriksaan latar belakang, izin bisnis, dan data asuransi bisnis. Dokumen apa pun yang terkait dengan lisensi dan asuransi dapat diakses melalui URL.
Perencanaan
- Menambahkan dukungan untuk menampilkan
Forecast.views
danPlannedProductForecast.views
untukReachPlanService.ListPlannableProducts
untuk jenis produk yang berlaku. - Menambahkan dukungan untuk menampilkan
PlannableTargeting.surface_targeting
untukReachPlanService.ListPlannableProducts
, yang menjelaskan platform yang tersedia untuk suatu produk. - Menambahkan enum
ReachPlanSurface
baru. - Menambahkan dukungan untuk menargetkan Frekuensi
target menggunakan
AdvancedProductTargeting.target_frequency_settings
, yang menampilkanPlannedProductForecast.average_frequency
. - Menambahkan
AudienceInsightsService.GenerateSuggestedTargetingInsights
untuk menampilkan audiens yang dapat ditargetkan yang disarankan. - Menambahkan nilai berikut ke
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Rekomendasi
- Menambahkan
RecommendationSubscriptionService
yang mengelola langganan rekomendasi: - Menambahkan jenis rekomendasi berikut:
FORECASTING_SET_TARGET_CPA
yang merekomendasikan penetapan target CPA untuk kampanye yang belum menentukannya, sebelum acara musiman yang diperkirakan akan meningkatkan traffic.SET_TARGET_CPA
yang merekomendasikan penetapan target CPA untuk kampanye yang belum ditentukan.SET_TARGET_ROAS
yang merekomendasikan penetapan target ROAS untuk kampanye yang belum menentukan target ROAS.
Pelaporan
- Menambahkan metrik baru berikut, yang dapat dikueri dengan
campaign
(tersedia untuk kampanye Display, Video, Discovery, dan Aplikasi) sertasegments.device
:
Shopping
- Menghapus
ShoppingSetting.sales_country
, yang nilainya kini ditampilkan sebagaiShoppingSetting.feed_label
.- Anda dapat terus menggunakan feed Merchant Center tertentu untuk kampanye dengan menggunakan kolom
ShoppingSetting.feed_label
. Harus ditetapkan ke nilai label feed atau kode negara dua huruf yang sebelumnya digunakan untukShoppingSetting.sales_country
. Untuk detail selengkapnya, lihat artikel dukungan untuk label feed.
- Anda dapat terus menggunakan feed Merchant Center tertentu untuk kampanye dengan menggunakan kolom
- Menghapus dependensi kategori produk pada kode negara dalam pelaporan.
Kumpulan ID kategori yang didukung tidak berubah.
- Mengganti kolom berikut yang digunakan di
shopping_performance_view
:segments.product_bidding_category_level1
dengansegments.product_category_level1
segments.product_bidding_category_level2
dengansegments.product_category_level2
segments.product_bidding_category_level3
dengansegments.product_category_level3
segments.product_bidding_category_level4
dengansegments.product_category_level4
segments.product_bidding_category_level5
dengansegments.product_category_level5
- Mengganti
product_bidding_category_constant
denganproduct_category_constant
, yang menampilkan semua pelokalan kategori yang tersedia di kolom berulang. ListingDimensionInfo.product_bidding_category
diganti denganListingDimensionInfo.product_category
.ListingGroupFilterDimension.product_bidding_category
diganti denganListingGroupFilterDimension.product_category
.
- Mengganti kolom berikut yang digunakan di
- Menghapus dukungan untuk menambahkan
Campaign.shopping_setting
ke kampanye Penelusuran. Mencoba membuat kampanye Penelusuran denganCampaign.shopping_setting
atau menambahkanCampaign.shopping_setting
ke kampanye Penelusuran yang ada sekarang akan menghasilkanOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Menghapus dukungan untuk menambahkan
CampaignCriterion.listing_scope
ke kampanye Penelusuran. Mencoba menambahkanCampaignCriterion.listing_scope
ke kampanye Penelusuran yang ada sekarang akan menghasilkanOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Menambahkan metrik konversi dengan data keranjang berikut:
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- Semua metrik ini dapat dipilih dengan laporan berikut:
Sasaran Terpadu
- Menambahkan
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
untuk mengonfigurasi sasaran akuisisi pelanggan di tingkat pelanggan.- Laporan:
customer_lifecycle_goal
- Laporan:
- Menambahkan
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
untuk mengonfigurasi sasaran akuisisi pelanggan di tingkat kampanye.- Laporan:
campaign_lifecycle_goal
- Laporan:
- Menambahkan
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
. - Menambahkan nilai berikut ke
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
Video
- Menambahkan dukungan untuk menargetkan Google TV di tingkat kampanye:
- Menambahkan
NetworkSettings.target_google_tv_network
- Menambahkan
AdNetworkType.GOOGLE_TV
.
- Menambahkan
- Menambahkan dukungan untuk menargetkan YouTube di tingkat kampanye:
- Menambahkan
NetworkSettings.target_youtube
- Di
AdNetworkType
, gabungkanYOUTUBE_WATCH
danYOUTUBE_SEARCH
keYOUTUBE
. - Menambahkan
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Menambahkan
Arsip catatan rilis
Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.