Ghi chú phát hành

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. Nhờ đó, AdService phù hợp với các dịch vụ khác trong API Google Ads. Xem phần Truy xuất đối tượng để biết cách thức được đề xuất để tìm nạp quảng cáo và các loại tài nguyên khác.
• Thêm nhiều quy trình xác thực hơn cho ImageAdInfo.image_asset liên quan đến các phương diệ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, sẽ được gửi khi AddBatchJobOperationsRequest đã gửi lớn hơn 10484504 byte.
• Hỗ trợ thêm chế độ cài đặt MutateOperation.asset_group_operation khi sử dụng BatchJobService. Điều này cho phép bạn sử dụng tính năng xử lý theo lô để 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 của tất cả tài nguyên 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 để cho phép bạn đặt kiểu khớp từ khoá cho tất cả từ khoá trong chiến dịch.

Lượt chuyển đổi

• Đối với các lượt chuyển đổi SKAdNetwork,
  • Đổ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 giá trị bằng 0. Nhờ đó, các chỉ số này 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í

• Được thêm vào các trường sau vào AdGroupCriterion để cho biết liệu tiêu chí 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:
  • primary_status
  • primary_status_reasons
• Thêm tính năng hỗ trợ cho metrics.search_impression_share cho gender_view
• Thêm tính năng hỗ trợ cho metrics.phone_calls cho keyword_view

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

• Thêm LocalServicesLeadService.AppendLeadConversation() dùng để thêm LocalServicesLeadConversation mới vào LocalServicesLead. Tính năng này sẽ gửi tin nhắn đến người dùng thông qua các kênh thích hợp như SMS tuỳ thuộc vào cách tạo khách hàng tiềm năng.
  • Kích thước của AppendLeadConversationRequest.conversations bị giới hạn ở 1.000.
  • Bạn chỉ có thể chỉ định LocalServicesLead có lead_type được đặt thành LeadType.MESSAGE 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 cuộc trò chuyện được giới thiệu bằng phương thức LocalServicesLeadService.AppendLeadConversation() mới.
• 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

• Thêm giá trị mới vào QuotaError, dùng cho quá nhiều yêu cầu tốn kém trong một khoảng thời gian. Để biết thêm thông tin, hãy xem bài viết Nội dung cập nhật Chính sách sử dụng tài nguyên của API Google Ads.
  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION
• Giờ đây, bạn chỉ có thể chọn các trường liên quan đến một sản phẩm được liên kết khi truy vấn product_link. Việc chọn nhiều trường trong 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ụ: bạn không thể chọn product_link.advertising_partner.customer và product_link.data_partner.data_partner_id trong cùng một truy vấn.
• Việc chuyển page_size đến GoogleAdsService.Search sẽ dẫn đến lỗi RequestError.PAGE_SIZE_NOT_SUPPORTED.

Mua sắm

• Thêm một báo cáo mới shopping_product, tương ứng với trang Sản phẩm trong giao diện người dùng Google Ads. Tính năng này hỗ trợ trả về dữ liệu liên quan đến trạng thái hiện tại của các sản phẩm từ các tài khoản Google Merchant Center đã liên kết với tài khoản Google Ads.
  • Bạn có thể lọc các chỉ số trong báo cáo shopping_product bằng cách 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ề lỗi ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

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

• Thêm UserListCustomerTypeService.MutateUserListCustomerTypes() để định cấu hình loại khách hàng của đối tượng.
• Đã xoá CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. Để định cấu hình chế độ cài đặt đối tượng của các mục tiêu trong vòng đời của khách hàng, hãy sử dụng UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Đính kèm hoặc huỷ đính kèm danh sách người dùng bằng cách đặt UserListCustomerType.customer_type_category thành UserListCustomerTypeCategory.PURCHASERS để đưa vào hoặc loại trừ danh sách đó khỏi định nghĩa khách hàng hiện tại cho các mục tiêu vòng đời của khách hàng. Hãy xem bài viết phân khúc đối tượng để biết thêm thông tin.

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 tài sản video khi tạo DemandGenVideoResponsiveAdInfo.
• (Chỉ dành cho những tài khoản có trong danh sách cho phép) Có thể biến đổi Campaign.video_brand_safety_suitability.

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 hỗ trợ việc 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ợ các thành phần liên quan đến chiến dịch Tạo nhu cầu đến 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ó là 1.000.

