Package google.ads.searchads360.v0.resources

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)
• AdGroupAdEffectiveLabel (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)
• AdGroupCriterionEffectiveLabel (thông báo)
• AdGroupCriterionLabel (thông báo)
• AdGroupEffectiveLabel (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)
• CampaignEffectiveLabel (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)
• UserLocationView (thông báo)
• Visit (thông báo)
• WebpageView (thông báo)

AccessibleBiddingStrategy

Biểu thị chế độ xem BiddingStrategies do khách hàng sở hữu và chia sẻ.

Không giống như 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 do 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ỉ hiển thị một tập hợp con hạn chế của các thuộc tính BiddingStrategy.

Trường
resource_name	string Tên tài nguyên của chiến lược giá thầu có thể truy cập. Tên tài nguyên AccessibleBiddingStrategy có dạng: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 Mã nhận dạng của chiến lược đặt giá thầu.
name	string Tên của chiến lược đặt giá thầu.
type	BiddingStrategyType Loại chiến lược đặt giá thầu.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu chiến lược đặt giá thầu.
owner_descriptive_name	string descriptive_name của Khách hàng sở hữu chiến lược đặt giá thầu.
Trường nhóm scheme. Lược đồ đặt giá thầu. Bạn chỉ có thể đặt một giá trị. scheme chỉ có thể là một trong những trạng thái sau:
maximize_conversion_value	MaximizeConversionValue Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị lượt chuyển đổi cao nhất cho chiến dịch trong phạm vi ngân sách của mình.
maximize_conversions	MaximizeConversions Một chiến lược đặt giá thầu tự động giúp bạn nhận được nhiều lượt chuyển đổi nhất cho chiến dịch trong phạm vi ngân sách của mình.
target_cpa	TargetCpa Một 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ể với chi phí thu nạp khách hàng (CPA) mục tiêu mà bạn đã đặt.
target_impression_share	TargetImpressionShare Một chiến lược đặt giá thầu tự động tối ưu hoá theo một tỷ lệ phần trăm số lượt hiển thị đã chọn.
target_roas	TargetRoas Một 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	TargetSpend Một chiến lược giá thầu đặ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ị lượt chuyển đổi cao nhất cho chiến dịch trong phạm vi ngân sách của mình.

Trường
target_roas	double Lựa 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 tính trung bình 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 hết ngân sách. Nếu bạn không đặt ROAS mục tiêu, chiến lược giá thầu sẽ cố gắng đạt được ROAS cao nhất có thể cho ngân sách.

MaximizeConversions

Một chiến lược đặt giá thầu tự động giúp bạn nhận được nhiều lượt chuyển đổi nhất cho chiến dịch trong phạm vi ngân sách của mình.

Trường
target_cpa	int64 Lựa chọn chi phí mục tiêu mỗi lượt thu nạp khách hàng (CPA). Đây là số tiền trung bình mà bạn muốn chi tiêu cho mỗi lượt thu nạp.
target_cpa_micros	int64 Lựa chọn chi phí mục tiêu mỗi lượt thu nạp khách hàng (CPA). Đây là số tiền trung bình mà bạn muốn chi tiêu cho mỗi lượt thu nạp.

TargetCpa

Đây là một chiến lược đặt giá thầu tự động. Chiến lược này sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể, theo mức chi phí mục tiêu trên mỗi lượt chuyển đổi (CPA) do bạn đặt ra.

Trường
target_cpa_micros	int64 CPA mục tiêu trung bình. Mục tiêu này phải lớn hơn hoặc bằng đơn vị tối thiểu có thể tính phí dựa trên đơn vị tiền tệ của tài khoản.

TargetImpressionShare

Một chiến lược đặt giá thầu tự động đặt giá thầu để một tỷ lệ phần trăm nhất định của quảng cáo tìm kiếm xuất hiện ở đầu trang đầu tiên (hoặc vị trí được nhắm mục tiêu khác).

Trường
location	TargetImpressionShareLocation Vị trí được nhắm đến trên trang kết quả tìm kiếm.
location_fraction_micros	int64 Phân số quảng cáo được chọn để hiển thị ở vị trí được nhắm mục tiêu (tính bằng phần triệu). Ví dụ: 1% bằng 10.000.
cpc_bid_ceiling_micros	int64 Giá thầu CPC cao nhất mà hệ thống đặt giá thầu tự động được phép chỉ định. Đây là trường bắt buộc do nhà quảng cáo nhập, đặt mức trần và được chỉ định bằng đơn vị vi mô tại địa phương.

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 lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) trung bình.

Trường
target_roas	double 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 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.

Trường
target_spend_micros (deprecated)	int64 Mục này không còn được dùng nữa! Mục tiêu chi tiêu để tối đa hoá số lượt nhấp. Trình đặt giá thầu TargetSpend sẽ cố gắng chi tiêu số tiền nhỏ hơn giữa 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 đã ngừng hoạt động 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	int64 Giới hạn 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ừ khoá do chiến lược quản lý.

Quảng cáo

Một quảng cáo.

Trường
resource_name	string 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: customers/{customer_id}/ads/{ad_id}
final_urls[]	string Danh sách các URL cuối cùng có thể có sau tất cả các lệnh chuyển hướng nhiều miền cho quảng cáo.
final_app_urls[]	FinalAppUrl Danh sách URL cuối cùng của ứng dụng sẽ được dùng trên thiết bị di động nếu người dùng đã cài đặt ứng dụng cụ thể.
final_mobile_urls[]	string Danh sách các URL cuối cùng có thể có trên thiết bị di động sau tất cả các lượt chuyển hướng trên nhiều miền cho quảng cáo.
type	AdType Loại quảng cáo.
id	int64 Mã của quảng cáo.
tracking_url_template	string Mẫu URL để tạo URL theo dõi.
final_url_suffix	string Hậu tố cần sử dụng khi tạo URL cuối cùng.
display_url	string URL xuất hiện trong nội dung mô tả quảng cáo đối với một số định dạng quảng cáo.
name	string Tên của quảng cáo. Tham số này chỉ được dùng để xác định quảng cáo. Tham số này không cần phải là tham số duy nhất và không ảnh hưởng đến quảng cáo được phân phát.
Trường nhóm 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:
text_ad	SearchAds360TextAdInfo Thông tin chi tiết liên quan đến quảng cáo dạng văn bản.
expanded_text_ad	SearchAds360ExpandedTextAdInfo 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	SearchAds360ResponsiveSearchAdInfo Thông tin chi tiết liên quan đến quảng cáo tìm kiếm thích ứng.
product_ad	SearchAds360ProductAdInfo Thông tin chi tiết liên quan đến quảng cáo sản phẩm.
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo Thông tin chi tiết liên quan đến quảng cáo tìm kiếm động mở rộng.

Nhóm Quảng cáo

Một nhóm quảng cáo.

Trường
resource_name	string 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: customers/{customer_id}/adGroups/{ad_group_id}
status	AdGroupStatus Trạng thái của nhóm quảng cáo.
type	AdGroupType Loại nhóm quảng cáo.
ad_rotation_mode	AdGroupAdRotationMode Chế độ xoay vòng quảng cáo của nhóm quảng cáo.
creation_time	string Dấu thời gian khi ad_group này được tạo. Dấu thời gian nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".
targeting_setting	TargetingSetting Chế độ cài đặt cho các tính năng liên quan đến việc nhắm mục tiêu.
labels[]	string Tên tài nguyên của các nhãn được đính kèm vào nhóm quảng cáo này.
effective_labels[]	string Tên tài nguyên của các nhãn hiệu quả được đính kèm vào nhóm quảng cáo này. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho nhóm quảng cáo này.
engine_id	string Mã nhận dạng 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 Google Ads, ví dụ: Yahoo Nhật Bản, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "ad_group.id".
start_date	string 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, nhóm quảng cáo sẽ bắt đầu ngay hoặc vào ngày bắt đầu của nhóm quảng cáo, tuỳ theo ngày nào muộn hơn. 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 tài khoản cổng Microsoft Advertising và Facebook. Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14
end_date	string Ngày nhóm quảng cáo ngừng phân phát quảng cáo. Theo mặc định, nhóm quảng cáo sẽ 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 tài khoản cổng Microsoft Advertising và Facebook. Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14
language_code	string Ngôn ngữ của quảng cáo và từ khoá trong một nhóm quảng cáo. Trường này chỉ dành cho tài khoản Microsoft Advertising. Thông tin chi tiết khác: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
last_modified_time	string Ngày giờ nhóm quảng cáo này được sửa đổi lần gần nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
id	int64 Mã nhóm quảng cáo.
name	string Tên của nhóm quảng cáo. Bạn phải điền thông tin vào trường này và không được để trống khi tạo nhóm quảng cáo mới. Tên này phải chứa ít hơn 255 ký tự có chiều rộng đầy đủ theo chuẩn UTF-8. Đường dẫn này không được chứa bất kỳ ký tự nào là giá trị rỗng (điểm mã 0x0), ký tự xuống dòng NL (điểm mã 0xA) hoặc ký tự trả về vị trí đầu dòng (điểm mã 0xD).
tracking_url_template	string Mẫu URL để tạo URL theo dõi.
cpc_bid_micros	int64 Giá thầu CPC (chi phí mỗi lượt nhấp) tối đa.
engine_status	AdGroupEngineStatus Trạng thái của nhóm quảng cáo trên Công cụ.
final_url_suffix	string Mẫu URL để thêm các tham số vào URL cuối cùng.

AdGroupAd

Quảng cáo của nhóm quảng cáo.

