Ghi chú phát hành

Phiên bản 17.1.0 (07/08/2024)

Các tính năng và nội dung cập nhật mới sau đây đã được thêm vào phiên bản 17_1.

Thành phần

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() cho phép bạn xoá những thành phần được tạo tự động được liên kết với Quảng cáo tìm kiếm thích ứng.

Đối tượng

• Các giá trị enum mới trong 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

Chiến dịch

• ShareablePreviewService.GenerateShareablePreviews() tạo URL (shareable_preview_url trong câu trả lời) để xem trước quảng cáo có thể chia sẻ cho các nhóm thành phần đã bật và đang tạm dừng.
  • Trường expiration_date_time cho biết ngày hết hạn của các URL trong phản hồi.
  • Nếu xảy ra lỗi, phương thức này sẽ trả về partial_failure_error thay vì URL.

Lịch sử thay đổi

• Loại tài nguyên trạng thái thay đổi mới: ASSET_GROUP.

Lượt chuyển đổi

• Trường phân đoạn mới cho phiên bản SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary hiển thị thông tin chẩn đoán về lượt tải lượt chuyển đổi lên ở cấp hành động chuyển đổi.
• Các chỉ số sau đây được thêm vào báo cáo chẩn đoán ngoại tuyến để thể hiện số lượt chuyển đổi đã tải lên vẫn đang được xử lý:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Lập kế hoạch

• AudienceInsights.GenerateAudienceOverlapInsights() chấp nhận thuộc tính chính đầu vào và một tập hợp các thuộc tính đối tượng, đồng thời trả về số liệu ước tính về phạm vi tiếp cận tiềm năng trên YouTube giữa thuộc tính chính và thuộc tính đối tượng.

Báo cáo

• Hỗ trợ phân đoạn per_store_view dựa trên segments.date

Video

• Hỗ trợ truy xuất thông tin liên quan đến các chiến lược đặt giá thầu chuẩn sau đây cho những chiến dịch video sử dụng các báo cáo, chẳng hạn như ad_group, campaign:
  • Campaign.fixed_cpm (CPM cố định (chi phí mỗi nghìn lượt hiển thị))
  • Campaign.target_cpv (CPV (chi phí mỗi lượt xem) mục tiêu)
• Campaign.video_campaign_settings cho phép bạn xác định những khoảng không quảng cáo có thể hiển thị quảng cáo dạng video thông qua các trường báo cáo sau:
  • 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 cho phép bạn phân đoạn các báo cáo sau dựa trên loại định dạng quảng cáo dạng video:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

phiên bản 17 (05/06/2024)

Các tính năng và thay đổi sau đây đã được thêm vào phiên bản 17.

Quảng cáo

• Đã xoá AdService.getAd. Điều này mang lại AdService phù hợp với các dịch vụ khác trong API Google Ads. Hãy xem phần Truy xuất đối tượng để cách đề xuất để tìm nạp quảng cáo và các loại tài nguyên khác.
• Đã thêm các quy trình xác thực khác cho ImageAdInfo.image_asset về thứ nguyên và định dạng. Các lỗi sau có thể xảy ra nếu hình ảnh không hợp lệ:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Thành phần

• Thêm enum mới: ClickType.AD_IMAGE
• Đã thêm các báo cáo mới sau đây chứa các chỉ số mới cho chiến dịch Tối đa hoá hiệu suất và chiến dịch Tìm kiếm:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Đối tượng

• Đã thêm OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Công việc hàng loạt

• Đã thêm BatchJobError.REQUEST_TOO_LARGE, giá trị này sẽ được gửi khi AddBatchJobOperationsRequest đã gửi lớn hơn 10484504 byte.
• Hỗ trợ thêm cho chế độ cài đặt MutateOperation.asset_group_operation khi dùng BatchJobService. Điều này cho phép bạn sử dụng xử lý hàng loạt để tạo và quản lý toàn bộ chiến dịch Tối đa hoá hiệu suất. Hãy xem hướng dẫn chuyên dụng mới của chúng tôi.

Chiến dịch

• Đổi tên chiến dịch Khám phá thành chiến dịch Tạo nhu cầu trong tất cả các trường, enum, lỗi trong tất cả trên API Google Ads, chẳng hạn như chiến dịch, quảng cáo và thành phần. Để ví dụ: AdvertisingChannelType.DISCOVERY hiện là AdvertisingChannelType.DEMAND_GEN.
• Đã thêm Campaign.keyword_match_type để đặt kiểu khớp từ khoá cho tất cả từ khoá trong một chiến dịch.

