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

v18 (16-10-2024)

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

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

• (สําหรับบัญชีในรายการที่อนุญาตเท่านั้น) เพิ่ม DataLinkService.CreateDataLink ซึ่งอนุญาตให้ลิงก์บัญชี Google Ads กับวิดีโอของครีเอเตอร์ที่โฮสต์ในช่อง YouTube ของครีเอเตอร์ การลิงก์วิดีโอช่วยให้บัญชี Google Ads แสดงโฆษณาพาร์ทเนอร์โดยใช้วิดีโอของครีเอเตอร์ได้

กลุ่มโฆษณา

• เพิ่ม AdGroup.exclude_demographic_expansion ซึ่งช่วยให้คุณยกเว้นข้อมูลประชากรไม่ให้ขยายได้เมื่อ optimized_targeting_enabled เป็น true ซึ่งเป็นฟีเจอร์ที่ก่อนหน้านี้รองรับเฉพาะ Demand Gen เท่านั้น

โฆษณา

• เพิ่ม AdGroupAd.ad_group_ad_asset_automation_settings ซึ่งช่วยให้เลือกให้โฆษณาใช้หรือไม่ใช้การสร้างชิ้นงานอัตโนมัติได้
• เพิ่มค่าต่อไปนี้ลงใน AssetAutomationType
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• เพิ่ม AdNetworkType.GOOGLE_OWNED_CHANNELS ซึ่งใช้โดยโฆษณาที่แสดงในช่องทางที่เป็นของ Google เช่น YouTube, Gmail และฟีด Discover

ชิ้นงาน

• เปลี่ยนชื่อ AssetType.DISCOVERY_CAROUSEL_CARD เป็น AssetType.DEMAND_GEN_CAROUSEL_CARD แล้ว

แคมเปญ

• เพิ่ม metrics.store_visits_last_click_model_attributed_conversions ซึ่งแสดงจํานวนการเข้าชมร้านค้าที่มาจากรูปแบบคลิกสุดท้ายของแคมเปญ
• เพิ่มเมตริกที่เกี่ยวข้องกับการดูวิดีโอต่อไปนี้สําหรับแคมเปญ
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• เพิ่ม metrics.results_conversions_purchase ซึ่งแสดง Conversion การซื้อสําหรับผลลัพธ์เป้าหมายแบบรวมของแคมเปญ
• เปลี่ยนค่าเริ่มต้นของ DemandGenCampaignSettings.upgraded_targeting จาก false เป็น true

เกณฑ์

• เพิ่ม content_criterion_view ซึ่งแสดงเมตริกประสิทธิภาพของเนื้อหาที่กำหนดเป้าหมาย เช่น คีย์เวิร์ด ตําแหน่ง และหัวข้อสําหรับแคมเปญ Display, Demand Gen และวิดีโอ

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

• การรองรับฟีดการเดินทางในโฆษณา Search
  • เพิ่ม ClickType.TRAVEL_ASSETS เพื่ออนุญาตให้แบ่งกลุ่มเมตริกของฟีดการเดินทางในโฆษณา Search
  • เพิ่ม AssetSetType.TRAVEL_FEED ซึ่งสามารถใช้เพื่อเลือกใช้และไม่เลือกใช้ฟีดการเดินทางในโฆษณา Search
• (สําหรับบัญชีในรายการที่อนุญาตเท่านั้น) เพิ่มแผนการเดินทางเป็นกฎมูลค่า Conversion ใหม่ที่มีช่องและค่าใหม่ต่อไปนี้
  • ConversionValueRule.itinerary_condition พร้อม ValueRuleItineraryCondition ซึ่งช่วยให้ระบุระยะเวลาที่จองได้ล่วงหน้าก่อนถึงวันเข้าพักจริง ระยะเวลาของแผนการเดินทาง และวันเริ่มเดินทางในสัปดาห์ได้
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• เพิ่มกลุ่มต่อไปนี้สําหรับรายงาน campaign และ ad_group เพื่อแบ่งกลุ่มข้อมูลประสิทธิภาพตามจุดหมายหนึ่งๆ (เมือง ประเทศ และภูมิภาค) สําหรับแคมเปญโรงแรมและแคมเปญ Search
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

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

• PhoneCallDetails.call_recording_url จะว่างเปล่าแทนที่จะแสดง URL ที่ไม่ถูกต้อง หากไม่มีการบันทึกการโทรสําหรับการสนทนาโอกาสในการขายบริการในพื้นที่ที่ระบุ
• เพิ่ม CategoryBid.target_cpa_bid_micro ซึ่งช่วยให้ตั้งค่า CPA เป้าหมายสําหรับหมวดหมู่ผ่าน Campaign.local_services_campaign_settings ได้