Trường
resource_name	string 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: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus Trạng thái của quảng cáo.
ad	Ad Quảng cáo.
creation_time	string Dấu thời gian khi ad_group_ad này được tạo. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
labels[]	string Tên tài nguyên của các nhãn được đính kèm vào quảng cáo trong nhóm quảng cáo này.
effective_labels[]	string Tên tài nguyên của các nhãn có hiệu lực được đính kèm vào quảng cáo này. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho quảng cáo này.
engine_id	string Mã nhận dạng 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 Nhật Bản, 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".
engine_status	AdGroupAdEngineStatus 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	string Ngày giờ mà quảng cáo này trong nhóm quảng cáo được sửa đổi lần gần đây nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

AdGroupAdEffectiveLabel

Mối quan hệ giữa quảng cáo trong nhóm quảng cáo và nhãn hiệu quả. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho quảng cáo này trong nhóm quảng cáo.

Trường
resource_name	string Tên tài nguyên của nhãn hiệu quả của quảng cáo thuộc nhóm quảng cáo. Tên tài nguyên nhãn hiệu quả của quảng cáo trong nhóm quảng cáo có dạng: customers/{owner_customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Quảng cáo trong nhóm quảng cáo mà nhãn hiệu quả được đính kèm.
label	string Nhãn hiệu quả được chỉ định cho quảng cáo trong nhóm quảng cáo.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn có hiệu lực.

AdGroupAdLabel

Mối quan hệ giữa quảng cáo trong nhóm quảng cáo và nhãn.

Trường
resource_name	string Tên tài nguyên của nhãn quảng cáo 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: customers/{owner_customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad	string Quảng cáo trong nhóm quảng cáo mà nhãn được đính kèm.
label	string Nhãn được chỉ định cho quảng cáo trong nhóm quảng cáo.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn.

AdGroupAsset

Mối liên kết giữa một nhóm quảng cáo và một thành phần.

Trường
resource_name	string 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: customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}
ad_group	string Bắt buộc. Nhóm quảng cáo mà thành phần được liên kết.
asset	string Bắt buộc. Thành phần được liên kết với nhóm quảng cáo.
status	AssetLinkStatus Trạng thái của thành phần nhóm quảng cáo.

AdGroupAssetSet

AdGroupAssetSet 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 AdGroupAssetSet sẽ liên kết một nhóm thành phần với một nhóm quảng cáo.

Trường
resource_name	string Tên tài nguyên của nhóm quảng cáo được đặt thành nhóm thành phần. Tên tài nguyên của nhóm thành phần của nhóm quảng cáo có dạng: customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
ad_group	string Nhóm quảng cáo mà tập hợp thành phần này được liên kết.
asset_set	string Nhóm thành phần được liên kết với nhóm quảng cáo.
status	AssetSetLinkStatus Trạng thái của nhóm tài sản được liên kết với nhóm quảng cáo. Chỉ đọc.

AdGroupAudienceView

Chế độ xem đối tượng của nhóm quảng cáo. Bao gồm dữ liệu hiệu suất từ mối quan tâm và danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và 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	string 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 của chế độ xem đối tượng nhóm quảng cáo có dạng: customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Đại diện cho hệ số sửa đổi giá thầu của nhóm quảng cáo.

Trường
resource_name	string Tên tài nguyên của hệ số điều chỉnh giá thầu nhóm quảng cáo. Tên tài nguyên của hệ số sửa đổi giá thầu nhóm quảng cáo có dạng: customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}
bid_modifier	double Hệ số điều chỉnh giá thầu khi tiêu chí khớp. Hệ số điều chỉnh phải nằm trong phạm vi từ 0,1 đến 10,0. Phạm vi là 1.0 – 6.0 đối với PreferredContent. Sử dụng 0 để chọn không sử dụng một Loại thiết bị.
Trường nhóm criterion. Tiêu chí của hệ số sửa đổi giá thầu nhóm quảng cáo này. Bắt buộc trong các thao tác tạo kể từ phiên bản 5. criterion chỉ có thể là một trong những trạng thái sau:
device	DeviceInfo Một tiêu chí về thiết bị.

AdGroupCriterion

Một tiêu chí của nhóm quảng cáo. Báo cáo ad_group_criterion chỉ trả về những tiêu chí được thêm rõ ràng vào nhóm quảng cáo.

Trường
resource_name	string 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: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
creation_time	string 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 nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".
status	AdGroupCriterionStatus 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 ứng dụng khách đặt. Lưu ý: Báo cáo trên 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, tiêu chí đã bị XOÁ trong API vẫn có thể xuất hiện ở trạng thái đã bật trong giao diện người dùng. Ví dụ: theo mặc định, chiến dịch sẽ hiển thị cho người dùng ở mọi độ tuổi, trừ phi bạn loại trừ. Giao diện người dùng sẽ cho thấy từng độ tuổi là "đã bật" vì họ đủ điều kiện xem quảng cáo; nhưng AdGroupCriterion.status sẽ cho thấy "đã xoá" vì không có tiêu chí tích cực nào được thêm.
quality_info	QualityInfo Thông tin về chất lượng của tiêu chí.
type	CriterionType Loại tiêu chí.
labels[]	string Tên tài nguyên của các nhãn được đính kèm vào tiêu chí này của nhóm quảng cáo.
effective_labels[]	string Tên tài nguyên của nhãn có hiệu lực được đính kèm vào tiêu chí này của nhóm quảng cáo. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho tiêu chí nhóm quảng cáo này.
position_estimates	PositionEstimates Thông tin ước tính về giá thầu theo tiêu chí ở nhiều vị trí.
final_urls[]	string Danh sách các URL cuối cùng có thể có sau tất cả các lệnh chuyển hướng nhiều miền cho quảng cáo.
final_mobile_urls[]	string Danh sách các URL cuối cùng có thể có trên thiết bị di động sau tất cả các lượt chuyển hướng trên nhiều miền.
url_custom_parameters[]	CustomParameter Danh sách các mối liên kết dùng để thay thế thẻ tham số tuỳ chỉnh trong tracking_url_template, final_urls hoặc mobile_final_urls.
engine_id	string Mã nhận dạng 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 Google Ads, ví dụ: Yahoo Nhật Bản, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "ad_group_criterion.criterion_id".
last_modified_time	string Ngày giờ mà tiêu chí của nhóm quảng cáo này được sửa đổi lần gần đây nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
criterion_id	int64 Mã nhận dạng của tiêu chí.
ad_group	string Nhóm quảng cáo mà tiêu chí thuộc về.
negative	bool Có nhắm mục tiêu (false) hay loại trừ (true) tiêu chí này. Trường này là bất biến. Để chuyển một tiêu chí từ khẳng định sang phủ định, hãy xoá rồi thêm lại tiêu chí đó.
bid_modifier	double Hệ số điều chỉnh giá thầu khi tiêu chí khớp. Hệ số điều chỉnh phải nằm trong phạm vi từ 0,1 đến 10,0. Hầu hết các loại tiêu chí có thể nhắm mục tiêu đều hỗ trợ hệ số điều chỉnh.
cpc_bid_micros	int64 Giá thầu CPC (chi phí mỗi lượt nhấp).
effective_cpc_bid_micros	int64 Giá thầu CPC (chi phí mỗi lượt nhấp) hiệu quả.
engine_status	AdGroupCriterionEngineStatus Trạng thái của công cụ cho tiêu chí nhóm quảng cáo.
final_url_suffix	string Mẫu URL để thêm các tham số vào URL cuối cùng.
tracking_url_template	string Mẫu URL để tạo URL theo dõi.
Trường nhóm criterion. Tiêu chí của nhóm quảng cáo. Bạn phải đặt đúng một. criterion chỉ có thể là một trong những trạng thái sau:
keyword	KeywordInfo Từ khoá.
listing_group	ListingGroupInfo Nhóm trang thông tin.
age_range	AgeRangeInfo Độ tuổi.
gender	GenderInfo Giới tính.
user_list	UserListInfo Danh sách người dùng.
webpage	WebpageInfo Trang web
location	LocationInfo Vị trí.

PositionEstimates

Thông tin ước tính về giá thầu theo tiêu chí ở nhiều vị trí.

Trường
top_of_page_cpc_micros	int64 Giá thầu ước tính cho mô hình CPC cần thiết để quảng cáo xuất hiện ở đầu trang kết quả tìm kiếm đầu tiên.

QualityInfo

Vùng chứa thông tin về chất lượng tiêu chí của nhóm quảng cáo.

Trường
quality_score	int32 Đ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ị.

AdGroupCriterionEffectiveLabel

Mối quan hệ giữa tiêu chí nhóm quảng cáo và nhãn hiệu quả. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho tiêu chí nhóm quảng cáo này.

Trường
resource_name	string Tên tài nguyên của nhãn hiệu quả theo tiêu chí của nhóm quảng cáo. Tên tài nguyên nhãn có hiệu lực của tiêu chí nhóm quảng cáo có dạng: customers/{owner_customer_id}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Tiêu chí của nhóm quảng cáo mà nhãn có hiệu lực được đính kèm.
label	string Nhãn có hiệu lực được chỉ định cho tiêu chí của nhóm quảng cáo.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn có hiệu lực.

AdGroupCriterionLabel

Mối quan hệ giữa tiêu chí nhóm quảng cáo và nhãn.

Trường
resource_name	string 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: customers/{owner_customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}
ad_group_criterion	string Tiêu chí của nhóm quảng cáo mà nhãn được đính kèm.
label	string Nhãn được chỉ định cho tiêu chí của nhóm quảng cáo.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn.

