Chỉ mục
AccessibleBiddingStrategy
(thông báo)AccessibleBiddingStrategy.MaximizeConversionValue
(thông báo)AccessibleBiddingStrategy.MaximizeConversions
(thông báo)AccessibleBiddingStrategy.TargetCpa
(thông báo)AccessibleBiddingStrategy.TargetImpressionShare
(thông báo)AccessibleBiddingStrategy.TargetRoas
(thông báo)AccessibleBiddingStrategy.TargetSpend
(thông báo)Ad
(thông báo)AdGroup
(thông báo)AdGroupAd
(thông báo)AdGroupAdLabel
(thông báo)AdGroupAsset
(thông báo)AdGroupAssetSet
(thông báo)AdGroupAudienceView
(thông báo)AdGroupBidModifier
(thông báo)AdGroupCriterion
(thông báo)AdGroupCriterion.PositionEstimates
(thông báo)AdGroupCriterion.QualityInfo
(thông báo)AdGroupCriterionLabel
(thông báo)AdGroupLabel
(thông báo)AgeRangeView
(thông báo)Asset
(thông báo)AssetGroup
(thông báo)AssetGroupAsset
(thông báo)AssetGroupAssetCombinationData
(thông báo)AssetGroupListingGroupFilter
(thông báo)AssetGroupSignal
(thông báo)AssetGroupTopCombinationView
(thông báo)AssetSet
(thông báo)AssetSetAsset
(thông báo)Audience
(thông báo)BiddingStrategy
(thông báo)Campaign
(thông báo)Campaign.DynamicSearchAdsSetting
(thông báo)Campaign.GeoTargetTypeSetting
(thông báo)Campaign.NetworkSettings
(thông báo)Campaign.OptimizationGoalSetting
(thông báo)Campaign.SelectiveOptimization
(thông báo)Campaign.ShoppingSetting
(thông báo)Campaign.TrackingSetting
(thông báo)CampaignAsset
(thông báo)CampaignAssetSet
(thông báo)CampaignAudienceView
(thông báo)CampaignBudget
(thông báo)CampaignCriterion
(thông báo)CampaignLabel
(thông báo)CartDataSalesView
(thông báo)Conversion
(thông báo)ConversionAction
(thông báo)ConversionAction.AttributionModelSettings
(thông báo)ConversionAction.FloodlightSettings
(thông báo)ConversionAction.ValueSettings
(thông báo)ConversionCustomVariable
(thông báo)ConversionCustomVariable.FloodlightConversionCustomVariableInfo
(thông báo)ConversionTrackingSetting
(thông báo)CustomColumn
(thông báo)Customer
(thông báo)CustomerAsset
(thông báo)CustomerAssetSet
(thông báo)CustomerClient
(thông báo)CustomerManagerLink
(thông báo)DoubleClickCampaignManagerSetting
(thông báo)DynamicSearchAdsSearchTermView
(thông báo)GenderView
(thông báo)GeoTargetConstant
(thông báo)KeywordView
(thông báo)Label
(thông báo)LanguageConstant
(thông báo)ListingGroupFilterDimension
(thông báo)ListingGroupFilterDimension.ProductBiddingCategory
(thông báo)ListingGroupFilterDimension.ProductBrand
(thông báo)ListingGroupFilterDimension.ProductChannel
(thông báo)ListingGroupFilterDimension.ProductCondition
(thông báo)ListingGroupFilterDimension.ProductCustomAttribute
(thông báo)ListingGroupFilterDimension.ProductItemId
(thông báo)ListingGroupFilterDimension.ProductType
(thông báo)ListingGroupFilterDimensionPath
(thông báo)LocationView
(thông báo)ProductBiddingCategoryConstant
(thông báo)ProductGroupView
(thông báo)SearchAds360Field
(thông báo)ShoppingPerformanceView
(thông báo)UserList
(thông báo)Visit
(thông báo)WebpageView
(thông báo)
AccessibleBiddingStrategy
Thể hiện chế độ xem Đặt giá thầu do khách hàng sở hữu và chia sẻ với khách hàng.
Trái ngược với BiddingStrategy, tài nguyên này bao gồm các chiến lược do người quản lý của khách hàng sở hữu và được chia sẻ với khách hàng này, ngoài các chiến lược mà khách hàng này sở hữu. Tài nguyên này không cung cấp các chỉ số và chỉ trình bày một số ít các thuộc tính Đặt giá thầu.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chiến lược đặt giá thầu có thể truy cập. Tên tài nguyên AccessibleBidStrategy có dạng:
|
id |
Mã của chiến lược đặt giá thầu. |
name |
Tên của chiến lược đặt giá thầu. |
type |
Loại chiến lược đặt giá thầu. |
owner_customer_id |
Mã của khách hàng sở hữu chiến lược đặt giá thầu. |
owner_descriptive_name |
description_name [tên_mô_tả] của Khách hàng sở hữu chiến lược đặt giá thầu. |
Trường kết hợp Bạn chỉ có thể đặt một. |
|
maximize_conversion_value |
Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách. |
maximize_conversions |
Một chiến lược đặt giá thầu tự động giúp nhận được nhiều lượt chuyển đổi nhất cho chiến dịch khi chi tiêu ngân sách của bạn. |
target_cpa |
Chiến lược đặt giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt. |
target_impression_share |
Chiến lược đặt giá thầu tự động tối ưu hoá theo tỷ lệ phần trăm lượt hiển thị đã chọn. |
target_roas |
Chiến lược đặt giá thầu giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được lợi tức trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể. |
target_spend |
Chiến lược giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình. |
MaximizeConversionValue
Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách.
Trường | |
---|---|
target_roas |
Tuỳ chọn lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS). Nếu được đặt, chiến lược giá thầu sẽ tối đa hoá doanh thu trong khi vẫn đạt được mức lợi tức mục tiêu trên chi tiêu quảng cáo. Nếu ROAS mục tiêu cao, chiến lược giá thầu có thể không chi tiêu được toàn bộ ngân sách. Nếu bạn không đặt ROAS mục tiêu, chiến lược giá thầu sẽ nhắm đến việc đạt được ROAS cao nhất có thể trong phạm vi ngân sách. |
MaximizeConversions
Một chiến lược đặt giá thầu tự động giúp nhận được nhiều lượt chuyển đổi nhất cho chiến dịch khi chi tiêu ngân sách của bạn.
Trường | |
---|---|
target_cpa |
Tuỳ chọn chi phí thu nạp khách hàng (CPA) mục tiêu. Đây là số tiền trung bình mà bạn muốn chi tiêu cho mỗi lượt thu nạp khách hàng. |
target_cpa_micros |
Tuỳ chọn chi phí thu nạp khách hàng (CPA) mục tiêu. Đây là số tiền trung bình mà bạn muốn chi tiêu cho mỗi lượt thu nạp khách hàng. |
TargetCpa
Chiến lược giá thầu tự động sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.
Trường | |
---|---|
target_cpa_micros |
Mục tiêu CPA trung bình. Mục tiêu này phải lớn hơn hoặc bằng đơn vị có thể tính phí tối thiểu dựa trên đơn vị tiền tệ của tài khoản. |
TargetRoas
Một chiến lược đặt giá thầu tự động giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được một mức lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.
Trường | |
---|---|
target_roas |
Doanh thu đã chọn (dựa trên dữ liệu lượt chuyển đổi) trên mỗi đơn vị chi tiêu. |
TargetSpend
Một chiến lược đặt giá thầu tự động giúp bạn đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình.
Trường | |
---|---|
target_spend_micros |
Mục tiêu chi tiêu mà bạn đặt ra để tối đa hoá số lượt nhấp. Bên đặt giá thầu Mục tiêu chi tiêu sẽ cố gắng chi tiêu ít hơn giá trị này hoặc số tiền chi tiêu điều tiết tự nhiên. Nếu bạn không chỉ định, ngân sách sẽ được dùng làm mục tiêu chi tiêu. Trường này không được dùng nữa và không nên được sử dụng nữa. Hãy xem https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html để biết thông tin chi tiết. |
cpc_bid_ceiling_micros |
Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý. |
Quảng cáo
Một quảng cáo.
Trường | |
---|---|
resource_name |
Tên tài nguyên của quảng cáo. Tên tài nguyên quảng cáo có dạng:
|
final_urls[] |
Danh sách URL cuối cùng có thể có sau tất cả các lần chuyển hướng giữa nhiều miền cho quảng cáo. |
type |
Loại quảng cáo. |
id |
Mã của quảng cáo. |
display_url |
URL xuất hiện trong nội dung mô tả quảng cáo cho một số định dạng quảng cáo. |
name |
Tên của quảng cáo. Thông tin này chỉ được dùng để xác định quảng cáo. Mã này không cần phải là duy nhất và không ảnh hưởng đến quảng cáo được phân phát. Hiện tại, trường tên chỉ được hỗ trợ cho DisplayUploadAd, ImageAd, ShoppingCompareListingAd và VideoAd. |
Trường kết hợp ad_data . Thông tin chi tiết liên quan đến loại quảng cáo. Bạn phải đặt đúng một giá trị. ad_data chỉ có thể là một trong những trạng thái sau đây: |
|
text_ad |
Thông tin chi tiết liên quan đến quảng cáo dạng văn bản. |
expanded_text_ad |
Thông tin chi tiết liên quan đến quảng cáo dạng văn bản mở rộng. |
responsive_search_ad |
Thông tin chi tiết liên quan đến một quảng cáo tìm kiếm thích ứng. |
product_ad |
Thông tin chi tiết liên quan đến một quảng cáo sản phẩm. |
expanded_dynamic_search_ad |
Thông tin chi tiết liên quan đến một quảng cáo tìm kiếm động mở rộng. |
Nhóm Quảng cáo
Nhóm quảng cáo.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhóm quảng cáo. Tên tài nguyên nhóm quảng cáo có dạng:
|
status |
Trạng thái của nhóm quảng cáo. |
type |
Loại nhóm quảng cáo. |
ad_rotation_mode |
Chế độ xoay vòng quảng cáo của nhóm quảng cáo. |
creation_time |
Dấu thời gian khi nhóm quảng cáo này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
targeting_setting |
Chế độ cài đặt cho các tính năng liên quan đến tiêu chí nhắm mục tiêu. |
labels[] |
Tên tài nguyên của các nhãn được đính kèm với nhóm quảng cáo này. |
engine_id |
Mã của nhóm quảng cáo trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản không phải tài khoản Google Ads, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "ad_group.id" thay thế. |
start_date |
Ngày nhóm quảng cáo này bắt đầu phân phát quảng cáo. Theo mặc định, ngày bắt đầu của nhóm quảng cáo hoặc ngày bắt đầu của nhóm quảng cáo, tuỳ vào ngày nào đến sau. Nếu bạn đặt trường này, thì nhóm quảng cáo sẽ bắt đầu vào đầu ngày được chỉ định theo múi giờ của khách hàng. Trường này chỉ dành cho các tài khoản cổng vào Microsoft Advertising và Facebook. Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14 |
end_date |
Ngày nhóm quảng cáo kết thúc phân phát quảng cáo. Theo mặc định, nhóm quảng cáo kết thúc vào ngày kết thúc của nhóm quảng cáo. Nếu bạn đặt trường này thì nhóm quảng cáo sẽ kết thúc vào cuối ngày được chỉ định theo múi giờ của khách hàng. Trường này chỉ dành cho các tài khoản cổng vào Microsoft Advertising và Facebook. Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14 |
language_code |
Ngôn ngữ của quảng cáo và từ khoá trong nhóm quảng cáo. Trường này chỉ dành cho tài khoản Microsoft Advertising. Thêm chi tiết: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
Ngày giờ khi nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
id |
Mã của nhóm quảng cáo. |
name |
Tên của nhóm quảng cáo. Trường này là bắt buộc và không được để trống khi tạo nhóm quảng cáo mới. Mã này phải chứa ít hơn 255 ký tự có độ rộng đầy đủ UTF-8. Nó không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD). |
cpc_bid_micros |
Giá thầu CPC (chi phí mỗi lượt nhấp) tối đa. |
engine_status |
Trạng thái của công cụ cho nhóm quảng cáo. |
AdGroupAd
Một quảng cáo trong nhóm quảng cáo.
Trường | |
---|---|
resource_name |
Tên tài nguyên của quảng cáo. Tên tài nguyên quảng cáo của nhóm quảng cáo có dạng:
|
status |
Trạng thái của quảng cáo. |
ad |
Quảng cáo. |
creation_time |
Dấu thời gian khi ad_group_ad này được tạo. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
labels[] |
Tên tài nguyên của các nhãn được đính kèm với quảng cáo trong nhóm quảng cáo này. |
engine_id |
Mã của quảng cáo trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản Search Ads 360, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể không phải Search Ads 360, hãy sử dụng "ad_group_ad.ad.id" thay thế. |
engine_status |
Trạng thái bổ sung của quảng cáo trong tài khoản công cụ bên ngoài. Các trạng thái có thể có (tuỳ thuộc vào loại tài khoản bên ngoài) bao gồm đang hoạt động, đủ điều kiện, đang chờ xem xét, v.v. |
last_modified_time |
Ngày giờ khi quảng cáo của nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
AdGroupAdLabel
Mối quan hệ giữa quảng cáo của nhóm quảng cáo và nhãn.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhãn quảng cáo trong nhóm quảng cáo. Tên tài nguyên nhãn quảng cáo của nhóm quảng cáo có dạng: |
ad_group_ad |
Quảng cáo trong nhóm quảng cáo mà nhãn được đính kèm. |
label |
Nhãn được chỉ định cho quảng cáo của nhóm quảng cáo. |
AdGroupAsset
Mối liên kết giữa nhóm quảng cáo và một thành phần.
Trường | |
---|---|
resource_name |
Tên tài nguyên của thành phần nhóm quảng cáo. Tên tài nguyên AdGroupAsset có dạng như sau:
|
ad_group |
Bắt buộc. Nhóm quảng cáo mà tài sản được liên kết. |
asset |
Bắt buộc. Thành phần được liên kết với nhóm quảng cáo. |
status |
Trạng thái của thành phần nhóm quảng cáo. |
AdGroupAssetSet
Nhóm quảng cáo thành phần là mối liên kết giữa một nhóm quảng cáo và một nhóm thành phần. Việc tạo một Nhóm thành phần quảng cáo sẽ liên kết một bộ thành phần với một nhóm quảng cáo.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhóm thành phần nhóm quảng cáo. Tên tài nguyên nhóm thành phần của nhóm quảng cáo có dạng như sau:
|
ad_group |
Nhóm quảng cáo mà tập hợp thành phần này được liên kết. |
asset_set |
Nhóm thành phần được liên kết với nhóm quảng cáo. |
status |
Trạng thái của nhóm thành phần nhóm quảng cáo. Chỉ có thể đọc. |
AdGroupAudienceView
Chế độ xem đối tượng của một nhóm quảng cáo. Bao gồm dữ liệu hiệu suất từ các mối quan tâm, danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và quảng cáo trên Mạng YouTube cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp ở cấp đối tượng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem đối tượng nhóm quảng cáo. Tên tài nguyên chế độ xem đối tượng của nhóm quảng cáo có dạng:
|
AdGroupBidModifier
Đại diện cho hệ số sửa đổi giá thầu cho nhóm quảng cáo.
Trường | |
---|---|
resource_name |
Tên tài nguyên của hệ số sửa đổi giá thầu cho nhóm quảng cáo. Tên tài nguyên hệ số sửa đổi giá thầu của nhóm quảng cáo có dạng như sau:
|
bid_modifier |
Công cụ sửa đổi cho giá thầu khi tiêu chí phù hợp. Công cụ sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Phạm vi là từ 1.0 - 6.0 cho PreferredContent. Sử dụng số 0 để chọn không sử dụng một Loại thiết bị. |
Trường kết hợp Bắt buộc trong các thao tác tạo bắt đầu từ phiên bản 5. |
|
device |
Tiêu chí thiết bị. |
AdGroupCriterion
Tiêu chí của nhóm quảng cáo. Báo cáo tiêu chí của nhóm quảng cáo chỉ trả về tiêu chí đã được thêm vào nhóm quảng cáo một cách rõ ràng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của tiêu chí nhóm quảng cáo. Tên tài nguyên tiêu chí của nhóm quảng cáo có dạng như sau:
|
creation_time |
Dấu thời gian khi tiêu chí nhóm quảng cáo này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
status |
Trạng thái của tiêu chí. Đây là trạng thái của thực thể tiêu chí nhóm quảng cáo do khách hàng đặt. Lưu ý: Báo cáo giao diện người dùng có thể kết hợp thêm thông tin ảnh hưởng đến việc một tiêu chí có đủ điều kiện chạy hay không. Trong một số trường hợp, một tiêu chí đã bị XOÁ trong API vẫn có thể hiển thị là đã bật trong giao diện người dùng. Ví dụ: các chiến dịch theo mặc định hiển thị cho người dùng thuộc tất cả các độ tuổi trừ khi bị loại trừ. Giao diện người dùng sẽ hiển thị từng độ tuổi là "đã bật", vì người dùng đủ điều kiện xem quảng cáo; nhưng AdGroupCriterion.status sẽ hiển thị "đã xoá", vì không có tiêu chí khẳng định nào được thêm vào. |
quality_info |
Thông tin về chất lượng của tiêu chí. |
type |
Loại tiêu chí. |
labels[] |
Tên tài nguyên của các nhãn được đính kèm với tiêu chí của nhóm quảng cáo này. |
position_estimates |
Số liệu ước tính cho giá thầu tiêu chí ở các vị trí khác nhau. |
final_urls[] |
Danh sách URL cuối cùng có thể có sau tất cả các lần chuyển hướng giữa nhiều miền cho quảng cáo. |
engine_id |
Mã của tiêu chí nhóm quảng cáo trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản không phải tài khoản Google Ads, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "ad_group_criterion.criterion_id" thay thế. |
last_modified_time |
Ngày giờ khi tiêu chí của nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
criterion_id |
Mã của tiêu chí. |
ad_group |
Nhóm quảng cáo chứa tiêu chí. |
negative |
Liệu sẽ nhắm mục tiêu ( Trường này là không thể thay đổi. Để chuyển một tiêu chí từ dương sang phủ định, hãy xoá rồi thêm lại tiêu chí đó. |
bid_modifier |
Công cụ sửa đổi cho giá thầu khi tiêu chí phù hợp. Công cụ sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Hầu hết các loại tiêu chí có thể nhắm mục tiêu đều hỗ trợ đối tượng sửa đổi. |
cpc_bid_micros |
Giá thầu CPC (chi phí mỗi lượt nhấp). |
effective_cpc_bid_micros |
Giá thầu CPC (chi phí mỗi lượt nhấp) hiệu dụng. |
engine_status |
Trạng thái công cụ cho tiêu chí nhóm quảng cáo. |
final_url_suffix |
Mẫu URL để thêm các tham số vào URL cuối cùng. |
tracking_url_template |
Mẫu URL để tạo URL theo dõi. |
Trường kết hợp Bạn phải đặt chính xác một. |
|
keyword |
Từ khoá. |
listing_group |
Nhóm trang thông tin. |
age_range |
Độ tuổi. |
gender |
Giới tính. |
user_list |
Danh sách người dùng. |
webpage |
Trang web |
location |
Vị trí. |
PositionEstimates
Số liệu ước tính cho giá thầu tiêu chí ở các vị trí khác nhau.
Trường | |
---|---|
top_of_page_cpc_micros |
Ước tính giá thầu CPC bắt buộc để quảng cáo được hiển thị ở đầu trang đầu tiên của kết quả tìm kiếm. |
QualityInfo
Vùng chứa thông tin về chất lượng theo tiêu chí của nhóm quảng cáo.
Trường | |
---|---|
quality_score |
Điểm chất lượng. Trường này có thể không được điền sẵn nếu Google không có đủ thông tin để xác định giá trị. |
AdGroupCriterionLabel
Mối quan hệ giữa tiêu chí nhóm quảng cáo và nhãn.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhãn tiêu chí nhóm quảng cáo. Tên tài nguyên nhãn tiêu chí của nhóm quảng cáo có dạng: |
ad_group_criterion |
Tiêu chí nhóm quảng cáo mà nhãn được đính kèm. |
label |
Nhãn được chỉ định cho tiêu chí nhóm quảng cáo. |
AdGroupLabel
Mối quan hệ giữa nhóm quảng cáo và nhãn.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhãn nhóm quảng cáo. Tên tài nguyên nhãn nhóm quảng cáo có dạng: |
ad_group |
Nhóm quảng cáo mà nhãn được đính kèm. |
label |
Nhãn được chỉ định cho nhóm quảng cáo. |
AgeRangeView
Chế độ xem độ tuổi.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem độ tuổi. Tên tài nguyên của chế độ xem độ tuổi có dạng như sau:
|
Thành phần
Thành phần là một phần của một quảng cáo và có thể được chia sẻ trên nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YouTubeVideoAsset), v.v. Các thành phần không thể thay đổi và không thể xoá được. Để ngừng phân phát một thành phần, hãy xoá thành phần đó khỏi thực thể đang sử dụng thành phần đó.
Trường | |
---|---|
resource_name |
Tên tài nguyên của tài sản. Tên tài nguyên thành phần có dạng như sau:
|
type |
Loại nội dung. |
final_urls[] |
Danh sách URL cuối cùng có thể có sau tất cả các lần chuyển hướng giữa nhiều miền. |
status |
Trạng thái của tài sản. |
creation_time |
Dấu thời gian khi thành phần này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
last_modified_time |
Ngày giờ khi thành phần này được sửa đổi lần gần đây nhất. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
id |
ID của nội dung. |
name |
Tên tài sản (không bắt buộc). |
tracking_url_template |
Mẫu URL để tạo URL theo dõi. |
engine_status |
Trạng thái của công cụ cho một tài sản. |
Trường kết hợp asset_data . Loại nội dung cụ thể. asset_data chỉ có thể là một trong những trạng thái sau đây: |
|
youtube_video_asset |
Nội dung video trên YouTube. |
image_asset |
Thành phần hình ảnh. |
text_asset |
Thành phần văn bản. |
callout_asset |
Một thành phần chú thích hợp nhất. |
sitelink_asset |
Thành phần đường liên kết hợp nhất của trang web. |
page_feed_asset |
Một thành phần nguồn cấp dữ liệu trang hợp nhất. |
mobile_app_asset |
Thành phần ứng dụng di động. |
call_asset |
Một thành phần cuộc gọi hợp nhất. |
call_to_action_asset |
Thành phần lời kêu gọi hành động. |
location_asset |
Một thành phần địa điểm hợp nhất. |
AssetGroup
Một nhóm thành phần. AssetGroupAsset dùng để liên kết một thành phần với nhóm thành phần. AssetGroupSignal dùng để liên kết một tín hiệu với một nhóm thành phần.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhóm thành phần. Tên tài nguyên của nhóm thành phần có dạng như sau:
|
id |
Mã của nhóm tài sản. |
campaign |
Chiến dịch được liên kết với nhóm thành phần này. Thành phần được liên kết với nhóm thành phần. |
name |
Bắt buộc. Tên của nhóm tài sản. Bắt buộc. Phải có độ dài tối thiểu là 1 và chiều dài tối đa là 128. Mã này phải là mã riêng biệt trong một chiến dịch. |
final_urls[] |
Danh sách URL cuối cùng sau tất cả các lần chuyển hướng giữa nhiều miền. Theo mặc định, trong chiến dịch Tối đa hoá hiệu suất, các URL sẽ đủ điều kiện mở rộng trừ phi bạn chọn không sử dụng. |
final_mobile_urls[] |
Danh sách URL cuối cùng trên thiết bị di động sau tất cả các lần chuyển hướng giữa nhiều miền. Theo mặc định, trong chiến dịch Tối đa hoá hiệu suất, các URL sẽ đủ điều kiện mở rộng trừ phi bạn chọn không sử dụng. |
status |
Trạng thái của nhóm thành phần. |
path1 |
Phần đầu tiên của văn bản có thể xuất hiện được nối thêm vào url hiển thị trong quảng cáo. |
path2 |
Phần thứ hai của văn bản có thể xuất hiện được nối thêm vào url hiển thị trong quảng cáo. Bạn chỉ có thể đặt trường này khi đã đặt path1. |
ad_strength |
Độ mạnh tổng thể của quảng cáo của nhóm thành phần này. |
AssetGroupAsset
AssetGroupAsset là mối liên kết giữa một thành phần và một nhóm thành phần. Khi bạn thêm một AssetGroupAsset sẽ liên kết một thành phần với một nhóm thành phần.
Trường | |
---|---|
resource_name |
Tên tài nguyên của thành phần trong nhóm thành phần. Tên tài nguyên thành phần của nhóm thành phần có dạng:
|
asset_group |
Nhóm thành phần mà thành phần trong nhóm thành phần này đang liên kết. |
asset |
Thành phần mà thành phần trong nhóm thành phần này đang liên kết. |
field_type |
Nội dung mô tả về vị trí của thành phần trong nhóm thành phần. Ví dụ: HEADLINE, YOUTUBE_VIDEO, v.v. |
status |
Trạng thái của mối liên kết giữa một thành phần và nhóm thành phần. |
AssetGroupAssetCombinationData
Dữ liệu kết hợp thành phần của nhóm thành phần
Trường | |
---|---|
asset_combination_served_assets[] |
Thành phần được phân phát. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter thể hiện một nút cây bộ lọc nhóm trang thông tin trong một nhóm thành phần.
Trường | |
---|---|
resource_name |
Tên tài nguyên của bộ lọc nhóm trang thông tin của nhóm thành phần. Tên tài nguyên bộ lọc của nhóm trang thông tin của nhóm thành phần có dạng như sau:
|
asset_group |
Nhóm thành phần có bộ lọc nhóm trang thông tin của nhóm thành phần này. |
id |
Mã của ListGroupFilter. |
type |
Loại nút bộ lọc nhóm trang thông tin. |
vertical |
Dọc mà cây nút hiện tại đại diện. Tất cả các nút trong cùng một cây phải thuộc cùng một ngành dọc. |
case_value |
Giá trị phương diện mà nhóm trang thông tin này đang tinh chỉnh lại thành phần mẹ. Không xác định cho nhóm gốc. |
parent_listing_group_filter |
Tên tài nguyên của nhóm phụ nhóm trang thông tin gốc. Giá trị rỗng cho nút bộ lọc nhóm trang thông tin gốc. |
path |
Đường dẫn của các phương diện xác định bộ lọc nhóm trang thông tin này. |
AssetGroupSignal
AssetGroupSignal thể hiện một tín hiệu trong nhóm thành phần. Sự tồn tại của tín hiệu cho chiến dịch tối đa hoá hiệu suất biết ai có nhiều khả năng chuyển đổi nhất. Chiến dịch Tối đa hoá hiệu suất sử dụng tín hiệu này để tìm những người dùng mới có ý định tương tự hoặc rõ ràng hơn nhằm thu hút các lượt chuyển đổi trên Mạng Tìm kiếm, Mạng Hiển thị, Video, v.v.
Trường | |
---|---|
resource_name |
Tên tài nguyên của tín hiệu nhóm thành phần. Tên tài nguyên tín hiệu của nhóm thành phần có dạng:
|
asset_group |
Nhóm thành phần chứa tín hiệu của nhóm thành phần này. |
Trường kết hợp signal . Tín hiệu của nhóm thành phần. signal chỉ có thể là một trong những trạng thái sau đây: |
|
audience |
Tín hiệu về đối tượng mà chiến dịch tối đa hoá hiệu suất sẽ sử dụng. |
AssetGroupTopCombinationView
Chế độ xem về việc sử dụng tổ hợp thành phần quảng cáo của nhóm quảng cáo.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem tổ hợp hàng đầu của nhóm thành phần. Tên tài nguyên của chế độ xem Kết hợp hàng đầu của AssetGroup có dạng: ""khách hàng/{customer_id}/assetGroupTopMergeViews/{asset_group_id}~{asset_results_category}" |
asset_group_top_combinations[] |
Các kiểu kết hợp thành phần hiệu quả nhất được phân phát cùng nhau. |
AssetSet
Một nhóm thành phần đại diện cho một tập hợp các thành phần. Sử dụng AssetSetAsset để liên kết một thành phần với nhóm thành phần.
Trường | |
---|---|
id |
Mã của nhóm thành phần. |
resource_name |
Tên tài nguyên của nhóm thành phần. Tên tài nguyên của nhóm thành phần có dạng như sau:
|
AssetSetAsset
AssetSetAsset là mối liên kết giữa một tài sản và một nhóm tài sản. Khi bạn thêm một AssetSetAsset, một tài sản sẽ được liên kết với một nhóm thành phần.
Trường | |
---|---|
resource_name |
Tên tài nguyên của thành phần của nhóm thành phần. Tên tài nguyên thành phần của nhóm thành phần có dạng như sau:
|
asset_set |
Nhóm thành phần mà thành phần nhóm thành phần này đang liên kết đến. |
asset |
Tài sản mà thành phần nhóm thành phần này đang liên kết đến. |
status |
Trạng thái của thành phần nhóm thành phần. Chỉ có thể đọc. |
Đối tượng
Đối tượng là một lựa chọn nhắm mục tiêu hiệu quả, cho phép bạn phân tách các thuộc tính phân khúc (chẳng hạn như thông tin chi tiết về nhân khẩu học và đối tượng chung sở thích) để tạo đối tượng đại diện cho các phần trong phân khúc mục tiêu của bạn.
Trường | |
---|---|
resource_name |
Tên tài nguyên của đối tượng. Tên đối tượng có dạng:
|
id |
Mã nhận dạng của đối tượng. |
name |
Bắt buộc. Tên của đối tượng. Thông tin này cần phải khác biệt với tất cả các đối tượng. Phải có độ dài tối thiểu là 1 và chiều dài tối đa là 255. |
description |
Nội dung mô tả về đối tượng này. |
BiddingStrategy
Chiến lược đặt giá thầu.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chiến lược đặt giá thầu. Tên tài nguyên chiến lược đặt giá thầu có dạng như sau:
|
status |
Trạng thái của chiến lược đặt giá thầu. Trường này ở chế độ chỉ đọc. |
type |
Loại chiến lược đặt giá thầu. Tạo chiến lược đặt giá thầu bằng cách đặt lược đồ đặt giá thầu. Trường này ở chế độ chỉ đọc. |
currency_code |
Đơn vị tiền tệ mà chiến lược đặt giá thầu sử dụng (mã gồm ba chữ cái theo ISO 4217). Đối với chiến lược đặt giá thầu đối với khách hàng là người quản lý, bạn có thể thiết lập đơn vị tiền tệ này khi tạo và đặt đơn vị tiền tệ mặc định theo đơn vị tiền tệ của khách hàng là người quản lý. Để phục vụ khách hàng, bạn không được đặt trường này; tất cả các chiến lược trong một khách hàng phân phát đều ngầm sử dụng đơn vị tiền tệ của khách hàng phân phát. Trong mọi trường hợp, trường hiệu quả_currency_code sẽ trả về đơn vị tiền tệ mà chiến lược sử dụng. |
id |
Mã của chiến lược đặt giá thầu. |
name |
Tên của chiến lược đặt giá thầu. Tất cả chiến lược đặt giá thầu trong tài khoản phải được đặt tên riêng biệt. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 255, tính cả hai byte UTF-8 (đã cắt bớt). |
effective_currency_code |
Đơn vị tiền tệ mà chiến lược đặt giá thầu sử dụng (mã gồm ba chữ cái theo ISO 4217). Đối với chiến lược đặt giá thầu của khách hàng là người quản lý, đây là đơn vị tiền tệ do nhà quảng cáo đặt khi tạo chiến lược. Để phục vụ khách hàng, đây là Currency_code của khách hàng. Các chỉ số của chiến lược đặt giá thầu được báo cáo theo đơn vị tiền tệ này. Trường này ở chế độ chỉ đọc. |
campaign_count |
Số lượng chiến dịch sử dụng chiến lược đặt giá thầu này. Trường này ở chế độ chỉ đọc. |
non_removed_campaign_count |
Số lượng chiến dịch chưa bị xoá được đính kèm với chiến lược đặt giá thầu này. Trường này ở chế độ chỉ đọc. |
Trường kết hợp Bạn chỉ có thể đặt một. |
|
enhanced_cpc |
Chiến lược đặt giá thầu sẽ tăng giá thầu cho các lượt nhấp dường như có nhiều khả năng dẫn đến lượt chuyển đổi hơn và giảm giá thầu cho các lượt nhấp mà chúng có vẻ ít có khả năng dẫn đến lượt chuyển đổi hơn. |
maximize_conversion_value |
Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách. |
maximize_conversions |
Một chiến lược đặt giá thầu tự động giúp nhận được nhiều lượt chuyển đổi nhất cho chiến dịch khi chi tiêu ngân sách của bạn. |
target_cpa |
Chiến lược đặt giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt. |
target_impression_share |
Chiến lược đặt giá thầu tự động tối ưu hoá theo tỷ lệ phần trăm lượt hiển thị đã chọn. |
target_outrank_share |
Chiến lược đặt giá thầu sẽ đặt giá thầu dựa trên tỷ lệ mục tiêu của phiên đấu giá mà nhà quảng cáo phải nâng thứ hạng của một đối thủ cạnh tranh cụ thể. Trường này không được dùng nữa. Bạn sẽ không thể tạo chiến lược đặt giá thầu mới với trường này hoặc đính kèm chiến lược đặt giá thầu có trường này vào chiến dịch. Bạn có thể thay đổi các chiến lược đã điền sẵn lược đồ này. |
target_roas |
Chiến lược đặt giá thầu giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được lợi tức trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể. |
target_spend |
Chiến lược giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình. |
Chiến dịch
Chiến dịch.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chiến dịch. Tên tài nguyên chiến dịch có dạng:
|
status |
Trạng thái của chiến dịch. Khi thêm một chiến dịch mới, trạng thái mặc định là BẬT. |
serving_status |
Trạng thái phân phát quảng cáo của chiến dịch. |
bidding_strategy_system_status |
Trạng thái hệ thống của chiến lược đặt giá thầu của chiến dịch. |
ad_serving_optimization_status |
Trạng thái tối ưu hoá việc phân phát quảng cáo của chiến dịch. |
advertising_channel_type |
Mục tiêu phân phát chính cho các quảng cáo trong chiến dịch. Bạn có thể tinh chỉnh các lựa chọn nhắm mục tiêu trong Đây là trường bắt buộc và không được để trống khi tạo chiến dịch mới. Chỉ có thể thiết lập khi tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường này. |
advertising_channel_sub_type |
Tinh chỉnh (không bắt buộc) đối với Chỉ có thể thiết lập khi tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường này. |
url_custom_parameters[] |
Danh sách mối liên kết dùng để thay thế các thẻ thông số tuỳ chỉnh trong |
real_time_bidding_setting |
Cài đặt cho Đặt giá thầu theo thời gian thực, tính năng chỉ có sẵn cho các chiến dịch nhắm mục tiêu mạng Ad Exchange. |
network_settings |
Chế độ cài đặt mạng cho chiến dịch. |
dynamic_search_ads_setting |
Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA). |
shopping_setting |
Chế độ cài đặt để kiểm soát chiến dịch Mua sắm. |
geo_target_type_setting |
Chế độ cài đặt cho tiêu chí nhắm mục tiêu theo địa lý của quảng cáo. |
labels[] |
Tên tài nguyên của các nhãn được đính kèm với chiến dịch này. |
bidding_strategy_type |
Loại chiến lược đặt giá thầu. Bạn có thể tạo chiến lược đặt giá thầu bằng cách thiết lập lược đồ đặt giá thầu để tạo chiến lược đặt giá thầu chuẩn hoặc trường Trường này ở chế độ chỉ đọc. |
accessible_bidding_strategy |
Tên tài nguyên của AccessibleBidStrategy, chế độ xem chỉ có thể đọc cho các thuộc tính không bị hạn chế của chiến lược đặt giá thầu danh mục đầu tư đính kèm được xác định bằng thuộc tính "bidding_strategy". Để trống, nếu chiến dịch không sử dụng chiến lược danh mục đầu tư. Tất cả khách hàng được chia sẻ chiến lược này đều có thể sử dụng các thuộc tính chiến lược không bị hạn chế cũng như được đọc trong tài nguyên AccessibleBidStrategy. Ngược lại, các thuộc tính bị hạn chế chỉ được cung cấp cho khách hàng là chủ sở hữu của chiến lược và người quản lý của chiến lược đó. Bạn chỉ có thể đọc các thuộc tính bị hạn chế trong tài nguyên BiddingStrategy. |
frequency_caps[] |
Danh sách giới hạn tần suất mỗi người dùng sẽ thấy quảng cáo của chiến dịch này. |
selective_optimization |
Chế độ cài đặt tối ưu hoá có chọn lọc cho chiến dịch này, bao gồm một nhóm hành động chuyển đổi để tối ưu hoá chiến dịch này. Tính năng này chỉ áp dụng cho những chiến dịch ứng dụng sử dụng MULTI_CHANNEL làm AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT làm AdvertisingChannelSubType. |
optimization_goal_setting |
Chế độ cài đặt mục tiêu tối ưu hoá cho chiến dịch này, bao gồm một nhóm các loại mục tiêu tối ưu hoá. |
tracking_setting |
Chế độ cài đặt cấp chiến dịch cho thông tin theo dõi. |
engine_id |
Mã của chiến dịch trong tài khoản công cụ bên ngoài. Trường này chỉ dành cho tài khoản không phải tài khoản Google Ads, ví dụ: Yahoo Japan, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "campaign.id" thay thế. |
excluded_parent_asset_field_types[] |
Các loại trường thành phần sẽ bị loại trừ khỏi chiến dịch này. Chiến dịch này sẽ không kế thừa những đường liên kết tài sản có các loại trường này ở cấp cao hơn. |
create_time |
Dấu thời gian khi chiến dịch này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . create_time sẽ không được dùng nữa trong phiên bản 1. Thay vào đó, hãy sử dụng creator_time. |
creation_time |
Dấu thời gian khi chiến dịch này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
last_modified_time |
Ngày giờ khi chiến dịch này được sửa đổi lần gần đây nhất. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
id |
Mã của chiến dịch. |
name |
Tên của chiến dịch. Đây là trường bắt buộc và không được để trống khi tạo chiến dịch mới. Nó không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD). |
tracking_url_template |
Mẫu URL để tạo URL theo dõi. |
campaign_budget |
Ngân sách của chiến dịch. |
start_date |
Ngày chiến dịch bắt đầu phân phát theo múi giờ của khách hàng theo định dạng YYYY-MM-DD. |
end_date |
Ngày cuối cùng của chiến dịch phân phát theo múi giờ của khách hàng theo định dạng YYYY-MM-DD. Khi tạo, giá trị mặc định là 2037-12-30, nghĩa là chiến dịch sẽ chạy vô thời hạn. Để đặt một chiến dịch hiện tại chạy vô thời hạn, hãy đặt trường này thành 2037-12-30. |
final_url_suffix |
Hậu tố dùng để thêm các tham số truy vấn vào trang đích được phân phát thông qua tính năng theo dõi song song. |
url_expansion_opt_out |
Thể hiện việc chọn không sử dụng tính năng mở rộng URL cho các URL được nhắm mục tiêu cụ thể hơn. Nếu bạn chọn không sử dụng (true), thì chỉ các URL cuối cùng trong nhóm thành phần hoặc các URL được chỉ định trong Google Merchant Center hoặc nguồn cấp dữ liệu doanh nghiệp của nhà quảng cáo mới được nhắm đến. Nếu chọn sử dụng (false), toàn bộ miền sẽ được nhắm mục tiêu. Bạn chỉ có thể đặt trường này cho những chiến dịch Tối đa hoá hiệu suất có giá trị mặc định là false. |
Trường kết hợp Phải là danh mục đầu tư (được tạo thông qua dịch vụ Đặt giá thầu) hoặc danh mục chuẩn được nhúng vào chiến dịch. |
|
bidding_strategy |
Chiến lược giá thầu danh mục đầu tư mà chiến dịch sử dụng. |
manual_cpa |
Chiến lược đặt giá thầu CPA thủ công chuẩn. Chiến lược đặt giá thầu thủ công cho phép nhà quảng cáo đặt giá thầu cho mỗi hành động do nhà quảng cáo chỉ định. Chỉ được hỗ trợ cho chiến dịch Dịch vụ địa phương. |
manual_cpc |
Chiến lược đặt giá thầu CPC thủ công chuẩn. Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp. |
manual_cpm |
Chiến lược đặt giá thầu CPM thủ công chuẩn. Đặt giá thầu dựa trên lượt hiển thị thủ công, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị. |
maximize_conversions |
Chiến lược đặt giá thầu Tối đa hoá lượt chuyển đổi chuẩn tự động tối đa hoá số lượt chuyển đổi trong khi chi tiêu ngân sách của bạn. |
maximize_conversion_value |
Chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi chuẩn. Chiến lược này sẽ tự động đặt giá thầu để tối đa hoá doanh thu trong khi chi tiêu ngân sách của bạn. |
target_cpa |
Chiến lược đặt giá thầu CPA mục tiêu chuẩn sẽ tự động đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể với mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt. |
target_impression_share |
Chiến lược đặt giá thầu Tỷ lệ hiển thị mục tiêu. Một chiến lược đặt giá thầu tự động giúp đặt giá thầu để đạt được tỷ lệ phần trăm lượt hiển thị đã chọn. |
target_roas |
Chiến lược đặt giá thầu ROAS mục tiêu chuẩn giúp tự động tối đa hoá doanh thu trong khi vẫn đạt được một mức lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể. |
target_spend |
Chiến lược đặt giá thầu Chi tiêu mục tiêu chuẩn sẽ tự động đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách. |
percent_cpc |
Chiến lược đặt giá thầu Phần trăm Cpc chuẩn, trong đó giá thầu bằng một phần giá quảng cáo cho một số hàng hóa hoặc dịch vụ. |
target_cpm |
Chiến lược đặt giá thầu tự động tối ưu hoá chi phí mỗi nghìn lượt hiển thị. |
DynamicSearchAdsSetting
Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA).
Trường | |
---|---|
domain_name |
Bắt buộc. Tên miền Internet mà chế độ cài đặt này đại diện, chẳng hạn như "google.com" hoặc "www.google.com". |
language_code |
Bắt buộc. Mã ngôn ngữ chỉ định ngôn ngữ của miền, ví dụ: "en". |
use_supplied_urls_only |
Chiến dịch có sử dụng URL độc quyền do nhà quảng cáo cung cấp hay không. |
GeoTargetTypeSetting
Trình bày tập hợp các chế độ cài đặt liên quan đến việc nhắm mục tiêu theo địa lý của quảng cáo.
Trường | |
---|---|
positive_geo_target_type |
Chế độ cài đặt dùng để nhắm mục tiêu theo địa lý khẳng định trong chiến dịch cụ thể này. |
negative_geo_target_type |
Chế độ cài đặt dùng để nhắm mục tiêu theo địa lý phủ định trong chiến dịch cụ thể này. |
NetworkSettings
Chế độ cài đặt mạng cho chiến dịch.
Trường | |
---|---|
target_google_search |
Liệu quảng cáo có được phân phát cùng với kết quả tìm kiếm trên google.com. |
target_search_network |
Liệu quảng cáo có được phân phát trên các trang web đối tác trong Mạng Tìm kiếm của Google hay không (yêu cầu |
target_content_network |
Liệu quảng cáo có được phân phát trên các vị trí cụ thể trong Mạng Hiển thị của Google hay không. Vị trí được chỉ định bằng tiêu chí Vị trí. |
target_partner_search_network |
Quảng cáo có được phân phát trên Mạng đối tác của Google hay không. Tính năng này chỉ dành cho một số tài khoản đối tác của Google được chọn. |
OptimizationGoalSetting
Chế độ cài đặt mục tiêu tối ưu hoá cho chiến dịch này, bao gồm một nhóm các loại mục tiêu tối ưu hoá.
Trường | |
---|---|
optimization_goal_types[] |
Danh sách các loại mục tiêu tối ưu hoá. |
SelectiveOptimization
Chế độ cài đặt tối ưu hoá có chọn lọc cho chiến dịch này, bao gồm một nhóm hành động chuyển đổi để tối ưu hoá chiến dịch này. Tính năng này chỉ áp dụng cho những chiến dịch ứng dụng sử dụng MULTI_CHANNEL làm AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT làm AdvertisingChannelSubType.
Trường | |
---|---|
conversion_actions[] |
Nhóm hành động chuyển đổi đã chọn để tối ưu hoá chiến dịch này. |
ShoppingSetting
Chế độ cài đặt cho chiến dịch Mua sắm. Xác định nhiều loại sản phẩm mà chiến dịch có thể quảng cáo và cách chiến dịch này tương tác với các chiến dịch Mua sắm khác.
Trường | |
---|---|
feed_label |
Nhãn nguồn cấp dữ liệu của sản phẩm cần thêm vào chiến dịch. Bạn chỉ có thể đặt một trong hai giá trị feed_label hoặc sales_country. Nếu được sử dụng thay cho sales_country, thì trường feed_label sẽ chấp nhận mã quốc gia có cùng định dạng, ví dụ: "XX". Nếu không, có thể là bất kỳ chuỗi nào dùng cho nhãn nguồn cấp dữ liệu trong Google Merchant Center. |
use_vehicle_inventory |
Liệu có nhắm đến khoảng không quảng cáo của Trang thông tin xe hay không. |
merchant_id |
Mã của tài khoản Merchant Center. Đây là trường bắt buộc cho các thao tác tạo. Trường này không thể thay đổi cho chiến dịch Mua sắm. |
sales_country |
Quốc gia bán của sản phẩm cần đưa vào chiến dịch. |
campaign_priority |
Mức độ ưu tiên của chiến dịch. Các chiến dịch có mức độ ưu tiên cao hơn về mặt số lượng sẽ được ưu tiên hơn các chiến dịch có mức độ ưu tiên thấp hơn. Đây là trường bắt buộc đối với chiến dịch Mua sắm, có giá trị từ 0 đến 2. Trường này không bắt buộc đối với chiến dịch Mua sắm thông minh, nhưng nếu bạn đặt trường này thì giá trị phải bằng 3. |
enable_local |
Liệu có thêm sản phẩm tại cửa hàng địa phương hay không. |
TrackingSetting
Chế độ cài đặt cấp chiến dịch cho thông tin theo dõi.
Trường | |
---|---|
tracking_url |
URL dùng để theo dõi linh động. |
CampaignAsset
Mối liên kết giữa Chiến dịch và Tài sản.
Trường | |
---|---|
resource_name |
Tên tài nguyên của thành phần chiến dịch. Tên tài nguyên CampaignAsset có dạng:
|
status |
Trạng thái của thành phần chiến dịch. |
campaign |
Chiến dịch liên kết với tài sản. |
asset |
Thành phần được liên kết với chiến dịch. |
CampaignAssetSet
CampaignAssetSet là mối liên kết giữa một chiến dịch và một nhóm thành phần. Khi bạn thêm CampaignAssetSet, một nhóm thành phần sẽ được liên kết với một chiến dịch.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhóm thành phần chiến dịch. Tên tài nguyên thành phần của nhóm thành phần có dạng như sau:
|
campaign |
Chiến dịch mà tập hợp thành phần này được liên kết. |
asset_set |
Nhóm thành phần được liên kết với chiến dịch. |
status |
Trạng thái của thành phần nhóm thành phần chiến dịch. Chỉ có thể đọc. |
CampaignAudienceView
Chế độ xem đối tượng chiến dịch. Bao gồm dữ liệu hiệu suất từ các mối quan tâm, danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và quảng cáo trên Mạng YouTube, cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp theo tiêu chí chiến dịch và tiêu chí đối tượng. Chế độ xem này chỉ bao gồm đối tượng được đính kèm ở cấp chiến dịch.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem đối tượng của chiến dịch. Tên tài nguyên chế độ xem đối tượng của chiến dịch có dạng:
|
CampaignBudget
Ngân sách chiến dịch.
Trường | |
---|---|
resource_name |
Tên tài nguyên của ngân sách chiến dịch. Tên tài nguyên ngân sách chiến dịch có dạng:
|
delivery_method |
Phương thức phân phối xác định tỷ lệ chi tiêu ngân sách chiến dịch. Giá trị mặc định là STANDARD nếu bạn không chỉ định trong thao tác tạo. |
period |
Khoảng thời gian chi tiêu ngân sách. Giá trị mặc định là HẰNG NGÀY nếu không được chỉ định. |
amount_micros |
Số tiền ngân sách, bằng nội tệ cho tài khoản. Số tiền được chỉ định bằng phần triệu, trong đó một triệu tương đương với một đơn vị tiền tệ. Giới hạn chi tiêu hằng tháng tối đa là 30,4 lần số tiền này. |
CampaignCriterion
Tiêu chí chiến dịch.
Trường | |
---|---|
resource_name |
Tên tài nguyên của tiêu chí chiến dịch. Tên tài nguyên tiêu chí chiến dịch có dạng:
|
display_name |
Tên hiển thị của tiêu chí. Trường này bị bỏ qua đối với các trường hợp thay đổi. |
type |
Loại tiêu chí. |
status |
Trạng thái của tiêu chí. |
last_modified_time |
Ngày giờ khi tiêu chí chiến dịch này được sửa đổi lần cuối. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
criterion_id |
Mã của tiêu chí. Trường này bị bỏ qua khi thay đổi. |
bid_modifier |
Công cụ sửa đổi cho giá thầu khi tiêu chí phù hợp. Công cụ sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Hầu hết các loại tiêu chí có thể nhắm mục tiêu đều hỗ trợ đối tượng sửa đổi. Sử dụng số 0 để chọn không sử dụng một Loại thiết bị. |
negative |
Liệu sẽ nhắm mục tiêu ( |
Trường kết hợp Bạn phải đặt chính xác một. |
|
keyword |
Từ khoá. |
location |
Vị trí. |
device |
Thiết bị. |
age_range |
Độ tuổi. |
gender |
Giới tính. |
user_list |
Danh sách người dùng. |
language |
Ngôn ngữ. |
webpage |
Trang web. |
location_group |
Nhóm vị trí |
CampaignLabel
Thể hiện mối quan hệ giữa chiến dịch và nhãn.
Trường | |
---|---|
resource_name |
Tên của tài nguyên. Tên tài nguyên nhãn chiến dịch có dạng: |
campaign |
Chiến dịch mà nhãn được đính kèm. |
label |
Nhãn được chỉ định cho chiến dịch. |
CartDataSalesView
Chế độ xem lượt bán hàng trong dữ liệu giỏ hàng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem lượt bán hàng dựa trên dữ liệu giỏ hàng. Tên tài nguyên chế độ xem lượt bán hàng trong dữ liệu giỏ hàng có dạng: |
Chuyển đổi
Lượt chuyển đổi.
Trường | |
---|---|
resource_name |
Tên tài nguyên của lượt chuyển đổi. Tên tài nguyên chuyển đổi có dạng:
|
id |
Mã của lượt chuyển đổi |
criterion_id |
Mã tiêu chí Search Ads 360. Giá trị 0 cho biết tiêu chí đó chưa được phân bổ. |
merchant_id |
Mã tài khoản kho hàng Search Ads 360 chứa sản phẩm mà người dùng đã nhấp vào. Search Ads 360 tạo mã này khi bạn liên kết một tài khoản kho hàng trong Search Ads 360. |
ad_id |
Mã quảng cáo. Giá trị 0 cho biết rằng quảng cáo không được phân bổ. |
click_id |
Một chuỗi riêng biệt dành cho lượt truy cập mà lượt chuyển đổi được phân bổ, được chuyển đến trang đích dưới dạng tham số URL mã lượt nhấp. |
visit_id |
Mã lượt truy cập Search Ads 360 mà lượt chuyển đổi được phân bổ. |
advertiser_conversion_id |
Đối với lượt chuyển đổi ngoại tuyến, đây là mã do nhà quảng cáo cung cấp. Nếu nhà quảng cáo không chỉ định một mã nhận dạng như vậy, thì Search Ads 360 sẽ tạo một mã. Đối với lượt chuyển đổi trực tuyến, giá trị này bằng cột id hoặc cột floodlight_order_id, tuỳ thuộc vào hướng dẫn Floodlight của nhà quảng cáo. |
product_id |
Mã của sản phẩm được nhấp vào. |
product_channel |
Kênh bán hàng của sản phẩm mà người dùng nhấp vào: Trực tuyến hoặc Địa phương. |
product_language_code |
Ngôn ngữ (ISO-639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center có chứa dữ liệu về sản phẩm. |
product_store_id |
Cửa hàng trong Quảng cáo kho hàng tại địa phương mà người dùng đã nhấp vào. Giá trị này phải khớp với mã cửa hàng dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn. |
product_country_code |
Quốc gia (định dạng ISO-3166) đã đăng ký nguồn cấp dữ liệu kho hàng có chứa sản phẩm mà người dùng nhấp vào. |
attribution_type |
Chuyển đổi được phân bổ cho: Lượt truy cập hoặc Từ khoá+Quảng cáo. |
conversion_date_time |
Dấu thời gian của sự kiện chuyển đổi. |
conversion_last_modified_date_time |
Dấu thời gian của lần sửa đổi lượt chuyển đổi gần đây nhất. |
conversion_visit_date_time |
Dấu thời gian của lượt truy cập mà lượt chuyển đổi được phân bổ. |
conversion_quantity |
Số lượng mặt hàng được ghi lại bởi lượt chuyển đổi, như được xác định bởi thông số url số lượng. Nhà quảng cáo có trách nhiệm tự động điền thông số (chẳng hạn như số lượng mặt hàng đã bán trong lượt chuyển đổi), nếu không, giá trị mặc định sẽ là 1. |
conversion_revenue_micros |
Doanh thu đã điều chỉnh tính bằng phần triệu cho sự kiện chuyển đổi. Đơn vị tiền tệ này sẽ luôn sử dụng đơn vị tiền tệ của tài khoản phân phát quảng cáo. |
floodlight_original_revenue |
Doanh thu ban đầu, không thay đổi được liên kết với sự kiện Floodlight (theo đơn vị tiền tệ của báo cáo hiện tại) trước khi chỉ định về đơn vị tiền tệ của Floodlight sửa đổi. |
floodlight_order_id |
Mã đơn hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi. |
status |
Trạng thái của lượt chuyển đổi: ĐÃ BẬT hoặc ĐÃ LOẠI BỎ. |
asset_id |
Mã của tài sản được tương tác trong sự kiện chuyển đổi. |
asset_field_type |
Loại trường thành phần của sự kiện chuyển đổi. |
ConversionAction
Hành động chuyển đổi.
Trường | |
---|---|
resource_name |
Tên tài nguyên của hành động chuyển đổi. Tên tài nguyên hành động chuyển đổi có dạng như sau:
|
creation_time |
Dấu thời gian tạo hoạt động Floodlight, được định dạng theo ISO 8601. |
status |
Trạng thái của hành động chuyển đổi này để tích luỹ sự kiện chuyển đổi. |
type |
Loại của hành động chuyển đổi này. |
category |
Danh mục lượt chuyển đổi được báo cáo cho hành động chuyển đổi này. |
value_settings |
Chế độ cài đặt liên quan đến giá trị cho sự kiện chuyển đổi được liên kết với hành động chuyển đổi này. |
attribution_model_settings |
Chế độ cài đặt liên quan đến mô hình phân bổ của hành động chuyển đổi này. |
floodlight_settings |
Chế độ cài đặt Floodlight cho các loại chuyển đổi Floodlight. |
id |
Mã của hành động chuyển đổi. |
name |
Tên của hành động chuyển đổi. Đây là trường bắt buộc và không được để trống khi tạo hành động chuyển đổi mới. |
primary_for_goal |
Nếu giá trị primary_for_mục tiêu (chính_mục_tiêu) của hành động chuyển đổi là false, thì hành động chuyển đổi đó không thể đặt giá thầu cho tất cả chiến dịch, bất kể mục tiêu lượt chuyển đổi khách hàng hoặc mục tiêu lượt chuyển đổi của chiến dịch. Tuy nhiên, mục tiêu lượt chuyển đổi tuỳ chỉnh không tuân theo nguyên tắc primary_for_mục tiêu. Vì vậy, nếu một chiến dịch có mục tiêu lượt chuyển đổi tuỳ chỉnh được định cấu hình với hành động chuyển đổi primary_for_mục tiêu = hành động chuyển đổi sai, thì hành động chuyển đổi đó vẫn có thể đặt giá thầu. Theo mặc định, primary_for_mục tiêu sẽ là đúng nếu không được đặt. Trong V9, bạn chỉ có thể đặt primary_for_mục tiêu thành false sau khi tạo thông qua mục "cập nhật" vì không được khai báo là không bắt buộc. |
owner_customer |
Tên tài nguyên của khách hàng là chủ sở hữu hành động chuyển đổi, hoặc rỗng nếu đây là hành động chuyển đổi do hệ thống xác định. |
include_in_client_account_conversions_metric |
Liệu hành động chuyển đổi này có được đưa vào cột "client_account_conversions" hay không chỉ số. |
include_in_conversions_metric |
Liệu hành động chuyển đổi này có được đưa vào "lượt chuyển đổi" hay không chỉ số. |
click_through_lookback_window_days |
Số ngày tối đa có thể trôi qua giữa một lượt tương tác (ví dụ: một lượt nhấp) và một sự kiện chuyển đổi. |
app_id |
Mã ứng dụng cho một hành động chuyển đổi đối với ứng dụng. |
AttributionModelSettings
Chế độ cài đặt liên quan đến mô hình phân bổ của hành động chuyển đổi này.
Trường | |
---|---|
attribution_model |
Loại mô hình phân bổ của hành động chuyển đổi này. |
data_driven_model_status |
Trạng thái của mô hình phân bổ dựa trên dữ liệu cho hành động chuyển đổi. |
FloodlightSettings
Chế độ cài đặt liên quan đến hành động chuyển đổi Floodlight.
Trường | |
---|---|
activity_group_tag |
Chuỗi được dùng để xác định một nhóm hoạt động Floodlight khi báo cáo lượt chuyển đổi. |
activity_tag |
Chuỗi được dùng để xác định hoạt động Floodlight khi báo cáo lượt chuyển đổi. |
activity_id |
Mã của hoạt động Floodlight trong Trình quản lý chiến dịch DoubleClick (DCM). |
ValueSettings
Chế độ cài đặt liên quan đến giá trị cho sự kiện chuyển đổi được liên kết với hành động chuyển đổi này.
Trường | |
---|---|
default_value |
Giá trị cần sử dụng khi các sự kiện chuyển đổi cho hành động chuyển đổi này được gửi kèm theo một giá trị không hợp lệ, không được phép hoặc bị thiếu, hoặc khi hành động chuyển đổi này được định cấu hình để luôn sử dụng giá trị mặc định. |
default_currency_code |
Mã đơn vị tiền tệ để sử dụng khi sự kiện chuyển đổi cho hành động chuyển đổi này được gửi cùng với mã đơn vị tiền tệ không hợp lệ hoặc bị thiếu mã đơn vị tiền tệ hoặc khi hành động chuyển đổi này được định cấu hình để luôn sử dụng giá trị mặc định. |
always_use_default_value |
Kiểm soát việc có sử dụng giá trị mặc định và mã đơn vị tiền tệ mặc định thay cho giá trị và mã đơn vị tiền tệ được chỉ định trong các sự kiện chuyển đổi cho hành động chuyển đổi này hay không. |
ConversionCustomVariable
Biến tuỳ chỉnh cho lượt chuyển đổi. Xem bài viết "Giới thiệu về các phương diện và chỉ số Floodlight tuỳ chỉnh trong Search Ads 360 mới" tại https://support.google.com/sa360/answer/13567857
Trường | |
---|---|
resource_name |
Tên tài nguyên của biến tùy chỉnh lượt chuyển đổi. Tên tài nguyên biến tùy chỉnh của lượt chuyển đổi có dạng như sau:
|
id |
Mã của biến tuỳ chỉnh lượt chuyển đổi. |
name |
Bắt buộc. Tên của biến tuỳ chỉnh cho lượt chuyển đổi. Tên phải là duy nhất. Độ dài tối đa của tên là 100 ký tự. Không được có thêm dấu cách ở trước và sau. |
tag |
Bắt buộc. Thẻ của biến tùy chỉnh lượt chuyển đổi. Thẻ phải là duy nhất và chứa chữ "u" ký tự trực tiếp theo sau bằng một số nhỏ hơn hoặc bằng 100. Ví dụ: "u4". |
status |
Trạng thái của biến tuỳ chỉnh lượt chuyển đổi để tích luỹ sự kiện chuyển đổi. |
owner_customer |
Tên tài nguyên của khách hàng sở hữu biến tuỳ chỉnh cho lượt chuyển đổi. |
family |
Nhóm biến tuỳ chỉnh cho lượt chuyển đổi. |
cardinality |
Số lượng giá trị riêng biệt của biến tuỳ chỉnh lượt chuyển đổi. |
floodlight_conversion_custom_variable_info |
Các trường dành cho biến tuỳ chỉnh của lượt chuyển đổi Floodlight trong Search Ads 360. |
custom_column_ids[] |
Mã của các cột tuỳ chỉnh sử dụng biến tuỳ chỉnh của lượt chuyển đổi này. |
FloodlightConversionCustomVariableInfo
Thông tin về Biến tuỳ chỉnh của lượt chuyển đổi Floodlight của Search Ads 360.
Trường | |
---|---|
floodlight_variable_type |
Loại biến Floodlight được xác định trong Search Ads 360. |
floodlight_variable_data_type |
Loại dữ liệu của biến Floodlight được xác định trong Search Ads 360. |
ConversionTrackingSetting
Tập hợp các chế độ cài đặt trên toàn khách hàng liên quan đến tính năng Theo dõi lượt chuyển đổi của Search Ads 360.
Trường | |
---|---|
accepted_customer_data_terms |
Liệu khách hàng đã chấp nhận các điều khoản về dữ liệu khách hàng hay chưa. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này ở chế độ chỉ đọc. Để biết thêm thông tin, hãy xem https://support.google.com/adspolicy/answer/7475709. |
conversion_tracking_status |
Trạng thái theo dõi lượt chuyển đổi. Mã này cho biết liệu khách hàng có đang sử dụng tính năng theo dõi lượt chuyển đổi hay không và ai là chủ sở hữu tính năng theo dõi lượt chuyển đổi của khách hàng này. Nếu khách hàng này đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị được trả về sẽ khác nhau dựa trên |
enhanced_conversions_for_leads_enabled |
Liệu khách hàng có chọn sử dụng tính năng lượt chuyển đổi nâng cao cho khách hàng tiềm năng hay không. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này ở chế độ chỉ đọc. |
google_ads_conversion_customer |
Tên tài nguyên của khách hàng nơi tạo và quản lý lượt chuyển đổi. Trường này ở chế độ chỉ đọc. |
conversion_tracking_id |
Id theo dõi chuyển đổi được sử dụng cho tài khoản này. Mã này không cho biết liệu khách hàng có sử dụng tính năng theo dõi lượt chuyển đổi hay không (conversion_tracking_status). Trường này ở chế độ chỉ đọc. |
google_ads_cross_account_conversion_tracking_id |
Id theo dõi chuyển đổi của người quản lý của khách hàng. Giá trị này được đặt khi khách hàng chọn sử dụng tính năng theo dõi lượt chuyển đổi và sẽ ghi đè conversion_tracking_id. Bạn chỉ có thể quản lý trường này thông qua giao diện người dùng Google Ads. Trường này ở chế độ chỉ đọc. |
cross_account_conversion_tracking_id |
Id theo dõi chuyển đổi của người quản lý của khách hàng. Giá trị này được đặt khi khách hàng chọn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản và sẽ ghi đè conversion_tracking_id. |
CustomColumn
Cột tuỳ chỉnh. Xem cột tùy chỉnh của Search Ads 360 tại https://support.google.com/sa360/answer/9633916
Trường | |
---|---|
resource_name |
Tên tài nguyên của cột tuỳ chỉnh. Tên tài nguyên cột tuỳ chỉnh có dạng:
|
id |
Mã của cột tuỳ chỉnh. |
name |
Tên của cột tuỳ chỉnh do người dùng xác định. |
description |
Nội dung mô tả về cột tuỳ chỉnh do người dùng xác định. |
value_type |
Loại giá trị kết quả của cột tuỳ chỉnh. |
references_attributes |
Đúng khi cột tuỳ chỉnh tham chiếu đến một hoặc nhiều thuộc tính. |
references_metrics |
Đúng khi cột tuỳ chỉnh đề cập đến một hoặc nhiều chỉ số. |
queryable |
Đúng khi cột tuỳ chỉnh có sẵn để dùng trong truy vấn của SearchAds360Service.Search và SearchAds360Service.SearchStream. |
referenced_system_columns[] |
Danh sách các cột hệ thống được tham chiếu của cột tuỳ chỉnh này. Ví dụ: "Tổng số lượt hiển thị và số lượt nhấp" trong cột tuỳ chỉnh có các cột hệ thống tham chiếu {"metric.clicks", "chiso.display"}. |
Khách hàng
Khách hàng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của khách hàng. Tên tài nguyên dành cho khách hàng có dạng:
|
conversion_tracking_setting |
Cài đặt theo dõi chuyển đổi cho khách hàng. |
account_type |
Loại tài khoản công cụ, ví dụ: Google Ads, Microsoft Advertising, Yahoo Nhật Bản, Baidu, Facebook, Engine Track, v.v. |
double_click_campaign_manager_setting |
Cài đặt Trình quản lý chiến dịch DoubleClick (DCM) cho một khách hàng là người quản lý. |
account_status |
Trạng thái tài khoản, ví dụ: Đã bật, Đang tạm dừng, Đã xoá, v.v. |
last_modified_time |
Ngày giờ khi khách hàng này được sửa đổi lần gần đây nhất. Ngày giờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" . |
engine_id |
Mã của tài khoản trong tài khoản công cụ bên ngoài. |
status |
Trạng thái của khách hàng. |
creation_time |
Dấu thời gian khi khách hàng này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
id |
Mã của khách hàng. |
descriptive_name |
Tên mô tả không bắt buộc và không phải duy nhất của khách hàng. |
currency_code |
Đơn vị tiền tệ mà tài khoản hoạt động. Một số mã đơn vị tiền tệ theo tiêu chuẩn ISO 4217 sẽ được hỗ trợ. |
time_zone |
Mã múi giờ địa phương của khách hàng. |
tracking_url_template |
Mẫu URL để tạo URL theo dõi từ các tham số. |
final_url_suffix |
Mẫu URL để thêm các tham số vào URL cuối cùng. |
auto_tagging_enabled |
Liệu tính năng tự động gắn thẻ có được bật cho khách hàng hay không. |
manager |
Liệu khách hàng có phải là người quản lý hay không. |
CustomerAsset
Mối liên kết giữa khách hàng và thành phần.
Trường | |
---|---|
resource_name |
Tên tài nguyên của thành phần khách hàng. Tên tài nguyên CustomerAsset có dạng:
|
asset |
Bắt buộc. Thành phần được liên kết với khách hàng. |
status |
Trạng thái thành phần khách hàng. |
CustomerAssetSet
CustomerAssetSet là mối liên kết giữa khách hàng và nhóm thành phần. Khi bạn thêm một CustomerAssetSet, một nhóm thành phần sẽ được liên kết với một khách hàng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của nhóm thành phần khách hàng. Tên tài nguyên thành phần của nhóm thành phần có dạng như sau:
|
asset_set |
Nhóm thành phần được liên kết với khách hàng. |
customer |
Khách hàng được liên kết với tập hợp thành phần này. |
status |
Trạng thái của thành phần nhóm thành phần khách hàng. Chỉ có thể đọc. |
CustomerClient
Mối liên kết giữa khách hàng cụ thể và khách hàng của khách hàng. Đối tượng CustomerClient chỉ dành cho khách hàng là người quản lý. Tất cả khách hàng trực tiếp và gián tiếp của khách hàng đều được bao gồm, cũng như bản thân người quản lý.
Trường | |
---|---|
resource_name |
Tên tài nguyên của ứng dụng của khách hàng. Tên tài nguyên CustomerClient có dạng: |
applied_labels[] |
Tên tài nguyên của những nhãn thuộc sở hữu của khách hàng đưa ra yêu cầu được áp dụng cho khách hàng của khách hàng. Tên tài nguyên nhãn có dạng:
|
status |
Trạng thái của khách hàng là khách hàng. Chỉ có thể đọc. |
client_customer |
Tên tài nguyên của khách hàng-khách hàng được liên kết với một khách hàng cụ thể. Chỉ có thể đọc. |
level |
Khoảng cách giữa khách hàng và khách hàng nhất định. Đối với bản thân liên kết, giá trị cấp sẽ là 0. Chỉ có thể đọc. |
time_zone |
Chuỗi Kho lưu trữ dữ liệu ngôn ngữ phổ biến (CLDR) biểu thị múi giờ của ứng dụng, ví dụ: America/Los_Angeles. Chỉ có thể đọc. |
test_account |
Xác định xem khách hàng có phải là một tài khoản thử nghiệm hay không. Chỉ có thể đọc. |
manager |
Xác định xem khách hàng có phải là một người quản lý hay không. Chỉ có thể đọc. |
descriptive_name |
Tên mô tả của khách hàng. Chỉ có thể đọc. |
currency_code |
Mã đơn vị tiền tệ (ví dụ: "USD", "EUR") của khách hàng. Chỉ có thể đọc. |
id |
Mã của khách hàng của khách hàng. Chỉ có thể đọc. |
CustomerManagerLink
Thể hiện mối quan hệ liên kết giữa khách hàng và người quản lý.
Trường | |
---|---|
resource_name |
Tên của tài nguyên. Tên tài nguyên CustomerManagerLink có dạng: |
status |
Trạng thái của mối liên kết giữa khách hàng và người quản lý. |
manager_customer |
Khách hàng là người quản lý được liên kết với khách hàng. |
manager_link_id |
Mã của mối liên kết với tài khoản người quản lý khách hàng. Trường này ở chế độ chỉ đọc. |
start_time |
Dấu thời gian khi CustomerManagerLink được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
DoubleClickCampaignManagerSetting
Cài đặt Trình quản lý chiến dịch DoubleClick (DCM) cho một khách hàng là người quản lý.
Trường | |
---|---|
advertiser_id |
Mã nhận dạng của nhà quảng cáo Campaign Manager được liên kết với khách hàng này. |
network_id |
Mã của mạng Campaign Manager được liên kết với khách hàng này. |
time_zone |
Múi giờ của mạng Campaign Manager liên kết với khách hàng này ở định dạng Cơ sở dữ liệu múi giờ của IANA, chẳng hạn như America/New_ Được. |
DynamicSearchAdsSearchTermView
Chế độ xem cụm từ tìm kiếm cho quảng cáo tìm kiếm động.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem cụm từ tìm kiếm trong quảng cáo tìm kiếm động. Tên tài nguyên của chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động có dạng như sau:
|
landing_page |
URL trang đích được chọn linh động của lượt hiển thị. Trường này ở chế độ chỉ đọc. |
GenderView
Chế độ xem theo giới tính. Tài nguyêngender_view phản ánh trạng thái phân phát hiệu quả, thay vì tiêu chí nào được thêm vào. Theo mặc định, nhóm quảng cáo không có tiêu chí về giới tính sẽ hiển thị cho tất cả giới tính, do đó, tất cả giới tính đều xuất hiện trong giới_tính cùng với số liệu thống kê.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem theo giới tính. Tên tài nguyên chế độ xem giới tính có dạng như sau:
|
GeoTargetConstant
Hằng số mục tiêu địa lý.
Trường | |
---|---|
resource_name |
Tên tài nguyên của hằng số mục tiêu địa lý. Tên tài nguyên hằng số mục tiêu địa lý có dạng như sau:
|
status |
Trạng thái hằng số của mục tiêu địa lý. |
id |
Mã của hằng số mục tiêu địa lý. |
name |
Tên tiếng Anh của hằng số mục tiêu địa lý. |
country_code |
Mã quốc gia theo ISO-3166-1 alpha-2 được liên kết với mục tiêu. |
target_type |
Loại mục tiêu hằng số mục tiêu địa lý. |
canonical_name |
Tên tiếng Anh đủ điều kiện, bao gồm tên của mục tiêu, tên gốc và quốc gia của mục tiêu. |
parent_geo_target |
Tên tài nguyên của hằng số mục tiêu địa lý gốc. Tên tài nguyên hằng số mục tiêu địa lý có dạng như sau:
|
KeywordView
Chế độ xem từ khoá.
Trường | |
---|---|
resource_name |
Tên tài nguyên của khung hiển thị từ khoá. Tên tài nguyên của chế độ xem từ khoá có dạng như sau:
|
Hãng nhạc
Một nhãn.
Trường | |
---|---|
resource_name |
Tên của tài nguyên. Tên tài nguyên nhãn có dạng: |
status |
Trạng thái của nhãn. Chỉ có thể đọc. |
text_label |
Một loại nhãn hiển thị văn bản trên nền có màu. |
id |
Mã nhận dạng của nhãn. Chỉ có thể đọc. |
name |
Tên nhãn. Đây là trường bắt buộc và không được để trống khi tạo nhãn mới. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 80. |
LanguageConstant
Một ngôn ngữ.
Trường | |
---|---|
resource_name |
Tên tài nguyên của hằng số ngôn ngữ. Tên tài nguyên hằng số ngôn ngữ có dạng:
|
id |
Mã của hằng số ngôn ngữ. |
code |
Mã ngôn ngữ, ví dụ: "en_US", "en_AU", "es", "fr", v.v. |
name |
Tên đầy đủ của ngôn ngữ bằng tiếng Anh, ví dụ: "tiếng Anh (Mỹ)", "tiếng Tây Ban Nha", v.v. |
targetable |
Liệu ngôn ngữ có thể nhắm mục tiêu hay không. |
ListingGroupFilterDimension
Các phương diện về trang thông tin cho bộ lọc nhóm trang thông tin của nhóm thành phần.
Trường | |
---|---|
Trường kết hợp dimension . Phương diện thuộc một trong các loại bên dưới luôn hiển thị. dimension chỉ có thể là một trong những trạng thái sau đây: |
|
product_bidding_category |
Danh mục đặt giá thầu của một sản phẩm. |
product_brand |
Thương hiệu của sản phẩm được chào bán. |
product_channel |
Thành phố của sản phẩm. |
product_condition |
Điều kiện của ưu đãi sản phẩm. |
product_custom_attribute |
Thuộc tính tuỳ chỉnh của ưu đãi sản phẩm. |
product_item_id |
Mã mặt hàng của ưu đãi sản phẩm. |
product_type |
Loại ưu đãi sản phẩm. |
ProductBiddingCategory
Một phần tử của danh mục đặt giá thầu ở một cấp nhất định. Các danh mục cấp cao nhất là cấp 1, con của họ ở cấp 2, v.v. Chúng tôi hiện hỗ trợ tối đa 5 cấp. Người dùng phải chỉ định một loại phương diện cho biết cấp của danh mục. Tất cả các trường hợp của cùng một phân mục phải có cùng loại phương diện (cấp danh mục).
Trường | |
---|---|
level |
Cho biết cấp của danh mục trong thông tin phân loại. |
id |
Mã nhận dạng của danh mục đặt giá thầu cho sản phẩm. Mã này tương đương với mã google_product_category [danh_mục_sản_phẩm_của_Google] như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436 |
ProductBrand
Thương hiệu của sản phẩm.
Trường | |
---|---|
value |
Giá trị chuỗi của thương hiệu sản phẩm. |
ProductChannel
Thành phố của sản phẩm.
Trường | |
---|---|
channel |
Giá trị của địa phương. |
ProductCondition
Điều kiện của ưu đãi sản phẩm.
Trường | |
---|---|
condition |
Giá trị của điều kiện. |
ProductCustomAttribute
Thuộc tính tuỳ chỉnh của ưu đãi sản phẩm.
Trường | |
---|---|
index |
Cho biết chỉ mục của thuộc tính tuỳ chỉnh. |
value |
Giá trị chuỗi của thuộc tính tuỳ chỉnh của sản phẩm. |
ProductItemId
Mã mặt hàng của ưu đãi sản phẩm.
Trường | |
---|---|
value |
Giá trị của id. |
ProductType
Loại ưu đãi sản phẩm.
Trường | |
---|---|
level |
Cấp độ của loại. |
value |
Giá trị của kiểu. |
ListingGroupFilterDimensionPath
Lộ trình xác định các phương diện sẽ xác định một bộ lọc nhóm trang thông tin.
Trường | |
---|---|
dimensions[] |
Đường dẫn đầy đủ của các phương diện thông qua hệ thống phân cấp bộ lọc nhóm trang thông tin (ngoại trừ nút gốc) đến bộ lọc nhóm trang thông tin này. |
LocationView
Chế độ xem vị trí tóm tắt hiệu suất của chiến dịch theo tiêu chí Vị trí.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem vị trí. Tên tài nguyên chế độ xem vị trí có dạng:
|
ProductBiddingCategoryConstant
Danh mục đặt giá thầu sản phẩm.
Trường | |
---|---|
resource_name |
Tên tài nguyên của danh mục đặt giá thầu cho sản phẩm. Tên tài nguyên danh mục đặt giá thầu cho sản phẩm có dạng:
|
level |
Cấp của danh mục đặt giá thầu sản phẩm. |
status |
Trạng thái của danh mục đặt giá thầu sản phẩm. |
id |
Mã nhận dạng của danh mục đặt giá thầu cho sản phẩm. Mã này tương đương với mã google_product_category [danh_mục_sản_phẩm_của_Google] như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436. |
country_code |
Mã quốc gia viết hoa gồm hai chữ cái của danh mục đặt giá thầu sản phẩm. |
product_bidding_category_constant_parent |
Tên tài nguyên của danh mục đặt giá thầu cho sản phẩm chính. |
language_code |
Mã ngôn ngữ của danh mục đặt giá thầu sản phẩm. |
localized_name |
Giá trị hiển thị của danh mục đặt giá thầu sản phẩm được bản địa hoá theo language_code. |
ProductGroupView
Chế độ xem nhóm sản phẩm.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem nhóm sản phẩm. Tên tài nguyên trong chế độ xem nhóm sản phẩm có dạng:
|
SearchAds360Field
Trường hoặc tài nguyên (cấu phần phần mềm) mà SearchAds360Service sử dụng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của cấu phần phần mềm. Tên tài nguyên của cấu phần phần mềm có dạng:
|
category |
Danh mục của cấu phần phần mềm. |
selectable_with[] |
Tên của tất cả tài nguyên, phân đoạn và chỉ số có thể chọn bằng cấu phần phần mềm được mô tả. |
attribute_resources[] |
Tên của tất cả tài nguyên có thể chọn bằng cấu phần phần mềm được mô tả. Các trường từ những tài nguyên này không phân đoạn chỉ số khi được đưa vào truy vấn tìm kiếm. Trường này chỉ dành cho các cấu phần phần mềm có danh mục là TÀI NGUYÊN. |
metrics[] |
Trường này liệt kê tên của tất cả chỉ số có thể chọn bằng cấu phần phần mềm được mô tả khi dùng trong mệnh đề TỪ. Chế độ này chỉ được đặt cho các cấu phần phần mềm có danh mục là TÀI NGUYÊN. |
segments[] |
Trường này liệt kê tên của tất cả cấu phần phần mềm, cho dù là phân đoạn hay tài nguyên khác, các chỉ số phân đoạn khi được đưa vào truy vấn tìm kiếm và khi cấu phần phần mềm được mô tả được sử dụng trong mệnh đề TỪ. Chế độ này chỉ được đặt cho các cấu phần phần mềm có danh mục là TÀI NGUYÊN. |
enum_values[] |
Giá trị mà cấu phần phần mềm có thể giả định nếu đó là một trường thuộc loại ENUM. Trường này chỉ được đặt cho các cấu phần phần mềm thuộc danh mục SEGMENT hoặc ATTRIBUTE. |
data_type |
Trường này xác định các toán tử có thể dùng với cấu phần phần mềm trong mệnh đề WHERE. |
name |
Tên của cấu phần phần mềm. |
selectable |
Liệu cấu phần phần mềm có thể được sử dụng trong mệnh đề SELECT của các truy vấn tìm kiếm hay không. |
filterable |
Liệu cấu phần phần mềm có thể được sử dụng trong mệnh đề WHERE trong các truy vấn tìm kiếm hay không. |
sortable |
Liệu cấu phần phần mềm có thể được sử dụng trong mệnh đề ORDER BY trong truy vấn tìm kiếm hay không. |
type_url |
URL của proto mô tả loại dữ liệu của cấu phần phần mềm. |
is_repeated |
Liệu cấu phần phần mềm của trường có lặp lại hay không. |
ShoppingPerformanceView
Chế độ xem hiệu suất mua sắm. Cung cấp số liệu thống kê tổng hợp về chiến dịch Mua sắm ở một số cấp thứ nguyên sản phẩm. Các giá trị phương diện sản phẩm trong Merchant Center như thương hiệu, danh mục, thuộc tính tuỳ chỉnh, tình trạng sản phẩm và loại sản phẩm sẽ thể hiện trạng thái của từng phương diện kể từ ngày và giờ ghi lại sự kiện tương ứng.
Trường | |
---|---|
resource_name |
Tên tài nguyên của chế độ xem hiệu suất Mua sắm. Tên tài nguyên chế độ xem hiệu suất mua sắm có dạng: |
UserList
Danh sách người dùng. Đây là danh sách người dùng mà khách hàng có thể nhắm mục tiêu.
Trường | |
---|---|
resource_name |
Tên tài nguyên của danh sách người dùng. Tên tài nguyên danh sách người dùng có dạng:
|
type |
Loại danh sách này. Trường này ở chế độ chỉ đọc. |
id |
Mã của danh sách người dùng. |
name |
Tên của danh sách người dùng này. Tuỳ thuộc vào access_reason, tên danh sách người dùng có thể không phải là duy nhất (ví dụ: nếu access_reason=SHARED) |
Truy cập
Lượt ghé thăm.
Trường | |
---|---|
resource_name |
Tên tài nguyên của lượt truy cập. Tên tài nguyên truy cập có dạng:
|
id |
Mã của lượt truy cập. |
criterion_id |
Mã từ khoá trên Search Ads 360. Giá trị 0 cho biết từ khoá không được phân bổ. |
merchant_id |
Mã tài khoản kho hàng Search Ads 360 chứa sản phẩm mà người dùng đã nhấp vào. Search Ads 360 tạo mã này khi bạn liên kết một tài khoản kho hàng trong Search Ads 360. |
ad_id |
Mã quảng cáo. Giá trị 0 cho biết rằng quảng cáo không được phân bổ. |
click_id |
Một chuỗi riêng biệt cho mỗi lượt truy cập được chuyển đến trang đích dưới dạng tham số URL mã lượt nhấp. |
visit_date_time |
Dấu thời gian của sự kiện truy cập. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" . |
product_id |
Mã của sản phẩm được nhấp vào. |
product_channel |
Kênh bán hàng của sản phẩm mà người dùng nhấp vào: Trực tuyến hoặc Địa phương. |
product_language_code |
Ngôn ngữ (ISO-639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center có chứa dữ liệu về sản phẩm. |
product_store_id |
Cửa hàng trong Quảng cáo kho hàng tại địa phương mà người dùng đã nhấp vào. Giá trị này phải khớp với mã cửa hàng dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn. |
product_country_code |
Quốc gia (định dạng ISO-3166) đã đăng ký nguồn cấp dữ liệu kho hàng có chứa sản phẩm mà người dùng nhấp vào. |
asset_id |
Mã của tài sản được tương tác trong sự kiện truy cập. |
asset_field_type |
Loại trường thành phần của sự kiện truy cập. |
WebpageView
Chế độ xem trang web.
Trường | |
---|---|
resource_name |
Tên tài nguyên của khung hiển thị trang web. Tên tài nguyên lượt xem trang web có dạng:
|