v17 (05-06-2024)
เราได้เพิ่มฟีเจอร์และการเปลี่ยนแปลงต่อไปนี้ในเวอร์ชัน 17
โฆษณา
- นำ
AdService.getAd
ออกแล้ว ซึ่งทำให้AdService
สอดคล้องกับบริการอื่นๆ ใน Google Ads API ดูการเรียกข้อมูลออบเจ็กต์สำหรับวิธีที่แนะนำในการดึงโฆษณาและทรัพยากรประเภทอื่นๆ - เพิ่มการตรวจสอบสำหรับ
ImageAdInfo.image_asset
เกี่ยวกับมิติข้อมูลและรูปแบบเพิ่มเติม อาจมีข้อผิดพลาดต่อไปนี้หากรูปภาพไม่ถูกต้อง
ชิ้นงาน
- เพิ่ม enum ใหม่:
ClickType.AD_IMAGE
- เพิ่มรายงานใหม่ต่อไปนี้ซึ่งมีเมตริกใหม่สําหรับแคมเปญ Performance Max และ Search
กลุ่มเป้าหมาย
งานแบบกลุ่ม
- เพิ่ม
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
เพื่อแสดงการสนทนาที่แนะนำผ่าน WhatsAppADS_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
ที่ระบุไว้ ซึ่งจะสร้างเซสชันการยืนยันใหม่และส่งคืนการตอบกลับที่ว่างเปล่าสำหรับการยืนยันที่สร้างขึ้นเรียบร้อยแล้วGetIdentityVerification()
สามารถใช้ในการเรียกข้อมูลการยืนยัน ซึ่งจะแสดงผลออบเจ็กต์IdentityVerification
หลายรายการIdentityVerification
แต่ละรายการประกอบด้วยverification_program
ซึ่งเป็นโปรแกรมการยืนยันตัวตนประเภทidentity_verification_requirement
ที่มีรายละเอียดเกี่ยวกับกำหนดเวลาที่ผู้ลงโฆษณาควรทำการยืนยันให้เสร็จสิ้นverification_progress
ที่มีรายละเอียดเกี่ยวกับเซสชันการยืนยัน ได้แก่program_status
แสดงสถานะปัจจุบันของ เซสชันการยืนยันนี้action_url
จะนำลูกค้าไปยัง URL เพื่อทำการยืนยันให้เสร็จสมบูรณ์invitation_link_expiration_time
คือวันที่หมดอายุ ของaction_url
- Enum:
- ข้อผิดพลาด:
- เพิ่ม
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
สําหรับโฆษณากิจกรรมน่าสนใจเพื่อเปิดใช้งานการสร้างกลุ่มรายชื่อตามรัฐและเมืองที่มีกิจกรรมการเดินทาง - เพิ่มการรองรับกลุ่มต่อไปนี้ใน
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 MaxREFRESH_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
- หากต้องการลิงก์บัญชี Google Ads กับบัญชี Merchant Center ให้ใช้
- นำ
AccountLink.hotel_center
ออกและการสนับสนุนการอัปเดตคำเชิญลิงก์จากบัญชี Hotel Center โดยใช้AccountLinkService
- หากต้องการอัปเดตคำเชิญให้ลิงก์จากบัญชี Hotel Center ให้ใช้
ProductLinkInvitationService
- หากต้องการอัปเดตคำเชิญให้ลิงก์จากบัญชี Hotel Center ให้ใช้
ชิ้นงาน
- แทนที่
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 ตามลำดับเพิ่ม
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_conversions
ด้วยmetrics.sk_ad_network_installs
แล้ว - เพิ่มการรองรับการวินิจฉัยการอัปโหลด Conversion ออฟไลน์
- ย้าย
offline_conversion_upload_client_summary
จากช่องในทรัพยากรcustomer
ไปยังรายงานระดับบนสุด ใช้รายงานนี้เพื่อดูรายละเอียดที่เป็นประโยชน์เกี่ยวกับสถานะการอัปโหลด Conversion เช่น จำนวนเหตุการณ์ที่ประสบความสำเร็จ อัตราความสำเร็จ และเปอร์เซ็นต์ข้อผิดพลาด- โปรดทราบ: Conversion ที่อัปโหลดแต่เกิดข้อผิดพลาด
ConversionUploadError.CLICK_NOT_FOUND
จะยังคงนับว่าสําเร็จ แต่จะแจ้งว่าเป็นOfflineConversionAlert
ด้วย
- โปรดทราบ: Conversion ที่อัปโหลดแต่เกิดข้อผิดพลาด
- เพิ่ม
job_id
เป็นพารามิเตอร์ที่ไม่บังคับสำหรับประเภทคำขอต่อไปนี้ เพื่อให้คุณจัดกลุ่มคำขออัปโหลดหลายรายการไว้ในงานเชิงแนวคิดเดียวได้อย่างสมเหตุสมผล - เพิ่ม
INVALID_JOB_ID
ในข้อผิดพลาดต่อไปนี้แล้ว - แทนที่
INVALID_CONVERSION_ACTION
ด้วยNO_CONVERSION_ACTION_FOUND
และINVALID_CONVERSION_ACTION_TYPE
แล้วในข้อผิดพลาดต่อไปนี้
- ย้าย
- เพิ่มรายงาน 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
- กลุ่ม:
- เมตริก:
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
โฆษณาบริการในพื้นที่
- เพิ่ม
LocalServicesSettings
และช่องในรายงานcustomer
สำหรับการส่งคืนใบอนุญาตแบบละเอียดและการประกันของผู้ลงโฆษณาบริการในพื้นที่ - เพิ่มรายงานใหม่ต่อไปนี้สำหรับบริการในพื้นที่
local_services_lead
มีรายละเอียดทั้งหมดที่เกี่ยวข้องกับโอกาสในการขายโฆษณาบริการในพื้นที่ เช่นlead_charged
,lead_type
,lead_status
- Enum:
local_services_lead_conversation
มีข้อความและรายละเอียดการสนทนาทางโทรศัพท์ เช่นconversation_channel
,call_duration_millis
,call_recording_url
- URL การบันทึกการโทรจะได้รับการตรวจสอบสิทธิ์กับบัญชีของลูกค้าเป้าหมายและบัญชีดูแลจัดการ
local_services_verification_artifact
ส่งคืนอาร์ติแฟกต์ของผู้ลงโฆษณาบริการในพื้นที่ เช่น การตรวจสอบภูมิหลัง ใบอนุญาตประกอบธุรกิจ และข้อมูลการประกันธุรกิจ เอกสารที่เกี่ยวข้องกับใบอนุญาตและการประกันภัยจะสามารถเข้าถึงได้ผ่าน URL
การวางแผน
- เพิ่มการรองรับในการคืนสินค้า
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
ซึ่งจัดการการสมัครใช้บริการการแนะนำ - เพิ่มคำแนะนำประเภทต่อไปนี้
FORECASTING_SET_TARGET_CPA
ซึ่งแนะนำให้กำหนด CPA เป้าหมายสำหรับแคมเปญที่ไม่ได้ระบุ CPA ล่วงหน้าก่อนเทศกาลประจำปีที่คาดว่าจะเพิ่มการเข้าชมSET_TARGET_CPA
ซึ่งแนะนำให้กำหนด CPA เป้าหมายสำหรับแคมเปญที่ไม่ได้ระบุ CPA เป้าหมายไว้SET_TARGET_ROAS
ซึ่งแนะนำการตั้งค่า ROAS เป้าหมายสำหรับแคมเปญที่ไม่ได้ระบุ ROAS เป้าหมาย
การรายงาน
- เพิ่มเมตริกใหม่ต่อไปนี้ซึ่งค้นหาได้ด้วย
campaign
(ใช้ได้กับ Display, วิดีโอ, Discovery และ App Campaign) และsegments.device
Shopping
- นำ
ShoppingSetting.sales_country
ออกแล้ว ซึ่งตอนนี้แสดงผลค่าเป็นShoppingSetting.feed_label
แล้ว- คุณยังคงใช้ฟีด Merchant Center ที่เจาะจงสำหรับแคมเปญต่อไปได้โดยใช้ช่อง
ShoppingSetting.feed_label
ควรตั้งค่าเป็นค่าป้ายกำกับฟีดหรือรหัสประเทศ 2 ตัวอักษรที่ก่อนหน้านี้ใช้สำหรับShoppingSetting.sales_country
โปรดดูรายละเอียดเพิ่มเติมในบทความการสนับสนุนสำหรับป้ายกำกับฟีด
- คุณยังคงใช้ฟีด Merchant Center ที่เจาะจงสำหรับแคมเปญต่อไปได้โดยใช้ช่อง
- นำหมวดหมู่ผลิตภัณฑ์ที่ไม่พึ่งพิงรหัสประเทศในการรายงานออก
ชุดรหัสหมวดหมู่ที่รองรับไม่มีการเปลี่ยนแปลง
- แทนที่ช่องต่อไปนี้ที่ใช้ใน
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
แล้ว
- เพิ่มแล้ว
บันทึกประจำรุ่นที่เก็บไว้
ดูเวอร์ชันที่หยุดให้บริการสำหรับบันทึกประจำรุ่นที่เก็บไว้