Lượt chuyển đổi

• Đối với SKAdNetwork lượt chuyển đổi,
  • Đổi tên segments.sk_ad_network_conversion_value thành segments.sk_ad_network_fine_conversion_value.
  • Đã thêm segments.sk_ad_network_redistributed_fine_conversion_value.
• Các chỉ số sau đây hiện được trả về cùng với phản hồi ngay cả khi chúng đều bằng 0. Điều này giúp chúng nhất quán với các chỉ số khác.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Tiêu chí

• Đã thêm vào các trường sau đây vào AdGroupCriterion để cho biết liệu tiêu chí của nhóm quảng cáo có đang phân phát hay không hoặc lý do khiến tiêu chí đó không phân phát phân phát:
  • primary_status
  • primary_status_reasons
• Hỗ trợ thêm cho metrics.search_impression_share cho gender_view
• Đã thêm khả năng hỗ trợ cho metrics.phone_calls cho keyword_view

Dịch vụ địa phương

• Đã thêm LocalServicesLeadService.AppendLeadConversation() được sử dụng để thêm một thẻ mới LocalServicesLeadConversation đến LocalServicesLead, thao tác này sẽ gửi gửi tin nhắn cho người dùng thông qua các kênh thích hợp như SMS, tuỳ thuộc vào khách hàng tiềm năng đã được tạo.
  • Kích thước của AppendLeadConversationRequest.conversations bị giới hạn đến 1.000.
  • Chỉ LocalServicesLead với Đã đặt lead_type thành LeadType.MESSAGE có thể được chỉ định trong Conversation.local_services_lead.
• Thêm các giá trị enum mới vào ConversationType:
  • WHATSAPP để đại diện cho một cuộc trò chuyện được giới thiệu qua WhatsApp.
  • ADS_API để đại diện cho một cuộc trò chuyện được giới thiệu bằng LocalServicesLeadService.AppendLeadConversation() .
• Thêm các trường mới sau đây vào local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Báo cáo

• Giờ đây, bạn chỉ có thể chọn những trường liên quan đến một sản phẩm được liên kết khi truy vấn product_link. Chọn nhiều của một số sản phẩm được liên kết sẽ gửi ra QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Ví dụ: product_link.advertising_partner.customer và product_link.data_partner.data_partner_id Không thể chọn trong cùng một truy vấn.
• Truyền page_size đến GoogleAdsService.Search sẽ dẫn đến RequestError.PAGE_SIZE_NOT_SUPPORTED .

Mua sắm

• Đã thêm báo cáo mới shopping_product. Báo cáo này tương ứng với trang Sản phẩm của giao diện người dùng Google Ads. Hỗ trợ trả lại hàng dữ liệu liên quan đến trạng thái hiện tại của sản phẩm trong Google Merchant Center tài khoản Google Ads được liên kết với Tài khoản Google Ads.
  • Bạn có thể lọc các chỉ số từ shopping_product báo cáo sử dụng segments.date khi sử dụng GoogleAdsService.Search hoặc GoogleAdsService.SearchStream. Không được phép phân đoạn theo ngày và sẽ trả về ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION .

Mục tiêu hợp nhất

• Đã thêm UserListCustomerTypeService.MutateUserListCustomerTypes() để định cấu hình khách hàng là đối tượng các loại.
• Đã xoá CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Để thiết lập chế độ cài đặt đối tượng cho các mục tiêu trong vòng đời của khách hàng, hãy sử dụng Hãy UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Đính kèm hoặc hủy đính kèm danh sách người dùng bằng cách cài đặt UserListCustomerType.customer_type_category đến UserListCustomerTypeCategory.PURCHASERS để bao gồm hoặc loại trừ dữ liệu đó khỏi định nghĩa về khách hàng hiện tại cho các mục tiêu trong vòng đời của khách hàng. Truy cập phân đoạn đối tượng để biết thêm chi tiết.

Video

• Đã thêm các giá trị sau vào ContentLabelType. Bạn có thể loại trừ những ContentLabelTypes này ở cấp khách hàng:
  • 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
