ลงทะเบียนวันนี้เพื่อเข้าร่วม Performance Max และเวิร์กช็อป Google Ads API ซึ่งจะจัดขึ้นในวันที่ 17 กรกฎาคม

หน้านี้ได้รับการแปลโดย Cloud Translation API

บันทึกประจำรุ่น

v17 (05-06-2024)

เราได้เพิ่มฟีเจอร์และการเปลี่ยนแปลงต่อไปนี้ในเวอร์ชัน 17

โฆษณา

นำ AdService.getAd ออกแล้ว ซึ่งทำให้ AdService สอดคล้องกับบริการอื่นๆ ใน Google Ads API ดูการเรียกข้อมูลออบเจ็กต์สำหรับวิธีที่แนะนำในการดึงโฆษณาและทรัพยากรประเภทอื่นๆ
เพิ่มการตรวจสอบสำหรับ ImageAdInfo.image_asset เกี่ยวกับมิติข้อมูลและรูปแบบเพิ่มเติม อาจมีข้อผิดพลาดต่อไปนี้หากรูปภาพไม่ถูกต้อง
- ImageError.UNEXPECTED_SIZE
- ImageError.FORMAT_NOT_ALLOWED

ชิ้นงาน

เพิ่ม enum ใหม่: ClickType.AD_IMAGE
เพิ่มรายงานใหม่ต่อไปนี้ซึ่งมีเมตริกใหม่สําหรับแคมเปญ Performance Max และ Search
- campaign_aggregate_asset_view
- channel_aggregate_asset_view

กลุ่มเป้าหมาย

เพิ่ม OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED แล้ว

งานแบบกลุ่ม

เพิ่ม BatchJobError.REQUEST_TOO_LARGE แล้ว ซึ่งระบบจะส่งเมื่อ AddBatchJobOperationsRequest ที่ส่งมีขนาดใหญ่กว่า 10484504 ไบต์
เพิ่มการรองรับการตั้งค่า MutateOperation.asset_group_operation เมื่อใช้ BatchJobService วิธีนี้ช่วยให้คุณใช้การประมวลผลแบบกลุ่มเพื่อสร้างและจัดการแคมเปญ Performance Max ทั้งหมดได้ โปรดดูคู่มือเฉพาะฉบับใหม่ของเรา

แคมเปญ

เปลี่ยนชื่อ Discovery เป็น Demand Gen ในทุกช่อง, enum, ข้อผิดพลาดของทรัพยากรทั้งหมดใน Google Ads API เช่น แคมเปญ โฆษณา และชิ้นงาน ตัวอย่างเช่น AdvertisingChannelType.DISCOVERY เปลี่ยนเป็น AdvertisingChannelType.DEMAND_GEN
เพิ่ม Campaign.keyword_match_type เพื่อให้คุณสามารถตั้งค่าประเภทการทำงานของคีย์เวิร์ดสําหรับคีย์เวิร์ดทั้งหมดในแคมเปญ

Conversion

สำหรับ Conversion ของ SKAdNetwork
- เปลี่ยนชื่อ segments.sk_ad_network_conversion_value เป็น segments.sk_ad_network_fine_conversion_value แล้ว
- เพิ่ม segments.sk_ad_network_redistributed_fine_conversion_value แล้ว
ตอนนี้ระบบจะแสดงผลเมตริกต่อไปนี้พร้อมการตอบสนองแม้ว่าจะเป็น 0 ก็ตาม ซึ่งทำให้สอดคล้องกับเมตริกอื่นๆ

เกณฑ์

เพิ่มลงในช่องต่อไปนี้ใน AdGroupCriterion เพื่อแสดงว่าเกณฑ์ของกลุ่มโฆษณากำลังแสดงหรือไม่ หรือเหตุผลที่ไม่แสดงเกณฑ์ดังกล่าว
- primary_status
- primary_status_reasons
เพิ่มการรองรับ metrics.search_impression_share สำหรับ gender_view
เพิ่มการรองรับ metrics.phone_calls สำหรับ keyword_view

บริการในท้องถิ่น

เพิ่ม LocalServicesLeadService.AppendLeadConversation() ใช้เพื่อต่อท้าย LocalServicesLeadConversation ใหม่ลงใน LocalServicesLead ซึ่งจะส่งข้อความให้ผู้ใช้ผ่านช่องทางที่เหมาะสม เช่น SMS โดยขึ้นอยู่กับวิธีสร้างโอกาสในการขาย
- ขนาดของ AppendLeadConversationRequest.conversations จำกัดไว้ที่ 1,000
- ระบุได้เฉพาะ LocalServicesLead ที่ตั้งค่า lead_type เป็น LeadType.MESSAGE ใน Conversation.local_services_lead
เพิ่มค่า enum ใหม่ไปยัง ConversationType แล้ว
- WHATSAPP เพื่อแสดงการสนทนาที่แนะนำผ่าน WhatsApp
- ADS_API เพื่อแสดงการสนทนาที่แนะนำโดยใช้เมธอด LocalServicesLeadService.AppendLeadConversation() ใหม่
เพิ่มช่องใหม่ต่อไปนี้ใน local_services_verification_artifact
- local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
- local_services_verification_artifact.license_verification_artifact.expiration_date_time

