Catatan Rilis

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.

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:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

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 berdasarkan segments.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:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type yang memungkinkan Anda menyegmentasikan laporan berikut berdasarkan jenis format iklan video:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05-06-2024)

Fitur dan perubahan berikut ditambahkan di v17.

Iklan

• AdService.getAd dihapus. Hal ini menjadikan AdService 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:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Aset

• Menambahkan enum baru: ClickType.AD_IMAGE
• Menambahkan laporan baru berikut dengan metrik baru untuk kampanye Performa Maksimal dan Penelusuran:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Audiens

• Menambahkan OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Tugas Batch

• Ditambahkan BatchJobError.REQUEST_TOO_LARGE, yang akan ditampilkan saat AddBatchJobOperationsRequest yang dikirimkan lebih besar dari 10484504 byte.
• Menambahkan dukungan untuk setelan MutateOperation.asset_group_operation saat menggunakan BatchJobService. 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 menjadi AdvertisingChannelType.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 menjadi segments.sk_ad_network_fine_conversion_value.
  • Menambahkan segments.sk_ad_network_redistributed_fine_conversion_value.
• Metrik berikut sekarang ditampilkan dengan respons bahkan ketika mereka adalah nol. Hal ini membuatnya konsisten dengan metrik lainnya.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

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 untuk gender_view
• Menambahkan dukungan untuk metrics.phone_calls untuk keyword_view

Layanan Lokal

• Menambahkan LocalServicesLeadService.AppendLeadConversation() digunakan untuk menambahkan LocalServicesLeadConversation ke LocalServicesLead, yang mengirimkan kepada pengguna melalui saluran yang sesuai seperti SMS tergantung pada bagaimana prospek dibuat.
  • Ukuran AppendLeadConversationRequest.conversations dibatasi menjadi 1.000.
  • Hanya LocalServicesLead dengan lead_type ditetapkan ke LeadType.MESSAGE dapat ditentukan dalam Conversation.local_services_lead.
• Menambahkan nilai enum baru ke ConversationType:
  • WHATSAPP untuk mewakili percakapan yang diperkenalkan melalui WhatsApp.
  • ADS_API untuk mewakili percakapan yang diperkenalkan menggunakan LocalServicesLeadService.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 melempar QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Misalnya, product_link.advertising_partner.customer dan product_link.data_partner.data_partner_id tidak dapat dipilih dalam kueri yang sama.
• Meneruskan page_size ke GoogleAdsService.Search akan menghasilkan RequestError.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 menggunakan segments.date saat menggunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream. Segmentasi menurut tanggal tidak diizinkan dan akan menampilkan ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION {i>error<i}.

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 dapat UserListCustomerTypeCategory.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.

Video

