v16.1.0 (24-04-2024)
Fitur dan perubahan berikut telah 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 hingga
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 untuk
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 telah 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 yang terkait dengan batas waktu bagi pengiklan untuk menyelesaikan verifikasiverification_progress
yang berisi detail terkait sesi verifikasi, termasuk:program_status
merepresentasikan 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
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
- Menambahkan 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 menampilkan 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. Dengan mengaktifkan sinkronisasi, perubahan yang dibuat pada kampanye asli saat eksperimen Anda berjalan, akan 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 guna memungkinkan pembuatan 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
untuk memungkinkan pengiklan memantau progres proses verifikasi pendaftaran bisnis. - Menambahkan resource baru
local_services_employee
untuk memungkinkan pengiklan mengambil informasi karyawan yang telah ditambahkan.
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
yang ditetapkan keUNSPECIFIED
, bukanUNKNOWN
. - Menambahkan jenis rekomendasi berikut:
MAXIMIZE_CONVERSION_VALUE_OPT_IN
yang merekomendasikan untuk ikut serta dalam 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 MaksimalREFRESH_CUSTOMER_MATCH_LIST
yang merekomendasikan untuk memperbarui 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
guna memberikan error yang lebih mendetail untuk 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 di v15.
Pengelolaan Akun
- Jika akun Anda ditangguhkan karena aktivitas akun
yang tidak sah,
customer.status
dancustomer_client.status
kini ditampilkan sebagaiSUSPENDED
. Sebelumnya, parameter tersebut 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 Hotel Center 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 khusus 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 izin tidak ada untuk pengguna EEA, nilai izin ditentukan sebagai tidak diizinkan. Data dari pengguna EEA tanpa izin cookie tidak akan diproses dan tidak dapat digunakan untuk personalisasi iklan menggunakan Customer Match. Lihat panduan Customer Match untuk mengetahui detail selengkapnya. - Untuk Penjualan Toko, menambahkan
UserData.consent
untuk mendukung pemberian izin. Lihat panduan Penjualan Toko untuk mengetahui detail selengkapnya. Jika Anda menggunakan Customer Match dengan penjualan toko, tinjau FAQ untuk mengetahui informasi tambahan. - Menambahkan
UserList.lookalike_user_list
untuk mendukung pembuatan Segmen mirip, audiens yang dibuat berdasarkan audiens inti yang sudah ada yang disediakan. 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 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
yang 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 selengkapnya. - Menambahkan kolom berikut yang terkait dengan konversi
SKAdNetwork, yang tersedia saat membuat kuerinya dengan
customer
ataucampaign
: - Mengganti
metrics.sk_ad_network_conversions
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 yang berguna tentang status upload konversi seperti jumlah peristiwa yang berhasil, tingkat keberhasilan, dan persentase error.- Peringatan: Konversi yang diupload tetapi menghasilkan error
ConversionUploadError.CLICK_NOT_FOUND
masih 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
di error berikut:
- Memindahkan
- Menambahkan tiga laporan untuk mendukung atribusi Lintas jaringan
Privacy Sandbox Android 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 kini 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 lisensi terperinci dan status asuransi pengiklan Jasa dan Servis. - Menambahkan laporan baru berikut untuk Layanan
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 manajernya.
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 saran audiens yang dapat ditargetkan. - 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 ditentukan, sebelum peristiwa musiman yang diperkirakan akan meningkatkan traffic.SET_TARGET_CPA
yang merekomendasikan penetapan target CPA untuk kampanye yang belum menentukan target CPA.SET_TARGET_ROAS
yang merekomendasikan penetapan target ROAS untuk kampanye yang belum ditentukan.
Pelaporan
- Menambahkan metrik baru berikut, yang dapat dikueri dengan
campaign
(tersedia untuk kampanye Display, Video, Discovery, dan Aplikasi) dansegments.device
:
Shopping
- Menghapus
ShoppingSetting.sales_country
, yang nilainya sekarang ditampilkan sebagaiShoppingSetting.feed_label
.- Anda dapat terus menggunakan feed Merchant Center tertentu untuk kampanye menggunakan kolom
ShoppingSetting.feed_label
. Nilai ini 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 menggunakan kolom
- Menghapus ketergantungan 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. - Mengganti
ListingDimensionInfo.product_bidding_category
denganListingDimensionInfo.product_category
. - Mengganti
ListingGroupFilterDimension.product_bidding_category
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 kini 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 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
, menggabungkanYOUTUBE_WATCH
danYOUTUBE_SEARCH
ke dalamYOUTUBE
. - Menambahkan
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Menambahkan
v14.1.0 (09-08-2023)
Fitur dan update baru berikut diperkenalkan di v14.1.
Pengelolaan Akun
Customer.customer_agreement_setting
yang menunjukkan apakah pelanggan telah menyetujui persyaratan layanan formulir prospek
Aset
- Kolom baru di
AssetGroup
untuk menampilkan apakah grup aset ditayangkan atau alasan grup aset tidak ditayangkan:primary_status
primary_status_reasons
- Kolom baru di
AssetGroupAsset
untuk menampilkan apakah aset grup aset ditayangkan atau alasan aset grup tersebut tidak ditayangkan:primary_status
primary_status_details
primary_status_reasons
- Nilai baru dalam enum
CallToActionType
:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
- Nilai baru dalam enum
AssetLinkError
:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
Penagihan
- Kolom baru di
Invoice
danAccountSummary
:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
Kampanye
Nilai baru dalam enum
CampaignPrimaryStatusReason
:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(Khusus akun yang diizinkan)
DiscoveryCampaignSettings
denganupgraded_targeting
:- Jika
upgraded_targeting
ditetapkan ketrue
, Anda dapat menambahkan lokasi dan bahasa sebagai kriteria grup iklan
- Jika
Kriteria
Nilai enum baru:
CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Khusus akun yang diizinkan) Dukungan untuk menambahkan
LanguageInfo
danLocationInfo
sebagaiAdGroupCriterion
:- Ini hanya tersedia untuk kampanye Discovery dengan penargetan yang diupgrade diaktifkan
Eksperimen
- Nilai baru dalam enum
ExperimentError
:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
Rekomendasi
- Jenis rekomendasi baru:
PerformanceMaxOptInRecommendation
yang merekomendasikan pembuatan kampanye Performa Maksimal pertama di akunImprovePerformanceMaxAdStrengthRecommendation
yang merekomendasikan peningkatan daya grup aset dari kampanye Performa MaksimalMigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
yang merekomendasikan migrasi kampanye Iklan Penelusuran Dinamis ke Performa Maksimal
Pelaporan
- Metrik dan segmen baru tentang pelanggan baru versus pelanggan yang kembali:
- Tampilan
customer_search_term_insight
dancampaign_search_term_insight
baru:metrics.search_volume
menampilkan rentang volume untuk kategori insight istilah penelusuran
Shopping
- Kolom baru untuk grup listingan:
- Kolom baru:
ShoppingSetting.advertising_partner_ids
- Nilai baru dalam enum
CampaignError
:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
Video
- (Khusus akun yang diizinkan)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
danDiscoveryVideoResponsiveAdInfo
terkait
v14 (07-06-2023)
Fitur dan update baru berikut diperkenalkan di v14.
Kampanye
Konversi
Menambahkan dukungan untuk mengidentifikasi konversi Google Analytics dan menentukan apakah konversi diimpor dari properti Universal Analytics atau GA4:
- Menambahkan nilai berikut ke
ConversionActionType
:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
- Menambahkan
ConversionAction.google_analytics_4_settings
- Menambahkan nilai berikut ke
Menambahkan
Customer.offline_conversion_client_summaries
, yang merangkum status dan informasi diagnostik upload dan penyesuaian konversi offline pelanggan.- Enum
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- Enum
Menambahkan
job_id
ke respons yang ditampilkan olehConversionAdjustmentUploadService.UploadConversionAdjustments
danConversionUploadService.UploadClickConversions
untuk mengaitkan respons keOfflineConversionUploadSummary.job_id
.
Kriteria
Menambahkan dukungan untuk mengambil, membuat, dan memperbarui kata kunci negatif tingkat akun:
- Kolom:
- Enum:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- Error:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
Menambahkan
CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST
Iklan Hotel
- Mengganti nama
SuggestTravelAssetsRequest.place_id
menjadiSuggestTravelAssetsRequest.place_ids
Perencanaan
- Menghapus metode berikut dari
KeywordPlanService
:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
- Menambahkan
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
untuk mendukung pembuatan metrik perkiraan kampanye kata kunci tanpa perlu membuat rencana kata kunci terlebih dahulu. - Menghapus dukungan untuk mengambil laporan
campaign_criterion_simulation
- Menambahkan dukungan untuk
YOUTUBE_DYNAMIC_LINEUP
sebagai dimensi diAudienceInsightsService.ListAudienceInsightsAttributes
. - Menambahkan
DynamicLineupAttributeMetadata.sample_channels
, yang digunakan dalam responsGenerateAudienceCompositionInsights
untuk menyediakan saluran contoh dalam grup channel.
Rekomendasi
- Menambahkan
DynamicImageExtensionOptInRecommendation
yang merekomendasikan pengaktifan ekstensi gambar dinamis di akun - Menambahkan
LowerTargetRoasRecommendation
yang merekomendasikan untuk menurunkan target ROAS - Menambahkan
RaiseTargetCpaRecommendation
yang merekomendasikan untuk menaikkan target CPA - Menambahkan
ResponsiveSearchAdAssetRecommendation.current_ad
Pelaporan
- Menambahkan nilai berikut ke
ServedAssetFieldType
, yang tersedia dariad_group_ad_asset_view.pinned_field
:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
Arsip catatan rilis
Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.