Chiến dịch

• Hỗ trợ trả về mô phỏng giá thầu chiến dịch ROAS mục tiêu cho Chiến dịch quảng cáo ứng dụng bằng cách sử dụng báo cáo 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ợ các tính năng của SKAdNetwork 4.0.
• Thêm tính năng hỗ trợ cho các cảnh báo cho 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 lần lượt 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 trả về các URL có thể dùng để tải nội dung của các tệp đính kèm xuống.

Video

• customer.video_brand_safety_suitability và BrandSafetySuitability hỗ trợ truy xuất mức độ phù hợp để đảm bảo sự an toàn cho thương hiệu của video ở cấp khách hàng.
• 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 sang ProductLink và ProductLinkInvitation.
• Xoá data_partner và google_ads khỏi AccountLink.
• Thêm IdentityVerificationService để 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 được cung cấp. 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 thông tin xác minh đã được tạo thành công.
    • Đã thêm IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
  • Bạn có thể dùng GetIdentityVerification() để truy xuất thông tin xác minh (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 phải hoàn tất quy trình xác minh
    • verification_progress 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 phiên xác minh này
      • action_url chuyển hướng khách hàng đến một URL để hoàn tất quy trình xác minh.
      • invitation_link_expiration_time là ngày hết hạn của 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 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 trở thành một tài nguyên được phân bổ thay vì phân đoạn tài nguyên.

Chiến dịch

• Các thay đổi đối với chiến dịch Tạo nhu cầu:
  • Thêm tuỳ chọn hỗ trợ cho việc cài đặt Campaign.shopping_setting vào 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à DemandGenProductAdInfo tương ứng, có sẵn cho các chiến dịch Tạo nhu cầu có Campaign.shopping_setting không rỗng.
• Được thêm vào các trường sau vào AdGroup để cho biết liệu nhóm quảng cáo có đang phân phát hay không 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 vào AdGroupAd để cho biết liệu quảng cáo trong 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 để chỉ định xem có nên bật tính năng đồng bộ hoá trong thử nghiệm hay không. Khi bạn bật tính năng đồng bộ hoá, các thay đổi được thực hiện đối với chiến dịch gốc trong khi thử nghiệm đang chạy sẽ tự động được 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à du lịch

• Thêm các trường sau vào ListingDimensionInfo cho quảng cáo Điểm tham quan để cho phép tạo các nhóm trang thông tin dựa trên tiểu bang và thành phố có hoạt động du lịch:
  • activity_state
  • activity_city
• Thêm tính năng 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 để cho phép nhà quảng cáo theo dõi tiến trình của quy trình xác minh đăng ký kinh doanh.
• 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 nhân viên mà họ đã thêm.

Lập kế hoạch

• Xoá score khỏi AudienceInsightsAttributeMetadata.

Đề xuất

• Thêm RecommendationService.GenerateRecommendations() 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.
• Các từ khoá đề xuất chưa được đặt kiểu khớp từ khoá hiện đã được đặt recommended_match_type thành UNSPECIFIED thay vì UNKNOWN.
• Thêm các loại đề xuất sau:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN đề xuất chọn sử dụng chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi
  • IMPROVE_GOOGLE_TAG_COVERAGE đề xuất triển khai Thẻ Google trên nhiều trang hơn
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN đề xuất 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
  • REFRESH_CUSTOMER_MATCH_LIST đề xuất cập nhật danh sách khách hàng chưa được cập nhật trong 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 ở cấp chiến dịch hoặc cấp khách hàng
  • IMPROVE_DEMAND_GEN_AD_STRENGTH đề 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 thông tin chi tiết hơn về lỗi cho các chiến dịch Mua sắm được liên kết với tài khoản Comparison Shopping Service Center.
• 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 hoạt động tài khoản chưa được uỷ quyền, customer.status và customer_client.status hiện được trả về dưới dạng SUSPENDED. Trước đây, các hàm này được trả về dưới dạng ENABLED.
• Hỗ trợ thêm tính năng 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 tài khoản Hotel Center và tài khoản Merchant 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 từ các tài khoản Hotel Center bằ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ợ việc thêm và xoá hình ảnh bằng các thành phần. Do đó, chúng tôi cũng đã xoá 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 nhãn tuỳ chỉnh và chuỗi con của URL.
  • 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 để 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 người dùng ở Khu vực kinh tế Châu Âu (EEA) không lấy được sự đồng ý, thì giá trị đồng ý sẽ đượ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 để cá nhân hoá quảng cáo bằng tính năng So khớp khách hàng. Hãy xem hướng dẫn So khớp khách hàng để biết thêm thông tin.
• Đối với Lượt bán hàng tại cửa hàng thực tế, đã thêm UserData.consent để hỗ trợ việc đưa ra sự đồng ý. Hãy xem hướng dẫn về Lượt bán hàng tại cửa hàng thực tế để biết thêm thông tin. 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 phần Câu hỏi thường gặp để biết thêm thông tin.
• Thêm UserList.lookalike_user_list để hỗ trợ tạo Phân khúc tương tự, một đối tượng được tạo dựa trên đối tượng gốc hiện có được cung cấp. Bạn chỉ 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ợ 2 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 nếu 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. Bạn chỉ có thể sử dụng loại tiêu chí mới này trong các chiến dịch Tối đa hoá hiệu suất để tạo một AssetGroupSignal bằng cách điền vào AssetGroupSignal.search_theme tiêu chí SearchThemeInfo.
  • Thêm AssetGroupSignalOperation.exempt_policy_violation_keys để hỗ trợ yêu cầu miễn trừ khi thêm tín hiệu về nhóm thành phần.
  • Thêm asset_group_top_combination_view mới để 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.
  • Giờ đây, bạn có thể truy vấn asset_group bằng các trường chỉ số để hỗ trợ truy xuất hiệu suất của chiến dịch Tối đa hoá hiệu suất.
  • Trong 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á 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) hiện sẽ trả về 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 thương hiệu bị loại trừ. Bạn có thể sử dụng các thương hiệu này để tạo tiêu chí BRAND, thêm vào nhóm dùng chung BRANDS, sau đó đính kèm vào chiến dịch bằng cách tạo một CampaignCriterion trong đó brand_list được đặt thành nhóm chia sẻ. Bạn có thể nhắm đến tiêu chí chiến dịch trong chiến dịch Tìm kiếm và bị loại trừ trong chiến dịch Tối đa hoá hiệu suất tương ứng.

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