• Menambahkan nilai berikut ke ContentLabelType Anda dapat mengecualikan ContentLabelTypes 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 membuat DemandGenVideoResponsiveAdInfo.
• (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 dan asset_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 sebagai MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Jika ditetapkan ke true, error non-pemblokiran yang terkait dengan kegagalan operasi akan dikembalikan sebagai MutateCustomerSkAdNetworkConversionValueSchemaResponse.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 dan local_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 dan BrandSafetySuitability 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 dari AccountLink ke ProductLink dan ProductLinkInvitation.
• data_partner dan google_ads dihapus dari AccountLink
• Ditambahkan IdentityVerificationService ke mengelola verifikasi pengiklan.
  • StartIdentityVerification() digunakan untuk memulai sesi verifikasi menggunakan verification_program. Metode ini membuat sesi verifikasi baru dan menampilkan respons kosong untuk berhasil membuat verifikasi.
    • Ditambahkan IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() dapat digunakan untuk mengambil informasi verifikasi, yang mengembalikan beberapa objek IdentityVerification. Setiap IdentityVerification mencakup:
    • verification_program yang merupakan jenis program verifikasi identitas
    • identity_verification_requirement yang berisi detail yang terkait dengan tenggat waktu ketika pengiklan sebaiknya menyelesaikan verifikasi
    • verification_progress yang berisi detail terkait sesi verifikasi, termasuk:
      • program_status merepresentasikan status terkini sesi verifikasi
      • action_url mengarahkan pelanggan ke URL untuk menyelesaikan verifikasi.
      • invitation_link_expiration_time menunjukkan tanggal habis masa berlaku untuk action_url
  • Enum:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Kesalahan:
    • IdentityVerificationError
• Ditambahkan AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

Aset

• Perubahan pada asset_group:
  • Menambahkan dukungan untuk segmen terkait waktu, seperti segments.year dan segments.month.
  • Membuat campaign sebagai resource yang diatribusikan, bukan segmentasi sumber daya.

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 model DemandGenProductAdInfo, tersedia untuk Kampanye Peningkat Permintaan dengan nilai non-null Campaign.shopping_setting.
• 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:
  • activity_state
  • activity_city
• Menambahkan dukungan untuk segmen berikut ke travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Layanan Lokal

• Ditambahkan LocalServicesVerificationArtifact.business_registration_check_verification_artifact dan BusinessRegistrationCheckArtifact 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 dari AudienceInsightsAttributeMetadata.

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 ke UNSPECIFIED, bukan UNKNOWN.
• Menambahkan jenis rekomendasi berikut:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN yang merekomendasikan untuk ikut serta dalam bidding Maksimalkan nilai konversi strategi
  • IMPROVE_GOOGLE_TAG_COVERAGE yang merekomendasikan penerapan Tag Google di lebih banyak halaman
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN yang merekomendasikan agar Anda mengaktifkan perluasan URL final untuk Performa Maksimal promosi
  • REFRESH_CUSTOMER_MATCH_LIST yang merekomendasikan untuk memperbarui daftar pelanggan yang belum diperbarui di 90 hari terakhir
  • CUSTOM_AUDIENCE_OPT_IN yang merekomendasikan pembuatan audiens kustom
  • LEAD_FORM_ASSET yang merekomendasikan penambahan aset formulir prospek di kampanye atau pelanggan tingkat
  • IMPROVE_DEMAND_GEN_AD_STRENGTH yang merekomendasikan untuk meningkatkan daya iklan di kampanye Peningkat Permintaan

Belanja

• Ditambahkan CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT dan CampaignError.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 ke CustomerLifecycleGoalOperation dan CampaignLifecycleGoalOperation 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 dan customer_client.status sekarang dikembalikan sebagai SUSPENDED. Sebelumnya, mereka ditampilkan sebagai ENABLED
• Menambahkan dukungan untuk menambahkan dan menghapus penautan antara akun Google Ads dan akun Merchant Center:
  • Ditambahkan ProductLink.merchant_center dan MerchantCenterIdentifier.
  • Ditambahkan LinkedProductType.MERCHANT_CENTER
• Ditambahkan ProductLinkInvitationService dan ProductLinkInvitation 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 dan ProductLinkService.
• Menghapus AccountLink.hotel_center dan dukungan untuk memperbarui undangan penautan dari akun Pusat Pengelolaan Hotel menggunakan AccountLinkService.
  • Untuk memperbarui undangan penautan dari akun Pusat Pengelolaan Hotel, gunakan ProductLinkInvitationService

Aset

• ImageAdInfo.media_file diganti dengan ImageAdInfo.image_asset untuk didukung menambahkan dan menghapus gambar menggunakan aset. Akibatnya, kami juga menghapus MediaFileService, 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 dengan AssetGroupListingGroupFilter.listing_source dan ListingGroupFilterListingSource
• 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 dan Audience.asset_group untuk membatasi penggunaan audiens ke grup aset tertentu. Audience.asset_group harus ditetapkan jika dan hanya jika Audience.scope adalah ASSET_GROUP.
    • 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 membuat AssetGroupSignal dengan mengisi AssetGroupSignal.search_theme dengan kriteria SearchThemeInfo.
  • 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 nama UPGRADE_ELIGIBLE menjadi UPGRADE_ELIGIBLE.

• Untuk Peningkat Permintaan dan Penemuan Kampanye Target CPA, simulasi bid Target CPA tingkat kampanye (campaign_simulation.target_cpa_point_list.points) sekarang menampilkan TargetCpaSimulationPoint.interactions bukannya TargetCpaSimulationPoint.clicks.

• Menambahkan BrandSuggestionService yang dapat sarankan merek berdasarkan awalan merek yang diberikan dan daftar yang dikecualikan perusahaan. Merek-merek ini dapat digunakan untuk membuat Kriteria BRAND, ditambahkan ke BRANDS kumpulan bersama, lalu disertakan ke kampanye dengan membuat CampaignCriterion dengan brand_list disetel ke kumpulan bersama. Kriteria kampanye dapat ditargetkan di kampanye Penelusuran dan dikecualikan di Kampanye Performa Maksimal.

  • Kolom:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enum:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 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 dan ClickConversion.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 atau campaign:
  • Segmen:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Metrik:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions diganti dengan metrics.sk_ad_network_installs.
• Menambahkan dukungan untuk mendiagnosis upload konversi offline
  • Memindahkan offline_conversion_upload_client_summary dari kolom di resource customer 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 sebagai OfflineConversionAlert
  • Menambahkan job_id sebagai parameter opsional untuk jenis permintaan berikut sehingga secara logis, Anda dapat mengelompokkan beberapa permintaan upload menjadi satu pekerjaan:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • Menambahkan INVALID_JOB_ID ke error berikut:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • INVALID_CONVERSION_ACTION diganti dengan NO_CONVERSION_ACTION_FOUND dan INVALID_CONVERSION_ACTION_TYPE dalam error berikut:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Menambahkan tiga laporan untuk mendukung Android Privacy Sandbox Lintas Jaringan atribusi tanpa pengalihan:
  • android_privacy_shared_key_google_campaign yang berisi shared_campaign_key dan beberapa kolom yang membantu mengenkode kunci.
  • android_privacy_shared_key_google_ad_group yang berisi shared_ad_group_key dan beberapa kolom yang membantu mengenkode kunci.
  • android_privacy_shared_key_google_network_type yang berisi shared_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 dengan UNKNOWN error.

Hotel & Bepergian

• Menambahkan dukungan untuk kolom berikut di travel_activity_group_view dan travel_activity_performance_view:
  • Segmen:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 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 laporan customer 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 seperti lead_charged, lead_type, lead_status.
    • Enum:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation berisi detail pesan dan percakapan telepon seperti conversation_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.
    • Enum:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Perencanaan

• Menambahkan dukungan untuk menampilkan Forecast.views dan PlannedProductForecast.views untuk ReachPlanService.ListPlannableProducts untuk jenis produk yang berlaku.
• Menambahkan dukungan untuk pengembalian PlannableTargeting.surface_targeting untuk ReachPlanService.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 mengembalikan PlannedProductForecast.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:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 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) dan segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Belanja