• Đã thêm AdVideoAsset.ad_video_asset_info để hỗ trợ các lựa chọn ưu tiên về khoảng không quảng cáo cho nội dung video khi tạo DemandGenVideoResponsiveAdInfo.
• (Chỉ những tài khoản có trong danh sách cho phép) Đã tạo Campaign.video_brand_safety_suitability có thể thay đổi.

Phiên bản 16.1.0 (24/04/2024)

Các tính năng và thay đổi sau đây đã được thêm vào phiên bản 16.1.

Quản lý tài khoản

• CustomerNegativeCriterion.ip_block cho phép thêm một IP làm tiêu chí phủ định ở cấp khách hàng.
• Giá trị enum mới: ProductLinkError.LINK_EXISTS.
• Giá trị enum mới: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION.

Thành phần

• Hỗ trợ cho những thành phần có liên quan đến chiến dịch Tạo nhu cầu để ad_group_ad_asset_view và asset_field_type_view.
• Giá trị enum mới: AssetFieldType.DISCOVERY_CAROUSEL_CARD.

Đối tượng

• Giá trị enum mới: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER để giới hạn số lượng danh sách người dùng tương tự mà một khách hàng có thể có ở mức 1.000.

Chiến dịch

• Hỗ trợ trả về Target (Mục tiêu) Trình mô phỏng giá thầu của chiến dịch ROAS cho Chiến dịch Quảng cáo ứng dụng sử dụng campaign_simulation.
• Giá trị enum mới: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN.
• Giá trị enum mới: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY.
• Giá trị enum mới: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS.

Lượt chuyển đổi

• SkAdNetworkConversionValueSchema.postback_mappings hỗ trợ SKAdNetwork 4 các tính năng AI mới.
• Bổ sung tính năng hỗ trợ cho các cảnh báo đối với CustomerSkAdNetworkConversionValueSchemaService dưới dạng MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Khi bạn đặt thành true, mọi lỗi không chặn liên quan đến lỗi thao tác sẽ được trả về dưới dạng MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning.
• Các giá trị enum mới trong CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Tiêu chí

• Các trường mới trong BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Enum mới: BrandRequestRejectionReason.
• Giá trị enum mới: CriterionType.LIFE_EVENT.

Thử nghiệm

• Giá trị enum mới: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Dịch vụ địa phương

• local_services_lead.credit_details.credit_state và local_services_lead.credit_details.credit_state_last_update_date_time Hàm này trả về trạng thái tín dụng và dấu thời gian khi trạng thái tín dụng đã được cập nhật.
• local_services_lead_conversation.message_details.attachment_urls Lệnh này trả về các URL có thể dùng để tải xuống nội dung của tệp đính kèm.

Video

• customer.video_brand_safety_suitability và BrandSafetySuitability hỗ trợ truy xuất mức độ phù hợp của video đối với sự an toàn đối với thương hiệu cho khách hàng cấp độ.
• Giá trị enum mới: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

phiên bản 16 (21/02/2024)

Các tính năng và thay đổi sau đây đã được thêm vào phiên bản 16.

Quản lý tài khoản

• Đã di chuyển advertising_partner từ AccountLink đến ProductLink và ProductLinkInvitation.
• Đã xoá data_partner và google_ads khỏi AccountLink.
• Đã thêm IdentityVerificationService đến quản lý quy trình xác minh nhà quảng cáo.
  • StartIdentityVerification() được dùng để bắt đầu phiên xác minh bằng verification_program. Phương thức này tạo một phiên xác minh mới và trả về một phản hồi trống cho một đã tạo thành công xác minh.
    • Đã thêm IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
  • GetIdentityVerification() có thể được sử dụng để truy xuất thông tin xác minh, mà trả về một số đối tượng của IdentityVerification. Mỗi IdentityVerification bao gồm:
    • verification_program là loại chương trình xác minh danh tính
    • identity_verification_requirement chứa thông tin chi tiết liên quan đến thời hạn mà nhà quảng cáo cần hoàn tất quy trình xác minh
    • verification_progress có chứa thông tin chi tiết liên quan đến phiên xác minh, bao gồm:
      • program_status thể hiện trạng thái hiện tại của yêu cầu này phiên xác minh
      • action_url chuyển hướng khách hàng đến một URL để hoàn tất xác minh.
      • invitation_link_expiration_time đại diện cho ngày hết hạn cho action_url
  • Enum:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Lỗi:
    • IdentityVerificationError
• Đã thêm AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

Thành phần