• Thêm Campaign.asset_automation_settings[] để hiển thị 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 enum CampaignPrimaryStatusReason:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Lượt chuyển đổi

• Thêm CallConversion.consent và ClickConversion.consent để hỗ trợ việc cung cấp sự đồng ý. Bạn có thể xem hướng dẫn về lượt chuyển đổi dẫn đến cuộc gọi và hướng dẫn về lượt chuyển đổi từ lượt nhấp để biết thêm thông tin.
• Thêm các trường sau liên quan đến lượt chuyển đổi SKAdNetwork, có sẵn khi truy vấn các lượt chuyển đổi đó 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 chuyển đổi ngoại tuyến được tải lên
  • Đã di chuyển offline_conversion_upload_client_summary từ một trường trên tài nguyên customer sang báo cáo cấp cao nhất. Hãy sử dụng báo cá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ố sự kiện thành công, tỷ lệ thành công và tỷ lệ phần trăm lỗi.
    • Caveat: Một lượt chuyển đổi được tải lên nhưng dẫn đến lỗi ConversionUploadError.CLICK_NOT_FOUND 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 công việc khái niệm duy nhất:
    • 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ợ tính năng Phân bổ trên nhiều mạng trong Hộp cát về quyền riêng tư của Android mà không có lệnh chuyển hướng:
  • android_privacy_shared_key_google_campaign chứa shared_campaign_key và một số trường giúp mã hoá khoá.
  • android_privacy_shared_key_google_ad_group chứa shared_ad_group_key và một số trường giúp mã hoá khoá.
  • android_privacy_shared_key_google_network_type 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. ConversionActionOperation cố gắng sử dụng một trong các mô hình phân bổ dựa trên quy tắc không dùng nữa hiện không thành công với lỗi này. Trước đây, thao tác này sẽ không thành công và báo lỗi UNKNOWN.

