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ệ:
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:
Đối tượng
Công việc hàng loạt
- Thêm
BatchJobError.REQUEST_TOO_LARGE
, sẽ được gửi khiAddBatchJobOperationsRequest
đã gửi lớn hơn 10484504 byte. - Hỗ trợ thêm chế độ cài đặt
MutateOperation.asset_group_operation
khi sử dụngBatchJobService
. Đ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ànhsegments.sk_ad_network_fine_conversion_value
. - Đã thêm
segments.sk_ad_network_redistributed_fine_conversion_value
.
- Đổi tên
- 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.
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
chogender_view
- Thêm tính năng hỗ trợ cho
metrics.phone_calls
chokeyword_view
Dịch vụ địa phương
- Thêm
LocalServicesLeadService.AppendLeadConversation()
dùng để thêmLocalServicesLeadConversation
mới vàoLocalServicesLead
. 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ànhLeadType.MESSAGE
trongConversation.local_services_lead
.
- Kích thước của
- 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ứcLocalServicesLeadService.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
- 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 raQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
. Ví dụ: bạn không thể chọnproduct_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
đếnGoogleAdsService.Search
sẽ dẫn đến lỗiRequestError.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ụngsegments.date
khi sử dụngGoogleAdsService.Search
hoặcGoogleAdsService.SearchStream
. Không được phép phân đoạn theo ngày và sẽ trả về lỗiShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Bạn có thể lọc các chỉ số trong báo cáo
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ụngUserListCustomerTypeService.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ànhUserListCustomerTypeCategory.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.
- Đính kèm hoặc huỷ đính kèm danh sách người dùng bằng cách đặt
Video
- Thêm các giá trị sau vào
ContentLabelType
. Bạn có thể loại trừ nhữngContentLabelTypes
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ạoDemandGenVideoResponsiveAdInfo
. - (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ạngMutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
. Khi bạn đặt thànhtrue
, mọi lỗi không chặn liên quan đến lỗi thao tác sẽ được trả về dưới dạngMutateCustomerSkAdNetworkConversionValueSchemaResponse.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
sangProductLink
vàProductLinkInvitation
. - Xoá
data_partner
vàgoogle_ads
khỏiAccountLink
. - 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ằngverification_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.- 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ủaIdentityVerification
). MỗiIdentityVerification
bao gồm:verification_program
là loại chương trình xác minh danh tínhidentity_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 minhverification_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àyaction_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ủaaction_url
- Enum:
- Lỗi:
- Đã 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.
- Hỗ trợ thêm các phân đoạn liên quan đến thời gian, chẳng hạn như
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.
- Thêm tuỳ chọn hỗ trợ cho việc cài đặt
- Đượ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: - Thêm tính năng hỗ trợ cho các phân đoạn sau vào
travel_activity_performance_view
:
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ỏiAudienceInsightsAttributeMetadata
.
Đề 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ànhUNSPECIFIED
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 đổiIMPROVE_GOOGLE_TAG_COVERAGE
đề xuất triển khai Thẻ Google trên nhiều trang hơnPERFORMANCE_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ấtREFRESH_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 quaCUSTOM_AUDIENCE_OPT_IN
đề xuất tạo một đối tượng tuỳ chỉnhLEAD_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àngIMPROVE_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àoCustomerLifecycleGoalOperation
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ạngSUSPENDED
. Trước đây, các hàm này được trả về dưới dạngENABLED
. - 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
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
.
- Để liên kết tài khoản Google Ads với tài khoản Merchant Center, hãy sử dụng
- 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ằngAccountLinkService
.- Để 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
.
- Để cập nhật lời mời liên kết từ tài khoản Hotel Center, hãy sử dụng
Thành phần
- Thay thế
ImageAdInfo.media_file
bằngImageAdInfo.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ằngAssetGroupListingGroupFilter.listing_source
vàListingGroupFilterListingSource
- Cũng thay thế
- Đã 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 đặtAudience.asset_group
nếu và chỉ khiAudience.scope
làASSET_GROUP
.
- Thêm
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ộtAssetGroupSignal
bằng cách điền vàoAssetGroupSignal.search_theme
tiêu chíSearchThemeInfo
.
- Thêm
- 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ênUPGRADE_ELIGIBLE
thànhUPGRADE_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 chungBRANDS
, sau đó đính kèm vào chiến dịch bằng cách tạo mộtCampaignCriterion
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.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ặccampaign
: - Thay thế
metrics.sk_ad_network_conversions
bằngmetrics.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êncustomer
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
.
- Caveat: Một lượt chuyển đổi được tải lên nhưng dẫn đến lỗi
- 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: - Thêm
INVALID_JOB_ID
vào các lỗi sau: - Thay thế
INVALID_CONVERSION_ACTION
bằngNO_CONVERSION_ACTION_FOUND
vàINVALID_CONVERSION_ACTION_TYPE
trong các lỗi sau:
- Đã di chuyển
- 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ứashared_campaign_key
và một số trường giúp mã hoá khoá.android_privacy_shared_key_google_ad_group
chứashared_ad_group_key
và một số trường giúp mã hoá khoá.android_privacy_shared_key_google_network_type
chứashared_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ỗiUNKNOWN
.
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:
- 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áocustomer
để 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:
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.
Lập kế hoạch
- Thêm tính năng hỗ trợ trả về
Forecast.views
vàPlannedProductForecast.views
choReachPlanService.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
choReachPlanService.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: - 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
:
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 choShoppingSetting.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.
- 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
- Đã 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ớisegments.product_category_level1
segments.product_bidding_category_level2
vớisegments.product_category_level2
segments.product_bidding_category_level3
vớisegments.product_category_level3
segments.product_bidding_category_level4
vớisegments.product_category_level4
segments.product_bidding_category_level5
vớisegments.product_category_level5
- Thay thế
product_bidding_category_constant
bằngproduct_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ằngListingDimensionInfo.product_category
. - Thay thế
ListingGroupFilterDimension.product_bidding_category
bằngListingGroupFilterDimension.product_category
.
- Thay thế các trường sau dùng trong
- Đã 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ằngCampaign.shopping_setting
hoặc thêmCampaign.shopping_setting
vào một chiến dịch Tìm kiếm hiện có sẽ dẫn đếnOPERATION_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êmCampaignCriterion.listing_scope
vào chiến dịch Tìm kiếm hiện có sẽ dẫn đếnOPERATION_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:
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
- Báo cáo:
- 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
- Báo cáo:
- Đã 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
- 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ấtYOUTUBE_WATCH
vàYOUTUBE_SEARCH
vàoYOUTUBE
. - Đã thêm
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
.
- Đã thêm
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ữ.