Package google.ads.searchads360.v0.resources

Chỉ mục

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à 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ỉ trình bày một số ít thuộc tính Đặ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 hỗ trợ tiếp cận. Tên tài nguyên AccessibleBiddingStrategy có dạng:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

Mã của chiến lược 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ã 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 hợp hợp nhất 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 giá trị 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 khi chi tiêu ngân sách.

maximize_conversions

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.

target_cpa

TargetCpa

Một chiến lược đặt giá thầu giúp đặ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

Chiến lược đặt giá thầu tự động tối ưu hoá để đạt được tỷ lệ hiển thị đã chọn.

target_roas

TargetRoas

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

target_spend

TargetSpend

Một chiến lược giá thầu giúp bạn đặt giá thầu để 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 khi chi tiêu ngân sách.

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ẽ hướng đến việc đạt được ROAS cao nhất có thể trong 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

int64

Lựa chọn chi phí mục tiêu để 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 khách hàng.

target_cpa_micros

int64

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

Đâ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 hành động (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ính phí tối thiểu dựa trên đơn vị tiền tệ của tài khoản.

TargetImpressionShare

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 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 mục tiêu trên trang kết quả tìm kiếm.

location_fraction_micros

int64

Tỷ lệ phần trăm quảng cáo được chọn sẽ hiển thị ở vị trí được nhắm mục tiêu tính theo micro giây. 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 giá trị trần và được chỉ định trong phạm vi cục bộ.

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 giúp bạn đặt giá thầu để 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 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 TargetSpend sẽ cố gắng chi tiêu giá trị nhỏ hơn giữa giá trị này hoặc số tiền chi tiêu tự nhiên bị điều tiết. 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òn được dùng nữa và bạn không nên 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ừ khóa do chiến lược quản lý.

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 URL cuối cùng có thể có sau tất cả các lượt chuyển hướng 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.

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. Mã này chỉ được dùng để nhận dạng quảng cáo. Mã này không cần phải 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 hợp hợp nhất 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 giá trị 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 một quảng cáo sản phẩm.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

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

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 theo 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 tiêu chí 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ới nhóm quảng cáo này.

effective_labels[]

string

Tên tài nguyên của các nhãn đang có hiệu lực được đính kèm với 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ã 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 Japan, 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 mà 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 lập tức 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 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

string

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 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ờ 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

int64

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

name

string

Tên của nhóm quảng cáo.

Đây là trường 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ự UTF-8 có độ rộng đầy đủ.

Chuỗi này không được chứa ký tự rỗng (điểm mã 0x0), ký tự xuống 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

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 công cụ cho nhóm quảng cáo.

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 như sau:

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ờ theo 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ới 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 hiệu quả được đính kèm vào quảng cáo này. Nhãn có hiệu lực 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ã 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".

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ó thể có các trạng thái sau (tuỳ thuộc vào loại tài khoản bên ngoài): đang hoạt động, đủ điều kiện, đang chờ xem xét, v.v.

last_modified_time

string

Ngày giờ quảng cáo trong nhóm quảng cáo này được sửa đổi lần gần 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".

AdGroupAdEffectiveLabel

Mối quan hệ giữa quảng cáo của nhóm quảng cáo và nhãn có hiệu lực. 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 trong 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ả quảng cáo của 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/{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 được gắn nhãn hiệu quả.

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ã của Khách hàng sở hữu nhãn hiệu quả.

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/{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 được gắn nhãn.

label

string

Nhãn được chỉ định cho quảng cáo của nhóm quảng cáo.

owner_customer_id

int64

Mã của Khách hàng sở hữu nhãn.

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

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 như sau:

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à tài sả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 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

string

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:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_group

string

Nhóm quảng cáo được liên kết với nhóm thành phần này.

asset_set

string

Tập hợp 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 thành phần nhóm quảng cáo. Chỉ có thể đọ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ừ các 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ị 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 chế độ xem đối tượng của nhóm quảng cáo có dạng:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Biểu thị 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ố sửa đổi giá thầu 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:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

Hệ số sửa đổi cho giá thầu khi tiêu chí khớp. Đối tượng sửa đổi phải nằm trong phạm vi: 0,1 – 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 kết hợp 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 bắt đầu từ phiên bản 5. criterion chỉ có thể là một trong những giá trị sau:

device

DeviceInfo

Một tiêu chí 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 vào nhóm quảng cáo một cách rõ ràng.

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 theo 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 đặ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, tiêu chí đã BỊ XOÁ trong API vẫn có thể hiển thị là đang 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ẽ hiển thị mỗi độ tuổi là "đã bật" vì những độ tuổi này đủ điều kiện để xem quảng cáo; nhưng AdGroupCriterion.status sẽ hiển thị là "đã xoá" vì không có tiêu chí tích cực nào được thêm vào.

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ới tiêu chí của nhóm quảng cáo này.

effective_labels[]

string

Tên tài nguyên của nhãn hiệu quả được đính kèm vào tiêu chí 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 tiêu chí nhóm quảng cáo này.

position_estimates

PositionEstimates

Giá thầu ước tính theo tiêu chí ở nhiều vị trí.

final_urls[]

string

Danh sách URL cuối cùng có thể có sau tất cả các lượt chuyển hướng nhiều miền cho quảng cáo.

engine_id

string

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 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ờ 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

int64

Mã của tiêu chí.

ad_group

string

Nhóm quảng cáo chứa tiêu chí đó.

negative

bool

Liệu sẽ nhắm mục tiêu (false) hay loại trừ (true) tiêu chí.

Trường này không thể thay đổi. Để chuyển đổi một tiêu chí từ tích cực sang tiêu cực, hãy xoá rồi thêm lại tiêu chí đó.

bid_modifier

double

Hệ số sửa đổi cho giá thầu khi tiêu chí khớp. Đối tượng sửa đổi phải nằm trong phạm vi: 0,1 – 10,0. Hầu hết các loại tiêu chí nhắm mục tiêu đều hỗ trợ hệ số sửa đổi.

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ông cụ của tiêu chí nhóm quảng cáo.

final_url_suffix

string

Mẫu URL cho việc 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 hợp hợp nhất criterion. Tiêu chí của nhóm quảng cáo.

Bạn phải đặt đúng một giá trị. criterion chỉ có thể là một trong những trạng thái sau đây:

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

Giá thầu ước tính theo tiêu chí ở nhiều vị trí.

Trường
top_of_page_cpc_micros

int64

Giá thầu CPC ước tính cần thiết để quảng cáo xuất hiện ở đầ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 của tiêu chí 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 một tiêu chí nhóm quảng cáo và một nhãn hiệu quả. Nhãn có hiệu lực là nhãn được kế thừa hoặc được chỉ định trực tiếp cho tiêu chí của 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ả cho tiêu chí nhóm quảng cáo. Tên tài nguyên nhãn hiệu hiệu quả của tiêu chí nhóm quảng cáo có dạng: customers/{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 được đính kèm nhãn hiệu quả.

label

string

Nhãn hiệu quả được chỉ định cho tiêu chí của nhóm quảng cáo.

owner_customer_id

int64

Mã của Khách hàng sở hữu nhãn hiệu quả.

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/{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ã 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 có hiệu lực 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/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

ad_group

string

Nhóm quảng cáo có đính kèm nhãn hiệu quả.

label

string

Nhãn hiệu quả được chỉ định cho nhóm quảng cáo.

owner_customer_id

int64

Mã của Khách hàng sở hữu nhãn hiệu quả.

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/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

Nhóm quảng cáo được gắn nhãn.

label

string

Nhãn được chỉ định cho nhóm quảng cáo.

owner_customer_id

int64

Mã 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 chế độ xem độ tuổi. Tên tài nguyên thành phần hiển thị độ 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 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

string

Tên tài nguyên của thành phần. Tên tài nguyên thành phần có dạng:

customers/{customer_id}/assets/{asset_id}

type

AssetType

Loại thành phần.

final_urls[]

string

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

AssetStatus

Trạng thái của tài sản.

creation_time

string

Dấu thời gian khi tài sản này được tạo. Dấu thời gian theo 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ờ gần đây nhất tài sản này được sửa đổ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

int64

ID của nội dung.

name

string

Tên không bắt buộc của thành phần.

tracking_url_template

string

Mẫu URL để tạo URL theo dõi.

engine_status

AssetEngineStatus

Trạng thái công cụ của một thành phần.

Trường hợp hợp nhất asset_data. Loại tài sản cụ thể. asset_data chỉ có thể là một trong những giá trị sau:
youtube_video_asset

YoutubeVideoAsset

Thành phần video trên YouTube.

image_asset

ImageAsset

Thành phần hình ảnh.

text_asset

TextAsset

Một thành phần văn bản.

callout_asset

UnifiedCalloutAsset

Thành phần chú thích hợp nhất.

page_feed_asset

UnifiedPageFeedAsset

Một thành phần nguồn cấp dữ liệu trang hợp nhất.

mobile_app_asset

MobileAppAsset

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

Thành phần lời kêu gọi hành động.

location_asset

UnifiedLocationAsset

Một 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 của nhóm thành phần có dạng:

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

Mã của nhóm thành phần.

campaign

string

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

string

Bắt buộc. Tên của nhóm tài sản. Bắt buộc. Chuỗi này phải có độ dài tối thiểu là 1 và tối đa là 128. Tên chiến dịch phải là duy nhất trong một chiến dịch.

final_urls[]

string

Danh sách URL cuối cùng sau tất cả các lượt chuyển hướng trên 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[]

string

Danh sách URL cuối cùng 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. 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

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 văn bản thứ hai có thể xuất hiện ở cuối URL xuất hiện 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 trong nhóm thành phần này.

AssetGroupAsset

AssetGroupAsset là đường 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 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 của 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 đường 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 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 của nhóm trang thông tin của nhóm thành phần có dạng như sau:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset_group

string

Nhóm thành phần chứa bộ lọc nhóm trang thông tin của nhóm thành phần này.

id

int64

Mã của ListingGroupFilter.

type

ListingGroupFilterType

Loại nút bộ lọc nhóm trang thông tin.

vertical

ListingGroupFilterVertical

Chiều dọc của cây nút hiện tại. 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

ListingGroupFilterDimension

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ẹ. Chưa xác định cho nhóm gốc.

parent_listing_group_filter

string

Tên tài nguyên của nhóm phụ trang thông tin mẹ. Rỗng đối với 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 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 chứa tín hiệu 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 giá trị 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

Thông tin về mức sử dụng kiểu kết hợp thành phần 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 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 Kết hợp hàng đầu của AssetGroup có dạng: ""client/{customer_id}/assetGroupTopKết hợpViews/{asset_group_id}~{asset_results_category}"

asset_group_top_combinations[]

AssetGroupAssetCombinationData

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 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ã 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 nhóm tài sản có dạng:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

AssetSetAsset là đường 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 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 thành phần của nhóm tài sả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

Tài sản mà thành phần 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ó 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 kết hợp 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 như sau:

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. Mã này phải khác nhau trên tất cả các đối tượng. Độ dài tối thiểu là 1 và tối đa là 255.

description

string

Nội dung mô tả về đối tượng này.

BiddingStrategy

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 như sau:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

Trạng thái của chiến lược đặt giá thầu.

Trường này chỉ có thể đọ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 thiết lập lược đồ đặt giá thầu.

Trường này chỉ có thể đọ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 đố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ý. Đối với khách hàng phân phát, bạn không thể đặt trường này; tất cả chiến lược trong 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ã của chiến lược 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 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ả 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 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 khách hàng được phân phát, đâ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ỉ có thể đọc.

campaign_count

int64

Số 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ỉ có thể đọc.

non_removed_campaign_count

int64

Số 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ỉ có thể đọc.

Trường hợp hợp nhất 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 đây:

enhanced_cpc

EnhancedCpc

Một chiến lược đặt giá thầu tăng giá thầu cho những lượt nhấp có vẻ như có nhiều khả năng dẫn đến lượt chuyển đổi hơn và giảm giá thầu cho những lượt nhấp có vẻ như có ít khả năng dẫn đến lượt chuyển đổi hơn.

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.

maximize_conversions

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.

target_cpa

TargetCpa

Một chiến lược đặt giá thầu giúp đặ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

Chiến lược đặt giá thầu tự động tối ưu hoá để đạt được tỷ lệ hiển thị đã chọn.

target_outrank_share

TargetOutrankShare

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 xếp hạng cao hơn 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 có 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

TargetRoas

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

target_spend

TargetSpend

Một chiến lược giá thầu giúp bạn đặt giá thầu để 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 của chiến dịch có dạng như sau:

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 tuỳ chọn 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.

Chỉ có thể đặt 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

Tinh chỉnh (không bắt buộc) đối với advertising_channel_type. Phải là loại phụ hợp lệ của loại kênh mẹ.

Chỉ có thể đặt 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 ánh xạ dùng để thay thế thẻ thông 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à một 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 cho tính năng nhắm mục tiêu theo vị trí địa lý của 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 giao thức đặt giá thầu để tạo chiến lược đặt giá thầu chuẩn hoặc 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 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 đều có thể sử dụng các thuộc tính chiến lược không bị hạn chế và đọc các thuộc tính đó 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

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

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 cho thông tin theo dõi.

engine_id

string

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 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 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 các đường liên kết thành phần với những loại trường này từ cấp trên.

create_time

string

Dấu thời gian khi chiến dịch này được tạo. Dấu thời gian 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 ở phiên bản 1. Thay vào đó, hãy sử dụng creation_time.

creation_time

string

Dấu thời gian khi chiến dịch này được tạo. Dấu thời gian theo 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ờ gần đây nhất chiến dịch này được sửa đổ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

int64

Mã của 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.

Chuỗi này không được chứa ký tự rỗng (điểm mã 0x0), ký tự xuống 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

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 bắt đầu chiến dịch phân phát 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à 30/12/2037, 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 ngày 30 tháng 12 năm 2037.

final_url_suffix

string

Hậu tố dùng để nối các tham số truy vấn vào các trang đích được phân phát bằng tính năng theo dõi song song.

url_expansion_opt_out

bool

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 khác. Nếu 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 mục tiêu. 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 chiến dịch Tối đa hoá hiệu suất, trong đó giá trị mặc định là false.

Trường kết hợp campaign_bidding_strategy. Chiến lược đặt giá thầu cho chiến dịch.

Phải là chiến lược giá thầu danh mục đầu tư (được tạo thông qua dịch vụ BiddingStrategy) hoặc chiến lược giá thầu 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 đây:

bidding_strategy

string

Tên tài nguyên của chiến lược 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ỉ 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 thủ công dựa trên lượt nhấp, trong đó người dùng trả phí theo mỗi lượt nhấp.

manual_cpm

ManualCpm

Chiến lược đặt giá thầu CPM thủ công chuẩn. Chiến lược đặ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 chuẩn tự động tối đa hoá số lượt chuyển đổi trong khi chi tiêu ngân sách.

maximize_conversion_value

MaximizeConversionValue

Chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi 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 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

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 tỷ lệ phần trăm lượt hiển thị đã chọn.

target_roas

TargetRoas

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

TargetSpend

Chiến lược đặt giá thầu theo Mức 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 của mình.

percent_cpc

PercentCpc

Chiến lược đặt giá thầu CPC theo tỷ lệ phần trăm 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

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

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

Liệu chiến dịch có sử dụng riê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 vị trí địa lý dương tính trong chiến dịch cụ thể này.

negative_geo_target_type

NegativeGeoTargetType

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_search_network

bool

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_google_search cũng phải là true).

target_content_network

bool

Liệu quảng cáo có được phân phát trên các vị trí đã chỉ định trong Mạng Hiển thị của Google hay không. Vị trí được chỉ định bằng cách sử dụng tiêu chí Vị trí.

target_partner_search_network

bool

Liệu 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[]

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 ứ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 được chọn cho 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 tập hợp 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 sản phẩm cần đưa 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 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

bool

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

int64

Mã của tài khoản Merchant Center. Trường này là bắt buộc đối với các thao tác tạo. Trường này không thể thay đổi đối với chiến dịch Mua sắm.

sales_country

string

Quốc gia bán sản phẩm cần đưa 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ề mặt số sẽ được ưu tiên hơn những chiến dịch có mức độ ưu tiên thấp hơn. Trường này là bắt buộc đối với chiến dịch Mua sắm, với các giá trị từ 0 đến 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 nếu điền thì giá trị phải bằng 3.

enable_local

bool

Liệu 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 cho thông tin theo dõi.

Trường
tracking_url

string

URL dùng để theo dõi linh động.

CampaignAsset

Đường liên kết giữa một Chiến dịch và một Thành phầ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 liên kết với thành phần đó.

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

string

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 tài sản có dạng:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Chiến dịch mà nhóm 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ó thể đọc.

CampaignAudienceView

Chế độ xem đối tượng của chiến dịch. Bao gồm dữ liệu hiệu suất từ các 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ị cho quảng cáo tìm kiếm (RLSA), được tổng hợp theo chiến dịch và tiêu chí đố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 chế độ xem đối tượng của chiến dịch có dạng như sau:

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 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 của 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

BudgetPeriod

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

int64

Số tiền ngân sách, tính bằng nội tệ của 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ệ. Mức chi tiêu hằng tháng được giới hạn ở mức 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 bị bỏ qua đối với các hoạt động thay đổ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ờ sửa đổi tiêu chí chiến dịch này 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".

criterion_id

int64

Mã của tiêu chí.

Trường này bị bỏ qua trong quá trình thay đổi.

bid_modifier

float

Hệ số sửa đổi cho giá thầu khi tiêu chí khớp. Đối tượng sửa đổi phải nằm trong phạm vi: 0,1 – 10,0. Hầu hết các loại tiêu chí nhắm mục tiêu đều hỗ trợ hệ số sửa đổi. Sử dụng 0 để chọn không sử dụng một Loại thiết bị.

negative

bool

Liệu có nhắm đến (false) hay loại trừ (true) tiêu chí hay không.

Trường hợp hợp nhất criterion. Tiêu chí chiến dịch.

Bạn phải đặt đúng một giá trị. criterion chỉ có thể là một trong những giá trị 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 vị trí

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 tài nguyên. Tên tài nguyên CampaignEffectivelabel có dạng: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}

campaign

string

Chiến dịch được đính kèm nhãn hiệu quả.

label

string

Nhãn hiệu quả được chỉ định cho chiến dịch.

owner_customer_id

int64

Mã của Khách hàng sở hữu nhãn hiệu quả.

CampaignLabel

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

Trường
resource_name

string

Tên tài nguyên. Tên tài nguyên nhãn chiến dịch có dạng: customers/{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ã của Khách hàng sở hữu nhãn.

CartDataSalesView

Chế độ xem lượt bán hàng có dữ liệu giỏ hàng.

Trường
resource_name

string

Tên tài nguyên của chế độ xem bán hàng Dữ liệu giỏ hàng. Tên tài nguyên của chế độ xem lượt bán hàng theo 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 chuyển đổi có dạng:

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 được nhấp vào. Search Ads 360 sẽ tạo mã này khi bạn liên kết một tài khoản khoảng không quảng cáo 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 được phân bổ lượt chuyển đổi, được truyền đến trang đích dưới dạng tham số URL mã lượt nhấp.

visit_id

int64

Mã lượt truy cập trên 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ã nhận dạng. Đố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

string

Mã 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 được 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. Mã 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 cửa hàng địa phương.

product_country_code

string

Quốc gia (theo định dạng ISO-3166) được đăng ký cho nguồn cấp dữ liệu kho hàng chứa sản phẩm được nhấp vào.

attribution_type

AttributionType

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 sửa đổi gần đây nhất đối với lượt chuyển đổi.

conversion_visit_date_time

string

Dấu thời gian của lượt truy cập mà lượt chuyển đổi được phân bổ.

conversion_quantity

int64

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 chịu trách nhiệm tự động điền thông số này (chẳng hạn như số lượng mặt hàng đã bán trong lượt chuyển đổi), nếu không thì thông số này sẽ mặc định là 1.

conversion_revenue_micros

int64

Doanh thu đã điều chỉnh tính bằng micro 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

int64

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 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, là ĐÃ BẬT hoặc ĐÃ XOÁ.

asset_id

int64

Mã của tài sản được 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

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 để 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ì bạn không thể đặt giá thầu cho hành động chuyển đổi đó 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 hay mục tiêu lượt chuyển đổi của chiến dịch. Tuy nhiên, các 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 thiết lập với hành động chuyển đổi chính_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 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 "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 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ó đượ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ó đượ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ụ: một 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 ứ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 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ã 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ệ cần sử dụng khi sự kiện chuyển đổi cho hành động chuyển đổi này được gửi kèm theo 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 giá trị mặc định và mã đơn vị tiền tệ mặc định có được sử dụng 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 hay không.

ConversionCustomVariable

Biến tuỳ chỉnh lượt chuyển đổi. Xem bài viết "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 tùy 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 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ó dấu cách thừa ở trước và sau.

tag

string

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à bao gồm một ký tự "u", theo sau 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 lượt chuyển đổi Floodlight của Search Ads 360.

custom_column_ids[]

int64

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

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

bool

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ừ tài khoản người quản lý. Trường này chỉ có thể đọ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. Thuộc tính này cho biết 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 login-customer-id của yêu cầu.

enhanced_conversions_for_leads_enabled

bool

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

string

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

int64

Mã theo dõi lượt 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ỉ có thể đọc.

google_ads_cross_account_conversion_tracking_id

int64

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ỉ có thể đọ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. 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 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ã 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 cho 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

Đúng khi cột tuỳ chỉnh tham chiếu đến một hoặc nhiều thuộc tính.

references_metrics

bool

Đúng khi cột tuỳ chỉnh tham chiếu đến một hoặc nhiều chỉ số.

queryable

bool

Đú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[]

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 đến các cột hệ thống {"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:

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

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

AccountStatus

Trạng thái tài khoản, ví dụ: Đã bật, Đang tạm dừng, Đã xoá, v.v.

last_modified_time

string

Ngày giờ sửa đổi khách hàng này 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

string

Mã 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 khi khách hàng này được tạo. Dấu thời gian theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".

id

int64

Mã của khách hàng.

descriptive_name

string

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

string

Đơn vị tiền tệ mà tài khoản sử dụng. Một tập hợp con của mã tiền tệ theo tiêu chuẩn ISO 4217 được hỗ trợ.

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

Liệu tính năng tự động gắn thẻ có được bật cho khách hàng hay không.

manager

bool

Liệu khách hàng có phải là người quản lý hay không.

CustomerAsset

Đường liên kết giữa khách hàng và một tài sản.

Trường
resource_name

string

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:

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à nhóm thành phần. Việc thêm 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 thành phần của nhóm thành phần có dạng như sau:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Tập hợp thành phần được liên kết với khách hàng.

customer

string

Khách hàng được liên kết với nhóm tài sản này.

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ó thể đọc.

CustomerClient

Đường liên kết giữa khách hàng nhất định và khách hàng của ứng dụng. CustomerClient chỉ tồn tại đối với 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 của khách hàng đều được đưa vào, 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 của 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 của 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 của khách hàng. Chỉ đọc.

client_customer

string

Tên tài nguyên của khách hàng-khách hàng được liên kết với khách hàng đã cho. Chỉ có thể đọ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 nhất định. Đối với đường liên kết nội bộ, giá trị cấp sẽ là 0. Chỉ đọc.

time_zone

string

Chuỗi đại diện cho kho lưu trữ dữ liệu ngôn ngữ chung (CLDR) của múi giờ của ứng dụng, ví dụ: America/Los_Angeles. Chỉ có thể đọ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 khách. Chỉ đọc.

currency_code

string

Mã đơn vị tiền tệ (ví dụ: "USD", "EUR") cho ứng dụng. Chỉ đọc.

id

int64

Mã khách hàng của ứng dụng khách. Chỉ đọc.

DoubleClickCampaignManagerSetting

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

Trường
advertiser_id

int64

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

int64

Mã 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 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

string

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 chế độ xem cụm từ tìm kiếm của 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ỉ có thể đọ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, một nhóm quảng cáo không có tiêu chí 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 thành phần hiển thị giới tính có dạng:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Hằng số mục tiêu theo đị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ố của tiêu chí nhắm mục tiêu theo vị trí địa lý có dạng:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Trạng thái hằng số của mục tiêu theo vị trí địa lý.

id

int64

Mã 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 của tiêu chí nhắm mục tiêu theo vị trí địa lý.

canonical_name

string

Tên đủ điều kiện 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 thành phần hiển thị từ khoá. Tên tài nguyên của chế độ xem từ khoá có dạng như sau:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Hãng nhạc

Một nhãn.

Trường
resource_name

string

Tên tài nguyên. Tên tài nguyên nhãn có dạng: customers/{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 màu.

id

int64

Mã 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ụ: "vi_VN", "vi_US", "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

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 hợp hợp nhất dimension. Phương diện của một trong các loại dưới đây luôn xuất hiện. dimension chỉ có thể là một trong những giá trị sau:
product_bidding_category

ProductBiddingCategory

Danh mục đặt giá thầu của một sản phẩm.

product_brand

ProductBrand

Thương hiệu của mặt hàng.

product_channel

ProductChannel

Vị trí của mặt hàng.

product_condition

ProductCondition

Tình trạng của mặt hàng.

product_custom_attribute

ProductCustomAttribute

Thuộc tính tuỳ chỉnh của mặt hàng.

product_item_id

ProductItemId

Mã mặt hàng của mặt hàng.

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 tiểu 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 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

string

Giá trị chuỗi của thương hiệu sản phẩm.

ProductChannel

Vị trí của mặt hàng.

Trường
channel

ListingGroupFilterProductChannel

Giá trị của địa phương.

ProductCondition

Tình trạng của mặt hàng.

Trường
condition

ListingGroupFilterProductCondition

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

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 sản phẩm.

ProductItemId

Mã mặt hàng của mặt hàng.

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 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ệ 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 các chiến dịch theo tiêu chí Vị trí.

Trường
resource_name

string

Tên tài nguyên của thành phần hiển thị vị trí. Tên tài nguyên thành phần hiển thị vị trí có dạng:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

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 cho 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ã 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 hai 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 cho sản phẩm chính.

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 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) mà 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 được 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 cụm từ 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[]

string

Trường này liệt kê tên của tất cả các chỉ số có thể chọn được bằng cấu phần phần mềm được mô tả khi được sử dụng trong mệnh đề FROM. Thuộc tính này chỉ được đặt cho các cấu phần phần mềm có danh mục là RESOURCE (TÀI NGUYÊN).

segments[]

string

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Ừ. Thuộc tính này chỉ được đặt cho các cấu phần phần mềm có danh mục là RESOURCE (TÀI NGUYÊN).

enum_values[]

string

Giá trị mà cấu phần phần mềm có thể giả định nếu đó là 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 PHÂN ĐOẠN hoặc THƯỜNG TÍNH.

data_type

SearchAds360FieldDataType

Trường này xác định các toán tử có thể được sử 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 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

bool

Liệu cấu phần phần mềm có thể được sử dụng trong mệnh đề WHERE trong cụm từ tìm kiếm hay không.

sortable

bool

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

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

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 của chiến dịch 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

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 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 của danh sách này.

Trường này chỉ có thể đọc.

id

int64

Mã 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í của 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. Giải pháp này báo cáo các chỉ số tại vị trí thực tế của người dùng theo vị trí được nhắm đến hoặc không được nhắm đến. 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 thành phần hiển thị vị trí của người dùng. Tên tài nguyên của chế độ xem 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 liệu vị trí có được nhắm mục tiêu 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 Visit 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 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

int64

Mã nhận dạng cho 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 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

string

Dấu thời gian của sự kiện truy cập. Dấu thời gian theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss".

product_id

string

Mã 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 được 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 dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn.

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 chứa sản phẩm được nhấp vào.

asset_id

int64

Mã 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 thành phần hiển thị trang web. Tên tài nguyên chế độ xem trang web có dạng:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}