• Các thay đổi đối với asset_group:
  • Hỗ trợ thêm cho các phân đoạn liên quan đến thời gian, chẳng hạn như segments.year và segments.month.
  • Đặt campaign thành tài nguyên được phân bổ thay vì tài nguyên phân đoạn.

Chiến dịch

• Các thay đổi đối với chiến dịch Tạo nhu cầu:
  • Hỗ trợ thêm cho chế độ cài đặt Campaign.shopping_setting đến chiến dịch Tạo nhu cầu hiện có.
  • Đã thêm ShoppingSetting.disable_product_feed để tắt nguồn cấp dữ liệu sản phẩm không bắt buộc của chiến dịch Tạo nhu cầu.
  • Đã thêm Ad.demand_gen_product_ad và thuộc tính tương ứng DemandGenProductAdInfo, dành cho Chiến dịch Tạo nhu cầu có giá trị không rỗng Campaign.shopping_setting.
• Đã thêm vào các trường sau đây vào AdGroup để cho biết liệu nhóm quảng cáo đang phân phát hoặc lý do khiến nhóm quảng cáo không phân phát:
  • primary_status
  • primary_status_reasons
• Đã thêm vào các trường sau đây vào AdGroupAd để hiển thị liệu quảng cáo của nhóm quảng cáo có đang phân phát hay không hoặc lý do khiến quảng cáo không phân phát:
  • primary_status
  • primary_status_reasons
• Đã thêm các giá trị sau vào AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Thử nghiệm

• Đã thêm Experiment.sync_enabled vào chỉ định xem có nên bật tính năng đồng bộ hóa trong thử nghiệm hay không. Bằng tính năng đồng bộ hoá đã bật, các thay đổi được thực hiện đối với chiến dịch gốc trong khi thử nghiệm của bạn đang chạy sẽ tự động sao chép vào chiến dịch thử nghiệm.
• Đã thêm ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
• Đã thêm CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

Khách sạn và Dùng khi đi du lịch

• Đã thêm các trường sau vào ListingDimensionInfo cho Điểm tham quan quảng cáo để cho phép tạo nhóm trang thông tin dựa trên tiểu bang và thành phố nơi hoạt động đi lại có sẵn:
  • activity_state
  • activity_city
• Đã thêm hỗ trợ cho các phân đoạn sau vào travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Dịch vụ địa phương

• Đã thêm LocalServicesVerificationArtifact.business_registration_check_verification_artifact và BusinessRegistrationCheckArtifact giúp nhà quảng cáo theo dõi tiến trình đăng ký kinh doanh xác minh.
• Đã thêm tài nguyên mới local_services_employee để cho phép nhà quảng cáo để truy xuất thông tin về nhân viên mà họ đã thêm.

Lập kế hoạch

• Đã xoá score khỏi AudienceInsightsAttributeMetadata.

Đề xuất

• Đã thêm RecommendationService.GenerateRecommendations() Phương thức này trả về các đề xuất dựa trên chế độ cài đặt đã chỉ định, chẳng hạn như loại đề xuất và loại kênh quảng cáo. Điều này đặc biệt hữu ích trong quá trình tạo chiến dịch.
• Đã thêm RecommendationMetrics.conversions_value.
• Từ khóa được đề xuất chưa đặt loại so khớp từ khóa hiện có recommended_match_type được đặt thành UNSPECIFIED thay vì UNKNOWN.
• Đã thêm các loại đề xuất sau:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN đề xuất sử dụng chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi chiến thuật
  • IMPROVE_GOOGLE_TAG_COVERAGE Chương trình này khuyến nghị triển khai Thẻ Google trên nhiều trang hơn
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN Theo đó, bạn nên bật tính năng mở rộng URL cuối cùng cho chiến dịch Tối đa hoá hiệu suất các chiến dịch
  • REFRESH_CUSTOMER_MATCH_LIST Loại chiến dịch này đề xuất cập nhật một danh sách khách hàng chưa được cập nhật 90 ngày qua
  • CUSTOM_AUDIENCE_OPT_IN đề xuất tạo một đối tượng tuỳ chỉnh
  • LEAD_FORM_ASSET đề xuất thêm thành phần biểu mẫu khách hàng tiềm năng vào chiến dịch hoặc chiến dịch cho khách hàng cấp độ
  • IMPROVE_DEMAND_GEN_AD_STRENGTH Mục này đề xuất cải thiện độ mạnh của quảng cáo trên chiến dịch Tạo nhu cầu

