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

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 ที่อัปโหลดซึ่งยังอยู่ระหว่างการประมวลผล
  • 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)

เราได้เพิ่มฟีเจอร์และการเปลี่ยนแปลงต่อไปนี้ในเวอร์ชัน 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 ในทุกช่อง, แจกแจง, ข้อผิดพลาดทั้งหมด ใน 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 ซึ่งทำให้สอดคล้องกับเมตริกอื่นๆ
  • 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

การรายงาน

• ตอนนี้คุณสามารถเลือกได้เฉพาะช่องที่เกี่ยวข้องกับผลิตภัณฑ์ที่ลิงก์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
  • 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
• ตอนนี้คีย์เวิร์ดที่แนะนําซึ่งมีประเภทการทำงานของคีย์เวิร์ดที่ไม่ได้ตั้งค่ามีดังนี้ 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
• นำ 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 รองรับ ประเภทสัญญาณที่แนบกับกลุ่มชิ้นงานเพื่อการกำหนดเป้าหมายที่ปรับปรุงแล้วได้
    • 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 ตามลำดับ

  • ช่อง:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enum:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• เพิ่มเมื่อ Campaign.asset_automation_settings[] เพื่อแสดงสถานะอัตโนมัติของชิ้นงานแต่ละประเภท

• เพิ่มค่าต่อไปนี้ลงในส่วน CampaignPrimaryStatusReason enum:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Conversion

• เพิ่ม CallConversion.consent และ ClickConversion.consent เพื่อให้การสนับสนุน ให้คำยินยอม โปรดดู คู่มือเกี่ยวกับ Conversion การโทร และคู่มือ Conversion การคลิกเพื่อดู รายละเอียด
• เพิ่มช่องต่อไปนี้ที่เกี่ยวข้องกับ SKAdNetwork Conversion ซึ่งสามารถใช้ได้เมื่อสืบค้นข้อมูลด้วย customer หรือ campaign:
  • กลุ่ม:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • เมตริก:
    • 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
  • กลุ่ม:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • เมตริก:
    • 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:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation มีรายละเอียดการสนทนาแบบข้อความและโทรศัพท์ เช่น conversation_channel, call_duration_millis, call_recording_url
    • URL การบันทึกการโทรได้รับการตรวจสอบสิทธิ์กับลูกค้าเป้าหมาย และบัญชีดูแลจัดการ
  • local_services_verification_artifact จะแสดงอาร์ติแฟกต์ของผู้ลงโฆษณาบริการในพื้นที่ เช่น การตรวจสอบภูมิหลัง ใบอนุญาตประกอบธุรกิจ และข้อมูลการประกันธุรกิจ เอกสารทั้งหมดที่เกี่ยวข้อง ที่มีใบอนุญาตและการประกันภัย สามารถเข้าถึงได้ผ่าน URL
    • Enum:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

การวางแผน

• เพิ่มการรองรับในการคืนสินค้า 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 ซึ่งจัดการการสมัครรับข้อมูลที่แนะนำ:
  • แหล่งข้อมูล: 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 สำหรับรายละเอียดเพิ่มเติม ดูบทความสนับสนุนสำหรับฟีด ป้ายกำกับ [label]
• นำหมวดหมู่ผลิตภัณฑ์ที่ไม่พึ่งพิงรหัสประเทศในการรายงานออก ชุดรหัสหมวดหมู่ที่รองรับไม่มีการเปลี่ยนแปลง
  • แทนที่ฟิลด์ต่อไปนี้ที่ใช้ใน 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
  • คุณเลือกเมตริกทั้งหมดเหล่านี้ได้จากรายงานต่อไปนี้
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

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

• เพิ่มเมื่อ 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

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

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