v17.1.0 (07-08-2024)
Fitur dan update baru berikut ditambahkan di v17_1.
Aset
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
memungkinkan Anda menghapus aset yang dibuat otomatis tertentu yang ditautkan ke Iklan Penelusuran Responsif.
Audiens
- Nilai enum baru di
UserListCustomerTypeCategory
:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
Kampanye
ShareablePreviewService.GenerateShareablePreviews()
membuat URL (shareable_preview_url
dalam respons) untuk pratinjau iklan yang dapat dibagikan bagi grup aset yang diaktifkan dan dijeda.- Kolom
expiration_date_time
menunjukkan tanggal habis masa berlaku URL dalam respons. - Jika terjadi error, metode akan menampilkan
partial_failure_error
, bukan URL.
- Kolom
Histori Perubahan
- Jenis resource status perubahan baru:
ASSET_GROUP
.
Konversi
- Kolom segmen baru untuk versi SKAdNetwork:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
yang mengekspos diagnostik upload konversi di tingkat tindakan konversi.- Metrik berikut ditambahkan ke laporan diagnostik offline untuk menampilkan jumlah konversi yang diupload yang masih diproses:
Perencanaan
AudienceInsights.GenerateAudienceOverlapInsights()
yang menerima atribut utama input dan kumpulan atribut audiens, serta menampilkan estimasi tumpang-tindih potensi jangkauan YouTube antara atribut utama dan atribut audiens.
Pelaporan
- Dukungan untuk membuat segmentasi
per_store_view
berdasarkansegments.date
Video
- Dukungan untuk mengambil informasi yang terkait dengan strategi bidding standar berikut untuk kampanye video yang menggunakan laporan, seperti
ad_group
,campaign
:Campaign.fixed_cpm
(CPM Tetap (biaya per seribu tayangan iklan))Campaign.target_cpv
(Target CPV (biaya per tampilan))
Campaign.video_campaign_settings
yang memungkinkan Anda menentukan inventaris mana yang dapat menampilkan iklan video, menggunakan kolom laporan berikut:segments.ad_format_type
yang memungkinkan Anda menyegmentasikan laporan berikut berdasarkan jenis format iklan video:
v17 (05-06-2024)
Fitur dan perubahan berikut ditambahkan di v17.
Iklan
AdService.getAd
dihapus. Hal ini menjadikanAdService
sesuai dengan layanan lain di API Google Ads. Baca artikel Mengambil objek untuk mengetahui cara yang direkomendasikan untuk 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
- Ditambahkan
BatchJobError.REQUEST_TOO_LARGE
, yang akan ditampilkan saatAddBatchJobOperationsRequest
yang dikirimkan lebih besar dari 10484504 byte. - Menambahkan dukungan untuk setelan
MutateOperation.asset_group_operation
saat menggunakanBatchJobService
. Hal ini memungkinkan Anda gunakan 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
resource di Google Ads API, seperti kampanye, iklan, dan aset. Sebagai
contoh,
AdvertisingChannelType.DISCOVERY
sekarang menjadiAdvertisingChannelType.DEMAND_GEN
. - Ditambahkan
Campaign.keyword_match_type
agar Anda dapat menetapkan jenis pencocokan kata kunci untuk semua kata kunci dalam suatu kampanye.
Konversi
- Untuk SKAdNetwork
konversi,
- 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 sekarang ditampilkan dengan respons bahkan ketika mereka adalah 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 penayangan:primary_status
primary_status_reasons
- Menambahkan dukungan untuk
metrics.search_impression_share
untukgender_view
- Menambahkan dukungan untuk
metrics.phone_calls
untukkeyword_view
Layanan Lokal
- Menambahkan
LocalServicesLeadService.AppendLeadConversation()
digunakan untuk menambahkanLocalServicesLeadConversation
keLocalServicesLead
, yang mengirimkan kepada pengguna melalui saluran yang sesuai seperti SMS tergantung pada bagaimana prospek dibuat.- Ukuran
AppendLeadConversationRequest.conversations
dibatasi menjadi 1.000. - Hanya
LocalServicesLead
denganlead_type
ditetapkan keLeadType.MESSAGE
dapat ditentukan dalamConversation.local_services_lead
.
- Ukuran
- Menambahkan nilai enum baru ke
ConversationType
:WHATSAPP
untuk mewakili percakapan yang diperkenalkan melalui WhatsApp.ADS_API
untuk mewakili percakapan yang diperkenalkan menggunakanLocalServicesLeadService.AppendLeadConversation()
.
- 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
- Anda kini dapat memilih kolom yang terkait dengan satu produk tertaut saja
saat membuat kueri
product_link
. Memilih beberapa beberapa bidang dari beberapa produk yang saling terkait akan melemparQueryError.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 menghasilkanRequestError.PAGE_SIZE_NOT_SUPPORTED
{i>error<i}.
Belanja
- Menambahkan laporan baru
shopping_product
, yang sesuai dengan halaman Produk di UI Google Ads. Metode ini mendukung pengembalian data yang terkait dengan status produk saat ini dari Google Merchant Center akun yang tertaut ke akun Google Ads.- Anda dapat memfilter metrik dari
shopping_product
laporkan menggunakansegments.date
saat menggunakanGoogleAdsService.Search
atauGoogleAdsService.SearchStream
. Segmentasi menurut tanggal tidak diizinkan dan akan menampilkanShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
{i>error<i}.
- Anda dapat memfilter metrik dari
Sasaran Terpadu
- Menambahkan
UserListCustomerTypeService.MutateUserListCustomerTypes()
untuk mengonfigurasi pelanggan audiens khusus. CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
dihapus. Untuk mengonfigurasi setelan audiens sasaran siklus proses pelanggan, gunakan Sebagai gantinya,UserListCustomerTypeService.MutateUserListCustomerTypes()
.- Melampirkan atau membatalkan lampiran daftar pengguna dengan menetapkan
UserListCustomerType.customer_type_category
dapatUserListCustomerTypeCategory.PURCHASERS
untuk menyertakannya ke dalam atau mengecualikannya dari definisi pelanggan lama untuk masing-masing sasaran siklus proses pelanggan. Kunjungi menyegmentasikan audiens untuk mengetahui detail selengkapnya.
- Melampirkan atau membatalkan 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
. - (Hanya akun yang diizinkan) Dibuat
Campaign.video_brand_safety_suitability
dapat berubah.
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 seorang pelanggan hingga 1.000.
Kampanye
- Dukungan untuk menampilkan Target
Simulasi bid kampanye 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 SKAdNetwork 4,0 baru.- Menambahkan dukungan untuk peringatan bagi
CustomerSkAdNetworkConversionValueSchemaService
sebagaiMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Jika ditetapkan ketrue
, error non-pemblokiran yang terkait dengan kegagalan operasi akan dikembalikan 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
.
Layanan Lokal
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 menghasilkan URL yang bisa digunakan untuk mengunduh konten lampiran.
Video
customer.video_brand_safety_suitability
danBrandSafetySuitability
yang mendukung pengambilan kesesuaian keamanan merek video kepada pelanggan level organisasi.- 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
. data_partner
dangoogle_ads
dihapus dariAccountLink
- Ditambahkan
IdentityVerificationService
ke mengelola verifikasi pengiklan.StartIdentityVerification()
digunakan untuk memulai sesi verifikasi menggunakanverification_program
. Metode ini membuat sesi verifikasi baru dan menampilkan respons kosong untuk berhasil membuat verifikasi.GetIdentityVerification()
dapat digunakan untuk mengambil informasi verifikasi, yang mengembalikan beberapa objekIdentityVerification
. SetiapIdentityVerification
mencakup:verification_program
yang merupakan jenis program verifikasi identitasidentity_verification_requirement
yang berisi detail yang terkait dengan tenggat waktu ketika pengiklan sebaiknya menyelesaikan verifikasiverification_progress
yang berisi detail terkait sesi verifikasi, termasuk:program_status
merepresentasikan status terkini sesi verifikasiaction_url
mengarahkan pelanggan ke URL untuk menyelesaikan verifikasi.invitation_link_expiration_time
menunjukkan tanggal habis masa berlaku untukaction_url
- Enum:
- Kesalahan:
- Ditambahkan
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 segmentasi sumber daya.
- Menambahkan dukungan untuk segmen terkait waktu, seperti
Kampanye
- Perubahan pada kampanye Peningkat Permintaan:
- Menambahkan dukungan untuk setelan
Campaign.shopping_setting
ke kampanye Peningkat Permintaan yang sudah ada. - Ditambahkan
ShoppingSetting.disable_product_feed
untuk menonaktifkan feed produk opsional di kampanye Peningkat Permintaan. - Menambahkan
Ad.demand_gen_product_ad
dan modelDemandGenProductAdInfo
, tersedia untuk Kampanye Peningkat Permintaan dengan nilai non-nullCampaign.shopping_setting
.
- Menambahkan dukungan untuk setelan
- Ditambahkan ke kolom berikut ke
AdGroup
untuk menunjukkan apakah grup iklan ditayangkan atau alasan mengapa grup iklan tidak ditayangkan:primary_status
primary_status_reasons
- Ditambahkan ke kolom berikut ke
AdGroupAd
untuk ditampilkan apakah iklan grup iklan ditayangkan atau alasan mengapa 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
ke menentukan apakah sinkronisasi harus diaktifkan dalam eksperimen. Dengan sinkronisasi diaktifkan, perubahan yang dibuat pada kampanye asli saat eksperimen berjalan, secara otomatis disalin ke kampanye eksperimen. - Ditambahkan
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
- Ditambahkan
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
Hotel & Bepergian
- Kolom berikut ditambahkan ke
ListingDimensionInfo
untuk Rekomendasi aktivitas iklan untuk memungkinkan pembuatan grup listingan berdasarkan negara bagian dan kota tempat aktivitas perjalanan tersedia: - Menambahkan dukungan untuk segmen berikut ke
travel_activity_performance_view
:
Layanan Lokal
- Ditambahkan
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
danBusinessRegistrationCheckArtifact
agar pengiklan dapat memantau progres pendaftaran bisnis proses verifikasi Anda. - Resource baru ditambahkan
local_services_employee
untuk mengizinkan pengiklan untuk mengambil informasi karyawan yang telah mereka tambahkan.
Perencanaan
score
dihapus dariAudienceInsightsAttributeMetadata
.
Rekomendasi
- Ditambahkan
RecommendationService.GenerateRecommendations()
yang menampilkan rekomendasi berdasarkan setelan tertentu, seperti jenis rekomendasi dan jenis saluran iklan. Hal ini sangat membantu selama pembuatan kampanye. - Ditambahkan
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 untuk ikut serta dalam bidding Maksimalkan nilai konversi strategiIMPROVE_GOOGLE_TAG_COVERAGE
yang merekomendasikan penerapan Tag Google di lebih banyak halamanPERFORMANCE_MAX_FINAL_URL_OPT_IN
yang merekomendasikan agar Anda mengaktifkan perluasan URL final untuk Performa Maksimal promosiREFRESH_CUSTOMER_MATCH_LIST
yang merekomendasikan untuk memperbarui daftar pelanggan yang belum diperbarui di 90 hari terakhirCUSTOM_AUDIENCE_OPT_IN
yang merekomendasikan pembuatan audiens kustomLEAD_FORM_ASSET
yang merekomendasikan penambahan aset formulir prospek di kampanye atau pelanggan tingkatIMPROVE_DEMAND_GEN_AD_STRENGTH
yang merekomendasikan untuk meningkatkan daya iklan di kampanye Peningkat Permintaan
Belanja
- Ditambahkan
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
danCampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
guna menampilkan error yang lebih mendetail untuk kampanye Shopping yang ditautkan ke Comparison Shopping Service Center akun. - 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
update
ditambahkan 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 akun yang tidak sah
aktivitas ini,
customer.status
dancustomer_client.status
sekarang dikembalikan sebagaiSUSPENDED
. Sebelumnya, mereka ditampilkan sebagaiENABLED
- Menambahkan dukungan untuk menambahkan dan menghapus penautan antara akun Google Ads dan
akun Merchant Center:
- Ditambahkan
ProductLink.merchant_center
danMerchantCenterIdentifier
. - Ditambahkan
LinkedProductType.MERCHANT_CENTER
- Ditambahkan
- Ditambahkan
ProductLinkInvitationService
danProductLinkInvitation
untuk mendukung memperbarui undangan penautan yang dikirim dari produk lain, tersedia untuk Hotel Center dan Penjual Pusat akun. 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
ImageAdInfo.media_file
diganti denganImageAdInfo.image_asset
untuk didukung menambahkan dan menghapus gambar menggunakan aset. Akibatnya, kami juga menghapusMediaFileService
, yang tidak lagi diperlukan.- Ditambahkan
ListingGroupFilterDimension.webpage
untuk mendukung pembuatan filter grup listingan berdasarkan URL dan label khusus {i>substring<i}.- Juga mengganti
AssetGroupListingGroupFilter.vertical
denganAssetGroupListingGroupFilter.listing_source
danListingGroupFilterListingSource
- Juga mengganti
- Menambahkan
asset_group_asset.source
untuk menampilkan sumber aset grup aset. - Ditambahkan
ad_group_ad_asset_view.source
ke menampilkan sumber aset iklan grup iklan.
Audiens
- Untuk Customer Match, ditambahkan
CustomerMatchUserListMetadata.consent
untuk mendukung pemberian izin. Mulai 6 Maret 2024 jika izin ditetapkan tidak ada untuk pengguna EEA, nilai izin ditentukan sebagai tidak ada izin. Data dari pengguna EEA tanpa izin cookie tidak akan diproses dan tidak dapat digunakan untuk iklan personalisasi menggunakan Customer Match. Kunjungi Panduan Customer Match untuk mengetahui detail selengkapnya. - Untuk Penjualan Toko, menambahkan
UserData.consent
ke dukungan yang memberikan izin. Kunjungi Panduan Penjualan Toko untuk secara lebih mendetail. Jika Anda menggunakan Customer Match dengan penjualan toko, tinjau FAQ untuk mengetahui tidak akurat atau tidak sesuai. - Ditambahkan
UserList.lookalike_user_list
ke dukungan pembuatan Tampilan mirip segmen, audiens yang dibuat berdasarkan audiens awal yang sudah ada. Segmen mirip dapat digunakan di kampanye Peningkat Permintaan saja.
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
- Ditambahkan
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
.
- Ditambahkan
- Ditambahkan
AssetGroupSignalOperation.exempt_policy_violation_keys
untuk mendukung permintaan pengecualian saat menambahkan sinyal grup aset. - Telah menambahkan yang baru
asset_group_top_combination_view
untuk melaporkan aset berperforma terbaik di tingkat grup aset. asset_group
sekarang dapat dikueri dengan kolom metrik untuk mendukung pengambilan performa kampanye Performa Maksimal.- Di beberapa
PerformanceMaxUpgradeStatus
, mengganti namaUPGRADE_ELIGIBLE
menjadiUPGRADE_ELIGIBLE
.
Untuk Peningkat Permintaan dan Penemuan Kampanye Target CPA, simulasi bid Target CPA tingkat kampanye (
campaign_simulation.target_cpa_point_list.points
) sekarang menampilkanTargetCpaSimulationPoint.interactions
bukannyaTargetCpaSimulationPoint.clicks
.Menambahkan
BrandSuggestionService
yang dapat sarankan merek berdasarkan awalan merek yang diberikan dan daftar yang dikecualikan perusahaan. Merek-merek ini dapat digunakan untuk membuat KriteriaBRAND
, ditambahkan keBRANDS
kumpulan bersama, lalu disertakan ke kampanye dengan membuatCampaignCriterion
denganbrand_list
disetel ke kumpulan bersama. Kriteria kampanye dapat ditargetkan di kampanye Penelusuran dan dikecualikan di Kampanye Performa Maksimal.Ditambahkan
Campaign.asset_automation_settings[]
untuk menampilkan status otomatisasi setiap jenis aset.Menambahkan nilai berikut ke
CampaignPrimaryStatusReason
enum:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Konversi
- Menambahkan
CallConversion.consent
danClickConversion.consent
untuk mendukung memberikan izin. Kunjungi panduan konversi panggilan dan klik panduan konversi untuk mengetahui spesifikasi pendukung. - Menambahkan kolom berikut yang terkait dengan
SKAdNetwork
konversi, yang tersedia saat mengkuerinya 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 ini untuk mendapatkan detail tentang status upload konversi yang berguna seperti jumlah peristiwa yang berhasil, tingkat keberhasilan, dan persentase error.- Peringatan: Konversi yang diupload, tetapi menghasilkan
ConversionUploadError.CLICK_NOT_FOUND
kesalahan tetap dihitung sebagai berhasil, tetapi juga ditandai sebagaiOfflineConversionAlert
- Peringatan: Konversi yang diupload, tetapi menghasilkan
- Menambahkan
job_id
sebagai parameter opsional untuk jenis permintaan berikut sehingga secara logis, Anda dapat mengelompokkan beberapa permintaan upload menjadi satu pekerjaan: - Menambahkan
INVALID_JOB_ID
ke error berikut: INVALID_CONVERSION_ACTION
diganti denganNO_CONVERSION_ACTION_FOUND
danINVALID_CONVERSION_ACTION_TYPE
dalam error berikut:
- Memindahkan
- Menambahkan tiga laporan untuk mendukung Android Privacy Sandbox Lintas Jaringan
atribusi 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.
- Ditambahkan
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
ConversionActionOperation
yang mencoba menggunakan salah satu atribusi berbasis aturan yang tidak digunakan lagi Anda sekarang gagal dengan error ini. Sebelumnya, operasi akan gagal denganUNKNOWN
error.
Hotel & Bepergian
- 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 kolom ke laporancustomer
untuk menampilkan Status asuransi dan lisensi terperinci pengiklan layanan. - Menambahkan laporan baru berikut untuk laporan Local
Layanan:
local_services_lead
berisi semua detail yang berkaitan dengan Jasa dan Servis Prospek Google Ads 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 pelanggan target dan akun pengelolanya.
local_services_verification_artifact
menampilkan artefak pengiklan Jasa dan Servis seperti pemeriksaan latar belakang, izin usaha, 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 pengembalian
PlannableTargeting.surface_targeting
untukReachPlanService.ListPlannableProducts
, yang menjelaskan platform yang tersedia untuk suatu produk. - Telah menambahkan yang baru
Enum
ReachPlanSurface
. - Menambahkan dukungan untuk penargetan Target
frekuensi menggunakan
AdvancedProductTargeting.target_frequency_settings
, yang mengembalikanPlannedProductForecast.average_frequency
- Ditambahkan
AudienceInsightsService.GenerateSuggestedTargetingInsights
untuk menampilkan audiens target yang disarankan. - Menambahkan nilai berikut ke
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
Rekomendasi
- Ditambahkan
RecommendationSubscriptionService
yang mengelola langganan rekomendasi:- Referensi:
RecommendationSubscription
- {i>Field<i} (Bidang isian):
MutateOperation.recommendation_subscription_operation
- Enum:
ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
- Kesalahan:
- Referensi:
- Menambahkan jenis rekomendasi berikut:
FORECASTING_SET_TARGET_CPA
yang merekomendasikan penetapan target CPA untuk kampanye yang belum memilikinya ditentukan, sebelum peristiwa musiman yang diperkirakan akan meningkat kemacetan.SET_TARGET_CPA
yang merekomendasikan penetapan target CPA untuk kampanye yang belum memilikinya yang ditentukan.SET_TARGET_ROAS
yang merekomendasikan penetapan target ROAS untuk kampanye yang belum memilikinya yang ditentukan.
Pelaporan
- Menambahkan metrik baru berikut, yang dapat dikueri dengan
campaign
(tersedia untuk Display, Video, Discovery, dan kampanye Aplikasi) dansegments.device
:
Belanja
- Menghapus
ShoppingSetting.sales_country
, yang nilainya kini ditampilkan sebagaiShoppingSetting.feed_label
.- Anda dapat terus menggunakan Merchant Center tertentu
feed untuk kampanye dengan menggunakan
tindakan
ShoppingSetting.feed_label
kolom tersebut. Nilai ini harus ditetapkan ke nilai label feed atau kode negara dua huruf kode yang sebelumnya digunakan untukShoppingSetting.sales_country
. Untuk detail selengkapnya, lihat artikel dukungan untuk feed label.
- Anda dapat terus menggunakan Merchant Center tertentu
feed untuk kampanye dengan menggunakan
tindakan
- 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
product_bidding_category_constant
diganti 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
untuk Menelusuri kampanye. Mencoba membuat kampanye Penelusuran denganCampaign.shopping_setting
atau tambahkanCampaign.shopping_setting
ke kampanye Penelusuran yang ada kini menghasilkanOPERATION_NOT_PERMITTED_FOR_CONTEXT
- Menghapus dukungan untuk menambahkan
CampaignCriterion.listing_scope
pada kampanye Penelusuran. Mencoba menambahkanCampaignCriterion.listing_scope
ke kampanye Penelusuran yang ada kini menghasilkanOPERATION_NOT_PERMITTED_FOR_CONTEXT
. - Konversi berikutnya dengan keranjang ditambahkan
metrik data:
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
- Ditambahkan
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
untuk mengonfigurasi sasaran akuisisi pelanggan di tingkat pelanggan.- Laporan:
customer_lifecycle_goal
- Laporan:
- Ditambahkan
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
untuk mengonfigurasi sasaran akuisisi pelanggan di tingkat kampanye.- Laporan:
campaign_lifecycle_goal
- Laporan:
- Ditambahkan
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:
- Ditambahkan
NetworkSettings.target_google_tv_network
- Ditambahkan
AdNetworkType.GOOGLE_TV
- Ditambahkan
- Menambahkan dukungan untuk menargetkan YouTube di tingkat kampanye:
- Ditambahkan
NetworkSettings.target_youtube
- Di
AdNetworkType
, digabungkanYOUTUBE_WATCH
danYOUTUBE_SEARCH
keYOUTUBE
. - Ditambahkan
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
- Ditambahkan
Arsip catatan rilis
Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.