Mua sắm

• Đã thêm CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT và CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS để cung cấp các lỗi chi tiết hơn cho các chiến dịch Mua sắm được liên kết với Trung tâm dịch vụ so sánh giá tài khoản.
• Đã thêm các giá trị sau vào 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

Mục tiêu về vòng đời

• Đã thêm update vào CustomerLifecycleGoalOperation và CampaignLifecycleGoalOperation để làm cho các loại thao tác này nhất quán với các loại thao tác khác trong API.

phiên bản 15 (18/10/2023)

Các tính năng và nội dung cập nhật mới sau đây đã ra mắt trong phiên bản 15.

Quản lý tài khoản

• Nếu tài khoản của bạn bị tạm ngưng do tài khoản trái phép hoạt động, customer.status và customer_client.status hiện được trả về dưới dạng SUSPENDED Trước đây, các trang này được trả về dưới dạng ENABLED.
• Đã thêm tuỳ chọn hỗ trợ cho việc thêm và xoá mối liên kết giữa tài khoản Google Ads và tài khoản Merchant Center:
  • Đã thêm ProductLink.merchant_center và MerchantCenterIdentifier.
  • Đã thêm LinkedProductType.MERCHANT_CENTER.
• Đã thêm ProductLinkInvitationService và ProductLinkInvitation để hỗ trợ cập nhật lời mời liên kết được gửi từ các sản phẩm khác, có sẵn cho Khách sạn Center và Người bán Center.
• Đã xoá MerchantCenterLinkService.
  • Để liên kết tài khoản Google Ads với tài khoản Merchant Center, hãy sử dụng ProductLinkInvitationService và ProductLinkService.
• Đã xoá AccountLink.hotel_center và hỗ trợ cập nhật lời mời liên kết trong các tài khoản Hotel Center đang sử dụng AccountLinkService.
  • Để cập nhật lời mời liên kết từ tài khoản Hotel Center, hãy sử dụng ProductLinkInvitationService.

Thành phần

• Đã thay thế ImageAdInfo.media_file bằng ImageAdInfo.image_asset để hỗ trợ thêm và xoá hình ảnh bằng thành phần đồ hoạ. Do đó, chúng tôi cũng đã gỡ bỏ MediaFileService không còn cần thiết nữa.
• Đã thêm ListingGroupFilterDimension.webpage để hỗ trợ việc tạo bộ lọc nhóm trang thông tin dựa trên URL và nhãn tuỳ chỉnh chuỗi con.
  • Cũng đã thay thế AssetGroupListingGroupFilter.vertical bằng AssetGroupListingGroupFilter.listing_source và ListingGroupFilterListingSource
• Đã thêm asset_group_asset.source để hiển thị nguồn của thành phần trong nhóm thành phần.
• Đã thêm ad_group_ad_asset_view.source đến hiển thị nguồn của thành phần quảng cáo cấp nhóm quảng cáo.

Đối tượng

• Đối với tính năng So khớp khách hàng, đã thêm CustomerMatchUserListMetadata.consent để hỗ trợ việc đưa ra sự đồng ý. Kể từ ngày 6 tháng 3 năm 2024 nếu bạn đã đồng ý bị thiếu đối với người dùng ở EEA, thì giá trị đồng ý được xác định là không đồng ý. Dữ liệu từ những người dùng ở EEA không đồng ý sẽ không được xử lý và không thể dùng để quảng cáo cá nhân hoá bằng tính năng So khớp khách hàng. Hãy khám phá Hướng dẫn sử dụng tính năng So khớp khách hàng để biết thêm chi tiết.
• Đối với Lượt bán hàng tại cửa hàng thực tế, đã thêm UserData.consent vào hỗ trợ đưa ra sự đồng ý. Hãy khám phá Hướng dẫn về Lượt bán hàng tại cửa hàng thực tế cho chi tiết hơn. Nếu bạn đang sử dụng tính năng So khớp khách hàng với lượt bán hàng tại cửa hàng thực tế, hãy xem xét Câu hỏi thường gặp để biết thêm của bạn.
• Đã thêm UserList.lookalike_user_list đến hỗ trợ tạo một Tương tự , một đối tượng đã tạo dựa trên đối tượng gốc hiện có được cung cấp. Bạn có thể sử dụng phân khúc tương tự trong chiến dịch Tạo nhu cầu .

Chiến dịch