การรายงาน

ตอนนี้คุณสามารถเลือกได้เฉพาะช่องที่เกี่ยวข้องกับผลิตภัณฑ์ที่ลิงก์ 1 รายการเมื่อค้นหา product_link การเลือกหลายช่องของผลิตภัณฑ์ที่ลิงก์หลายรายการจะแสดง QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE ตัวอย่างเช่น คุณจะไม่สามารถเลือก product_link.advertising_partner.customer และ product_link.data_partner.data_partner_id ในคำค้นหาเดียวกัน
การส่ง page_size ไปยัง GoogleAdsService.Search จะทำให้เกิดข้อผิดพลาด RequestError.PAGE_SIZE_NOT_SUPPORTED

Shopping

เพิ่มรายงานใหม่ shopping_product ซึ่งสอดคล้องกับหน้าผลิตภัณฑ์ใน UI ของ Google Ads รองรับข้อมูลที่ส่งคืนซึ่งเกี่ยวข้องกับสถานะปัจจุบันของผลิตภัณฑ์จากบัญชี Google Merchant Center ที่ลิงก์กับบัญชี Google Ads
- คุณสามารถกรองเมตริกจากรายงาน shopping_product ได้โดยใช้ segments.date เมื่อใช้ GoogleAdsService.Search หรือ GoogleAdsService.SearchStream ไม่อนุญาตให้แบ่งกลุ่มตามวันที่และจะแสดงผลข้อผิดพลาด ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION

เป้าหมายแบบรวม

เพิ่ม UserListCustomerTypeService.MutateUserListCustomerTypes() เพื่อกำหนดค่าประเภทลูกค้ากลุ่มเป้าหมาย
นำ CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings ออกแล้ว หากต้องการกําหนดการตั้งค่ากลุ่มเป้าหมายของเป้าหมายวงจรของลูกค้า ให้ใช้ UserListCustomerTypeService.MutateUserListCustomerTypes() แทน
- แนบหรือยกเลิกการแนบรายชื่อผู้ใช้โดยการตั้งค่า UserListCustomerType.customer_type_category เป็น UserListCustomerTypeCategory.PURCHASERS เพื่อรวมไว้ในหรือยกเว้นจากคำจำกัดความลูกค้าที่มีอยู่สำหรับเป้าหมายวงจรของลูกค้าตามลำดับ ไปที่แบ่งกลุ่มกลุ่มเป้าหมายเพื่อดูรายละเอียดเพิ่มเติม

วิดีโอ

เพิ่มค่าต่อไปนี้ไปยัง ContentLabelType แล้ว คุณสามารถยกเว้น ContentLabelTypes เหล่านี้ได้ในระดับลูกค้า
- 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
เพิ่ม AdVideoAsset.ad_video_asset_info เพื่อรองรับค่ากำหนดพื้นที่โฆษณาสำหรับชิ้นงานวิดีโอเมื่อสร้าง DemandGenVideoResponsiveAdInfo
(บัญชีในรายการที่อนุญาตเท่านั้น) ทำให้ Campaign.video_brand_safety_suitability เปลี่ยนแปลงได้

v16.1.0 (24-04-2024)

เราได้เพิ่มฟีเจอร์และการเปลี่ยนแปลงต่อไปนี้ใน v16.1

การจัดการบัญชี

CustomerNegativeCriterion.ip_block ซึ่งรองรับการเพิ่ม IP เป็นเกณฑ์เชิงลบในระดับลูกค้า
ค่า enum ใหม่: ProductLinkError.LINK_EXISTS
ค่า enum ใหม่: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION

ชิ้นงาน

การรองรับเนื้อหาที่เกี่ยวข้องกับ Demand Gen กับ ad_group_ad_asset_view และ asset_field_type_view
ค่า enum ใหม่: AssetFieldType.DISCOVERY_CAROUSEL_CARD

กลุ่มเป้าหมาย

ค่า enum ใหม่: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER ซึ่งจำกัดจำนวนรายการผู้ใช้ที่คล้ายกันที่ลูกค้ามีได้จนถึง 1,000 รายการ

แคมเปญ

รองรับการจําลองการเสนอราคาแคมเปญ ROAS เป้าหมายสําหรับ App Campaign โดยใช้รายงาน campaign_simulation
ค่า enum ใหม่: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
ค่า enum ใหม่: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
ค่า enum ใหม่: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS

Conversion

SkAdNetworkConversionValueSchema.postback_mappings ซึ่งรองรับฟีเจอร์ SKAdNetwork 4.0
เพิ่มการรองรับคำเตือนสำหรับ CustomerSkAdNetworkConversionValueSchemaService เป็น MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings เมื่อตั้งค่าเป็น true ระบบจะแสดงผลข้อผิดพลาดแบบไม่บล็อกที่เกี่ยวข้องกับการดำเนินการไม่สำเร็จเป็น MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
ค่า enum ใหม่ใน CustomerSkAdNetworkConversionValueSchemaError
- INVALID_EVENT_COUNTER
- INVALID_EVENT_NAME