AdGroupEffectiveLabel

Mối quan hệ giữa một nhóm quảng cáo và một nhãn hiệu quả. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho nhóm quảng cáo này.

Trường
resource_name	string Tên tài nguyên của nhãn hiệu quả của nhóm quảng cáo. Tên tài nguyên nhãn hiệu quả của nhóm quảng cáo có dạng: customers/{owner_customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group	string Nhóm quảng cáo mà nhãn hiệu quả được đính kèm.
label	string Nhãn hiệu quả được chỉ định cho nhóm quảng cáo.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn có hiệu lực.

AdGroupLabel

Mối quan hệ giữa một nhóm quảng cáo và một nhãn.

Trường
resource_name	string 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: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string Nhóm quảng cáo mà nhãn được đính kèm.
label	string Nhãn được chỉ định cho nhóm quảng cáo.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn.

AgeRangeView

Chế độ xem độ tuổi.

Trường
resource_name	string Tên tài nguyên của khung hiển thị phạm vi độ tuổi. Tên tài nguyên của chế độ xem dải độ tuổi có dạng: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Thành phần

Thành phần là một phần của quảng cáo và có thể được dùng chung cho nhiều quảng cáo. Đó có thể là một hình ảnh (ImageAsset), video (YoutubeVideoAsset), v.v. Tài sản là bất biến và không thể xoá. Để 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	string Tên tài nguyên của tài sản. Tên tài nguyên của thành phần có dạng: customers/{customer_id}/assets/{asset_id}
type	AssetType Loại tài sản.
final_urls[]	string Danh sách các URL cuối cùng có thể có sau tất cả các lượt chuyển hướng trên nhiều miền.
final_mobile_urls[]	string Danh sách các URL cuối cùng có thể có trên thiết bị di động sau tất cả các lượt chuyển hướng trên nhiều miền.
url_custom_parameters[]	CustomParameter Danh sách các mục ánh xạ sẽ được dùng để thay thế thẻ tham số tuỳ chỉnh của URL trong tracking_url_template, final_urls và/hoặc final_mobile_urls.
status	AssetStatus Trạng thái của thành phần.
creation_time	string Dấu thời gian cho biết thời điểm tạo tài sản này. Dấu thời gian nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".
last_modified_time	string Ngày giờ khi thành phần này được sửa đổi lần gần đây nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
id	int64 ID của nội dung.
name	string Tên không bắt buộc của tài sản.
tracking_url_template	string Mẫu URL để tạo URL theo dõi.
final_url_suffix	string Mẫu URL để nối các thông số vào URL trang đích được phân phát bằng tính năng theo dõi song song.
engine_status	AssetEngineStatus Trạng thái công cụ của một thành phần.
Trường nhóm asset_data. Loại tài sản cụ thể. asset_data chỉ có thể là một trong những trạng thái sau:
youtube_video_asset	YoutubeVideoAsset Một thành phần video trên YouTube.
image_asset	ImageAsset Một thành phần hình ảnh.
text_asset	TextAsset Một thành phần văn bản.
callout_asset	UnifiedCalloutAsset Một thành phần chú thích hợp nhất.
sitelink_asset	UnifiedSitelinkAsset Một thành phần đường liên kết hợp nhất của trang web.
page_feed_asset	UnifiedPageFeedAsset Một tài sản nguồn cấp dữ liệu trang hợp nhất.
mobile_app_asset	MobileAppAsset Một thành phần ứng dụng di động.
call_asset	UnifiedCallAsset Một thành phần cuộc gọi hợp nhất.
call_to_action_asset	CallToActionAsset Một thành phần lời kêu gọi hành động.
location_asset	UnifiedLocationAsset Thành phần địa điểm hợp nhất.

AssetGroup

Một nhóm thành phần. AssetGroupAsset được dùng để liên kết một thành phần với nhóm thành phần. AssetGroupSignal được 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	string Tên tài nguyên của nhóm thành phần. Tên tài nguyên nhóm thành phần có dạng: customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 Mã nhóm tài sản.
campaign	string Chiến dịch mà nhóm thành phần này được liên kết. Thành phần được liên kết với nhóm thành phần.
name	string Bắt buộc. Tên của nhóm thành phần. Bắt buộc. Độ dài tối thiểu là 1 và độ dài tối đa là 128. Mỗi chiến dịch phải có một giá trị riêng biệt.
final_urls[]	string Một danh sách các URL cuối cùng sau tất cả các hoạt động chuyển hướng trên nhiều miền. Trong chiến dịch Tối đa hoá hiệu suất, theo mặc định, các URL đều đủ điều kiện mở rộng trừ phi bạn chọn không sử dụng.
final_mobile_urls[]	string Danh sách URL cuối cùng trên thiết bị di động sau tất cả các hoạt động chuyển hướng trên nhiều miền. Trong chiến dịch Tối đa hoá hiệu suất, theo mặc định, các URL đều đủ điều kiện mở rộng trừ phi bạn chọn không sử dụng.
status	AssetGroupStatus Trạng thái của nhóm thành phần.
path1	string Phần đầu tiên của văn bản có thể xuất hiện được thêm vào URL hiển thị trong quảng cáo.
path2	string Phần thứ hai của văn bản có thể xuất hiện được 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	AdStrength Độ mạnh tổng thể của quảng cáo cho 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. Việc 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	string Tên tài nguyên của thành phần nhóm thành phần. Tên tài nguyên thành phần nhóm thành phần có dạng: customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}
asset_group	string Nhóm thành phần mà thành phần nhóm thành phần này đang liên kết.
asset	string Thành phần mà thành phần nhóm thành phần này đang liên kết.
field_type	AssetFieldType 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	AssetLinkStatus 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 về kiểu kết hợp thành phần của nhóm thành phần

Trường
asset_combination_served_assets[]	AssetUsage Thành phần được phân phát.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter đại diện cho 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	string 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 nhóm trang thông tin của nhóm thành phần có dạng: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string Nhóm thành phần mà bộ lọc nhóm trang thông tin của nhóm thành phần này thuộc về.
id	int64 Mã của ListingGroupFilter.
type	ListingGroupFilterType Loại nút bộ lọc nhóm trang thông tin.
vertical	ListingGroupFilterVertical Ngành 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 danh mục dọc.
case_value	ListingGroupFilterDimension Giá trị phương diện mà nhóm trang thông tin này đang tinh chỉnh nhóm trang thông tin mẹ. Không xác định cho nhóm gốc.
parent_listing_group_filter	string Tên tài nguyên của phân mục nhóm trang thông tin mẹ. Giá trị rỗng cho nút bộ lọc nhóm trang thông tin gốc.
path	ListingGroupFilterDimensionPath Đườ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 đại diện cho một tín hiệu trong nhóm thành phần. Sự tồn tại của một 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	string 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: customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string Nhóm thành phần mà tín hiệu nhóm thành phần này thuộc về.
Trường nhóm 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:
audience	AudienceInfo 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ề mức sử dụng các kiểu kết hợp thành phần hàng đầu của nhóm thành phần.

Trường
resource_name	string Tên tài nguyên của chế độ xem kiểu kết hợp hàng đầu của nhóm thành phần. Tên tài nguyên của chế độ xem Tổ hợp hàng đầu của AssetGroup có dạng: "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]	AssetGroupAssetCombinationData Các kiểu kết hợp thành phần hàng đầu đượ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	int64 Mã nhận dạng của nhóm thành phần.
resource_name	string Tên tài nguyên của nhóm tài sản. Tên tài nguyên của nhóm tài sản có dạng: customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset là mối liên kết giữa một thành phần và một nhóm thành phần. Việc thêm một AssetSetAsset 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	string 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 của thành phần trong nhóm thành phần có dạng: customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}
asset_set	string 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 đến.
asset	string Thành phần mà thành phần trong nhóm thành phần này đang liên kết đến.
status	AssetSetAssetStatus Trạng thái của thành phần trong nhóm thành phần. Chỉ đọ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 nhân khẩu học chi tiết và đối tượng chung sở thích) để tạo đối tượng thể hiện các phần trong phân khúc mục tiêu của bạn.

Trường
resource_name	string Tên tài nguyên của đối tượng. Tên đối tượng có dạng: customers/{customer_id}/audiences/{audience_id}
id	int64 Mã nhận dạng của đối tượng.
name	string Bắt buộc. Tên của đối tượng. Giá trị này phải là giá trị duy nhất trên tất cả các đối tượng. Độ dài tối thiểu là 1 và độ dài tối đa là 255.
description	string Nội dung mô tả về đối tượng này.

BiddingStrategy

Một chiến lược đặt giá thầu.