• Nội dung cập nhật đối với chiến dịch Tối đa hoá hiệu suất:

  • AssetGroupSignal hiện hỗ trợ cho 2 các loại tín hiệu có thể được đính kèm vào một nhóm thành phần để nhắm mục tiêu nâng cao:
    • AssetGroupSignal.audience
      • Đã thêm Audience.scope và Audience.asset_group để giới hạn mức sử dụng đối tượng cho một nhóm thành phần cụ thể. Bạn phải đặt Audience.asset_group khi và chỉ khi Audience.scope là ASSET_GROUP.
    • AssetGroupSignal.search_theme
      • Đã thêm CriterionType.SEARCH_THEME để hỗ trợ loại tiêu chí mới này. Loại tiêu chí mới này chỉ có thể được dùng trong chiến dịch Tối đa hoá hiệu suất để tạo AssetGroupSignal bằng cách điền sẵn AssetGroupSignal.search_theme với tiêu chí SearchThemeInfo.
  • Đã thêm AssetGroupSignalOperation.exempt_policy_violation_keys để hỗ trợ việc yêu cầu miễn trừ khi thêm tín hiệu về nhóm thành phần.
  • Đã thêm phần mới asset_group_top_combination_view để báo cáo những thành phần hoạt động hiệu quả nhất ở cấp nhóm thành phần.
  • asset_group hiện có thể được truy vấn bằng các trường chỉ số để hỗ trợ việc truy xuất hiệu suất của chiến dịch Tối đa hoá hiệu suất.
  • Ngang bằng PerformanceMaxUpgradeStatus, đổi tên UPGRADE_ELIGIBLE thành UPGRADE_ELIGIBLE.

• Đối với chiến dịch Tạo nhu cầu và Khám phá Chiến dịch CPA mục tiêu, công cụ mô phỏng giá thầu CPA mục tiêu ở cấp chiến dịch (campaign_simulation.target_cpa_point_list.points) giờ sẽ quay lại TargetCpaSimulationPoint.interactions thay vì TargetCpaSimulationPoint.clicks

• Đã thêm BrandSuggestionService có thể đề xuất các thương hiệu dựa trên tiền tố thương hiệu đã cung cấp và danh sách bị loại trừ thương hiệu khác. Bạn có thể sử dụng các thương hiệu này để tạo Đã thêm tiêu chí BRAND với một nhóm chia sẻ BRANDS, rồi đính kèm vào chiến dịch bằng cách tạo CampaignCriterion với brand_list được đặt thành nhóm dùng chung. Bạn có thể nhắm mục tiêu tiêu chí chiến dịch trong Chiến dịch tìm kiếm và loại trừ tiêu chí này trong Chiến dịch Tối đa hoá hiệu suất.

  • Trường:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enum:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Đã thêm Campaign.asset_automation_settings[] để cho biết trạng thái tự động hoá của từng loại thành phần.

• Đã thêm các giá trị sau vào phương thức CampaignPrimaryStatusReason enum:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Lượt chuyển đổi

• Đã thêm CallConversion.consent và ClickConversion.consent để hỗ trợ đưa ra sự đồng ý. Hãy khám phá hướng dẫn chuyển đổi cuộc gọi và hướng dẫn về lượt chuyển đổi từ lượt nhấp để tìm hiểu thêm chi tiết.
• Thêm các trường sau liên quan đến SKAdNetwork chuyển đổi, có sẵn khi truy vấn chúng bằng customer hoặc campaign:
  • Phân đoạn:
    • 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
  • Chỉ số:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• Đã thay thế metrics.sk_ad_network_conversions bằng metrics.sk_ad_network_installs.