Khách sạn và du lịch

• Thêm tính năng 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à các trường của nó vào báo cáo customer để trả về trạng thái bảo hiểm và giấy phép chi tiết của nhà quảng cáo Dịch vụ địa phương.
• Thêm các báo cáo mới sau đây cho Dịch vụ cục bộ:
  • local_services_lead chứa tất cả thông tin chi tiết liên quan đến khách hàng tiềm năng trong Quảng cáo dịch vụ địa phương, chẳng hạn 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 tài khoản khách hàng mục tiêu và tài khoản người quản lý tương ứng.
  • 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, chẳng hạn như kiểm tra lai lịch, giấy phép kinh doanh và dữ liệu bảo hiểm doanh nghiệp. Bạn có thể truy cập mọi tài liệu liên kết với giấy phép và bảo hiểm thông qua một 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 đối với các loại sản phẩm hiện có.
• Thêm tính năng hỗ trợ trả về PlannableTargeting.surface_targeting cho ReachPlanService.ListPlannableProducts, nhằm mô tả các nền tảng có sẵn của một sản phẩm.
• Thêm một enum ReachPlanSurface mới.
• Thêm tuỳ chọn hỗ trợ cho việc nhắm mục tiêu Tần suất mục tiêu bằng cách 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 để 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 đề xuất đặt CPA mục tiêu cho những chiến dịch chưa xác định trước một sự kiện theo mùa được dự đoán sẽ làm tăng lưu lượng truy cập.
  • SET_TARGET_CPA đề xuất đặt CPA mục tiêu cho những chiến dịch chưa được chỉ định.
  • SET_TARGET_ROAS đề xuất đặt lợi tức mục tiêu trên chi tiêu quảng cáo cho những chiến dịch chưa được 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 nguồn cấp dữ liệu Merchant Center cụ thể cho một chiến dịch bằng cách sử dụng trường ShoppingSetting.feed_label. Bạn phải đặt thuộc tính này thành giá trị nhãn nguồn cấp dữ liệu hoặc mã quốc gia gồm hai chữ cái trước đây dùng cho ShoppingSetting.sales_country. Để biết thêm thông tin chi tiết, hãy xem bài viết hỗ trợ về nhãn nguồn cấp dữ liệu.
• Đã 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 sau dùng trong shopping_performance_view:
    • segments.product_bidding_category_level1 với segments.product_category_level1
    • segments.product_bidding_category_level2 với segments.product_category_level2
    • segments.product_bidding_category_level3 với segments.product_category_level3
    • segments.product_bidding_category_level4 với segments.product_category_level4
    • segments.product_bidding_category_level5 với segments.product_category_level5
  • Thay thế product_bidding_category_constant bằng product_category_constant. Phương thức này sẽ trả về tất cả nội dung 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ợ tính năng thêm Campaign.shopping_setting vào chiến dịch Tìm kiếm. Giờ đây, việc 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 vào một chiến dịch Tìm kiếm hiện có sẽ dẫn đến OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Đã ngừng hỗ trợ việc thêm CampaignCriterion.listing_scope vào chiến dịch Tìm kiếm. Việc cố gắng thêm CampaignCriterion.listing_scope vào chiến dịch Tìm kiếm hiện có sẽ dẫn đến OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Đã thêm các chỉ số lượt chuyển đổi có dữ liệu 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 để định cấu hình 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 để định cấu hình 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.
• Hỗ trợ thêm tính năng 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.