Trường
resource_name	string 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: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus Trạng thái của chiến lược giá thầu. Trường này ở chế độ chỉ đọc.
type	BiddingStrategyType 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	string Đơn vị tiền tệ mà chiến lược đặt giá thầu sử dụng (mã gồm 3 chữ cái theo tiêu chuẩn ISO 4217). Đối với chiến lược đặt giá thầu trong khách hàng người quản lý, bạn có thể đặt đơn vị tiền tệ này khi tạo và đơn vị tiền tệ này sẽ mặc định là đơn vị tiền tệ của khách hàng người quản lý. Bạn không thể đặt trường này cho khách hàng phân phát; tất 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 effective_currency_code sẽ trả về đơn vị tiền tệ mà chiến lược sử dụng.
id	int64 Mã nhận dạng của chiến lược đặt giá thầu.
name	string Tên của chiến lược đặt giá thầu. Tất cả chiến lược đặt giá thầu trong một tài khoản phải có 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, bao gồm cả hai giá trị này, tính bằng byte UTF-8 (đã cắt bớt).
effective_currency_code	string Đơn vị tiền tệ mà chiến lược đặt giá thầu sử dụng (mã gồm 3 chữ cái theo tiêu chuẩn ISO 4217). Đối với chiến lược đặt giá thầu trong 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. Đối với việc phân phát cho khách hàng, đây là currency_code của khách hàng. Các chỉ số về chiến lược giá thầu được báo cáo bằng đơn vị tiền tệ này. Trường này ở chế độ chỉ đọc.
campaign_count	int64 Số lượng chiến dịch được đính kèm với chiến lược đặt giá thầu này. Trường này ở chế độ chỉ đọc.
non_removed_campaign_count	int64 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 nhóm scheme. Lược đồ đặt giá thầu. Bạn chỉ có thể đặt một giá trị. scheme chỉ có thể là một trong những trạng thái sau:
enhanced_cpc	EnhancedCpc Một chiến lược đặt giá thầu giúp tăng giá thầu cho những lượt nhấp có nhiều khả năng dẫn đến lượt chuyển đổi và giảm giá thầu cho những lượt nhấp có ít khả năng dẫn đến lượt chuyển đổi.
maximize_conversion_value	MaximizeConversionValue Một chiến lược đặt giá thầu tự động giúp bạn nhận được giá trị lượt chuyển đổi cao nhất cho chiến dịch trong phạm vi ngân sách của mình.
maximize_conversions	MaximizeConversions Một chiến lược đặt giá thầu tự động giúp bạn nhận được nhiều lượt chuyển đổi nhất cho chiến dịch trong phạm vi ngân sách của mình.
target_cpa	TargetCpa Một 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ể với chi phí thu nạp khách hàng (CPA) mục tiêu mà bạn đã đặt.
target_impression_share	TargetImpressionShare Một chiến lược đặt giá thầu tự động tối ưu hoá theo một tỷ lệ phần trăm số lượt hiển thị đã chọn.
target_outrank_share	TargetOutrankShare Một chiến lược đặt giá thầu đặt giá thầu dựa trên tỷ lệ mục tiêu của các phiên đấu giá mà nhà quảng cáo phải vượt qua 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 bằng trường này hoặc đính kèm chiến lược đặt giá thầu có trường này vào một chiến dịch. Bạn có thể chuyển đổi sang những chiến lược đã có lược đồ này.
target_roas	TargetRoas Một 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	TargetSpend Một chiến lược giá thầu đặ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

Một chiến dịch.

Trường
resource_name	string 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: customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus Trạng thái của chiến dịch. Khi bạn thêm một chiến dịch mới, trạng thái mặc định sẽ là ĐÃ BẬT.
serving_status	CampaignServingStatus Trạng thái phân phát quảng cáo của chiến dịch.
bidding_strategy_system_status	BiddingStrategySystemStatus 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	AdServingOptimizationStatus Trạng thái tối ưu hoá hoạt động phân phát quảng cáo của chiến dịch.
advertising_channel_type	AdvertisingChannelType Mục tiêu phân phát chính cho quảng cáo trong chiến dịch. Bạn có thể tinh chỉnh các tiêu chí nhắm mục tiêu trong network_settings. Đây là trường bắt buộc và không được để trống khi tạo chiến dịch mới. Bạn chỉ có thể đặt chế độ này 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	AdvertisingChannelSubType Bạn có thể tinh chỉnh advertising_channel_type (không bắt buộc). Phải là một loại phụ hợp lệ của loại kênh chính. Bạn chỉ có thể đặt chế độ này 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[]	CustomParameter Danh sách các mối liên kết dùng để thay thế thẻ tham số tuỳ chỉnh trong tracking_url_template, final_urls hoặc mobile_final_urls.
real_time_bidding_setting	RealTimeBiddingSetting Chế độ cài đặt cho tính năng Đặt giá thầu theo thời gian thực. Đây là tính năng chỉ dành cho những chiến dịch nhắm đến mạng Ad Exchange.
network_settings	NetworkSettings Chế độ cài đặt mạng cho chiến dịch.
dynamic_search_ads_setting	DynamicSearchAdsSetting Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA).
shopping_setting	ShoppingSetting Chế độ cài đặt để kiểm soát chiến dịch Mua sắm.
geo_target_type_setting	GeoTargetTypeSetting Chế độ cài đặt nhắm mục tiêu theo địa lý cho quảng cáo.
effective_labels[]	string Tên tài nguyên của các nhãn hiệu quả được đính kèm vào chiến dịch này. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho chiến dịch này.
labels[]	string Tên tài nguyên của các nhãn được đính kèm vào chiến dịch này.
bidding_strategy_type	BiddingStrategyType 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 đặt lược đồ đặt giá thầu để tạo chiến lược đặt giá thầu chuẩn hoặc đặt trường bidding_strategy để tạo chiến lược đặt giá thầu danh mục đầu tư. Trường này ở chế độ chỉ đọc.
accessible_bidding_strategy	string Tên tài nguyên của AccessibleBiddingStrategy, một chế độ xem chỉ đọc về 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ư được xác định bằng "bidding_strategy". Để trống nếu chiến dịch không sử dụng chiến lược danh mục đầu tư. Các thuộc tính chiến lược không bị hạn chế được cung cấp cho tất cả khách hàng mà chiến lược được chia sẻ và được đọc từ tài nguyên AccessibleBiddingStrategy. Ngược lại, chỉ khách hàng sở hữu chiến lược và người quản lý của họ mới có thể sử dụng các thuộc tính bị hạn chế. Bạn chỉ có thể đọc các thuộc tính bị hạn chế từ tài nguyên BiddingStrategy.
frequency_caps[]	FrequencyCapEntry Một danh sách giới hạn tần suất mà mỗi người dùng sẽ thấy quảng cáo của chiến dịch này.
selective_optimization	SelectiveOptimization Chế độ cài đặt tối ưu hoá 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 quảng cáo ứ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	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á.
tracking_setting	TrackingSetting Chế độ cài đặt cấp chiến dịch để theo dõi thông tin.
engine_id	string Mã nhận dạng 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 Google Ads, ví dụ: Yahoo Nhật Bản, Microsoft, Baidu, v.v. Đối với thực thể Google Ads, hãy sử dụng "campaign.id".
excluded_parent_asset_field_types[]	AssetFieldType Các loại trường thành phần cần được loại trừ khỏi chiến dịch này. Chiến dịch này sẽ không kế thừa các đường liên kết đến thành phần có những loại trường này từ cấp trên.
create_time	string Dấu thời gian cho biết thời điểm tạo chiến dịch này. Dấu thời gian nằm trong 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. Hãy sử dụng creation_time.
creation_time	string Dấu thời gian cho biết thời điểm tạo chiến dịch này. Dấu thời gian nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".
last_modified_time	string Ngày giờ mà chiến dịch này được sửa đổi lần gần đây nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
feed_types[]	AssetSetType Các loại nguồn cấp dữ liệu được đính kèm trực tiếp vào chiến dịch này.
id	int64 Mã chiến dịch.
name	string 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. Đường dẫn này không được chứa bất kỳ ký tự nào là giá trị rỗng (điểm mã 0x0), ký tự xuống dòng NL (điểm mã 0xA) hoặc ký tự trả về vị trí đầu dòng (điểm mã 0xD).
tracking_url_template	string Mẫu URL để tạo URL theo dõi.
campaign_budget	string Tên tài nguyên của ngân sách chiến dịch.
start_date	string Ngày chiến dịch bắt đầu theo múi giờ của khách hàng ở định dạng YYYY-MM-DD.
end_date	string Ngày cuối cùng của chiến dịch theo múi giờ của khách hàng ở định dạng YYYY-MM-DD. Khi tạo, giá trị mặc định là 2037-12-30, tức là chiến dịch sẽ chạy vô thời hạn. Để đặt một chiến dịch hiện có chạy vô thời hạn, hãy đặt trường này thành 2037-12-30.
final_url_suffix	string Hậu tố dùng để thêm các tham số truy vấn vào những trang đích được phân phát bằng tính năng theo dõi song song.
url_expansion_opt_out	bool Đại diện cho việc chọn không sử dụng tính năng mở rộng URL sang các URL được nhắm mục tiêu cụ thể hơn. Nếu chọn không sử dụng (true), thì chỉ các URL cuối cùng trong nhóm tài sản hoặ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 bạn chọn sử dụng (false), toàn bộ miền sẽ được nhắm đến. Bạn chỉ có thể đặt trường này cho chiến dịch Tối đa hoá hiệu suất, trong đó giá trị mặc định là false.
Trường nhóm campaign_bidding_strategy. Chiến lược đặt giá thầu cho chiến dịch. Phải là danh mục đầu tư (được tạo thông qua dịch vụ BiddingStrategy) hoặc chuẩn, được nhúng vào chiến dịch. campaign_bidding_strategy chỉ có thể là một trong những trạng thái sau:
bidding_strategy	string Tên tài nguyên của chiến lược đặt giá thầu danh mục đầu tư mà chiến dịch sử dụng.
manual_cpa	ManualCpa 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	ManualCpc Chiến lược đặt giá thầu CPC thủ công chuẩn. Đặt giá thầu dựa trên số lượt nhấp theo cách thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.
manual_cpm	ManualCpm Chiến lược đặt giá thầu CPM thủ công chuẩn. Đặt giá thầu thủ công dựa trên số lượt hiển thị, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị.
maximize_conversions	MaximizeConversions Chiến lược đặt giá thầu Tối đa hoá lượt chuyển đổi tiêu chuẩn sẽ 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	MaximizeConversionValue Chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi tiêu chuẩn tự động đặt giá thầu để tối đa hoá doanh thu trong khi chi tiêu ngân sách.
target_cpa	TargetCpa Chiến lược đặt giá thầu CPA mục tiêu tiêu chuẩn tự động đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức chi phí mục tiêu trên mỗi lượt chuyển đổi (CPA) mà bạn đặt.
target_impression_share	TargetImpressionShare Chiến lược đặt giá thầu theo Tỷ lệ hiển thị mục tiêu. Một chiến lược đặt giá thầu tự động đặt giá thầu để đạt được một tỷ lệ phần trăm số lượt hiển thị đã chọn.
target_roas	TargetRoas Chiến lược đặt giá thầu ROAS mục tiêu tiêu chuẩn tự động tối đa hoá doanh thu trong khi đạt được lợi tức trung bình trên chi tiêu quảng cáo (ROAS) cụ thể.
target_spend	TargetSpend Chiến lược đặt giá thầu theo Mức chi tiêu mục tiêu 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 của mình.
percent_cpc	PercentCpc Chiến lược đặt giá thầu % CPC tiêu chuẩn, trong đó giá thầu là một phần của giá được quảng cáo cho một số hàng hoá hoặc dịch vụ.
target_cpm	TargetCpm Một chiến lược đặt giá thầu tự động tối ưu hoá chi phí cho 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	string Bắt buộc. Tên miền Internet mà chế độ cài đặt này đại diện, ví dụ: "google.com" hoặc "www.google.com".
language_code	string Bắt buộc. Mã ngôn ngữ chỉ định ngôn ngữ của miền, ví dụ: "en".
use_supplied_urls_only	bool Chiến dịch có chỉ sử dụng URL do nhà quảng cáo cung cấp hay không.