เกณฑ์

ช่องใหม่ใน BrandInfo
- display_name
- primary_url
- rejection_reason
- status
enum ใหม่: BrandRequestRejectionReason
ค่า enum ใหม่: CriterionType.LIFE_EVENT

การทดสอบ

ค่า enum ใหม่: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT

บริการในท้องถิ่น

local_services_lead.credit_details.credit_state และ local_services_lead.credit_details.credit_state_last_update_date_time ซึ่งจะแสดงสถานะของเครดิตและการประทับเวลาเมื่อมีการอัปเดตสถานะเครดิตตามลำดับ
local_services_lead_conversation.message_details.attachment_urls ซึ่งแสดง URL ที่ใช้ดาวน์โหลดเนื้อหาของไฟล์แนบได้

วิดีโอ

customer.video_brand_safety_suitability และ BrandSafetySuitability ซึ่งรองรับการดึงข้อมูลความเหมาะสมด้านความปลอดภัยของแบรนด์ของวิดีโอในระดับลูกค้า
ค่า enum ใหม่: VideoCampaignError.MUTATE_REQUIRES_RESERVATION

v16 (21-02-2024)

เราได้เพิ่มฟีเจอร์และการเปลี่ยนแปลงต่อไปนี้ในเวอร์ชัน 16

การจัดการบัญชี

ย้ายข้อมูล advertising_partner จาก AccountLink ไปยัง ProductLink และ ProductLinkInvitation
นำ data_partner และ google_ads ออกจาก AccountLink แล้ว
เพิ่ม IdentityVerificationService เพื่อ จัดการการยืนยันตัวตนผู้ลงโฆษณาแล้ว
- StartIdentityVerification() จะใช้เพื่อเริ่มเซสชันการยืนยันโดยใช้ verification_program ที่ระบุไว้ ซึ่งจะสร้างเซสชันการยืนยันใหม่และส่งคืนการตอบกลับที่ว่างเปล่าสำหรับการยืนยันที่สร้างขึ้นเรียบร้อยแล้ว
  - เพิ่ม IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION แล้ว
- GetIdentityVerification() สามารถใช้ในการเรียกข้อมูลการยืนยัน ซึ่งจะแสดงผลออบเจ็กต์ IdentityVerification หลายรายการ IdentityVerification แต่ละรายการประกอบด้วย
  - verification_program ซึ่งเป็นโปรแกรมการยืนยันตัวตนประเภท
  - identity_verification_requirement ที่มีรายละเอียดเกี่ยวกับกำหนดเวลาที่ผู้ลงโฆษณาควรทำการยืนยันให้เสร็จสิ้น
  - verification_progress ที่มีรายละเอียดเกี่ยวกับเซสชันการยืนยัน ได้แก่
    - program_status แสดงสถานะปัจจุบันของ เซสชันการยืนยันนี้
    - action_url จะนำลูกค้าไปยัง URL เพื่อทำการยืนยันให้เสร็จสมบูรณ์
    - invitation_link_expiration_time คือวันที่หมดอายุ ของ action_url
- Enum:
  - IdentityVerificationProgram
  - IdentityVerificationProgramStatus
- ข้อผิดพลาด:
  - IdentityVerificationError
เพิ่ม AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT แล้ว

ชิ้นงาน

การเปลี่ยนแปลงของ asset_group:
- เพิ่มการรองรับกลุ่มที่เกี่ยวข้องกับเวลา เช่น segments.year และ segments.month
- สร้าง campaign เป็นทรัพยากรที่มีการระบุแหล่งที่มาแทนที่จะเป็นทรัพยากรการแบ่งกลุ่ม

แคมเปญ

การเปลี่ยนแปลงในแคมเปญ Demand Gen
- เพิ่มการรองรับการตั้งค่า Campaign.shopping_setting ในแคมเปญ Demand Gen ที่มีอยู่
- เพิ่ม ShoppingSetting.disable_product_feed เพื่อปิดใช้ฟีดผลิตภัณฑ์ที่ไม่บังคับของแคมเปญ Demand Gen
- เพิ่ม Ad.demand_gen_product_ad และ DemandGenProductAdInfo ที่เกี่ยวข้องซึ่งใช้ได้กับแคมเปญ Demand Gen ที่ไม่มีค่าว่าง Campaign.shopping_setting
เพิ่มลงในช่องต่อไปนี้ใน AdGroup เพื่อแสดงว่ากลุ่มโฆษณานั้นแสดงผลหรือไม่ หรือเหตุผลที่โฆษณาไม่แสดง
- primary_status
- primary_status_reasons
เพิ่มลงในช่องต่อไปนี้ใน AdGroupAd เพื่อแสดงว่าโฆษณาของกลุ่มโฆษณากำลังแสดงหรือไม่หรือเหตุผลที่โฆษณาไม่แสดง
- primary_status
- primary_status_reasons
เพิ่มค่าต่อไปนี้ใน AdGroupError แล้ว
- CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
- INVALID_STATUS

