Catatan Rilis

v17 (05-06-2024)

Fitur dan perubahan berikut ditambahkan di v17.

Iklan

• AdService.getAd dihapus. Tindakan ini menjadikan AdService 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:
  • 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

• Menambahkan BatchJobError.REQUEST_TOO_LARGE, yang akan ditampilkan saat AddBatchJobOperationsRequest yang dikirimkan lebih besar dari 10484504 byte.
• Menambahkan dukungan untuk menyetel MutateOperation.asset_group_operation saat menggunakan BatchJobService. 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 menjadi AdvertisingChannelType.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 menjadi segments.sk_ad_network_fine_conversion_value.
  • Menambahkan segments.sk_ad_network_redistributed_fine_conversion_value.
• Metrik berikut kini ditampilkan dengan respons meskipun bernilai 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 ditayangkan:
  • primary_status
  • primary_status_reasons
• Menambahkan dukungan metrics.search_impression_share untuk gender_view
• Menambahkan dukungan metrics.phone_calls untuk keyword_view

Jasa dan Servis

• Menambahkan LocalServicesLeadService.AppendLeadConversation() yang digunakan untuk menambahkan LocalServicesLeadConversation baru ke LocalServicesLead, 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 dengan lead_type yang ditetapkan ke LeadType.MESSAGE yang dapat ditentukan di Conversation.local_services_lead.
• Menambahkan nilai enum baru ke ConversationType:
  • WHATSAPP untuk mewakili percakapan yang diperkenalkan melalui WhatsApp.
  • ADS_API untuk merepresentasikan percakapan yang diperkenalkan menggunakan metode LocalServicesLeadService.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 menampilkan 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 error RequestError.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 menggunakan segments.date saat menggunakan GoogleAdsService.Search atau GoogleAdsService.SearchStream. Segmentasi menurut tanggal tidak diizinkan dan akan menampilkan error ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

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, gunakan UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Lampirkan atau batalkan lampiran daftar pengguna dengan menetapkan UserListCustomerType.customer_type_category ke UserListCustomerTypeCategory.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.

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.
• (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 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 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 sebagai MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Jika ditetapkan ke true, error non-pemblokiran yang terkait dengan kegagalan operasi akan ditampilkan 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.

Jasa dan Servis

• 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 menampilkan URL yang dapat digunakan untuk mendownload konten lampiran.

Video

• customer.video_brand_safety_suitability dan BrandSafetySuitability 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 dari AccountLink ke ProductLink dan ProductLinkInvitation.
• Menghapus data_partner dan google_ads dari AccountLink.
• Menambahkan IdentityVerificationService untuk mengelola verifikasi pengiklan.
  • StartIdentityVerification() digunakan untuk memulai sesi verifikasi menggunakan verification_program yang disediakan. Tindakan ini akan membuat sesi verifikasi baru dan menampilkan respons kosong untuk verifikasi yang berhasil dibuat.
    • Menambahkan IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
  • GetIdentityVerification() dapat digunakan untuk mengambil informasi verifikasi, yang menampilkan beberapa objek IdentityVerification. Setiap IdentityVerification mencakup:
    • verification_program yang merupakan jenis program verifikasi identitas
    • identity_verification_requirement yang berisi detail terkait batas waktu bagi pengiklan harus menyelesaikan verifikasi
    • verification_progress yang berisi detail terkait sesi verifikasi, termasuk:
      • program_status mewakili status sesi verifikasi saat ini
      • action_url mengarahkan pelanggan ke URL untuk menyelesaikan verifikasi.
      • invitation_link_expiration_time menunjukkan tanggal habis masa berlaku untuk action_url
  • Enum:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Error:
    • IdentityVerificationError
• Menambahkan 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 menyegmentasikan resource.

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

Jasa dan Servis

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

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

Shopping

• Menambahkan CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT dan CampaignError.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 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 aktivitas akun yang tidak sah, customer.status dan customer_client.status kini ditampilkan sebagai SUSPENDED. Sebelumnya, keduanya ditampilkan sebagai ENABLED.
• Menambahkan dukungan untuk menambahkan dan menghapus penautan antara akun Google Ads dan akun Merchant Center:
  • Menambahkan ProductLink.merchant_center dan MerchantCenterIdentifier.
  • Menambahkan LinkedProductType.MERCHANT_CENTER.
• Menambahkan ProductLinkInvitationService dan ProductLinkInvitation 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 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

• Mengganti ImageAdInfo.media_file dengan ImageAdInfo.image_asset untuk mendukung penambahan dan penghapusan gambar menggunakan aset. Akibatnya, kami juga menghapus MediaFileService, yang tidak lagi diperlukan.
• Menambahkan ListingGroupFilterDimension.webpage untuk mendukung pembuatan filter grup listingan berdasarkan label kustom dan substring URL.
  • Juga mengganti AssetGroupListingGroupFilter.vertical dengan AssetGroupListingGroupFilter.listing_source dan ListingGroupFilterListingSource
• 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 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
      • Menambahkan 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.
  • 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 nama UPGRADE_ELIGIBLE menjadi UPGRADE_ELIGIBLE.

• Untuk kampanye Target CPA Peningkat Permintaan dan Discovery, simulasi bid Target CPA tingkat kampanye (campaign_simulation.target_cpa_point_list.points) kini menampilkan TargetCpaSimulationPoint.interactions, bukan TargetCpaSimulationPoint.clicks.

• Menambahkan BrandSuggestionService yang dapat menyarankan merek berdasarkan awalan merek yang diberikan dan daftar merek yang dikecualikan. Merek ini dapat digunakan untuk membuat kriteria BRAND, ditambahkan ke kumpulan bersama BRANDS, lalu disertakan ke kampanye dengan membuat CampaignCriterion dengan brand_list ditetapkan 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

• 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 dan ClickConversion.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 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 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 sebagai OfflineConversionAlert.
  • Menambahkan job_id sebagai parameter opsional untuk jenis permintaan berikut sehingga Anda dapat secara logis mengelompokkan beberapa permintaan upload ke dalam satu tugas konseptual:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • Menambahkan INVALID_JOB_ID ke error berikut:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • Mengganti INVALID_CONVERSION_ACTION dengan NO_CONVERSION_ACTION_FOUND dan INVALID_CONVERSION_ACTION_TYPE pada error berikut:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Menambahkan tiga laporan untuk mendukung atribusi Lintas jaringan Android Privacy Sandbox 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.
• 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 error UNKNOWN.

Hotel & Perjalanan

• 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 kolomnya ke laporan customer 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 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 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.
    • 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 menampilkan PlannableTargeting.surface_targeting untuk ReachPlanService.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 menampilkan PlannedProductForecast.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:
  • Referensi: RecommendationSubscription
  • Kolom: MutateOperation.recommendation_subscription_operation
  • Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Error:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 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) serta segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Shopping

• Menghapus ShoppingSetting.sales_country, yang nilainya kini ditampilkan sebagai ShoppingSetting.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 untuk ShoppingSetting.sales_country. Untuk detail selengkapnya, lihat artikel dukungan untuk label feed.
• 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
  • Mengganti product_bidding_category_constant 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 ke kampanye Penelusuran. Mencoba membuat kampanye Penelusuran dengan Campaign.shopping_setting atau menambahkan Campaign.shopping_setting ke kampanye Penelusuran yang ada sekarang akan menghasilkan OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Menghapus dukungan untuk menambahkan CampaignCriterion.listing_scope ke kampanye Penelusuran. Mencoba menambahkan CampaignCriterion.listing_scope ke kampanye Penelusuran yang ada sekarang akan menghasilkan OPERATION_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:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Sasaran Terpadu

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

Arsip catatan rilis

Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.