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.
- Trường
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ý:
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ênsegments.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: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:
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ạiAdService
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ệ:
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
, giá trị này sẽ được gửi khiAddBatchJobOperationsRequest
đã gửi lớn hơn 10484504 byte. - Hỗ trợ thêm cho chế độ cài đặt
MutateOperation.asset_group_operation
khi dùngBatchJobService
. Đ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à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 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.
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
chogender_view
- Đã thêm khả năng hỗ trợ cho
metrics.phone_calls
chokeyword_view
Dịch vụ địa phương
- Đã thêm
LocalServicesLeadService.AppendLeadConversation()
được sử dụng để thêm một thẻ mớiLocalServicesLeadConversation
đếnLocalServicesLead
, 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 Đã đặtlead_type
thànhLeadType.MESSAGE
có thể được chỉ định 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 một cuộc trò chuyện được giới thiệu bằngLocalServicesLeadService.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 raQueryError.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
đếnGoogleAdsService.Search
sẽ dẫn đếnRequestError.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ụ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ềShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
.
- Bạn có thể lọc các chỉ số từ
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ãyUserListCustomerTypeService.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
đếnUserListCustomerTypeCategory.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.
- Đính kèm hoặc hủy đính kèm danh sách người dùng bằng cách cài đặ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 nội dung video khi tạoDemandGenVideoResponsiveAdInfo
. - (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ạ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
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
đếnProductLink
vàProductLinkInvitation
. - Đã xoá
data_partner
vàgoogle_ads
khỏiAccountLink
. - Đã 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ằngverification_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.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ủ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 cần hoàn tất quy trình xác minhverification_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 minhaction_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 choaction_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 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.
- Hỗ trợ thêm cho 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:
- 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 ứngDemandGenProductAdInfo
, dành cho Chiến dịch Tạo nhu cầu có giá trị không rỗngCampaign.shopping_setting
.
- Hỗ trợ thêm cho chế độ cài đặt
- Đã 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: - Đã thêm 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
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ỏiAudienceInsightsAttributeMetadata
.
Đề 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ànhUNSPECIFIED
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ậtIMPROVE_GOOGLE_TAG_COVERAGE
Chương trình này khuyến nghị triển khai Thẻ Google trên nhiều trang hơnPERFORMANCE_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ịchREFRESH_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 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 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à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 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ạngSUSPENDED
Trước đây, các trang này được trả về dưới dạngENABLED
. - Đã 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
- Đã 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
.
- Để 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 trong các tài khoản Hotel Center đang sử dụ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ợ 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ằ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
đế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 đặtAudience.asset_group
khi 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. 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ạoAssetGroupSignal
bằng cách điền sẵnAssetGroupSignal.search_theme
với tiêu chíSearchThemeInfo
.
- Đã thêm
- Đã 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ênUPGRADE_ELIGIBLE
thànhUPGRADE_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ạiTargetCpaSimulationPoint.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ạoCampaignCriterion
vớibrand_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.Đã 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ặ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 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êncustomer
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
.
- Caveat: Lượt chuyển đổi được tải lên nhưng dẫn đến kết quả là
- 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: - Đã 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ợ 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ứashared_campaign_key
và một số trường giúp mã hoá khoá.android_privacy_shared_key_google_ad_group
có chứashared_ad_group_key
và một số trường giúp mã hoá khoá.android_privacy_shared_key_google_network_type
có 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
. MộtConversionActionOperation
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ớiUNKNOWN
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:
- 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áocustomer
để 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:
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.
Lập kế hoạch
- Thêm tính năng hỗ trợ để trả về
Forecast.views
vàPlannedProductForecast.views
choReachPlanService.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ớiReachPlanService.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: - Đã 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
:
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 choShoppingSetting.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.
- 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
- Đã 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ằngsegments.product_category_level1
segments.product_bidding_category_level2
bằngsegments.product_category_level2
segments.product_bidding_category_level3
bằngsegments.product_category_level3
segments.product_bidding_category_level4
bằngsegments.product_category_level4
segments.product_bidding_category_level5
bằngsegments.product_category_level5
- Đã thay thế
product_bidding_category_constant
bằngproduct_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ằngListingDimensionInfo.product_category
. - Đã thay thế
ListingGroupFilterDimension.product_bidding_category
bằngListingGroupFilterDimension.product_category
.
- Đã thay thế các trường được sử dụng sau trong
- Đã 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ằngCampaign.shopping_setting
hoặc thêmCampaign.shopping_setting
đến một Chiến dịch Tìm kiếm hiện tại giờ đây sẽ mang lạiOPERATION_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êmCampaignCriterion.listing_scope
chiến dịch Tìm kiếm hiện có giờ đây sẽ mang lạiOPERATION_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:
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
- Báo cáo:
- Đã 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
- 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
- Đã 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ấ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ữ.