เวอร์ชันทดลอง

เพิ่ม Experiment.sync_enabled เพื่อระบุว่าควรเปิดใช้การซิงค์ในการทดสอบหรือไม่ เมื่อเปิดใช้การซิงค์ ระบบจะคัดลอกการเปลี่ยนแปลงที่ทำกับแคมเปญต้นฉบับขณะที่การทดสอบดำเนินอยู่ไปยังแคมเปญการทดสอบโดยอัตโนมัติ
เพิ่ม ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE แล้ว
เพิ่ม CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL แล้ว

โรงแรมและการท่องเที่ยว

เพิ่มช่องต่อไปนี้ใน ListingDimensionInfo สําหรับโฆษณากิจกรรมน่าสนใจเพื่อเปิดใช้งานการสร้างกลุ่มรายชื่อตามรัฐและเมืองที่มีกิจกรรมการเดินทาง
- activity_state
- activity_city
เพิ่มการรองรับกลุ่มต่อไปนี้ใน travel_activity_performance_view

บริการในท้องถิ่น

เพิ่ม LocalServicesVerificationArtifact.business_registration_check_verification_artifact และ BusinessRegistrationCheckArtifact เพื่อช่วยให้ผู้ลงโฆษณาตรวจสอบความคืบหน้าของกระบวนการยืนยันการจดทะเบียนธุรกิจได้
เพิ่มทรัพยากรใหม่ local_services_employee เพื่ออนุญาตให้ผู้ลงโฆษณาเรียกข้อมูลพนักงานที่เพิ่มไว้

การวางแผน

นำ score ออกจาก AudienceInsightsAttributeMetadata แล้ว

การแนะนำวิดีโอ

เพิ่ม RecommendationService.GenerateRecommendations() ซึ่งจะแสดงคำแนะนำตามการตั้งค่าที่ระบุ เช่น ประเภทคำแนะนำและประเภทช่องทางการโฆษณา ซึ่งมีประโยชน์มาก ระหว่างการสร้างแคมเปญ
เพิ่ม RecommendationMetrics.conversions_value แล้ว
ตอนนี้คีย์เวิร์ดที่แนะนำซึ่งมีประเภทการทำงานของคีย์เวิร์ดที่ไม่ได้ตั้งค่าไว้จะตั้งค่า recommended_match_type เป็น UNSPECIFIED แทน UNKNOWN
เพิ่มคำแนะนำประเภทต่อไปนี้
- MAXIMIZE_CONVERSION_VALUE_OPT_IN ซึ่งแนะนำให้เลือกใช้กลยุทธ์การเสนอราคาแบบเพิ่มมูลค่า Conversion สูงสุด
- IMPROVE_GOOGLE_TAG_COVERAGE ซึ่งแนะนำให้ทำให้แท็ก Google ใช้งานได้ในหน้าเว็บมากขึ้น
- PERFORMANCE_MAX_FINAL_URL_OPT_IN ซึ่งแนะนำให้เปิด Final URL Expansion สำหรับแคมเปญ Performance Max
- REFRESH_CUSTOMER_MATCH_LIST ซึ่งแนะนำให้อัปเดตรายชื่อลูกค้าที่ไม่มีการอัปเดตในช่วง 90 วันที่ผ่านมา
- CUSTOM_AUDIENCE_OPT_IN ซึ่งแนะนำให้สร้างกลุ่มเป้าหมายที่กำหนดเอง
- LEAD_FORM_ASSET ซึ่งแนะนำให้เพิ่มชิ้นงานโฆษณาแบบกรอกฟอร์มที่ระดับแคมเปญหรือระดับลูกค้า
- IMPROVE_DEMAND_GEN_AD_STRENGTH ซึ่งแนะนำการปรับปรุงคุณภาพของโฆษณาในแคมเปญ Demand Gen

Shopping

เพิ่ม CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT และ CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS เพื่อระบุข้อผิดพลาดโดยละเอียดเพิ่มเติมสำหรับแคมเปญ Shopping ที่ลิงก์กับบัญชี Comparison Shopping Service Center
เพิ่มค่าต่อไปนี้ใน 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

เป้าหมายของวงจร

เพิ่ม update ไปยัง CustomerLifecycleGoalOperation และ CampaignLifecycleGoalOperation เพื่อให้ประเภทการดำเนินการเหล่านี้สอดคล้องกับประเภทการดำเนินการอื่นๆ ใน API

v15 (18-10-2023)

ฟีเจอร์และการอัปเดตใหม่ๆ ต่อไปนี้เปิดตัวในเวอร์ชัน 15

การจัดการบัญชี