GeoTargetTypeSetting

Biểu thị một tập hợp các chế độ cài đặt liên quan đến tính năng nhắm mục tiêu theo vị trí địa lý của quảng cáo.

Trường
positive_geo_target_type	PositiveGeoTargetType Chế độ cài đặt được dùng để nhắm mục tiêu theo địa lý tích cực trong chiến dịch cụ thể này.
negative_geo_target_type	NegativeGeoTargetType Chế độ cài đặt được 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	bool 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 hay không.
target_search_network	bool 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 (bạn cũng phải đặt target_google_search thành true).
target_content_network	bool Quảng cáo có được phân phát trên các vị trí được chỉ định 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	bool 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 chọn lọc của Google.

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[]	OptimizationGoalType Danh sách các loại mục tiêu tối ưu hoá.

SelectiveOptimization

Chế độ cài đặt tối ưu hoá 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 quảng cáo ứ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[]	string Nhóm tên tài nguyên đã chọn cho các hành động chuyển đổi để 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 phạm vi 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	string Nhãn nguồn cấp dữ liệu của các sản phẩm cần thêm vào chiến dịch. Bạn chỉ có thể đặt một trong hai thuộc tính feed_label hoặc sales_country. Nếu được dùng thay cho sales_country, trường feed_label sẽ chấp nhận mã quốc gia ở cùng định dạng, ví dụ: "XX". Nếu không, bạn có thể dùng bất kỳ chuỗi nào cho nhãn nguồn cấp dữ liệu trong Google Merchant Center.
use_vehicle_inventory	bool Có nhắm đến khoảng không quảng cáo Trang thông tin về xe hay không.
merchant_id	int64 Mã nhận dạng của tài khoản Merchant Center. Bạn phải điền trường này để thực hiện các thao tác tạo. Bạn không thể thay đổi trường này cho chiến dịch Mua sắm.
sales_country	string Quốc gia bán sản phẩm cần thêm vào chiến dịch.
campaign_priority	int32 Mức độ ưu tiên của chiến dịch. Những chiến dịch có mức độ ưu tiên cao hơn về số sẽ được ưu tiên hơn những chiến dịch có mức độ ưu tiên thấp hơn. Bạn phải điền trường này cho chiến dịch Mua sắm, với các giá trị từ 0 đến 2 (bao gồm cả 0 và 2). Bạn không bắt buộc phải điền trường này cho chiến dịch Mua sắm thông minh, nhưng phải bằng 3 nếu bạn đặt.
enable_local	bool Có nên 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 để theo dõi thông tin.

Trường
tracking_url	string URL được 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	string 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: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus Trạng thái của thành phần chiến dịch.
campaign	string Chiến dịch mà thành phần được liên kết.
asset	string 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. Việc thêm một CampaignAssetSet sẽ liên kết một nhóm thành phần với một chiến dịch.

Trường
resource_name	string Tên tài nguyên của nhóm thành phần của chiến dịch. Tên tài nguyên của thành phần trong nhóm thành phần có dạng: customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign	string Chiến dịch mà tập hợp thành phần này được liên kết.
asset_set	string Nhóm thành phần được liên kết với chiến dịch.
status	AssetSetLinkStatus Trạng thái của thành phần trong nhóm thành phần của chiến dịch. Chỉ đọc.

CampaignAudienceView

Chế độ xem đối tượng của chiến dịch. Bao gồm dữ liệu hiệu suất từ danh sách mối quan tâm và danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và 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í về chiến dịch và đối tượng. Chế độ xem này chỉ bao gồm những đối tượng được đính kèm ở cấp chiến dịch.

Trường
resource_name	string Tên tài nguyên của chế độ xem đối tượng chiến dịch. Tên tài nguyên của chế độ xem đối tượng trong chiến dịch có dạng: customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

Ngân sách chiến dịch.

Trường
resource_name	string 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 của chiến dịch có dạng: customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method	BudgetDeliveryMethod Phương thức phân phối xác định tốc độ chi tiêu ngân sách chiến dịch. Mặc định là STANDARD nếu bạn không chỉ định trong thao tác tạo.
period	BudgetPeriod Khoảng thời gian chi tiêu ngân sách. Mặc định là DAILY nếu không được chỉ định.
amount_micros	int64 Số tiền ngân sách bằng nội tệ của tài khoản. Số tiền được chỉ định theo đơn vị một phần triệu, trong đó một triệu tương đương với một đơn vị tiền tệ. Mức chi tiêu hằng tháng tối đa là 30,4 lần số tiền này.

CampaignCriterion

Một tiêu chí chiến dịch.

Trường
resource_name	string 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: customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}
display_name	string Tên hiển thị của tiêu chí. Trường này sẽ bị bỏ qua đối với các thao tác biến đổi.
type	CriterionType Loại tiêu chí.
status	CampaignCriterionStatus Trạng thái của tiêu chí.
last_modified_time	string Ngày giờ mà tiêu chí chiến dịch này được sửa đổi lần gần đây nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
criterion_id	int64 Mã nhận dạng của tiêu chí. Trường này sẽ bị bỏ qua trong quá trình biến đổi.
bid_modifier	float Hệ số điều chỉnh cho giá thầu khi tiêu chí trùng khớp. Hệ số điều chỉnh phải nằm trong phạm vi từ 0,1 đến 10,0. Hầu hết các loại tiêu chí có thể nhắm mục tiêu đều hỗ trợ hệ số điều chỉnh. Sử dụng 0 để chọn không sử dụng một Loại thiết bị.
negative	bool Có nhắm mục tiêu (false) hay loại trừ (true) tiêu chí này.
Trường nhóm criterion. Tiêu chí chiến dịch. Bạn phải đặt đúng một. criterion chỉ có thể là một trong những trạng thái sau:
keyword	KeywordInfo Từ khoá.
location	LocationInfo Vị trí.
device	DeviceInfo Thiết bị.
age_range	AgeRangeInfo Độ tuổi.
gender	GenderInfo Giới tính.
user_list	UserListInfo Danh sách người dùng.
language	LanguageInfo Ngôn ngữ.
webpage	WebpageInfo Trang web.
location_group	LocationGroupInfo Nhóm địa điểm

CampaignEffectiveLabel

Biểu thị mối quan hệ giữa một chiến dịch và một nhãn hiệu quả. Nhãn hiệu quả là nhãn được kế thừa hoặc được chỉ định trực tiếp cho chiến dịch này.

Trường
resource_name	string Tên của tài nguyên. Tên tài nguyên CampaignEffectivelabel có dạng: customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string Chiến dịch mà nhãn hiệu quả được đính kèm.
label	string Nhãn hiệu quả được chỉ định cho chiến dịch.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn có hiệu lực.

CampaignLabel

Biểu thị mối quan hệ giữa chiến dịch và nhãn.

Trường
resource_name	string Tên của tài nguyên. Tên tài nguyên nhãn chiến dịch có dạng: customers/{owner_customer_id}/campaignLabels/{campaign_id}~{label_id}
campaign	string Chiến dịch mà nhãn được đính kèm.
label	string Nhãn được chỉ định cho chiến dịch.
owner_customer_id	int64 Mã nhận dạng của Khách hàng sở hữu nhãn.

CartDataSalesView

Chế độ xem doanh số bán hàng của dữ liệu giỏ hàng.

Trường
resource_name	string Tên tài nguyên của chế độ xem doanh số bán hàng Dữ liệu giỏ hàng. Tên tài nguyên của chế độ xem doanh số bán hàng của dữ liệu giỏ hàng có dạng: customers/{customer_id}/cartDataSalesView

Chuyển đổi