phiên bản 14.1.0 (09/08/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 14.1.

Quản lý tài khoản

• Customer.customer_agreement_setting cho biết liệu khách hàng đã chấp nhận điều khoản dịch vụ của biểu mẫu khách hàng tiềm năng hay chưa

Thành phần

• Các trường mới trong AssetGroup để cho biết nhóm thành phần có đang phân phát hay không hoặc lý do khiến nhóm thành phần không phân phát:
  • primary_status
  • primary_status_reasons
• Các trường mới trong AssetGroupAsset để cho biết liệu thành phần nhóm thành phần có đang phân phát hay không hay lý do khiến thành phần không phân phát:
  • primary_status
  • primary_status_details
  • primary_status_reasons
• Các giá trị mới trong enum CallToActionType:
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
• Các giá trị mới trong enum AssetLinkError:
  • CUSTOMER_NOT_VERIFIED
  • UNSUPPORTED_CALL_TO_ACTION
  • PAGE_FEED_INVALID_LABEL_TEXT

Thanh toán

• Các trường mới trong Invoice và AccountSummary:
  • export_charge_subtotal_amount_micros
  • export_charge_tax_amount_micros
  • export_charge_total_amount_micros

Chiến dịch

• Các giá trị mới trong enum CampaignPrimaryStatusReason:

  • HAS_ASSET_GROUPS_DISAPPROVED
  • HAS_ASSET_GROUPS_LIMITED_BY_POLICY
  • MOST_ASSET_GROUPS_UNDER_REVIEW

• (Chỉ dành cho những tài khoản có trong danh sách cho phép) DiscoveryCampaignSettings với upgraded_targeting:

  • Khi đặt upgraded_targeting thành true, bạn có thể thêm vị trí và ngôn ngữ làm tiêu chí của nhóm quảng cáo

Tiêu chí

• Giá trị enum mới: CriterionError.INVALID_DETAILED_DEMOGRAPHIC

• (Chỉ dành cho các tài khoản trong danh sách cho phép) Hỗ trợ thêm LanguageInfo và LocationInfo làm AdGroupCriterion:

  • Bạn chỉ có thể sử dụng tính năng này cho chiến dịch Khám phá đã bật tính năng nhắm mục tiêu nâng cấp

Thử nghiệm

• Các giá trị mới trong enum ExperimentError:
  • DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
  • CANNOT_REMOVE_IN_CREATION_EXPERIMENT
  • CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES

Đề xuất

• Các loại đề xuất mới:
  • PerformanceMaxOptInRecommendation đề xuất tạo chiến dịch Tối đa hoá hiệu suất đầu tiên trong tài khoản
  • ImprovePerformanceMaxAdStrengthRecommendation đề xuất cải thiện độ mạnh của nhóm thành phần trong một chiến dịch Tối đa hoá hiệu suất
  • MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation đề xuất di chuyển chiến dịch Quảng cáo tìm kiếm động sang chiến dịch Tối đa hoá hiệu suất

Báo cáo

• Các chỉ số và phân khúc mới về khách hàng mới so với khách hàng cũ:
  • metrics.new_customer_lifetime_value
  • metrics.all_new_customer_lifetime_value
  • segments.new_versus_returning_customers
• Các chế độ xem customer_search_term_insight và campaign_search_term_insight mới:
  • metrics.search_volume hiển thị phạm vi số lượng của danh mục thông tin chi tiết về cụm từ tìm kiếm

Mua sắm

• Các trường mới cho nhóm trang thông tin:
  • ListingGroupInfo.path
  • AssetGroupListingGroupFilter.path
• Trường mới: ShoppingSetting.advertising_partner_ids
• Các giá trị mới trong enum CampaignError:
  • NOT_LINKED_ADVERTISING_PARTNER
  • INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS

Video

• (Chỉ dành cho các tài khoản trong danh sách cho phép) AdType.DISCOVERY_VIDEO_RESPONSIVE_AD và DiscoveryVideoResponsiveAdInfo tương ứng

phiên bản 14 (07/06/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 14.

Chiến dịch

• Đã thêm CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD

Lượt chuyển đổi

• Hỗ trợ thêm tính năng xác định lượt chuyển đổi Google Analytics và xác định một lượt chuyển đổi được nhập từ tài sản Universal Analytics hay tài sản GA4:

  • Thêm các giá trị sau vào ConversionActionType:
    • UNIVERSAL_ANALYTICS_GOAL
    • UNIVERSAL_ANALYTICS_TRANSACTION
    • GOOGLE_ANALYTICS_4_CUSTOM
    • GOOGLE_ANALYTICS_4_PURCHASE
  • Đã thêm ConversionAction.google_analytics_4_settings

• Thêm Customer.offline_conversion_client_summaries để tóm tắt trạng thái và thông tin chẩn đoán về các lượt tải lên và điều chỉnh cho lượt chuyển đổi ngoại tuyến của khách hàng.

  • Enum
    • OfflineEventUploadClient:
      • GOOGLE_ADS_API
      • GOOGLE_ADS_WEB_CLIENT
      • ADS_DATA_CONNECTOR
    • OfflineConversionDiagnosticStatus:
      • EXCELLENT
      • GOOD
      • NEEDS_ATTENTION
      • NO_RECENT_UPLOAD

• Thêm job_id vào các phản hồi do ConversionAdjustmentUploadService.UploadConversionAdjustments và ConversionUploadService.UploadClickConversions trả về để liên kết phản hồi với OfflineConversionUploadSummary.job_id.

Tiêu chí

• Thêm tuỳ chọn hỗ trợ cho việc truy xuất, tạo và cập nhật từ khoá phủ định ở cấp tài khoản:

  • Trường:
    • CustomerNegativeCriterion.negative_keyword_list
  • Enum:
    • CriterionType.NEGATIVE_KEYWORD_LIST
    • SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
    • ResourceLimitType
      • SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
      • ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
  • Lỗi:
    • CriterionError
      • NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
      • CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
      • CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
      • CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE

• Đã thêm CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST

Quảng cáo khách sạn

• Đổi tên SuggestTravelAssetsRequest.place_id thành SuggestTravelAssetsRequest.place_ids

Lập kế hoạch

• Xoá các phương thức sau khỏi KeywordPlanService:
  • GenerateForecastCurve
  • GenerateForecastMetrics
  • GenerateForecastTimeSeries
  • GenerateHistoricalMetrics
• Thêm KeywordPlanIdeaService.GenerateKeywordForecastMetrics để hỗ trợ việc tạo các chỉ số dự đoán cho chiến dịch từ khoá mà không cần tạo kế hoạch từ khoá trước.
• Đã ngừng hỗ trợ truy xuất báo cáo campaign_criterion_simulation
• Đã thêm tuỳ chọn hỗ trợ cho YOUTUBE_DYNAMIC_LINEUP dưới dạng phương diện trong AudienceInsightsService.ListAudienceInsightsAttributes.
• Thêm DynamicLineupAttributeMetadata.sample_channels, dùng trong các phản hồi GenerateAudienceCompositionInsights để cung cấp kênh mẫu trong các nhóm kênh nổi tiếng.

Đề xuất

• Thêm DynamicImageExtensionOptInRecommendation đề xuất bật phần mở rộng về hình ảnh linh hoạt trên tài khoản
• Thêm LowerTargetRoasRecommendation để đề xuất giảm ROAS mục tiêu
• Đã thêm RaiseTargetCpaRecommendation đề xuất tăng CPA mục tiêu
• Đã thêm ResponsiveSearchAdAssetRecommendation.current_ad

Báo cáo

• Thêm các giá trị sau vào ServedAssetFieldType, có sẵn trong ad_group_ad_asset_view.pinned_field:
  • SITELINK
  • CALL
  • MOBILE_APP
  • CALLOUT
  • STRUCTURED_SNIPPET
  • PRICE
  • PROMOTION
  • AD_IMAGE
  • LEAD_FORM
  • BUSINESS_LOGO

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ữ.