หากบัญชีถูกระงับเนื่องจากกิจกรรมในบัญชีที่ไม่ได้รับอนุญาต ระบบจะแสดงผล customer.status และ customer_client.status เป็น SUSPENDED ก่อนหน้านี้เราแสดงผลเป็น ENABLED
เพิ่มการรองรับการเพิ่มและนำการลิงก์ระหว่างบัญชี Google Ads กับบัญชี Merchant Center ออก ดังนี้
- เพิ่ม ProductLink.merchant_center และ MerchantCenterIdentifier แล้ว
- เพิ่ม LinkedProductType.MERCHANT_CENTER แล้ว
เพิ่ม ProductLinkInvitationService และ ProductLinkInvitation เพื่อรองรับการอัปเดตคำเชิญลิงก์ที่ส่งจากผลิตภัณฑ์อื่นๆ ซึ่งใช้ได้กับบัญชี Hotel Center และ Merchant Center
นำ MerchantCenterLinkService ออกแล้ว
- หากต้องการลิงก์บัญชี Google Ads กับบัญชี Merchant Center ให้ใช้ ProductLinkInvitationService และ ProductLinkService
นำ AccountLink.hotel_center ออกและการสนับสนุนการอัปเดตคำเชิญลิงก์จากบัญชี Hotel Center โดยใช้ AccountLinkService
- หากต้องการอัปเดตคำเชิญให้ลิงก์จากบัญชี Hotel Center ให้ใช้ ProductLinkInvitationService

ชิ้นงาน

แทนที่ ImageAdInfo.media_file ด้วย ImageAdInfo.image_asset เพื่อรองรับการเพิ่มและนำรูปภาพออกโดยใช้ชิ้นงานแล้ว ด้วยเหตุนี้ เราจึงนำ MediaFileService ออกด้วย ซึ่งไม่จำเป็นต้องใช้อีกต่อไป
เพิ่ม ListingGroupFilterDimension.webpage เพื่อรองรับการสร้างตัวกรองกลุ่มรายชื่อตามป้ายกำกับที่กำหนดเองและสตริงย่อยของ URL
- แทนที่ AssetGroupListingGroupFilter.vertical ด้วย AssetGroupListingGroupFilter.listing_source และ ListingGroupFilterListingSource ด้วย
เพิ่ม asset_group_asset.source เพื่อแสดงแหล่งที่มาของชิ้นงานในกลุ่มชิ้นงาน
เพิ่ม ad_group_ad_asset_view.source เพื่อแสดงแหล่งที่มาของชิ้นงานโฆษณาระดับกลุ่มโฆษณา

กลุ่มเป้าหมาย

สำหรับการจับคู่ข้อมูลลูกค้า เพิ่ม CustomerMatchUserListMetadata.consent เพื่อรองรับการให้ความยินยอม ตั้งแต่วันที่ 6 มีนาคม 2024 เป็นต้นไป หากไม่มีความยินยอมสำหรับผู้ใช้ใน EEA ระบบจะระบุค่าความยินยอมเป็นไม่ยินยอม ข้อมูลจากผู้ใช้ใน EEA ที่ไม่ให้ความยินยอมจะไม่ผ่านการประมวลผล และไม่สามารถใช้สำหรับการปรับโฆษณาตามโปรไฟล์ของผู้ใช้โดยใช้การจับคู่ข้อมูลลูกค้า ดูรายละเอียดเพิ่มเติมได้ในคู่มือการจับคู่ข้อมูลลูกค้า
สำหรับยอดขายในร้าน เพิ่ม UserData.consent เพื่อสนับสนุนการให้ความยินยอม ดูรายละเอียดเพิ่มเติมได้ในคู่มือยอดขายในร้าน หากคุณใช้การจับคู่ข้อมูลลูกค้ากับยอดขายในร้าน ให้อ่านคำถามที่พบบ่อยเพื่อดูข้อมูลเพิ่มเติม
เพิ่ม UserList.lookalike_user_list เพื่อรองรับการสร้างกลุ่มที่คล้ายกัน ซึ่งเป็นกลุ่มเป้าหมายที่สร้างขึ้นโดยอิงตามกลุ่มเป้าหมายตั้งต้นที่มีอยู่ กลุ่มที่คล้ายกันใช้ได้ในแคมเปญ Demand Gen เท่านั้น

แคมเปญ

การอัปเดตแคมเปญ Performance Max
- ตอนนี้ AssetGroupSignal รองรับสัญญาณ 2 ประเภทที่แนบกับกลุ่มชิ้นงานเพื่อการกำหนดเป้าหมายที่ปรับปรุงแล้วได้
  - AssetGroupSignal.audience
    - เพิ่ม Audience.scope และ Audience.asset_group เพื่อจำกัดการใช้งานกลุ่มเป้าหมายให้อยู่ในกลุ่มชิ้นงานที่เฉพาะเจาะจง ต้องตั้งค่า Audience.asset_group หากและเฉพาะเมื่อ Audience.scope เป็น ASSET_GROUP
  - AssetGroupSignal.search_theme
    - เพิ่ม CriterionType.SEARCH_THEME เพื่อรองรับเกณฑ์ประเภทใหม่นี้ ประเภทเกณฑ์ใหม่นี้ใช้ได้เฉพาะในแคมเปญ Performance Max เพื่อสร้าง AssetGroupSignal โดยเติมข้อมูล AssetGroupSignal.search_theme ด้วยเกณฑ์ SearchThemeInfo