Một lượt chuyển đổi.

Trường
resource_name	string Tên tài nguyên của lượt chuyển đổi. Tên tài nguyên lượt chuyển đổi có dạng như sau: customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}
id	int64 Mã của lượt chuyển đổi
criterion_id	int64 Mã tiêu chí Search Ads 360. Giá trị 0 cho biết tiêu chí không được phân bổ.
merchant_id	int64 Mã tài khoản khoảng không quảng cáo 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	int64 Mã quảng cáo. Giá trị 0 cho biết quảng cáo không được phân bổ.
click_id	string Một chuỗi duy nhất cho lượt truy cập mà lượt chuyển đổi được phân bổ, được truyền đến trang đích dưới dạng tham số URL của mã lượt nhấp.
visit_id	int64 Mã lượt truy cập Search Ads 360 mà lượt chuyển đổi được phân bổ.
advertiser_conversion_id	string Đố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ã nhận dạng như vậy, thì Search Ads 360 sẽ tạo một mã nhận dạng. Đối với lượt chuyển đổi trực tuyến, giá trị này bằng với cột id hoặc cột floodlight_order_id, tuỳ thuộc vào hướng dẫn về Floodlight của nhà quảng cáo.
product_id	string Mã nhận dạng của sản phẩm được nhấp vào.
product_channel	ProductChannel 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 Tại cửa hàng địa phương.
product_language_code	string Ngôn ngữ (ISO-639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center chứa dữ liệu về sản phẩm.
product_store_id	string 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 được dùng trong nguồn cấp dữ liệu sản phẩm tại địa phương.
product_country_code	string Quốc gia (định dạng ISO-3166) được đăng ký cho 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	AttributionType Lượt chuyển đổi được phân bổ cho: Lượt truy cập hoặc Từ khoá + Quảng cáo.
conversion_date_time	string Dấu thời gian của sự kiện chuyển đổi.
conversion_last_modified_date_time	string Dấu thời gian của lần gần đây nhất lượt chuyển đổi được sửa đổi.
conversion_visit_date_time	string Dấu thời gian của lượt truy cập được phân bổ cho lượt chuyển đổi.
conversion_quantity	int64 Số lượng mặt hàng được lượt chuyển đổi ghi lại, do tham số qty url xác định. Nhà quảng cáo chịu trách nhiệm điền sẵn tham số một cách linh hoạt (chẳng hạn như số lượng mặt hàng được bán trong lượt chuyển đổi), nếu không, tham số này sẽ mặc định là 1.
conversion_revenue_micros	int64 Doanh thu đã điều chỉnh (tính bằng đơn vị vi mô) cho sự kiện chuyển đổi. Giá trị này sẽ luôn được tính bằng đơn vị tiền tệ của tài khoản phân phát.
floodlight_original_revenue	int64 Doanh thu ban đầu, không thay đổi được liên kết với sự kiện Floodlight (bằng đơn vị tiền tệ của báo cáo hiện tại), trước khi có các nội dung sửa đổi chỉ thị về đơn vị tiền tệ của Floodlight.
floodlight_order_id	string Mã đơn đặt hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi.
status	ConversionStatus Trạng thái của lượt chuyển đổi, có thể là ĐÃ BẬT hoặc ĐÃ XOÁ.
asset_id	int64 Mã nhận dạng của thành phần mà người dùng đã tương tác trong sự kiện chuyển đổi.
asset_field_type	AssetFieldType Loại trường thành phần của sự kiện chuyển đổi.

ConversionAction

Một hành động chuyển đổi.

Trường
resource_name	string 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: customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string Dấu thời gian tạo hoạt động Floodlight, được định dạng theo ISO 8601.
status	ConversionActionStatus Trạng thái của hành động chuyển đổi này đối với việc tích luỹ sự kiện chuyển đổi.
type	ConversionActionType Loại hành động chuyển đổi này.
category	ConversionActionCategory Danh mục lượt chuyển đổi được báo cáo cho hành động chuyển đổi này.
value_settings	ValueSettings Các 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	AttributionModelSettings Các 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	FloodlightSettings Chế độ cài đặt Floodlight cho các loại lượt chuyển đổi Floodlight.
id	int64 Mã của hành động chuyển đổi.
name	string 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	bool Nếu bit primary_for_goal của một hành động chuyển đổi là false, thì hành động chuyển đổi đó sẽ 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 của 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 primary_for_goal. Do đó, 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 bằng hành động chuyển đổi primary_for_goal = false, thì hành động chuyển đổi đó vẫn có thể đặt giá thầu. Theo mặc định, primary_for_goal sẽ là true nếu bạn không đặt. Trong phiên bản 9, bạn chỉ có thể đặt primary_for_goal thành false sau khi tạo thông qua thao tác "update" (cập nhật) vì thuộc tính này không được khai báo là không bắt buộc.
owner_customer	string 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 giá trị 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	bool Liệu hành động chuyển đổi này có nên được đưa vào chỉ số "client_account_conversions" hay không.
include_in_conversions_metric	bool Liệu hành động chuyển đổi này có nên được đưa vào chỉ số "lượt chuyển đổi" hay không.
click_through_lookback_window_days	int64 Số ngày tối đa có thể trôi qua giữa một lượt tương tác (ví dụ: lượt nhấp) và một sự kiện chuyển đổi.
app_id	string Mã ứng dụng cho một hành động chuyển đổi đối với ứng dụng.

AttributionModelSettings

Các 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	AttributionModel Loại mô hình phân bổ của hành động chuyển đổi này.
data_driven_model_status	DataDrivenModelStatus 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

Các chế độ cài đặt liên quan đến một hành động chuyển đổi trên Floodlight.

Trường
activity_group_tag	string Chuỗi 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	string Chuỗi dùng để xác định một hoạt động Floodlight khi báo cáo lượt chuyển đổi.
activity_id	int64 Mã nhận dạng của hoạt động Floodlight trong DoubleClick Campaign Manager (DCM).

ValueSettings

Các 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	double 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	string Mã đơn vị tiền tệ sẽ sử dụng khi các sự kiện chuyển đổi cho hành động chuyển đổi này được gửi bằng mã đơn vị tiền tệ không hợp lệ 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.
always_use_default_value	bool Kiểm soát việ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 sự kiện chuyển đổi cho hành động chuyển đổi này.

ConversionCustomVariable

Biến tuỳ chỉnh lượt chuyển đổi. Xem phần "Giới thiệu về các chỉ số và phương diện Floodlight tuỳ chỉnh trong Search Ads 360 mới" tại https://support.google.com/sa360/answer/13567857

Trường
resource_name	string Tên tài nguyên của biến tuỳ chỉnh lượt chuyển đổi. Tên tài nguyên biến tuỳ chỉnh lượt chuyển đổi có dạng: customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 Mã của biến tuỳ chỉnh lượt chuyển đổi.
name	string Bắt buộc. Tên của biến tuỳ chỉnh lượt chuyển đổi. Tên phải là duy nhất. Tên không được vượt quá 100 ký tự. Không được có dấu cách thừa ở trước và sau.
tag	string Bắt buộc. Thẻ của biến tuỳ chỉnh lượt chuyển đổi. Thẻ phải là duy nhất và bao gồm một ký tự "u" theo sau ngay lập tức là một số nhỏ hơn hoặc bằng 100. Ví dụ: "u4".
status	ConversionCustomVariableStatus 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	string Tên tài nguyên của khách hàng sở hữu biến tuỳ chỉnh lượt chuyển đổi.
family	ConversionCustomVariableFamily Nhóm biến tuỳ chỉnh lượt chuyển đổi.
cardinality	ConversionCustomVariableCardinality 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	FloodlightConversionCustomVariableInfo Các trường cho biến tuỳ chỉnh về lượt chuyển đổi Floodlight của Search Ads 360.
custom_column_ids[]	int64 Mã nhận dạng của các cột tuỳ chỉnh sử dụng biến tuỳ chỉnh lượt chuyển đổi này.

FloodlightConversionCustomVariableInfo

Thông tin về Biến tuỳ chỉnh lượt chuyển đổi Floodlight của Search Ads 360.

Trường
floodlight_variable_type	FloodlightVariableType Loại biến Floodlight được xác định trong Search Ads 360.
floodlight_variable_data_type	FloodlightVariableDataType Loại dữ liệu biến Floodlight được xác định trong Search Ads 360.

ConversionTrackingSetting

Một tập hợp các chế độ cài đặt trên toàn bộ 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	bool 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 đ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ị 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	ConversionTrackingStatus Trạng thái theo dõi lượt chuyển đổi. Thông tin 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ị trả về sẽ khác nhau dựa trên login-customer-id của yêu cầu.
enhanced_conversions_for_leads_enabled	bool 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 đ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ị này sẽ được kế thừa từ người quản lý. Trường này ở chế độ chỉ đọc.
google_ads_conversion_customer	string Tên tài nguyên của khách hàng nơi lượt chuyển đổi được tạo và quản lý. Trường này ở chế độ chỉ đọc.
conversion_tracking_id	int64 Mã theo dõi lượt chuyển đổi được dùng cho tài khoản này. Mã nhận dạng 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 cho biết). Trường này ở chế độ chỉ đọc.
google_ads_cross_account_conversion_tracking_id	int64 Mã theo dõi lượt chuyển đổi của người quản lý khách hàng. Tham số 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	int64 Mã theo dõi lượt chuyển đổi của người quản lý khách hàng. Tham số 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

Một cột tuỳ chỉnh. Xem cột tuỳ chỉnh của Search Ads 360 tại https://support.google.com/sa360/answer/9633916