• Menghapus ShoppingSetting.sales_country, yang nilainya kini ditampilkan sebagai ShoppingSetting.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 untuk ShoppingSetting.sales_country. Untuk detail selengkapnya, lihat artikel dukungan untuk feed label.
• 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 dengan segments.product_category_level1
    • segments.product_bidding_category_level2 dengan segments.product_category_level2
    • segments.product_bidding_category_level3 dengan segments.product_category_level3
    • segments.product_bidding_category_level4 dengan segments.product_category_level4
    • segments.product_bidding_category_level5 dengan segments.product_category_level5
  • product_bidding_category_constant diganti dengan product_category_constant, yang menampilkan semua pelokalan kategori yang tersedia di kolom berulang.
  • ListingDimensionInfo.product_bidding_category diganti dengan ListingDimensionInfo.product_category.
  • ListingGroupFilterDimension.product_bidding_category diganti dengan ListingGroupFilterDimension.product_category.
• Menghapus dukungan untuk menambahkan Campaign.shopping_setting untuk Menelusuri kampanye. Mencoba membuat kampanye Penelusuran dengan Campaign.shopping_setting atau tambahkan Campaign.shopping_setting ke kampanye Penelusuran yang ada kini menghasilkan OPERATION_NOT_PERMITTED_FOR_CONTEXT
• Menghapus dukungan untuk menambahkan CampaignCriterion.listing_scope pada kampanye Penelusuran. Mencoba menambahkan CampaignCriterion.listing_scope ke kampanye Penelusuran yang ada kini menghasilkan OPERATION_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:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Sasaran Terpadu

• Ditambahkan CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals untuk mengonfigurasi sasaran akuisisi pelanggan di tingkat pelanggan.
  • Laporan: customer_lifecycle_goal
• Ditambahkan CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals untuk mengonfigurasi sasaran akuisisi pelanggan di tingkat kampanye.
  • Laporan: campaign_lifecycle_goal
• 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
• Menambahkan dukungan untuk menargetkan YouTube di tingkat kampanye:
  • Ditambahkan NetworkSettings.target_youtube
  • Di AdNetworkType, digabungkan YOUTUBE_WATCH dan YOUTUBE_SEARCH ke YOUTUBE.
  • Ditambahkan CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Arsip catatan rilis

Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.