• Thêm tính năng hỗ trợ chẩn đoán lượt tải lượt chuyển đổi ngoại tuyến lên
  • Đã di chuyển offline_conversion_upload_client_summary từ một trường trên tài nguyên customer thành một báo cáo cấp cao nhất. Sử dụng bản thảo này để biết thông tin chi tiết hữu ích về trạng thái tải lượt chuyển đổi lên, chẳng hạn như số lượng sự kiện thành công, tỷ lệ thành công và tỷ lệ phần trăm lỗi.
    • Caveat: Lượt chuyển đổi được tải lên nhưng dẫn đến kết quả là ConversionUploadError.CLICK_NOT_FOUND lỗi vẫn được tính là thành công, nhưng cũng bị gắn cờ là OfflineConversionAlert.
  • Thêm job_id làm tham số không bắt buộc cho các loại yêu cầu sau đây để bạn có thể nhóm hợp lý nhiều yêu cầu tải lên vào một báo cáo khái niệm việc làm:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • Đã thêm INVALID_JOB_ID vào các lỗi sau:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • Đã thay thế INVALID_CONVERSION_ACTION bằng NO_CONVERSION_ACTION_FOUND và INVALID_CONVERSION_ACTION_TYPE trong các lỗi sau:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Thêm 3 báo cáo để hỗ trợ Nhiều mạng trong Hộp cát về quyền riêng tư của Android phân bổ mà không có lệnh chuyển hướng:
  • android_privacy_shared_key_google_campaign có chứa shared_campaign_key và một số trường giúp mã hoá khoá.
  • android_privacy_shared_key_google_ad_group có chứa shared_ad_group_key và một số trường giúp mã hoá khoá.
  • android_privacy_shared_key_google_network_type có chứa shared_network_type_key và một số trường giúp mã hoá khoá.
• Đã thêm ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Một ConversionActionOperation cố gắng sử dụng một trong các phân bổ dựa trên quy tắc không dùng nữa mô hình hiện không thành công với lỗi này. Trước đây, thao tác sẽ không thành công với UNKNOWN lỗi.

Khách sạn và Dùng khi đi du lịch

• Đã thêm hỗ trợ cho các trường sau trong travel_activity_group_view và travel_activity_performance_view:
  • Phân đoạn:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • Chỉ số:
    • 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

Quảng cáo dịch vụ địa phương

• Đã thêm LocalServicesSettings và vào báo cáo customer để trả về một chiến dịch Địa phương Trạng thái giấy phép và bảo hiểm chi tiết của nhà quảng cáo dịch vụ.
• Đã thêm các báo cáo mới sau cho báo cáo Địa phương Dịch vụ:
  • local_services_lead chứa tất cả thông tin chi tiết liên quan đến Dịch vụ địa phương Khách hàng tiềm năng trên Google Ads như lead_charged, lead_type, lead_status.
    • Enum:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation chứa thông tin chi tiết về tin nhắn và cuộc trò chuyện qua điện thoại như conversation_channel, call_duration_millis, call_recording_url.
    • URL ghi âm cuộc gọi điện thoại được xác thực dựa trên khách hàng mục tiêu tài khoản và tài khoản người quản lý của tài khoản đó.
  • local_services_verification_artifact trả về các cấu phần phần mềm của nhà quảng cáo Dịch vụ địa phương như kiểm tra lai lịch, giấy phép kinh doanh và dữ liệu bảo hiểm doanh nghiệp. Mọi giấy tờ liên quan có giấy phép và bảo hiểm đều có thể truy cập được thông qua URL.
    • Enum:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Lập kế hoạch

• Thêm tính năng hỗ trợ để trả về Forecast.views và PlannedProductForecast.views cho ReachPlanService.ListPlannableProducts cho các loại sản phẩm thích hợp.
• Đã thêm tuỳ chọn hỗ trợ để trả lại hàng PlannableTargeting.surface_targeting với ReachPlanService.ListPlannableProducts, mô tả các nền tảng có sẵn của một sản phẩm.
• Đã thêm phần mới Enum ReachPlanSurface.
• Đã thêm hỗ trợ cho tính năng nhắm mục tiêu Mục tiêu tần suất sử dụng AdvancedProductTargeting.target_frequency_settings, trả về PlannedProductForecast.average_frequency.
• Đã thêm AudienceInsightsService.GenerateSuggestedTargetingInsights để trả về các đối tượng có thể nhắm mục tiêu được đề xuất.
• Đã thêm các giá trị sau vào ReachPlanError:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Đề xuất

• Đã thêm RecommendationSubscriptionService Công cụ này quản lý các gói thuê bao đề xuất:
  • Tài nguyên: RecommendationSubscription
  • Trường: MutateOperation.recommendation_subscription_operation
  • Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Lỗi:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• Đã thêm các loại đề xuất sau:
  • FORECASTING_SET_TARGET_CPA Loại chiến dịch này đề xuất đặt CPA mục tiêu cho các chiến dịch không có CPA mục tiêu được chỉ định trước một sự kiện theo mùa được dự báo sẽ tăng lưu lượng truy cập.
  • SET_TARGET_CPA Loại chiến dịch này đề xuất đặt CPA mục tiêu cho các chiến dịch không có CPA mục tiêu đã chỉ định.
  • SET_TARGET_ROAS Loại chiến dịch này đề xuất đặt lợi tức mục tiêu trên chi tiêu quảng cáo cho các chiến dịch không có lợi tức mục tiêu trên chi tiêu quảng cáo đã chỉ định.