Trường
resource_name	string 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: customers/{customer_id}/customColumns/{custom_column_id}
id	int64 Mã nhận dạng của cột tuỳ chỉnh.
name	string Tên do người dùng xác định của cột tuỳ chỉnh.
description	string Nội dung mô tả do người dùng xác định về cột tuỳ chỉnh.
value_type	CustomColumnValueType Loại giá trị kết quả của cột tuỳ chỉnh.
references_attributes	bool True khi cột tuỳ chỉnh đang đề cập đến một hoặc nhiều thuộc tính.
references_metrics	bool True khi cột tuỳ chỉnh đang đề cập đến một hoặc nhiều chỉ số.
queryable	bool Giá trị là true khi bạn có thể sử dụng cột tuỳ chỉnh trong truy vấn của SearchAds360Service.Search và SearchAds360Service.SearchStream.
referenced_system_columns[]	string 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ụ: Cột tuỳ chỉnh "tổng số lượt hiển thị và lượt nhấp" đã tham chiếu các cột hệ thống là {"metrics.clicks", "metrics.impressions"}.
render_type	CustomColumnRenderType Cách diễn giải giá trị kết quả của cột tuỳ chỉnh.

Khách hàng

Một khách hàng.

Trường
resource_name	string Tên tài nguyên của khách hàng. Tên tài nguyên của khách hàng có dạng như sau: customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Chế độ cài đặt theo dõi lượt chuyển đổi cho một khách hàng.
account_type	AccountType Loại tài khoản công cụ, ví dụ: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, v.v.
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting Chế độ cài đặt DoubleClick Campaign Manager (DCM) cho một khách hàng là người quản lý.
account_status	AccountStatus Trạng thái tài khoản, ví dụ: Đã bật, Đã tạm dừng, Đã xoá, v.v.
last_modified_time	string Ngày giờ mà khách hàng này được sửa đổi lần gần đây nhất. Ngày giờ ở múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".
engine_id	string Mã nhận dạng của tài khoản trong tài khoản công cụ bên ngoài.
status	CustomerStatus Trạng thái của khách hàng.
creation_time	string Dấu thời gian cho biết thời điểm tạo khách hàng này. Dấu thời gian nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".
manager_id	int64 Mã khách hàng của người quản lý. Giá trị 0 cho biết khách hàng không có người quản lý SA360.
manager_descriptive_name	string Tên mô tả của người quản lý.
sub_manager_id	int64 Mã khách hàng của người quản lý phụ. Giá trị 0 cho biết khách hàng không có người quản lý phụ SA360.
sub_manager_descriptive_name	string Tên mô tả của người quản lý phụ.
associate_manager_id	int64 Mã khách hàng của người quản lý cấp phó. Giá trị 0 cho biết khách hàng không có người quản lý cấp phó SA360.
associate_manager_descriptive_name	string Tên mô tả của người quản lý liên kết.
account_level	AccountLevelType Cấp tài khoản của khách hàng: Người quản lý, Người quản lý phụ, Người quản lý cấp phó, Tài khoản dịch vụ.
id	int64 Mã nhận dạng của khách hàng.
descriptive_name	string Không bắt buộc, tên mô tả không phải là duy nhất của khách hàng.
currency_code	string Đơn vị tiền tệ mà tài khoản sử dụng. Chúng tôi hỗ trợ một nhóm nhỏ mã tiền tệ theo tiêu chuẩn ISO 4217.
time_zone	string Mã múi giờ địa phương của khách hàng.
tracking_url_template	string Mẫu URL để tạo URL theo dõi từ các tham số.
final_url_suffix	string Mẫu URL để thêm các tham số vào URL cuối cùng.
auto_tagging_enabled	bool Khách hàng có bật tính năng tự động gắn thẻ hay không.
manager	bool 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à tài sản.

Trường
resource_name	string Tên tài nguyên của tài sản khách hàng. Tên tài nguyên CustomerAsset có dạng: customers/{customer_id}/customerAssets/{asset_id}~{field_type}
asset	string Bắt buộc. Tài sản được liên kết với khách hàng.
status	AssetLinkStatus Trạng thái của thành phần của khách hàng.

CustomerAssetSet

CustomerAssetSet là mối liên kết giữa khách hàng và một nhóm tài sản. Việc thêm một CustomerAssetSet sẽ liên kết một nhóm thành phần với một khách hàng.

Trường
resource_name	string Tên tài nguyên của nhóm tài sản khách hàng. Tên tài nguyên của thành phần trong nhóm thành phần có dạng: customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set	string Nhóm tài sản được liên kết với khách hàng.
customer	string Khách hàng mà nhóm tài sản này được liên kết.
status	AssetSetLinkStatus Trạng thái của thành phần trong nhóm thành phần của khách hàng. Chỉ đọc.

CustomerClient

Mối liên kết giữa khách hàng đã cho và khách hàng ứng dụng. CustomerClient chỉ tồn tại cho khách hàng người quản lý. Tất cả khách hàng trực tiếp và gián tiếp đều được tính, cũng như chính người quản lý.

Trường
resource_name	string Tên tài nguyên của ứng dụng khách hàng. Tên tài nguyên CustomerClient có dạng: customers/{customer_id}/customerClients/{client_customer_id}
applied_labels[]	string Tên tài nguyên của các nhãn thuộc sở hữu của khách hàng yêu cầu được áp dụng cho khách hàng. Tên tài nguyên nhãn có dạng: customers/{customer_id}/labels/{label_id}
status	CustomerStatus Trạng thái của khách hàng. Chỉ đọc.
client_customer	string Tên tài nguyên của khách hàng được liên kết với khách hàng đã cho. Chỉ đọc.
hidden	bool Chỉ định xem đây có phải là tài khoản bị ẩn hay không. Chỉ đọc.
level	int64 Khoảng cách giữa khách hàng và ứng dụng đã cho. Đối với đường liên kết tự liên kết, giá trị cấp sẽ là 0. Chỉ đọc.
time_zone	string Chuỗi Common Locale Data Repository (CLDR) biểu thị múi giờ của máy khách, ví dụ: America/Los_Angeles. Chỉ đọc.
test_account	bool Xác định xem khách hàng có phải là tài khoản thử nghiệm hay không. Chỉ đọc.
manager	bool Xác định xem khách hàng có phải là người quản lý hay không. Chỉ đọc.
descriptive_name	string Tên mô tả cho ứng dụng. Chỉ đọc.
currency_code	string Mã đơn vị tiền tệ (ví dụ: "USD", "EUR") cho khách hàng. Chỉ đọc.
id	int64 Mã nhận dạng của khách hàng. Chỉ đọc.

CustomerManagerLink

Biểu thị mối quan hệ giữa khách hàng và người quản lý.

Trường
resource_name	string Tên của tài nguyên. Tên tài nguyên CustomerManagerLink có dạng: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}
status	ManagerLinkStatus 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	string Khách hàng người quản lý được liên kết với khách hàng.
manager_link_id	int64 Mã nhận dạng của mối liên kết giữa khách hàng và người quản lý. Trường này ở chế độ chỉ đọc.
start_time	string Dấu thời gian khi CustomerManagerLink được tạo. Dấu thời gian nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".

DoubleClickCampaignManagerSetting

Chế độ cài đặt DoubleClick Campaign Manager (DCM) cho một khách hàng là người quản lý.

Trường
advertiser_id	int64 Mã nhận dạng nhà quảng cáo trên Campaign Manager được liên kết với khách hàng này.
network_id	int64 Mã nhận dạng của mạng Campaign Manager được liên kết với khách hàng này.
time_zone	string Múi giờ của mạng Campaign Manager được liên kết với khách hàng này theo định dạng Cơ sở dữ liệu múi giờ IANA, chẳng hạn như America/New_York.

DynamicSearchAdsSearchTermView

Chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động.

Trường
resource_name	string Tên tài nguyên của chế độ xem cụm từ tìm kiếm cho 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 trong quảng cáo tìm kiếm động có dạng: customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landing_page	string 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ên gender_view phản ánh trạng thái phân phát hiệu quả, chứ không phải tiêu chí đã được thêm. Theo mặc định, một 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, vì vậy, tất cả giới tính đều xuất hiện trong gender_view cùng với số liệu thống kê.

Trường
resource_name	string Tên tài nguyên của chế độ xem theo giới tính. Tên tài nguyên của chế độ xem theo giới tính có dạng: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Một hằng số mục tiêu địa lý.

Trường
resource_name	string 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: geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus Trạng thái hằng số mục tiêu theo vị trí địa lý.
id	int64 Mã nhận dạng của hằng số mục tiêu địa lý.
name	string Tên tiếng Anh của hằng số mục tiêu địa lý.
country_code	string Mã quốc gia theo chuẩn ISO-3166-1 alpha-2 được liên kết với mục tiêu.
target_type	string Loại mục tiêu không đổi theo vị trí địa lý.
canonical_name	string Tên đầy đủ bằng tiếng Anh, bao gồm tên của mục tiêu, tên của mục tiêu mẹ và quốc gia.
parent_geo_target	string 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: geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Chế độ xem từ khoá.

Trường
resource_name	string Tên tài nguyên của chế độ xem từ khoá. Tên tài nguyên của chế độ xem từ khoá có dạng: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Hãng nhạc

Một nhãn.