- เพิ่ม AssetGroupSignalOperation.exempt_policy_violation_keys เพื่อรองรับการขอการยกเว้นเมื่อเพิ่มสัญญาณของกลุ่มชิ้นงาน
- เพิ่ม asset_group_top_combination_view ใหม่เพื่อรายงานชิ้นงานที่มีประสิทธิภาพสูงสุดในระดับกลุ่มชิ้นงาน
- ตอนนี้คุณสามารถค้นหา asset_group ด้วยช่องเมตริก เพื่อรองรับการดึงข้อมูลประสิทธิภาพของแคมเปญ Performance Max
- ใน PerformanceMaxUpgradeStatus เปลี่ยนชื่อ UPGRADE_ELIGIBLE เป็น UPGRADE_ELIGIBLE แล้ว
สำหรับแคมเปญ Demand Gen และ Discovery CPA เป้าหมาย ตอนนี้การจําลองการเสนอราคา CPA เป้าหมายระดับแคมเปญ (campaign_simulation.target_cpa_point_list.points) จะกลับมาใช้ TargetCpaSimulationPoint.interactions แทน TargetCpaSimulationPoint.clicks
เพิ่ม BrandSuggestionService ที่สามารถแนะนำแบรนด์ตามคำนำหน้าแบรนด์ที่ระบุและรายการแบรนด์ที่ยกเว้น คุณสามารถใช้แบรนด์เหล่านี้สร้างเกณฑ์ BRAND เพิ่ม ลงในชุดที่ใช้ร่วมกันของ BRANDS แล้วแนบกับแคมเปญโดยการสร้าง CampaignCriterion ที่มี brand_list เป็นชุดที่ใช้ร่วมกัน คุณกำหนดเป้าหมายเกณฑ์แคมเปญได้ในแคมเปญ Search และยกเว้นในแคมเปญ Performance Max ตามลำดับ
- ช่อง:
  - SharedCriterion.brand
  - CampaignCriterion.brand_list
- Enum:
  - SharedSetType.BRANDS
  - CriterionType.BRAND_LIST
เพิ่ม Campaign.asset_automation_settings[] เพื่อแสดงสถานะอัตโนมัติของชิ้นงานแต่ละประเภท
เพิ่มค่าต่อไปนี้ใน enum CampaignPrimaryStatusReason แล้ว
- NO_ASSET_GROUPS
- ASSET_GROUPS_PAUSED

Conversion

เพิ่ม CallConversion.consent และ ClickConversion.consent เพื่อรองรับการให้ความยินยอม ดูรายละเอียดเพิ่มเติมได้ในคู่มือ Conversion การโทรและคู่มือ Conversion การคลิก
เพิ่มช่องต่อไปนี้ที่เกี่ยวข้องกับ Conversion SKAdNetwork ซึ่งจะใช้ได้เมื่อค้นหาด้วย customer หรือ campaign
- กลุ่ม:
- เมตริก:
  - metrics.sk_ad_network_total_conversions
  - metrics.sk_ad_network_installs
แทนที่ metrics.sk_ad_network_conversions ด้วย metrics.sk_ad_network_installs แล้ว
เพิ่มการรองรับการวินิจฉัยการอัปโหลด Conversion ออฟไลน์
- ย้าย offline_conversion_upload_client_summary จากช่องในทรัพยากร customer ไปยังรายงานระดับบนสุด ใช้รายงานนี้เพื่อดูรายละเอียดที่เป็นประโยชน์เกี่ยวกับสถานะการอัปโหลด Conversion เช่น จำนวนเหตุการณ์ที่ประสบความสำเร็จ อัตราความสำเร็จ และเปอร์เซ็นต์ข้อผิดพลาด
  - โปรดทราบ: Conversion ที่อัปโหลดแต่เกิดข้อผิดพลาด ConversionUploadError.CLICK_NOT_FOUND จะยังคงนับว่าสําเร็จ แต่จะแจ้งว่าเป็น OfflineConversionAlert ด้วย
- เพิ่ม job_id เป็นพารามิเตอร์ที่ไม่บังคับสำหรับประเภทคำขอต่อไปนี้ เพื่อให้คุณจัดกลุ่มคำขออัปโหลดหลายรายการไว้ในงานเชิงแนวคิดเดียวได้อย่างสมเหตุสมผล
  - UploadConversionAdjustmentsRequest
  - UploadClickConversionsRequest
- เพิ่ม INVALID_JOB_ID ในข้อผิดพลาดต่อไปนี้แล้ว
  - ConversionAdjustmentUploadError
  - ConversionUploadError