Báo cáo

• Đã thêm các chỉ số mới sau đây. Các chỉ số này có thể được truy vấn bằng campaign (có sẵn cho chiến dịch Hiển thị, chiến dịch Video, chiến dịch Khám phá và Chiến dịch quảng cáo ứng dụng) và segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Mua sắm

• Xoá ShoppingSetting.sales_country, có giá trị hiện được trả về là ShoppingSetting.feed_label.
  • Bạn có thể tiếp tục sử dụng một Merchant Center cụ thể nguồn cấp dữ liệu cho chiến dịch bằng cách sử dụng thời gian ShoppingSetting.feed_label . Bạn phải đặt thuộc tính này thành giá trị của nhãn nguồn cấp dữ liệu hoặc quốc gia gồm hai chữ cái mã từng dùng cho ShoppingSetting.sales_country. Để biết thêm thông tin, hãy xem bài viết hỗ trợ về nguồn cấp dữ liệu nhãn.
• Đã xoá phần phụ thuộc của danh mục sản phẩm trên một mã quốc gia trong báo cáo. Bộ mã danh mục được hỗ trợ không thay đổi.
  • Đã thay thế các trường được sử dụng sau trong shopping_performance_view:
    • segments.product_bidding_category_level1 bằng segments.product_category_level1
    • segments.product_bidding_category_level2 bằng segments.product_category_level2
    • segments.product_bidding_category_level3 bằng segments.product_category_level3
    • segments.product_bidding_category_level4 bằng segments.product_category_level4
    • segments.product_bidding_category_level5 bằng segments.product_category_level5
  • Đã thay thế product_bidding_category_constant bằng product_category_constant: trả về tất cả thông tin bản địa hoá có sẵn của một danh mục trong trường lặp lại.
  • Đã thay thế ListingDimensionInfo.product_bidding_category bằng ListingDimensionInfo.product_category.
  • Đã thay thế ListingGroupFilterDimension.product_bidding_category bằng ListingGroupFilterDimension.product_category.
• Đã ngừng hỗ trợ việc thêm Campaign.shopping_setting đến Google Tìm kiếm . Khi cố gắng tạo một chiến dịch Tìm kiếm bằng Campaign.shopping_setting hoặc thêm Campaign.shopping_setting đến một Chiến dịch Tìm kiếm hiện tại giờ đây sẽ mang lại OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Đã ngừng hỗ trợ việc thêm CampaignCriterion.listing_scope đến chiến dịch Tìm kiếm. Đang cố gắng thêm CampaignCriterion.listing_scope chiến dịch Tìm kiếm hiện có giờ đây sẽ mang lại OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Đã thêm lượt chuyển đổi có giỏ hàng sau đây :
  • 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
  • Bạn có thể chọn tất cả các chỉ số này bằng các báo cáo sau:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Mục tiêu hợp nhất

• Đã thêm CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals để thiết lập mục tiêu thu nạp khách hàng ở cấp khách hàng.
  • Báo cáo: customer_lifecycle_goal
• Đã thêm CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals để thiết lập mục tiêu thu nạp khách hàng ở cấp chiến dịch.
  • Báo cáo: campaign_lifecycle_goal
• Đã thêm CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN.
• Đã thêm các giá trị sau vào ConversionGoalCampaignConfigError:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

Video

• Hỗ trợ thêm tính năng nhắm mục tiêu Google TV ở cấp chiến dịch:
  • Đã thêm NetworkSettings.target_google_tv_network
  • Đã thêm AdNetworkType.GOOGLE_TV.
• Đã thêm tùy chọn hỗ trợ cho việc nhắm mục tiêu YouTube ở cấp chiến dịch:
  • Đã thêm NetworkSettings.target_youtube
  • Trong AdNetworkType, đã hợp nhất YOUTUBE_WATCH và YOUTUBE_SEARCH vào YOUTUBE.
  • Đã thêm CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE.

Ghi chú phát hành đã lưu trữ

Bạn có thể xem Phiên bản ngừng hoạt động để biết các ghi chú phát hành đã lưu trữ.