Trường
resource_name	string Tên của tài nguyên. Tên tài nguyên nhãn có dạng: customers/{owner_customer_id}/labels/{label_id}
status	LabelStatus Trạng thái của nhãn. Chỉ đọc.
text_label	TextLabel Một loại nhãn hiển thị văn bản trên nền có màu.
id	int64 Mã nhận dạng của nhãn. Chỉ đọc.
name	string Tên của 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	string 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: languageConstants/{criterion_id}
id	int64 Mã nhận dạng của hằng số ngôn ngữ.
code	string Mã ngôn ngữ, ví dụ: "en_US", "en_AU", "es", "fr", v.v.
name	string 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	bool Ngôn ngữ có thể nhắm đến hay không.

ListingGroupFilterDimension

Phương diện 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 nhóm dimension. Luôn có phương diện thuộc một trong các loại dưới đây. dimension chỉ có thể là một trong những trạng thái sau:
product_bidding_category	ProductBiddingCategory Danh mục đặt giá thầu của một sản phẩm được chào bán.
product_brand	ProductBrand Thương hiệu của một sản phẩm được chào bán.
product_channel	ProductChannel Địa phương của một sản phẩm được chào bán.
product_condition	ProductCondition Tình trạng của một sản phẩm được chào bán.
product_custom_attribute	ProductCustomAttribute Thuộc tính tuỳ chỉnh của một sản phẩm được chào bán.
product_item_id	ProductItemId Mã mặt hàng của một sản phẩm được cung cấp.
product_type	ProductType 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. Danh mục cấp cao nhất ở cấp 1, danh mục con ở 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	ListingGroupFilterBiddingCategoryLevel Cho biết cấp độ của danh mục trong hệ thống phân loại.
id	int64 Mã nhận dạng của danh mục đặt giá thầu sản phẩm. Mã này tương đương với mã google_product_category 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	string Giá trị kiểu chuỗi của thương hiệu sản phẩm.

ProductChannel

Địa phương của một sản phẩm được chào bán.

Trường
channel	ListingGroupFilterProductChannel Giá trị của thành phố.

ProductCondition

Tình trạng của một sản phẩm được chào bán.

Trường
condition	ListingGroupFilterProductCondition Giá trị của điều kiện.

ProductCustomAttribute

Thuộc tính tuỳ chỉnh của một sản phẩm được chào bán.

Trường
index	ListingGroupFilterCustomAttributeIndex Cho biết chỉ mục của thuộc tính tuỳ chỉnh.
value	string 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 một sản phẩm được cung cấp.

Trường
value	string Giá trị của mã nhận dạng.

ProductType

Loại ưu đãi sản phẩm.

Trường
level	ListingGroupFilterProductTypeLevel Cấp độ của loại.
value	string Giá trị của loại.

ListingGroupFilterDimensionPath

Đường dẫn xác định các phương diện xác định một bộ lọc nhóm trang thông tin.

Trường
dimensions[]	ListingGroupFilterDimension Đường dẫn đầy đủ của các phương diện thông qua hệ phân cấp bộ lọc nhóm trang thông tin (không bao gồm 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	string Tên tài nguyên của chế độ xem vị trí. Tên tài nguyên của khung hiển thị vị trí có dạng: customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Một danh mục đặt giá thầu sản phẩm.

Trường
resource_name	string Tên tài nguyên của danh mục đặt giá thầu sản phẩm. Tên tài nguyên danh mục đặt giá thầu sản phẩm có dạng: productBiddingCategoryConstants/{country_code}~{level}~{id}
level	ProductBiddingCategoryLevel Cấp của danh mục đặt giá thầu sản phẩm.
status	ProductBiddingCategoryStatus Trạng thái của danh mục đặt giá thầu sản phẩm.
id	int64 Mã nhận dạng của danh mục đặt giá thầu sản phẩm. Mã này tương đương với mã google_product_category như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436.
country_code	string Mã quốc gia gồm 2 chữ cái viết hoa của danh mục đặt giá thầu sản phẩm.
product_bidding_category_constant_parent	string Tên tài nguyên của danh mục đặt giá thầu sản phẩm gốc.
language_code	string Mã ngôn ngữ của danh mục đặt giá thầu sản phẩm.
localized_name	string Hiển thị giá trị 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	string Tên tài nguyên của chế độ xem nhóm sản phẩm. Tên tài nguyên của chế độ xem nhóm sản phẩm có dạng: customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Một trường hoặc tài nguyên (cấu phần phần mềm) được SearchAds360Service sử dụng.

Trường
resource_name	string 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: SearchAds360Fields/{name}
category	SearchAds360FieldCategory Danh mục của cấu phần phần mềm.
selectable_with[]	string 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[]	string 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 trong những tài nguyên này không phân đoạn chỉ số khi được đưa vào cụm từ tìm kiếm. Trường này chỉ được đặt cho những cấu phần phần mềm có danh mục là RESOURCE.
metrics[]	string Trường này liệt kê tên của tất cả các chỉ số có thể chọn bằng cấu phần phần mềm được mô tả khi cấu phần phần mềm đó được dùng trong mệnh đề FROM. Thuộc tính này chỉ được đặt cho những cấu phần phần mềm có danh mục là RESOURCE.
segments[]	string Trường này liệt kê tên của tất cả các cấu phần phần mềm (cho dù đó là một phân đoạn hay một tài nguyên khác) sẽ phân đoạn các chỉ số khi được đưa vào cụm từ tìm kiếm và khi cấu phần phần mềm được mô tả được dùng trong mệnh đề FROM. Thuộc tính này chỉ được đặt cho những cấu phần phần mềm có danh mục là RESOURCE.
enum_values[]	string Các 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	SearchAds360FieldDataType Trường này xác định những toán tử có thể dùng với cấu phần phần mềm trong mệnh đề WHERE.
name	string Tên của cấu phần phần mềm.
selectable	bool Liệu bạn có thể dùng cấu phần phần mềm này trong mệnh đề SELECT trong các cụm từ tìm kiếm hay không.
filterable	bool Liệu bạn có thể dùng cấu phần phần mềm trong mệnh đề WHERE trong các cụm từ tìm kiếm hay không.
sortable	bool Liệu có thể dùng cấu phần phần mềm trong mệnh đề ORDER BY trong các cụm từ tìm kiếm hay không.
type_url	string URL của proto mô tả loại dữ liệu của cấu phần phần mềm.
is_repeated	bool Có lặp lại hiện vật trên trường hay không.

ShoppingPerformanceView

Chế độ xem hiệu suất mua sắm. Cung cấp số liệu thống kê về chiến dịch Mua sắm được tổng hợp ở một số cấp phương diện sản phẩm. Các giá trị phương diện sản phẩm trong Merchant Center (chẳng hạn 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ẽ phản ánh trạng thái của từng phương diện tính đến ngày và giờ ghi lại sự kiện tương ứng.

Trường
resource_name	string Tên tài nguyên của chế độ xem hiệu suất Mua sắm. Tên tài nguyên của chế độ xem hiệu suất trong Mua sắm có dạng: customers/{customer_id}/shoppingPerformanceView

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 đến.

Trường
resource_name	string 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: customers/{customer_id}/userLists/{user_list_id}
type	UserListType Loại danh sách này. Trường này ở chế độ chỉ đọc.
id	int64 Mã nhận dạng của danh sách người dùng.
name	string 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)

UserLocationView

Chế độ xem vị trí người dùng.

Chế độ xem vị trí của người dùng bao gồm tất cả các chỉ số được tổng hợp ở cấp quốc gia, mỗi quốc gia một hàng. Báo cáo này cho biết các chỉ số tại vị trí thực tế của người dùng theo vị trí được hoặc không được nhắm mục tiêu. Nếu sử dụng các trường phân khúc khác, bạn có thể nhận được nhiều hàng cho mỗi quốc gia.

Trường
resource_name	string Tên tài nguyên của chế độ xem vị trí của người dùng. Tên tài nguyên của khung hiển thị UserLocation có dạng: customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id	int64 Mã tiêu chí cho quốc gia.
targeting_location	bool Cho biết vị trí có được nhắm đến hay không.

Truy cập

Một lượt truy cập.

Trường
resource_name	string Tên tài nguyên của lượt truy cập. Tên tài nguyên lượt truy cập có dạng: customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}
id	int64 Mã của lượt truy cập.
criterion_id	int64 Mã từ khoá Search Ads 360. Giá trị 0 cho biết từ khoá không được phân bổ.
merchant_id	int64 Mã tài khoản khoảng không quảng cáo 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	int64 Mã quảng cáo. Giá trị 0 cho biết quảng cáo không được phân bổ.
click_id	string Một chuỗi riêng biệt cho mỗi lượt truy cập được truyền đến trang đích dưới dạng tham số URL mã lượt nhấp.
visit_date_time	string Dấu thời gian của sự kiện lượt truy cập. Dấu thời gian nằm trong múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".
product_id	string Mã nhận dạng của sản phẩm được nhấp vào.
product_channel	ProductChannel 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 Tại cửa hàng địa phương.
product_language_code	string Ngôn ngữ (ISO-639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center chứa dữ liệu về sản phẩm.
product_store_id	string 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 được dùng trong nguồn cấp dữ liệu sản phẩm tại địa phương.
product_country_code	string Quốc gia (định dạng ISO-3166) đã đăng ký cho 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	int64 Mã nhận dạng của thành phần mà người dùng đã tương tác trong sự kiện lượt truy cập.
asset_field_type	AssetFieldType Loại trường thành phần của sự kiện lượt truy cập.

WebpageView

Chế độ xem trang web.

Trường
resource_name	string Tên tài nguyên của lượt xem trang web. Tên tài nguyên của lượt xem trang trên trang web có dạng: customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}