v17.1.0 (07-08-2024)
มีการเพิ่มคุณลักษณะและการอัปเดตต่อไปนี้ใน v17_1
เนื้อหา
AdGroupAdService.RemoveAutomaticallyCreatedAssets()
ช่วยให้คุณนำชิ้นงานที่สร้างขึ้นโดยอัตโนมัติที่ระบุซึ่งลิงก์กับโฆษณา Search ที่ปรับเปลี่ยนตามบริบทออกได้
กลุ่มเป้าหมาย
- ค่า enum ใหม่ใน
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
แคมเปญ
ShareablePreviewService.GenerateShareablePreviews()
สร้าง URL (shareable_preview_url
ในการตอบกลับ) สำหรับตัวอย่างโฆษณาที่แชร์ได้สำหรับกลุ่มชิ้นงานที่เปิดใช้และหยุดชั่วคราว- ช่อง
expiration_date_time
จะระบุวันที่หมดอายุของ URL ในคำตอบ - หากเกิดข้อผิดพลาด เมธอดจะแสดง
partial_failure_error
แทน URL
- ช่อง
ประวัติการเปลี่ยนแปลง
- ประเภททรัพยากรสถานะการเปลี่ยนแปลงใหม่:
ASSET_GROUP
.
Conversion
- ช่องกลุ่มใหม่สำหรับเวอร์ชัน SKAdNetwork:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
ซึ่งแสดงการวินิจฉัยการอัปโหลด Conversion ที่ระดับการกระทำที่ถือเป็น Conversion- ระบบจะเพิ่มเมตริกต่อไปนี้ในรายงานการวินิจฉัยออฟไลน์เพื่อระบุจำนวน Conversion ที่อัปโหลดซึ่งยังอยู่ระหว่างการประมวลผล
การวางแผน
AudienceInsights.GenerateAudienceOverlapInsights()
ซึ่งยอมรับแอตทริบิวต์หลักอินพุตและคอลเล็กชันของแอตทริบิวต์กลุ่มเป้าหมาย และแสดงค่าประมาณของการทับซ้อนกันของการเข้าถึงที่เป็นไปได้ใน YouTube ระหว่างแอตทริบิวต์หลักกับแอตทริบิวต์กลุ่มเป้าหมาย
การรายงาน
- รองรับการแบ่งกลุ่ม
per_store_view
ตามsegments.date
วิดีโอ
- รองรับการเรียกข้อมูลที่เกี่ยวข้องกับกลยุทธ์การเสนอราคามาตรฐานต่อไปนี้สำหรับแคมเปญวิดีโอที่ใช้รายงาน เช่น
ad_group
,campaign
Campaign.fixed_cpm
(CPM คงที่ (ต้นทุนต่อการแสดงผลพันครั้ง))Campaign.target_cpv
(CPV เป้าหมาย (ต้นทุนต่อการดู))
Campaign.video_campaign_settings
ซึ่งจะช่วยให้คุณกำหนดพื้นที่โฆษณาที่โฆษณาวิดีโอสามารถแสดงได้โดยใช้ช่องรายงานต่อไปนี้segments.ad_format_type
ซึ่งช่วยให้คุณแบ่งกลุ่มรายงานต่อไปนี้ตามประเภทรูปแบบโฆษณาวิดีโอ
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 ในทุกช่อง, แจกแจง, ข้อผิดพลาดทั้งหมด
ใน Google Ads API เช่น แคมเปญ โฆษณา และชิ้นงาน สำหรับ
ตัวอย่างเช่น
AdvertisingChannelType.DISCOVERY
ขณะนี้คือAdvertisingChannelType.DEMAND_GEN
- เพิ่มเมื่อ
Campaign.keyword_match_type
เพื่อให้คุณสามารถตั้งค่าประเภทการทำงานของคีย์เวิร์ดสำหรับคีย์เวิร์ดทั้งหมดในแคมเปญ
Conversion
- สำหรับ SKAdNetwork
Conversion
- เปลี่ยนชื่อ
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 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 ที่ลิงก์กับ ศูนย์บริการช็อปปิ้งแบบเปรียบเทียบสินค้า บัญชี - เพิ่มค่าต่อไปนี้ใน
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
เพื่อให้การสนับสนุน การอัปเดตคำเชิญลิงก์ที่ส่งจากผลิตภัณฑ์อื่นๆ ใช้ได้กับ โรงแรม 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
รองรับ ประเภทสัญญาณที่แนบกับกลุ่มชิ้นงานเพื่อการกำหนดเป้าหมายที่ปรับปรุงแล้วได้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 และ การค้นพบ แคมเปญ 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[]
เพื่อแสดงสถานะอัตโนมัติของชิ้นงานแต่ละประเภทเพิ่มค่าต่อไปนี้ลงในส่วน
CampaignPrimaryStatusReason
enum:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
Conversion
- เพิ่ม
CallConversion.consent
และClickConversion.consent
เพื่อให้การสนับสนุน ให้คำยินยอม โปรดดู คู่มือเกี่ยวกับ Conversion การโทร และคู่มือ Conversion การคลิกเพื่อดู รายละเอียด - เพิ่มช่องต่อไปนี้ที่เกี่ยวข้องกับ
SKAdNetwork
Conversion ซึ่งสามารถใช้ได้เมื่อสืบค้นข้อมูลด้วย
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 ใบอนุญาตอย่างละเอียดและสถานะการประกันของผู้ลงโฆษณาบริการ - เพิ่มรายงานใหม่ต่อไปนี้สำหรับ Local
บริการ:
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
, ซึ่งอธิบายแพลตฟอร์มที่ใช้ได้สำหรับผลิตภัณฑ์ - เพิ่มใหม่
ReachPlanSurface
enum - เพิ่มการสนับสนุนสำหรับการกำหนดเป้าหมาย เป้าหมาย
ความถี่โดยใช้
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
สำหรับรายละเอียดเพิ่มเติม ดูบทความสนับสนุนสำหรับฟีด ป้ายกำกับ [label]
- คุณจะยังใช้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 ด้วย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
- เพิ่มเมื่อ
บันทึกประจำรุ่นที่เก็บไว้
ดูเวอร์ชันที่หยุดให้บริการสำหรับบันทึกประจำรุ่นที่เก็บไว้