Performance Max

• การสนับสนุนหลักเกณฑ์การใช้แบรนด์
  • เพิ่ม Campaign.brand_guidelines_enabled ซึ่งจะแสดงว่าเปิดใช้หลักเกณฑ์การใช้แบรนด์สําหรับแคมเปญ Performance Max หนึ่งๆ หรือไม่ หากเปิดใช้ ชิ้นงานที่ field_type ตั้งค่าเป็น BUSINESS_NAME, LOGO, LANDSCAPE_LOGO จะต้องลิงก์เป็นทรัพยากร CampaignAsset แทนทรัพยากร AssetGroupAsset
  • เพิ่มข้อผิดพลาด CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED และ CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED ซึ่งบ่งชี้ว่าแคมเปญ Performance Max ที่เปิดใช้หลักเกณฑ์การใช้แบรนด์ไม่มีทรัพยากร CampaignAsset ที่จําเป็นซึ่งลิงก์กับแคมเปญ
  • เมื่อเปิดใช้หลักเกณฑ์การใช้แบรนด์ คุณต้องลิงก์ชิ้นงานอย่างน้อย 1 รายการที่มี field_type ตั้งค่าเป็น BUSINESS_NAME และชิ้นงานอย่างน้อย 1 รายการที่มี LOGO กับแคมเปญเป็นทรัพยากร CampaignAsset แคมเปญ Performance Max สําหรับยอดขายออนไลน์ที่มีฟีดผลิตภัณฑ์ต้องเป็นไปตามข้อกําหนดนี้เฉพาะเมื่อมีชิ้นงานที่ลิงก์กับกลุ่มชิ้นงานของแคมเปญ
  • เพิ่มค่าต่อไปนี้ลงใน AssetLinkError
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL ซึ่งจะแสดงขึ้นเมื่อพยายามลิงก์ชิ้นงานแบรนด์กับแคมเปญเป็นทรัพยากร CampaignAsset แทนทรัพยากร AssetGroupAsset ในแคมเปญ Performance Max ที่ไม่ได้เปิดใช้หลักเกณฑ์การใช้แบรนด์
    • ข้อผิดพลาด BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL ซึ่งแสดงขึ้นเมื่อพยายามลิงก์ชิ้นงานแบรนด์กับแคมเปญเป็นทรัพยากร AssetGroupAsset แทนที่จะเป็นทรัพยากร CampaignAsset ในแคมเปญ Performance Max ที่เปิดใช้หลักเกณฑ์การใช้แบรนด์
• เพิ่ม performance_max_placement_view ซึ่งแสดงผลลัพธ์การแสดงผลของตําแหน่งโฆษณา Performance Max
• เพิ่ม AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION แล้ว

การวางแผน

• (สำหรับบัญชีในรายการที่อนุญาตเท่านั้น) เพิ่มบริการใหม่ด้วยเมธอด ContentCreatorInsightsService.GenerateCreatorInsights ซึ่งช่วยให้ผู้ใช้สำรวจข้อมูลเชิงลึกเกี่ยวกับครีเอเตอร์ YouTube ยอดนิยมได้ ซึ่งจะช่วยให้ลูกค้าค้นหาครีเอเตอร์ได้โดยใช้การผสมผสานการกำหนดกลุ่มเป้าหมายและการกําหนดเป้าหมายตามเนื้อหา หรือค้นหาข้อมูลเชิงลึกของครีเอเตอร์ได้โดยใช้รายการรหัสช่อง YouTube
• การอัปเดต AudienceInsightsService.GenerateSuggestedTargetingInsights
  • ย้าย audience, baseline_audience และ data_month ไปยัง audience_definition แล้ว
  • เพิ่ม audience_description เพื่อสร้างคําแนะนําการกําหนดเป้าหมายจากคําอธิบายแบบข้อความอิสระโดยใช้ Gen AI
• เพิ่ม AudienceInsightsService.GenerateTargetingSuggestionMetrics ซึ่งแสดงเมตริกการเข้าถึงที่เป็นไปได้สําหรับการรวมการกำหนดเป้าหมายตามกลุ่มเป้าหมายที่ระบุ

คำแนะนำ

• ตอนนี้คุณใช้ RecommendationService.GenerateRecommendations เพื่อสร้างคําแนะนําเกี่ยวกับงบประมาณที่เพิ่มประสิทธิภาพแล้วในระหว่างการสร้างแคมเปญได้โดยใส่ประเภทคําแนะนํา CAMPAIGN_BUDGET ใน GenerateRecommendationsRequest.recommendation_types[] ซึ่งใช้ได้กับแคมเปญ Performance Max และแคมเปญ Search

