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

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

เนื้อหา

แคมเปญ

เกณฑ์

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

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

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

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

v17.1.0 (07-08-2024)

มีการเพิ่มคุณลักษณะและการอัปเดตต่อไปนี้ใน v17_1

เนื้อหา

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

  • ค่า 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

แคมเปญ

ประวัติการเปลี่ยนแปลง

  • ประเภททรัพยากรสถานะการเปลี่ยนแปลงใหม่: ASSET_GROUP

Conversion

การวางแผน

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

การรายงาน

วิดีโอ

v17 (05-06-2024)

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

โฆษณา

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

เนื้อหา

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

งานแบบกลุ่ม

แคมเปญ

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

Conversion

เกณฑ์

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

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

  • เพิ่ม LocalServicesLeadService.AppendLeadConversation() แล้ว ใช้เพื่อต่อท้ายค่าใหม่ LocalServicesLeadConversation ไปยัง LocalServicesLead ซึ่งจะส่งข้อมูล ข้อความให้แก่ผู้ใช้ผ่านช่องทางที่เหมาะสมอย่าง SMS โดยขึ้นอยู่กับว่า สร้างโอกาสในการขายแล้ว
  • เพิ่มค่า 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

การรายงาน

Shopping

  • เพิ่มรายงานใหม่ shopping_product ซึ่งสอดคล้องกับหน้าผลิตภัณฑ์ของ UI ของ Google Ads ฟีเจอร์นี้รองรับการแสดงผลข้อมูลที่เกี่ยวข้องกับสถานะปัจจุบันของผลิตภัณฑ์จากบัญชี Google Merchant Center ที่ลิงก์กับบัญชี Google Ads

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

วิดีโอ

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

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

เนื้อหา

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

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

แคมเปญ

Conversion

เกณฑ์

การทดสอบ

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

วิดีโอ

v16 (21-02-2024)

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

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

  • ย้ายข้อมูล 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
    • Enums:
    • ข้อผิดพลาด:
  • เพิ่มแล้ว 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

การทดลอง

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

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

การวางแผน

คำแนะนำ

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

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

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

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