- แทนที่ INVALID_CONVERSION_ACTION ด้วย NO_CONVERSION_ACTION_FOUND และ INVALID_CONVERSION_ACTION_TYPE แล้วในข้อผิดพลาดต่อไปนี้
  - ConversionAdjustmentUploadError
  - ConversionUploadError
เพิ่มรายงาน 3 ฉบับเพื่อรองรับการระบุแหล่งที่มาแบบข้ามเครือข่ายสำหรับ Privacy Sandbox ของ Android โดยไม่มีการเปลี่ยนเส้นทาง ดังนี้
- android_privacy_shared_key_google_campaign ซึ่งมี shared_campaign_key และบางช่องที่ช่วยเข้ารหัสคีย์
- android_privacy_shared_key_google_ad_group ซึ่งมี shared_ad_group_key และบางช่องที่ช่วยเข้ารหัสคีย์
- android_privacy_shared_key_google_network_type ซึ่งมี shared_network_type_key และบางช่องที่ช่วยเข้ารหัสคีย์
เพิ่ม ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS แล้ว ConversionActionOperation ที่พยายามใช้รูปแบบการระบุแหล่งที่มาตามกฎที่เลิกใช้งานแล้วรายการใดรายการหนึ่งไม่สำเร็จเนื่องจากข้อผิดพลาดนี้ ก่อนหน้านี้การดำเนินการจะล้มเหลวโดยมีข้อผิดพลาด UNKNOWN

โรงแรมและการท่องเที่ยว

เพิ่มการรองรับช่องต่อไปนี้ใน travel_activity_group_view และ travel_activity_performance_view
- กลุ่ม:
- เมตริก:

โฆษณาบริการในพื้นที่

เพิ่ม LocalServicesSettings และช่องในรายงาน customer สำหรับการส่งคืนใบอนุญาตแบบละเอียดและการประกันของผู้ลงโฆษณาบริการในพื้นที่
เพิ่มรายงานใหม่ต่อไปนี้สำหรับบริการในพื้นที่
- local_services_lead มีรายละเอียดทั้งหมดที่เกี่ยวข้องกับโอกาสในการขายโฆษณาบริการในพื้นที่ เช่น lead_charged, lead_type, lead_status
  - Enum:
    - LeadStatus
    - LeadType
- local_services_lead_conversation มีข้อความและรายละเอียดการสนทนาทางโทรศัพท์ เช่น conversation_channel, call_duration_millis, call_recording_url
  - URL การบันทึกการโทรจะได้รับการตรวจสอบสิทธิ์กับบัญชีของลูกค้าเป้าหมายและบัญชีดูแลจัดการ
- local_services_verification_artifact ส่งคืนอาร์ติแฟกต์ของผู้ลงโฆษณาบริการในพื้นที่ เช่น การตรวจสอบภูมิหลัง ใบอนุญาตประกอบธุรกิจ และข้อมูลการประกันธุรกิจ เอกสารที่เกี่ยวข้องกับใบอนุญาตและการประกันภัยจะสามารถเข้าถึงได้ผ่าน URL
  - Enum:

การวางแผน

เพิ่มการรองรับในการคืนสินค้า Forecast.views และ PlannedProductForecast.views สำหรับ ReachPlanService.ListPlannableProducts สำหรับประเภทผลิตภัณฑ์ที่เกี่ยวข้อง
เพิ่มการรองรับในการส่งคืน PlannableTargeting.surface_targeting สำหรับ ReachPlanService.ListPlannableProducts ซึ่งอธิบายถึงแพลตฟอร์มที่พร้อมใช้งานสำหรับผลิตภัณฑ์
เพิ่ม enum ของ ReachPlanSurface ใหม่แล้ว
เพิ่มการรองรับการกำหนดเป้าหมายความถี่เป้าหมายโดยใช้ AdvancedProductTargeting.target_frequency_settings ซึ่งแสดงผล PlannedProductForecast.average_frequency
เพิ่ม AudienceInsightsService.GenerateSuggestedTargetingInsights เพื่อแสดงกลุ่มเป้าหมายที่แนะนำได้
เพิ่มค่าต่อไปนี้ใน ReachPlanError แล้ว
- NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
- NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

การแนะนำวิดีโอ

เพิ่มแล้ว RecommendationSubscriptionService ซึ่งจัดการการสมัครใช้บริการการแนะนำ
- แหล่งข้อมูล: RecommendationSubscription
- ฟิลด์: MutateOperation.recommendation_subscription_operation
- Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
- ข้อผิดพลาด:
  - RecommendationSubscriptionError
  - RecommendationSubscriptionStatus
เพิ่มคำแนะนำประเภทต่อไปนี้
- FORECASTING_SET_TARGET_CPA ซึ่งแนะนำให้กำหนด CPA เป้าหมายสำหรับแคมเปญที่ไม่ได้ระบุ CPA ล่วงหน้าก่อนเทศกาลประจำปีที่คาดว่าจะเพิ่มการเข้าชม
- SET_TARGET_CPA ซึ่งแนะนำให้กำหนด CPA เป้าหมายสำหรับแคมเปญที่ไม่ได้ระบุ CPA เป้าหมายไว้
- SET_TARGET_ROAS ซึ่งแนะนำการตั้งค่า ROAS เป้าหมายสำหรับแคมเปญที่ไม่ได้ระบุ ROAS เป้าหมาย