การรายงาน

• แทนที่ฟิลด์ summary_row_setting และ return_total_results_count ของ SearchGoogleAdsRequest ด้วยฟิลด์ search_settings ซึ่งมีประเภทเป็น SearchSettings ด้วยฟิลด์ต่อไปนี้
  • omit_results
  • return_summary_row
  • return_total_results_count
• เพิ่มเมตริกใหม่ต่อไปนี้เกี่ยวกับคลิกที่ไม่ถูกต้องทั่วไป เช่น คลิกที่เกิดจากบ็อตหรือ Crawler หรือคลิกที่มีรูปแบบผิดปกติ ซึ่งจะค้นหาได้ด้วยรายงาน campaign
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• เพิ่มค่าต่อไปนี้ลงใน QuotaError
  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

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 ออฟไลน์เพื่อแสดงจํานวน Conversion ที่อัปโหลดซึ่งยังอยู่ระหว่างการประมวลผล
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

การวางแผน

• AudienceInsights.GenerateAudienceOverlapInsights() ซึ่งรับแอตทริบิวต์หลักอินพุตและชุดแอตทริบิวต์กลุ่มเป้าหมาย และแสดงผลค่าประมาณของการทับซ้อนของการเข้าถึงที่เป็นไปได้บน YouTube ระหว่างแอตทริบิวต์หลักกับแอตทริบิวต์กลุ่มเป้าหมาย

การรายงาน

• การรองรับการแบ่งกลุ่ม per_store_view ตาม segments.date

วิดีโอ

• การรองรับการดึงข้อมูลที่เกี่ยวข้องกับกลยุทธ์การเสนอราคามาตรฐานต่อไปนี้สําหรับแคมเปญวิดีโอโดยใช้รายงาน เช่น ad_group, campaign
  • Campaign.fixed_cpm (CPM คงที่ (ต้นทุนต่อการแสดงผลพันครั้ง))
  • Campaign.target_cpv (CPV เป้าหมาย (ต้นทุนต่อการดู))
• Campaign.video_campaign_settings ซึ่งช่วยให้คุณระบุพื้นที่โฆษณาที่โฆษณาวิดีโอจะแสดงได้ โดยใช้ช่องรายงานต่อไปนี้
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type ซึ่งช่วยให้คุณแบ่งกลุ่มรายงานต่อไปนี้ตามประเภทรูปแบบโฆษณาวิดีโอได้
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

v17 (05-06-2024)

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

โฆษณา

• นำ 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 ในช่อง Enumeration ข้อผิดพลาด ของทรัพยากรทั้งหมดใน 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 ก็ตาม ซึ่งจะช่วยให้เมตริกเหล่านี้สอดคล้องกับเมตริกอื่นๆ
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

เกณฑ์

• เพิ่มลงในช่องต่อไปนี้ใน 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

การรายงาน

• ตอนนี้คุณเลือกได้เฉพาะช่องที่เกี่ยวข้องกับผลิตภัณฑ์ที่ลิงก์รายการเดียวเมื่อค้นหา 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 as MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings เมื่อตั้งค่าเป็น true ระบบจะแสดงข้อผิดพลาดที่ไม่ใช่การบล็อกซึ่งเกี่ยวข้องกับการดำเนินการที่ไม่สําเร็จเป็น MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
• ค่า enum ใหม่ใน CustomerSkAdNetworkConversionValueSchemaError
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

เกณฑ์

• ฟิลด์ใหม่ใน BrandInfo
  • display_name
  • primary_url
  • rejection_reason
  • status
• Enumeration ใหม่: 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)

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

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

• ย้ายข้อมูล 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
  • Enums:
    • 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
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

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

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

การวางแผน

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

คำแนะนำ

• เพิ่ม RecommendationService.GenerateRecommendations() ซึ่งแสดงคําแนะนําตามการตั้งค่าที่ระบุ เช่น ประเภทคําแนะนําและประเภทช่องทางโฆษณา ซึ่งจะเป็นประโยชน์อย่างยิ่งในระหว่างการสร้างแคมเปญ
• เพิ่มแล้ว RecommendationMetrics.conversions_value
• ตอนนี้คีย์เวิร์ดที่แนะนําซึ่งไม่มีการตั้งค่าประเภทการทํางานของคีย์เวิร์ดจะตั้งค่าเป็น UNSPECIFIED แทน UNKNOWNrecommended_match_type
• เพิ่มคําแนะนําประเภทต่อไปนี้
  • 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

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

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