การรายงาน

เพิ่มเมตริกใหม่ต่อไปนี้ซึ่งค้นหาได้ด้วย campaign (ใช้ได้กับ Display, วิดีโอ, Discovery และ App Campaign) และ segments.device
- metrics.unique_users
- metrics.average_impression_frequency_per_user

Shopping

นำ ShoppingSetting.sales_country ออกแล้ว ซึ่งตอนนี้แสดงผลค่าเป็น ShoppingSetting.feed_label แล้ว
- คุณยังคงใช้ฟีด Merchant Center ที่เจาะจงสำหรับแคมเปญต่อไปได้โดยใช้ช่อง ShoppingSetting.feed_label ควรตั้งค่าเป็นค่าป้ายกำกับฟีดหรือรหัสประเทศ 2 ตัวอักษรที่ก่อนหน้านี้ใช้สำหรับ ShoppingSetting.sales_country โปรดดูรายละเอียดเพิ่มเติมในบทความการสนับสนุนสำหรับป้ายกำกับฟีด
นำหมวดหมู่ผลิตภัณฑ์ที่ไม่พึ่งพิงรหัสประเทศในการรายงานออก ชุดรหัสหมวดหมู่ที่รองรับไม่มีการเปลี่ยนแปลง
- แทนที่ช่องต่อไปนี้ที่ใช้ใน shopping_performance_view
  - segments.product_bidding_category_level1 ด้วย segments.product_category_level1
  - segments.product_bidding_category_level2 ด้วย segments.product_category_level2
  - segments.product_bidding_category_level3 ด้วย segments.product_category_level3
  - segments.product_bidding_category_level4 ด้วย segments.product_category_level4
  - segments.product_bidding_category_level5 ด้วย segments.product_category_level5
- แทนที่ product_bidding_category_constant ด้วย product_category_constant ซึ่งแสดงผลการแปลเป็นภาษาท้องถิ่นทั้งหมดที่มีในช่องที่ซ้ำ
- แทนที่ ListingDimensionInfo.product_bidding_category ด้วย ListingDimensionInfo.product_category แล้ว
- แทนที่ ListingGroupFilterDimension.product_bidding_category ด้วย ListingGroupFilterDimension.product_category แล้ว
ยกเลิกการรองรับการเพิ่ม Campaign.shopping_setting ในแคมเปญ Search การพยายามสร้างแคมเปญ Search ด้วย Campaign.shopping_setting หรือเพิ่ม Campaign.shopping_setting ลงในแคมเปญ Search ที่มีอยู่จะทำให้เกิด OPERATION_NOT_PERMITTED_FOR_CONTEXT
ยกเลิกการรองรับการเพิ่ม CampaignCriterion.listing_scope ในแคมเปญ Search การพยายามเพิ่ม CampaignCriterion.listing_scope ลงในแคมเปญ Search ที่มีอยู่จะทําให้เกิด OPERATION_NOT_PERMITTED_FOR_CONTEXT
เพิ่มเมตริก Conversion จากข้อมูลรถเข็นช็อปปิ้งต่อไปนี้
- 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
- คุณเลือกเมตริกทั้งหมดเหล่านี้ได้จากรายงานต่อไปนี้

เป้าหมายแบบรวม

เพิ่ม CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals สําหรับการกําหนดค่าเป้าหมายการได้ลูกค้าใหม่ในระดับลูกค้า
- รายงาน: customer_lifecycle_goal
เพิ่ม CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals สําหรับการกําหนดค่าเป้าหมายการได้ลูกค้าใหม่ในระดับแคมเปญ
- รายงาน: campaign_lifecycle_goal
เพิ่ม CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN แล้ว
เพิ่มค่าต่อไปนี้ใน ConversionGoalCampaignConfigError แล้ว
- EMPTY_CONVERSION_GOALS
- STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
- PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

วิดีโอ

เพิ่มการรองรับการกำหนดเป้าหมาย Google TV ที่ระดับแคมเปญ
- เพิ่มแล้ว NetworkSettings.target_google_tv_network
- เพิ่ม AdNetworkType.GOOGLE_TV แล้ว
เพิ่มการรองรับการกำหนดเป้าหมาย YouTube ที่ระดับแคมเปญ
- เพิ่มแล้ว NetworkSettings.target_youtube
- ใน AdNetworkType รวม YOUTUBE_WATCH และ YOUTUBE_SEARCH เป็น YOUTUBE
- เพิ่ม CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE แล้ว

บันทึกประจำรุ่นที่เก็บไว้

ดูเวอร์ชันที่หยุดให้บริการสำหรับบันทึกประจำรุ่นที่เก็บไว้