SearchAds360Row

Một hàng được trả về từ truy vấn.

Biểu diễn dưới dạng JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Trường
adGroup

object (AdGroup)

Nhóm quảng cáo được tham chiếu trong truy vấn.

adGroupAd

object (AdGroupAd)

Quảng cáo được tham chiếu trong truy vấn.

adGroupAdLabel

object (AdGroupAdLabel)

Nhãn quảng cáo của nhóm quảng cáo được tham chiếu trong truy vấn.

adGroupAsset

object (AdGroupAsset)

Thành phần nhóm quảng cáo được tham chiếu trong truy vấn.

adGroupAssetSet

object (AdGroupAssetSet)

Nhóm thành phần nhóm quảng cáo được tham chiếu trong truy vấn.

adGroupAudienceView

object (AdGroupAudienceView)

Chế độ xem đối tượng của nhóm quảng cáo được tham chiếu trong truy vấn.

adGroupBidModifier

object (AdGroupBidModifier)

Hệ số sửa đổi giá thầu được tham chiếu trong truy vấn.

adGroupCriterion

object (AdGroupCriterion)

Tiêu chí được tham chiếu trong truy vấn.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Nhãn tiêu chí của nhóm quảng cáo được tham chiếu trong truy vấn.

adGroupLabel

object (AdGroupLabel)

Nhãn nhóm quảng cáo được tham chiếu trong truy vấn.

ageRangeView

object (AgeRangeView)

Chế độ xem độ tuổi được tham chiếu trong truy vấn.

asset

object (Asset)

Thành phần được tham chiếu trong truy vấn.

assetGroupAsset

object (AssetGroupAsset)

Thành phần nhóm thành phần được tham chiếu trong truy vấn.

assetGroupSignal

object (AssetGroupSignal)

Tín hiệu về nhóm thành phần được tham chiếu trong truy vấn.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Bộ lọc nhóm trang thông tin của nhóm thành phần được tham chiếu trong truy vấn.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Chế độ xem tổ hợp hàng đầu của nhóm thành phần được tham chiếu trong truy vấn.

assetGroup

object (AssetGroup)

Nhóm thành phần được tham chiếu trong truy vấn.

assetSetAsset

object (AssetSetAsset)

Thành phần bộ thành phần được tham chiếu trong truy vấn.

assetSet

object (AssetSet)

Nhóm thành phần được tham chiếu trong truy vấn.

biddingStrategy

object (BiddingStrategy)

Chiến lược đặt giá thầu được tham chiếu trong truy vấn.

campaignBudget

object (CampaignBudget)

Ngân sách chiến dịch được tham chiếu trong truy vấn.

campaign

object (Campaign)

Chiến dịch được tham chiếu trong truy vấn.

campaignAsset

object (CampaignAsset)

Thành phần chiến dịch được tham chiếu trong truy vấn.

campaignAssetSet

object (CampaignAssetSet)

Nhóm thành phần chiến dịch được tham chiếu trong truy vấn.

campaignAudienceView

object (CampaignAudienceView)

Chế độ xem đối tượng của chiến dịch được tham chiếu trong truy vấn.

campaignCriterion

object (CampaignCriterion)

Tiêu chí chiến dịch được tham chiếu trong truy vấn.

campaignLabel

object (CampaignLabel)

Nhãn chiến dịch được tham chiếu trong truy vấn.

cartDataSalesView

object (CartDataSalesView)

Chế độ xem doanh số dữ liệu giỏ hàng được tham chiếu trong truy vấn.

audience

object (Audience)

Đối tượng được tham chiếu trong truy vấn.

conversionAction

object (ConversionAction)

Hành động chuyển đổi được tham chiếu trong truy vấn.

conversionCustomVariable

object (ConversionCustomVariable)

Biến tuỳ chỉnh của lượt chuyển đổi được tham chiếu trong truy vấn.

customer

object (Customer)

Khách hàng được nhắc đến trong truy vấn.

customerAsset

object (CustomerAsset)

Thành phần khách hàng được tham chiếu trong truy vấn.

customerAssetSet

object (CustomerAssetSet)

Nhóm thành phần khách hàng được tham chiếu trong truy vấn.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Chiến lược đặt giá thầu có thể truy cập được tham chiếu trong truy vấn.

customerClient

object (CustomerClient)

CustomerClient được tham chiếu trong truy vấn.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Chế độ xem cụm từ tìm kiếm cho quảng cáo tìm kiếm động được tham chiếu trong truy vấn.

genderView

object (GenderView)

Chế độ xem theo giới tính được tham chiếu trong truy vấn.

geoTargetConstant

object (GeoTargetConstant)

Hằng số mục tiêu địa lý được tham chiếu trong truy vấn.

keywordView

object (KeywordView)

Chế độ xem từ khoá được tham chiếu trong truy vấn.

label

object (Label)

Nhãn được tham chiếu trong truy vấn.

languageConstant

object (LanguageConstant)

Hằng số ngôn ngữ được tham chiếu trong truy vấn.

locationView

object (LocationView)

Chế độ xem vị trí được tham chiếu trong truy vấn.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Danh mục Đặt giá thầu sản phẩm được tham chiếu trong truy vấn.

productGroupView

object (ProductGroupView)

Chế độ xem nhóm sản phẩm được tham chiếu trong truy vấn.

shoppingPerformanceView

object (ShoppingPerformanceView)

Chế độ xem hiệu suất mua sắm được tham chiếu trong truy vấn.

userList

object (UserList)

Danh sách người dùng được tham chiếu trong truy vấn.

webpageView

object (WebpageView)

Chế độ xem trang web được tham chiếu trong truy vấn.

visit

object (Visit)

Lượt truy cập ở cấp sự kiện được tham chiếu trong truy vấn.

conversion

object (Conversion)

Lượt chuyển đổi ở cấp sự kiện được tham chiếu trong truy vấn.

metrics

object (Metrics)

Các chỉ số.

segments

object (Segments)

Phân khúc.

customColumns[]

object (Value)

Cột tuỳ chỉnh.

AdGroup

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Trường
resourceName

string

Tên tài nguyên của nhóm quảng cáo. Tên tài nguyên của nhóm quảng cáo có dạng:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

Trạng thái của nhóm quảng cáo.

type

enum (AdGroupType)

Loại nhóm quảng cáo.

adRotationMode

enum (AdGroupAdRotationMode)

Chế độ xoay vòng quảng cáo của nhóm quảng cáo.

creationTime

string

Dấu thời gian khi 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".

targetingSetting

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

engineId

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 tài khoản Google Ads (ví dụ: Yahoo Japan, Microsoft, Baidu, v.v.). Đối với pháp nhân Google Ads, hãy sử dụng "adGroup.id".

startDate

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 bắt đầu ngay bây giờ hoặc ngày bắt đầu của nhóm quảng cáo, tuỳ vào ngày nào đến sau. Nếu bạn đặt trường này, thì nhóm quảng cáo sẽ bắt đầu vào ngày bắt đầu của 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 vào Facebook và Microsoft Advertising.

Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14

endDate

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 vào Facebook và Microsoft Advertising.

Định dạng: YYYY-MM-DD Ví dụ: 2019-03-14

languageCode

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 các tài khoản Microsoft Advertising. Xem thêm chi tiết: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

Ngày giờ khi nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

id

string (int64 format)

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 chỉ được chứa dưới 255 ký tự có độ rộng đầy đủ theo UTF-8.

Mã không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD).

cpcBidMicros

string (int64 format)

Giá thầu CPC (chi phí mỗi lượt nhấp) tối đa.

engineStatus

enum (AdGroupEngineStatus)

Trạng thái công cụ cho nhóm quảng cáo.

AdGroupStatus

Các trạng thái có thể có của một nhóm quảng cáo.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Nhóm quảng cáo đã được bật.
PAUSED Nhóm quảng cáo đã bị tạm dừng.
REMOVED Nhóm quảng cáo đã bị xóa.

AdGroupType

Enum liệt kê các loại nhóm quảng cáo có thể có.

Enum
UNSPECIFIED Loại chưa được chỉ định.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

SEARCH_STANDARD Loại nhóm quảng cáo mặc định cho chiến dịch Tìm kiếm.
DISPLAY_STANDARD Loại nhóm quảng cáo mặc định cho chiến dịch Hiển thị.
SHOPPING_PRODUCT_ADS Loại nhóm quảng cáo cho chiến dịch Mua sắm phân phát quảng cáo sản phẩm chuẩn.
SHOPPING_SHOWCASE_ADS Loại dành cho các nhóm quảng cáo bị giới hạn phân phát Quảng cáo trưng bày hoặc Quảng cáo người bán trong kết quả Mua sắm.
HOTEL_ADS Loại nhóm quảng cáo mặc định cho chiến dịch Khách sạn.
SHOPPING_SMART_ADS Loại nhóm quảng cáo trong chiến dịch Mua sắm thông minh.
VIDEO_BUMPER Quảng cáo dạng video trong luồng phát ngắn, không thể bỏ qua.
VIDEO_TRUE_VIEW_IN_STREAM Quảng cáo dạng video TrueView (có thể bỏ qua).
VIDEO_TRUE_VIEW_IN_DISPLAY Quảng cáo video TrueView trong hiển thị.
VIDEO_NON_SKIPPABLE_IN_STREAM Quảng cáo dạng video trong luồng phát không thể bỏ qua.
VIDEO_OUTSTREAM Quảng cáo dạng video ngoài luồng phát.
SEARCH_DYNAMIC_ADS Loại nhóm quảng cáo cho nhóm quảng cáo Quảng cáo tìm kiếm động.
SHOPPING_COMPARISON_LISTING_ADS Loại nhóm quảng cáo trong chiến dịch So sánh sản phẩm.
PROMOTED_HOTEL_ADS Loại nhóm quảng cáo cho nhóm quảng cáo Khách sạn được quảng cáo.
VIDEO_RESPONSIVE Nhóm quảng cáo thích ứng dạng video.
VIDEO_EFFICIENT_REACH Nhóm quảng cáo dạng video có phạm vi tiếp cận hiệu quả.
SMART_CAMPAIGN_ADS Loại nhóm quảng cáo cho chiến dịch Thông minh.
TRAVEL_ADS Loại nhóm quảng cáo cho chiến dịch Du lịch.

AdGroupAdRotationMode

Các chế độ xoay vòng quảng cáo có thể có của nhóm quảng cáo.

Enum
UNSPECIFIED Chế độ xoay vòng quảng cáo chưa được chỉ định.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

OPTIMIZE Tối ưu hoá quảng cáo trong nhóm quảng cáo dựa trên số lượt nhấp hoặc lượt chuyển đổi.
ROTATE_FOREVER Xoay vòng đồng đều vĩnh viễn.

AdGroupEngineStatus

Trạng thái của công cụ nhóm quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AD_GROUP_ELIGIBLE

Không dùng nữa. Không được dùng.

AD_GROUP_EXPIRED Không có quảng cáo nào đang chạy cho nhóm quảng cáo này, vì ngày kết thúc của nhóm quảng cáo đã qua.
AD_GROUP_REMOVED Nhóm quảng cáo đã bị xoá.
AD_GROUP_DRAFT Không có quảng cáo nào đang chạy cho nhóm quảng cáo này vì nhóm quảng cáo được liên kết vẫn đang ở dạng bản nháp.
AD_GROUP_PAUSED Nhóm quảng cáo đã bị tạm dừng.
AD_GROUP_SERVING Nhóm quảng cáo đang hoạt động và hiện đang phân phát quảng cáo.
AD_GROUP_SUBMITTED Nhóm quảng cáo đã được gửi (trạng thái cũ của Microsoft Bing Ads).
CAMPAIGN_PAUSED Không có quảng cáo nào đang chạy cho nhóm quảng cáo này, bởi vì chiến dịch đã bị tạm dừng.
ACCOUNT_PAUSED Không có quảng cáo nào đang chạy cho nhóm quảng cáo này, bởi vì tài khoản đã bị tạm dừng.

TargetingSetting

Cài đặt cho các tính năng liên quan đến nhắm mục tiêu, ở cấp chiến dịch và cấp nhóm quảng cáo. Để biết thêm thông tin về chế độ cài đặt tiêu chí nhắm mục tiêu, hãy truy cập vào https://support.google.com/google-ads/answer/7365594

Biểu diễn dưới dạng JSON
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Trường
targetRestrictions[]

object (TargetRestriction)

Chế độ cài đặt phương diện nhắm mục tiêu theo từng phương diện để hạn chế phạm vi tiếp cận của chiến dịch hoặc nhóm quảng cáo.

TargetRestriction

Danh sách chế độ cài đặt nhắm mục tiêu theo phương diện nhắm mục tiêu.

Biểu diễn dưới dạng JSON
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Trường
targetingDimension

enum (TargetingDimension)

Phương diện nhắm mục tiêu mà các chế độ cài đặt này áp dụng.

bidOnly

boolean

Cho biết liệu bạn sẽ giới hạn quảng cáo của mình chỉ hiển thị cho các tiêu chí mà bạn đã chọn cho Phương diện nhắm mục tiêu này hay nhắm mục tiêu tất cả các giá trị cho Phương diện nhắm mục tiêu này và hiển thị quảng cáo dựa trên tiêu chí nhắm mục tiêu của bạn trong các Phương diện nhắm mục tiêu khác. Giá trị true có nghĩa là các tiêu chí này sẽ chỉ áp dụng hệ số điều chỉnh giá thầu và không ảnh hưởng đến việc nhắm mục tiêu. Giá trị false có nghĩa là các tiêu chí này sẽ hạn chế việc nhắm mục tiêu cũng như áp dụng hệ số điều chỉnh giá thầu.

TargetingDimension

Enum mô tả các thứ nguyên nhắm mục tiêu có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
KEYWORD Tiêu chí từ khoá, ví dụ: 'hành trình trên biển". KEY có thể được sử dụng làm thứ nguyên giá thầu tùy chỉnh. Từ khóa luôn là thứ nguyên nhắm mục tiêu, do đó, bạn không thể đặt làm thứ nguyên "TẤT CẢ" mục tiêu bằng TargetRestriction.
AUDIENCE Tiêu chí về đối tượng, bao gồm danh sách người dùng, mối quan tâm của người dùng, đối tượng chung sở thích tuỳ chỉnh và đối tượng tuỳ chỉnh trên thị trường.
TOPIC Tiêu chí theo chủ đề để nhắm mục tiêu theo các danh mục nội dung, ví dụ: "category::Động vật>Thú cưng" Dùng để nhắm mục tiêu trên Mạng Hiển thị và Video.
GENDER Tiêu chí để nhắm mục tiêu giới tính.
AGE_RANGE Tiêu chí để nhắm mục tiêu độ tuổi.
PLACEMENT Tiêu chí vị trí, bao gồm các trang web như 'www.flowers4sale.com', cũng như các ứng dụng dành cho thiết bị di động, danh mục ứng dụng dành cho thiết bị di động, video trên YouTube và kênh YouTube.
PARENTAL_STATUS Tiêu chí để nhắm mục tiêu theo tình trạng con cái.
INCOME_RANGE Tiêu chí để nhắm mục tiêu theo phạm vi thu nhập.

AdGroupAd

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Trường
resourceName

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/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

Trạng thái của quảng cáo.

ad

object (Ad)

Quảng cáo.

creationTime

string

Dấu thời gian khi adGroupAd này được tạo. Ngày giờ này 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ào quảng cáo trong nhóm quảng cáo này.

engineId

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 Nhật Bản, Microsoft, Baidu, v.v.). Đối với pháp nhân không thuộc Search Ads 360, hãy sử dụng "adGroupAd.ad.id".

engineStatus

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

lastModifiedTime

string

Ngày giờ khi quảng cáo nhóm quảng cáo này được sửa đổi lần cuối cùng. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

AdGroupAdStatus

Các trạng thái có thể có của một Nhóm Quảng cáo.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Quảng cáo trong nhóm quảng cáo đã được bật.
PAUSED Nhóm quảng cáo đã bị tạm dừng.
REMOVED Quảng cáo trong nhóm quảng cáo đã bị xóa.

AdType

Các loại quảng cáo có thể xảy ra.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

TEXT_AD Quảng cáo là quảng cáo dạng văn bản.
EXPANDED_TEXT_AD Quảng cáo là quảng cáo văn bản mở rộng.
CALL_ONLY_AD Quảng cáo này là quảng cáo chỉ tạo cuộc gọi điện thoại.
EXPANDED_DYNAMIC_SEARCH_AD Quảng cáo này là quảng cáo tìm kiếm động mở rộng.
HOTEL_AD Quảng cáo này là quảng cáo khách sạn.
SHOPPING_SMART_AD Quảng cáo này là Quảng cáo mua sắm thông minh.
SHOPPING_PRODUCT_AD Quảng cáo này là quảng cáo Mua sắm thông thường.
VIDEO_AD Quảng cáo này là quảng cáo dạng video.
GMAIL_AD Quảng cáo này là quảng cáo Gmail.
IMAGE_AD Quảng cáo này là Quảng cáo hình ảnh.
RESPONSIVE_SEARCH_AD Quảng cáo này là quảng cáo tìm kiếm thích ứng.
LEGACY_RESPONSIVE_DISPLAY_AD Quảng cáo này là quảng cáo hiển thị thích ứng cũ.
APP_AD Quảng cáo là quảng cáo ứng dụng.
LEGACY_APP_INSTALL_AD Quảng cáo là quảng cáo cài đặt ứng dụng cũ.
RESPONSIVE_DISPLAY_AD Quảng cáo này là quảng cáo hiển thị thích ứng.
LOCAL_AD Quảng cáo này là quảng cáo địa phương.
HTML5_UPLOAD_AD Quảng cáo là quảng cáo tải lên hiển thị có loại sản phẩm HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Quảng cáo là quảng cáo hiển thị hình ảnh tải lên với một trong các loại sản phẩm dynamic_HTML5_*.
APP_ENGAGEMENT_AD Quảng cáo là quảng cáo tương tác với ứng dụng.
SHOPPING_COMPARISON_LISTING_AD Quảng cáo là quảng cáo so sánh sản phẩm mua sắm.
VIDEO_BUMPER_AD Quảng cáo đệm video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Quảng cáo trong luồng phát không thể bỏ qua dạng video.
VIDEO_OUTSTREAM_AD Quảng cáo video ngoài luồng phát.
VIDEO_TRUEVIEW_DISCOVERY_AD Quảng cáo TrueView dạng video trong hiển thị.
VIDEO_TRUEVIEW_IN_STREAM_AD Quảng cáo TrueView trong luồng dạng video.
VIDEO_RESPONSIVE_AD Quảng cáo thích ứng dạng video.
SMART_CAMPAIGN_AD Quảng cáo chiến dịch thông minh.
APP_PRE_REGISTRATION_AD Quảng cáo đăng ký trước ứng dụng toàn cầu.
DISCOVERY_MULTI_ASSET_AD Quảng cáo khám phá nhiều thành phần.
TRAVEL_AD Quảng cáo du lịch.
DISCOVERY_VIDEO_RESPONSIVE_AD Quảng cáo khám phá dạng video thích ứng.

SearchAds360TextAdInfo

Quảng cáo dạng văn bản trên Search Ads 360.

Biểu diễn dưới dạng JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Trường
headline

string

Dòng tiêu đề của quảng cáo.

description1

string

Dòng đầu tiên trong phần mô tả của quảng cáo.

description2

string

Dòng thứ hai trong nội dung mô tả của quảng cáo.

displayUrl

string

URL được hiển thị của quảng cáo.

displayMobileUrl

string

URL trên thiết bị di động được hiển thị của quảng cáo.

adTrackingId

string (int64 format)

Mã theo dõi của quảng cáo.

SearchAds360ExpandedTextAdInfo

Quảng cáo dạng văn bản mở rộng trong Search Ads 360.

Biểu diễn dưới dạng JSON
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Trường
headline

string

Dòng tiêu đề của quảng cáo.

headline2

string

Dòng tiêu đề thứ hai của quảng cáo.

headline3

string

Dòng tiêu đề thứ ba của quảng cáo.

description1

string

Dòng đầu tiên trong phần mô tả của quảng cáo.

description2

string

Dòng thứ hai trong nội dung mô tả của quảng cáo.

path1

string

Văn bản được thêm vào URL hiển thị được tạo tự động có dấu phân tách.

path2

string

Văn bản được thêm vào đường dẫn 1 bằng một dấu phân cách.

adTrackingId

string (int64 format)

Mã theo dõi của quảng cáo.

SearchAds360ResponsiveSearchAdInfo

Quảng cáo tìm kiếm thích ứng trên Search Ads 360.

Biểu diễn dưới dạng JSON
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Trường
path1

string

Văn bản được thêm vào URL hiển thị được tạo tự động có dấu phân tách.

path2

string

Văn bản được thêm vào đường dẫn 1 bằng một dấu phân cách.

adTrackingId

string (int64 format)

Mã theo dõi của quảng cáo.

SearchAds360ProductAdInfo

Loại này không có trường.

Quảng cáo sản phẩm trong Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Quảng cáo tìm kiếm động mở rộng.

Biểu diễn dưới dạng JSON
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Trường
description1

string

Dòng đầu tiên trong phần mô tả của quảng cáo.

description2

string

Dòng thứ hai trong nội dung mô tả của quảng cáo.

adTrackingId

string (int64 format)

Mã theo dõi của quảng cáo.

AdGroupAdEngineStatus

Liệt kê các trạng thái công cụ Nhóm quảng cáo.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AD_GROUP_AD_ELIGIBLE

Không dùng nữa. Không được dùng.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Mẫu quảng cáo không được phê duyệt.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL dành cho thiết bị di động đang trong quá trình xem xét.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: Mẫu quảng cáo không hợp lệ trên thiết bị di động nhưng hợp lệ trên máy tính.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: Mẫu quảng cáo đã sẵn sàng để kích hoạt.
AD_GROUP_AD_NOT_REVIEWED Baidu: Mẫu quảng cáo chưa được xem xét.
AD_GROUP_AD_ON_HOLD

Không dùng nữa. Không được dùng. Được Gemini sử dụng trước đây

AD_GROUP_AD_PAUSED Mẫu quảng cáo đã bị tạm dừng.
AD_GROUP_AD_REMOVED Đã xóa mẫu quảng cáo.
AD_GROUP_AD_PENDING_REVIEW Mẫu quảng cáo đang chờ xem xét.
AD_GROUP_AD_UNDER_REVIEW Mẫu quảng cáo đang được xem xét.
AD_GROUP_AD_APPROVED Mẫu quảng cáo đã được chấp thuận.
AD_GROUP_AD_DISAPPROVED Mẫu quảng cáo đã bị từ chối.
AD_GROUP_AD_SERVING Mẫu quảng cáo đang phân phát.
AD_GROUP_AD_ACCOUNT_PAUSED Mẫu quảng cáo đã bị tạm dừng vì tài khoản này bị tạm dừng.
AD_GROUP_AD_CAMPAIGN_PAUSED Mẫu quảng cáo đã bị tạm dừng vì chiến dịch bị tạm dừng.
AD_GROUP_AD_AD_GROUP_PAUSED Mẫu quảng cáo đã bị tạm dừng vì nhóm quảng cáo bị tạm dừng.

AdGroupAdLabel

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
Trường
resourceName

string

Tên tài nguyên của nhãn quảng cáo của 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/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

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

AdGroupAsset

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Trường
resourceName

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 DataStoreAsset có dạng:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

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

enum (AssetLinkStatus)

Trạng thái của thành phần nhóm quảng cáo.

AssetLinkStatus

Enum mô tả trạng thái của đường liên kết đến tài sản.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Đường liên kết đến tài sản đang bật.
REMOVED Đường liên kết đến tài sản đã bị xoá.
PAUSED Đường liên kết đến thành phần đã bị tạm dừng.

AdGroupAssetSet

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Trường
resourceName

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

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

adGroup

string

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

assetSet

string

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

status

enum (AssetSetLinkStatus)

Trạng thái của nhóm thành phần nhóm quảng cáo. Chỉ đọc.

AssetSetLinkStatus

Các trạng thái có thể xảy ra của mối liên kết giữa nhóm thành phần và vùng chứa của nhóm thành phần đó.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận. Đây là giá trị chỉ phản hồi.
ENABLED Mối liên kết giữa nhóm thành phần và vùng chứa của nhóm thành phần đã được bật.
REMOVED Mối liên kết giữa nhóm thành phần và vùng chứa của nhóm thành phần đó sẽ bị huỷ bỏ.

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ừ sở thích và danh sách tiếp thị lại cho quảng cáo trên Mạng hiển thị và Mạng YouTube cũng như danh sách tiếp thị lại dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp ở cấp đối tượng.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem đối tượng của 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/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Trường
resourceName

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 của công cụ sửa đổi giá thầu cho nhóm quảng cáo có dạng:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

Hệ số sửa đổi cho giá thầu khi tiêu chí khớp. Giá trị sửa đổi phải nằm trong khoảng: 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 hợp criterion. Tiêu chí của hệ số sửa đổi giá thầu cho nhóm quảng cáo này.

Bắt buộc khi tạo các thao tác bắt đầu trong phiên bản 5. criterion chỉ có thể là một trong những trạng thái sau:

device

object (DeviceInfo)

Tiêu chí về thiết bị.

DeviceInfo

Tiêu chí về thiết bị.

Biểu diễn dưới dạng JSON
{
  "type": enum (Device)
}
Trường
type

enum (Device)

Loại thiết bị.

Thiết bị

Liệt kê các thiết bị Google Ads có sẵn để nhắm mục tiêu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
MOBILE Thiết bị di động có trình duyệt hoàn chỉnh.
TABLET Máy tính bảng có trình duyệt hoàn chỉnh.
DESKTOP Máy tính.
CONNECTED_TV TV thông minh và máy chơi trò chơi.
OTHER Các loại thiết bị khác.

AdGroupCriterion

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Trường
resourceName

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/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

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

enum (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 khách hàng đặt. Lưu ý: báo cáo giao diện người dùng có thể kết hợp thông tin bổ sung ả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à đã bật trong giao diện người dùng. Ví dụ: theo mặc định, các chiến dịch sẽ hiển thị cho người dùng ở tất cả độ tuổi trừ phi bị loại trừ. Giao diện người dùng sẽ hiển thị từng độ tuổi là "đã bật" vì người dùng đủ điều kiện xem quảng cáo; nhưng nhóm AdsCriterion.status sẽ hiển thị trạng thái "đã xoá", vì họ chưa thêm tiêu chí khẳng định nào.

qualityInfo

object (QualityInfo)

Thông tin về chất lượng của tiêu chí.

type

enum (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í nhóm quảng cáo này.

positionEstimates

object (PositionEstimates)

Ước tính cho giá thầu tiêu chí ở các vị trí khác nhau.

finalUrls[]

string

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

engineId

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 tài khoản Google Ads (ví dụ: Yahoo Japan, Microsoft, Baidu, v.v.). Đối với pháp nhân Google Ads, hãy sử dụng "adGroupCriterion.criterion_id".

lastModifiedTime

string

Ngày giờ khi tiêu chí nhóm quảng cáo này được sửa đổi lần cuối. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

criterionId

string (int64 format)

Mã của tiêu chí.

adGroup

string

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

negative

boolean

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

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

bidModifier

number

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

cpcBidMicros

string (int64 format)

Giá thầu CPC (chi phí mỗi lượt nhấp).

effectiveCpcBidMicros

string (int64 format)

Giá thầu CPC (chi phí mỗi lượt nhấp) hiệu quả.

engineStatus

enum (AdGroupCriterionEngineStatus)

Tiêu chí Trạng thái công cụ cho nhóm quảng cáo.

finalUrlSuffix

string

Mẫu URL để thêm các tham số vào URL cuối cùng.

trackingUrlTemplate

string

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

Trường hợp criterion. Tiêu chí nhóm quảng cáo.

Bạn phải đặt chính xác một thuộc tính. criterion chỉ có thể là một trong những trạng thái sau:

keyword

object (KeywordInfo)

Từ khoá.

listingGroup

object (ListingGroupInfo)

Nhóm trang thông tin.

ageRange

object (AgeRangeInfo)

Độ tuổi.

gender

object (GenderInfo)

Giới tính.

userList

object (UserListInfo)

Danh sách người dùng.

webpage

object (WebpageInfo)

Trang web

location

object (LocationInfo)

Vị trí.

AdGroupCriterionStatus

Các trạng thái có thể có của Tiêu chí nhóm quảng cáo.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Tiêu chí nhóm quảng cáo đã được bật.
PAUSED Tiêu chí nhóm quảng cáo đã bị tạm dừng.
REMOVED Tiêu chí nhóm quảng cáo đã bị xóa.

QualityInfo

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

Biểu diễn dưới dạng JSON
{
  "qualityScore": integer
}
Trường
qualityScore

integer

Điểm chất lượng.

Trường này có thể không được điền nếu Google không có đủ thông tin để xác định một giá trị.

CriterionType

Enum mô tả các loại tiêu chí có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
KEYWORD Từ khóa, ví dụ: 'hành trình trên biển'.
PLACEMENT Vị trí, còn được gọi là Trang web, ví dụ: 'www.flowers4sale.com'
MOBILE_APP_CATEGORY Danh mục ứng dụng dành cho thiết bị di động để nhắm mục tiêu.
MOBILE_APPLICATION Ứng dụng trên thiết bị di động để nhắm mục tiêu.
DEVICE Thiết bị cần nhắm mục tiêu.
LOCATION Vị trí cần nhắm mục tiêu.
LISTING_GROUP Nhóm trang thông tin cần nhắm mục tiêu.
AD_SCHEDULE Lịch quảng cáo.
AGE_RANGE Độ tuổi.
GENDER Giới tính.
INCOME_RANGE Phạm vi thu nhập.
PARENTAL_STATUS Tình trạng con cái.
YOUTUBE_VIDEO Video trên YouTube.
YOUTUBE_CHANNEL Kênh YouTube.
USER_LIST Danh sách người dùng.
PROXIMITY Tiệm cận.
TOPIC Mục tiêu theo chủ đề trên mạng hiển thị (ví dụ: "Thú cưng và động vật").
LISTING_SCOPE Phạm vi trang thông tin cần nhắm mục tiêu.
LANGUAGE Ngôn ngữ.
IP_BLOCK IpBlock.
CONTENT_LABEL Nhãn nội dung để loại trừ danh mục.
CARRIER Nhà mạng.
USER_INTEREST Danh mục mà người dùng quan tâm.
WEBPAGE Tiêu chí trang web dành cho quảng cáo tìm kiếm động.
OPERATING_SYSTEM_VERSION Phiên bản hệ điều hành.
APP_PAYMENT_MODEL Mô hình thanh toán qua ứng dụng.
MOBILE_DEVICE Thiết bị di động.
CUSTOM_AFFINITY Sở thích tùy chỉnh.
CUSTOM_INTENT Đối tượng có ý định tuỳ chỉnh.
LOCATION_GROUP Nhóm địa điểm.
CUSTOM_AUDIENCE Đối tượng tuỳ chỉnh
COMBINED_AUDIENCE Đối tượng được kết hợp
KEYWORD_THEME Chủ đề từ khóa của Chiến dịch thông minh
AUDIENCE Đối tượng người xem
LOCAL_SERVICE_ID Mã dịch vụ quảng cáo dịch vụ địa phương.
BRAND Thương hiệu
BRAND_LIST Danh sách thương hiệu
LIFE_EVENT Sự kiện trong đời

PositionEstimates

Ước tính cho giá thầu tiêu chí ở các vị trí khác nhau.

Biểu diễn dưới dạng JSON
{
  "topOfPageCpcMicros": string
}
Trường
topOfPageCpcMicros

string (int64 format)

Ước tính giá thầu CPC bắt buộc để quảng cáo được hiển thị ở đầu trang đầu tiên của kết quả tìm kiếm.

AdGroupCriterionEngineStatus

Liệt kê các trạng thái công cụ của Nhóm tiêu chí quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AD_GROUP_CRITERION_ELIGIBLE

Không dùng nữa. Không được dùng.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: Giá thầu hoặc chất lượng quá thấp nên không thể hiển thị.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: Bị tạm dừng trên Baidu do lượng tìm kiếm thấp.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL dành cho thiết bị di động đang trong quá trình xem xét.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: Trang đích của một thiết bị không hợp lệ, trong khi trang đích cho thiết bị kia lại hợp lệ.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Từ khoá đã được nhóm quản lý tài khoản Baidu tạo và tạm dừng. Hiện đã sẵn sàng để bạn kích hoạt từ khoá.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Đang trong quá trình xem xét bởi Baidu. Song Tử: Tiêu chí đang được xem xét.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: Tiêu chí cần xem xét.
AD_GROUP_CRITERION_ON_HOLD

Không dùng nữa. Không được dùng. Được Gemini sử dụng trước đây

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Tiêu chí đang chờ xem xét
AD_GROUP_CRITERION_PAUSED Đã tạm dừng tiêu chí.
AD_GROUP_CRITERION_REMOVED Đã xóa tiêu chí.
AD_GROUP_CRITERION_APPROVED Tiêu chí đã được phê duyệt.
AD_GROUP_CRITERION_DISAPPROVED Tiêu chí đã bị từ chối.
AD_GROUP_CRITERION_SERVING Tiêu chí đang hoạt động và đang được phân phát.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Tiêu chí đã bị tạm dừng kể từ khi tài khoản bị tạm dừng.

KeywordInfo

Một tiêu chí từ khóa.

Biểu diễn dưới dạng JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Trường
matchType

enum (KeywordMatchType)

Kiểu khớp của từ khoá.

text

string

Văn bản của từ khoá (tối đa 80 ký tự và 10 từ).

KeywordMatchType

Các kiểu khớp Từ khóa có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
EXACT Khớp chính xác.
PHRASE Khớp cụm từ.
BROAD Khớp mở rộng.

ListingGroupInfo

Một tiêu chí cho nhóm trang thông tin.

Biểu diễn dưới dạng JSON
{
  "type": enum (ListingGroupType)
}
Trường
type

enum (ListingGroupType)

Loại nhóm trang thông tin.

ListingGroupType

Loại nhóm trang thông tin.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SUBDIVISION Phân mục sản phẩm theo một số phương diện trang thông tin. Các nút này không được sử dụng để phân phối cho các mục nhập danh sách nhắm mục tiêu, mà chỉ dùng để xác định cấu trúc của cây.
UNIT Đơn vị nhóm trang thông tin xác định giá thầu.

AgeRangeInfo

Một tiêu chí độ tuổi.

Biểu diễn dưới dạng JSON
{
  "type": enum (AgeRangeType)
}
Trường
type

enum (AgeRangeType)

Loại độ tuổi.

AgeRangeType

Loại độ tuổi theo thông tin nhân khẩu học (ví dụ: từ 18 đến 24 tuổi).

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AGE_RANGE_18_24 Từ 18 đến 24 tuổi.
AGE_RANGE_25_34 Trong độ tuổi từ 25 đến 34.
AGE_RANGE_35_44 Từ 35 đến 44 tuổi.
AGE_RANGE_45_54 Từ 45 đến 54 tuổi.
AGE_RANGE_55_64 Từ 55 đến 64 tuổi.
AGE_RANGE_65_UP 65 tuổi trở lên.
AGE_RANGE_UNDETERMINED Độ tuổi chưa được xác định.

GenderInfo

Tiêu chí giới tính.

Biểu diễn dưới dạng JSON
{
  "type": enum (GenderType)
}
Trường
type

enum (GenderType)

Loại giới tính.

GenderType

Loại giới tính nhân khẩu học (ví dụ: nữ).

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
MALE Nam.
FEMALE Nữ.
UNDETERMINED Giới tính chưa được xác định.

UserListInfo

Tiêu chí Danh sách người dùng. Đại diện cho danh sách người dùng mà nhà quảng cáo xác định cần nhắm mục tiêu.

Biểu diễn dưới dạng JSON
{
  "userList": string
}
Trường
userList

string

Tên tài nguyên Danh sách người dùng.

WebpageInfo

Đại diện cho một tiêu chí để nhắm mục tiêu các trang trên trang web của nhà quảng cáo.

Biểu diễn dưới dạng JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Trường
conditions[]

object (WebpageConditionInfo)

Các điều kiện hoặc biểu thức logic để nhắm mục tiêu trang web. Danh sách các điều kiện nhắm mục tiêu trang web được liên kết với nhau khi được đánh giá nhắm mục tiêu. Danh sách điều kiện trống cho biết tất cả các trang trong trang web của chiến dịch đều được nhắm mục tiêu.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

coveragePercentage

number

Tỷ lệ phần trăm mức độ phù hợp của tiêu chí trang web. Đây là tỷ lệ phần trăm mức độ phù hợp của trang web được tính toán dựa trên mục tiêu trang web, mục tiêu trang web phủ định và từ khoá phủ định trong nhóm quảng cáo và chiến dịch. Ví dụ: khi mức độ phù hợp trả về là 1, có nghĩa là phạm vi bao phủ có mức độ phù hợp 100%. Trường này chỉ để đọc.

criterionName

string

Tên của tiêu chí được thông số này xác định. Giá trị tên sẽ được dùng để xác định, sắp xếp và lọc tiêu chí bằng loại thông số này.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

WebpageConditionInfo

Biểu thức logic để nhắm mục tiêu các trang trên trang web của nhà quảng cáo.

Biểu diễn dưới dạng JSON
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Trường
operand

enum (WebpageConditionOperand)

Toán hạng của điều kiện nhắm mục tiêu trang web.

operator

enum (WebpageConditionOperator)

Toán tử của điều kiện nhắm mục tiêu trang web.

argument

string

Đối số của điều kiện nhắm mục tiêu trang web.

WebpageConditionOperand

Toán hạng điều kiện trang web trong tiêu chí trang web.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
URL Toán hạng cho biết điều kiện nhắm mục tiêu URL trang web.
CATEGORY Toán hạng cho biết điều kiện nhắm mục tiêu danh mục trang web.
PAGE_TITLE Toán hạng cho biết điều kiện nhắm mục tiêu tiêu đề trang web.
PAGE_CONTENT Toán hạng cho biết điều kiện nhắm mục tiêu nội dung trang web.
CUSTOM_LABEL Toán hạng cho biết điều kiện nhắm mục tiêu nhãn tuỳ chỉnh của trang web.

WebpageConditionOperator

Toán tử điều kiện trang web theo tiêu chí trang web.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
EQUALS Điều kiện web của đối số bằng với điều kiện web được so sánh.
CONTAINS Điều kiện web đối số là một phần của điều kiện web được so sánh.

LocationInfo

Tiêu chí vị trí.

Biểu diễn dưới dạng JSON
{
  "geoTargetConstant": string
}
Trường
geoTargetConstant

string

Tên tài nguyên hằng số nhắm mục tiêu theo địa lý.

AdGroupCriterionLabel

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
Trường
resourceName

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 của tiêu chí nhóm quảng cáo có dạng: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Tiêu chí nhóm quảng cáo mà nhãn được đính kèm.

label

string

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

AdGroupLabel

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
Trường
resourceName

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 của nhóm quảng cáo có dạng: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

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.

AgeRangeView

Chế độ xem độ tuổi.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem độ tuổi. Tên tài nguyên chế độ xem độ tuổi có dạng:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

Tài sản

Thành phần là một phần của quảng cáo có thể được dùng chung trên nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YouTubeVideoAsset), v.v. Thành phần là không thể thay đổi và không thể xoá. Để dừ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 đó.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Trường
resourceName

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Loại tài sản.

finalUrls[]

string

Danh sách các URL cuối cùng có thể xảy ra sau tất cả các lần chuyển hướng nhiều miền.

status

enum (AssetStatus)

Trạng thái của nội dung.

creationTime

string

Dấu thời gian khi thành phầ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".

lastModifiedTime

string

Ngày sửa đổi thành phần này gần đây nhất. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

id

string (int64 format)

ID của nội dung.

name

string

Tên tài sản (không bắt buộc).

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

Trạng thái công cụ của một nội dung.

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

object (YoutubeVideoAsset)

Tài sản video trên YouTube.

imageAsset

object (ImageAsset)

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

textAsset

object (TextAsset)

Thành phần văn bản.

calloutAsset

object (UnifiedCalloutAsset)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

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

mobileAppAsset

object (MobileAppAsset)

Thành phần ứng dụng di động.

callAsset

object (UnifiedCallAsset)

Thành phần cuộc gọi hợp nhất.

callToActionAsset

object (CallToActionAsset)

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

locationAsset

object (UnifiedLocationAsset)

Thành phần địa điểm hợp nhất.

AssetType

Enum mô tả các loại tài sản có thể sử dụng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
YOUTUBE_VIDEO Tài sản video trên YouTube.
MEDIA_BUNDLE Thành phần gói phương tiện.
IMAGE Thành phần hình ảnh.
TEXT Thành phần văn bản.
LEAD_FORM Thành phần biểu mẫu khách hàng tiềm năng.
BOOK_ON_GOOGLE Tài sản Đặt phòng trên Google.
PROMOTION Thành phần chương trình khuyến mãi.
CALLOUT Thành phần chú thích.
STRUCTURED_SNIPPET Thành phần Đoạn thông tin có cấu trúc.
PAGE_FEED Thành phần Nguồn cấp dữ liệu trang.
DYNAMIC_EDUCATION thành phần Dynamic Education.
MOBILE_APP Thành phần ứng dụng di động.
HOTEL_CALLOUT Thành phần chú thích cho khách sạn.
CALL Thành phần cuộc gọi.
PRICE Thành phần giá.
CALL_TO_ACTION Thành phần lời kêu gọi hành động.
DYNAMIC_REAL_ESTATE Thành phần linh động về bất động sản.
DYNAMIC_CUSTOM Thành phần tuỳ chỉnh linh động.
DYNAMIC_HOTELS_AND_RENTALS Thành phần linh động về khách sạn và nhà nghỉ cho thuê.
DYNAMIC_FLIGHTS Thành phần linh động về chuyến bay.
DYNAMIC_TRAVEL Thành phần linh động về du lịch.
DYNAMIC_LOCAL Thành phần linh động tại địa phương.
DYNAMIC_JOBS Thành phần linh động về việc làm.
LOCATION Thành phần địa điểm.
HOTEL_PROPERTY Thành phần cơ sở lưu trú khách sạn.

AssetStatus

Các trạng thái có thể xảy ra của một thành phần.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận. Đây là giá trị chỉ phản hồi.
ENABLED Thành phần này đã được bật.
REMOVED Thành phần này đã bị xoá.
ARCHIVED Tài sản này đã được lưu trữ.
PENDING_SYSTEM_GENERATED Thành phần này là do hệ thống tạo đang chờ người dùng xem xét.

AssetEngineStatus

Mã tiếp theo = 11

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SERVING Thành phần này đang hoạt động.
SERVING_LIMITED Thành phần này đang hoạt động nhưng có giới hạn.
DISAPPROVED Thành phần bị từ chối (không đủ điều kiện).
DISABLED Thành phần này không hoạt động (đang chờ xử lý).
REMOVED Thành phần này đã bị xoá.

YoutubeVideoAsset

Tài sản trên YouTube.

Biểu diễn dưới dạng JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Trường
youtubeVideoTitle

string

Tiêu đề video trên YouTube.

youtubeVideoId

string

Mã video trên YouTube. Đây là giá trị chuỗi gồm 11 ký tự được sử dụng trong URL của video trên YouTube.

ImageAsset

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

Biểu diễn dưới dạng JSON
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Trường
mimeType

enum (MimeType)

Loại MIME của thành phần hình ảnh.

fullSize

object (ImageDimension)

Siêu dữ liệu cho hình ảnh này ở kích thước ban đầu.

fileSize

string (int64 format)

Kích thước tệp của thành phần hình ảnh tính bằng byte.

MimeType

Loại MIME

Enum
UNSPECIFIED Loại MIME chưa được chỉ định.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

IMAGE_JPEG Loại MIME của hình ảnh/jpeg.
IMAGE_GIF Loại MIME của hình ảnh/gif.
IMAGE_PNG Loại MIME của hình ảnh/png.
FLASH Loại MIME của ứng dụng/x-shockwave-flash.
TEXT_HTML Loại văn bản/html MIME.
PDF Loại MIME của ứng dụng/pdf.
MSWORD Loại MIME của ứng dụng/msword.
MSEXCEL Loại MIME của ứng dụng/vnd.ms-excel.
RTF Loại MIME của ứng dụng/rtf.
AUDIO_WAV Loại MIME của âm thanh/wav.
AUDIO_MP3 Loại MIME của âm thanh/mp3.
HTML5_AD_ZIP Loại MIME của application/x-html5-ad-zip.

ImageDimension

Siêu dữ liệu của hình ảnh ở một kích thước nhất định, có thể là bản gốc hoặc đã đổi kích thước.

Biểu diễn dưới dạng JSON
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Trường
heightPixels

string (int64 format)

Chiều cao của hình ảnh.

widthPixels

string (int64 format)

Chiều rộng của hình ảnh.

url

string

URL trả về hình ảnh có chiều cao và chiều rộng này.

TextAsset

Thành phần Văn bản.

Biểu diễn dưới dạng JSON
{
  "text": string
}
Trường
text

string

Nội dung văn bản của thành phần văn bản.

UnifiedCalloutAsset

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

Biểu diễn dưới dạng JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Trường
calloutText

string

Văn bản chú thích. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25.

startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.

endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.

useSearcherTimeZone

boolean

Liệu có hiển thị thành phần này theo múi giờ của người dùng tìm kiếm hay không. Áp dụng cho Microsoft Ads.

AdScheduleInfo

Đại diện cho tiêu chí AdSchedule.

Lịch quảng cáo được chỉ định làm ngày trong tuần và khoảng thời gian mà quảng cáo sẽ được hiển thị.

Bạn chỉ có thể thêm tối đa 6 Lịch quảng cáo trong cùng một ngày.

Biểu diễn dưới dạng JSON
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Trường
startMinute

enum (MinuteOfHour)

Phút sau giờ bắt đầu mà lịch biểu này bắt đầu.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

endMinute

enum (MinuteOfHour)

Phút sau giờ kết thúc mà lịch biểu này kết thúc. Lịch biểu không bao gồm phút kết thúc.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

dayOfWeek

enum (DayOfWeek)

Ngày trong tuần áp dụng lịch biểu.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

startHour

integer

Giờ bắt đầu theo định dạng 24 giờ. Trường này phải nằm trong khoảng từ 0 đến 23.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

endHour

integer

Giờ kết thúc tính theo thời gian 24 giờ; 24 biểu thị thời điểm kết thúc ngày. Trường này phải nằm trong khoảng từ 0 đến 24.

Trường này là bắt buộc đối với các thao tác CREATE và bị cấm đối với các tác vụ CẬP NHẬT.

MinuteOfHour

Bảng đếm giờ. Ví dụ: "FIFTEEN"

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
ZERO 0 phút quá giờ.
FIFTEEN 15 phút quá 15 phút.
THIRTY 30 phút quá 1 giờ.
FORTY_FIVE 45 phút nữa.

DayOfWeek

Liệt kê các ngày trong tuần, ví dụ: "Thứ Hai".

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
MONDAY Thứ Hai.
TUESDAY Thứ Ba.
WEDNESDAY Thứ Tư.
THURSDAY Thứ Năm.
FRIDAY Thứ Sáu.
SATURDAY Thứ Bảy.
SUNDAY Chủ Nhật.

UnifiedSitelinkAsset

Thành phần đường liên kết của trang web hợp nhất.

Biểu diễn dưới dạng JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Trường
description1

string

Dòng đầu tiên của nội dung mô tả cho đường liên kết của trang web. Nếu đặt, độ dài phải nằm trong khoảng từ 1 đến 35, bao gồm cả phần mô tả và phần mô tả 2 cũng phải được đặt.

description2

string

Dòng thứ hai của nội dung mô tả cho đường liên kết của trang web. Nếu đặt, độ dài phải nằm trong khoảng từ 1 đến 35, và bạn cũng phải đặt description1.

startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.

endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.

adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.

trackingId

string (int64 format)

Mã được dùng để theo dõi số lượt nhấp cho thành phần đường liên kết của trang web. Đây là một tài khoản Yahoo! Trường chỉ dành cho Nhật Bản.

useSearcherTimeZone

boolean

Liệu có hiển thị thành phần đường liên kết của trang web theo múi giờ của người dùng tìm kiếm hay không. Áp dụng cho Microsoft Ads.

mobilePreferred

boolean

Liệu lựa chọn ưu tiên có phải là để thành phần đường liên kết của trang web xuất hiện trên thiết bị di động hay không. Áp dụng cho Microsoft Ads.

UnifiedPageFeedAsset

Thành phần Nguồn cấp dữ liệu trang hợp nhất.

Biểu diễn dưới dạng JSON
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Trường
pageUrl

string

Trang web mà nhà quảng cáo muốn nhắm mục tiêu.

labels[]

string

Nhãn dùng để nhóm các URL trang.

MobileAppAsset

Một thành phần đại diện cho ứng dụng di động.

Biểu diễn dưới dạng JSON
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Trường
appId

string

Bắt buộc. Một chuỗi xác định duy nhất một ứng dụng dành cho thiết bị di động. Tệp này chỉ nên chứa id gốc của nền tảng, chẳng hạn như "com.android.ebay" đối với Android hoặc "12345689" đối với iOS.

appStore

enum (MobileAppVendor)

Bắt buộc. Cửa hàng ứng dụng phân phối ứng dụng cụ thể này.

MobileAppVendor

Loại nhà cung cấp ứng dụng di động

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
APPLE_APP_STORE Nhà cung cấp ứng dụng di động cho cửa hàng ứng dụng của Apple.
GOOGLE_APP_STORE Nhà cung cấp ứng dụng di động cho cửa hàng ứng dụng của Google.

UnifiedCallAsset

Thành phần cuộc gọi hợp nhất.

Biểu diễn dưới dạng JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Trường
countryCode

string

Mã quốc gia gồm hai chữ cái của số điện thoại. Ví dụ: "US", "us".

phoneNumber

string

Số điện thoại thô của nhà quảng cáo. Ví dụ: "1234567890", "(123)456-7890"

callConversionReportingState

enum (CallConversionReportingState)

Cho biết liệu CallAsset này sẽ sử dụng chế độ cài đặt lượt chuyển đổi cuộc gọi riêng, tuân theo chế độ cài đặt cấp tài khoản hay tắt tính năng lượt chuyển đổi cuộc gọi.

callConversionAction

string

Hành động chuyển đổi để phân bổ lượt chuyển đổi dẫn đến cuộc gọi. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng hành động chuyển đổi mặc định. Trường này chỉ có hiệu lực nếu callConversionReportingState được đặt thành USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu.

callOnly

boolean

Liệu cuộc gọi có chỉ hiển thị số điện thoại mà không có đường liên kết đến trang web hay không. Áp dụng cho Microsoft Ads.

callTrackingEnabled

boolean

Liệu có nên bật cuộc gọi khi theo dõi cuộc gọi hay không. Áp dụng cho Microsoft Ads.

useSearcherTimeZone

boolean

Liệu có hiển thị phần mở rộng về cuộc gọi theo múi giờ của người dùng tìm kiếm hay không. Áp dụng cho Microsoft Ads.

startDate

string

Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd.

endDate

string

Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd.

CallConversionReportingState

Các loại dữ liệu có thể có cho trạng thái hành động chuyển đổi liên quan đến cuộc gọi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
DISABLED Hành động chuyển đổi cuộc gọi đã bị vô hiệu hóa.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Hành động chuyển đổi cuộc gọi sẽ sử dụng loại chuyển đổi cuộc gọi được đặt ở cấp tài khoản.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Hành động chuyển đổi cuộc gọi sẽ sử dụng loại chuyển đổi cuộc gọi được đặt ở cấp tài nguyên (quảng cáo chỉ tạo cuộc gọi điện thoại/phần mở rộng về cuộc gọi).

CallToActionAsset

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

Biểu diễn dưới dạng JSON
{
  "callToAction": enum (CallToActionType)
}
Trường
callToAction

enum (CallToActionType)

Lời kêu gọi hành động.

CallToActionType

Enum mô tả các loại lời kêu gọi hành động có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LEARN_MORE Loại lời kêu gọi hành động cần tìm hiểu thêm.
GET_QUOTE Loại lời kêu gọi hành động là nhận thông tin báo giá.
APPLY_NOW Loại lời kêu gọi hành động hiện được áp dụng.
SIGN_UP Loại lời kêu gọi hành động là đăng ký.
CONTACT_US Loại lời kêu gọi hành động là liên hệ với chúng tôi.
SUBSCRIBE Loại lời kêu gọi hành động là đăng ký.
DOWNLOAD Loại lời kêu gọi hành động là tải xuống.
BOOK_NOW Loại lời kêu gọi hành động là đặt ngay bây giờ.
SHOP_NOW Loại lời kêu gọi hành động là "mua sắm ngay".
BUY_NOW Loại lời kêu gọi hành động là mua ngay.
DONATE_NOW Lời kêu gọi hành động hiện là quyên góp.
ORDER_NOW Loại lời kêu gọi hành động là đặt hàng ngay bây giờ.
PLAY_NOW Loại lời kêu gọi hành động là phát ngay bây giờ.
SEE_MORE Bạn có thể xem thêm thông tin về loại lời kêu gọi hành động này.
START_NOW Loại lời kêu gọi hành động sẽ bắt đầu ngay bây giờ.
VISIT_SITE Loại lời kêu gọi hành động là truy cập trang web.
WATCH_NOW Loại lời kêu gọi hành động là "Xem ngay".

UnifiedLocationAsset

Thành phần địa điểm hợp nhất.

Biểu diễn dưới dạng JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Trường
placeId

string

Mã địa điểm xác định duy nhất một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Trường này là dành riêng cho một mã khách hàng và loại thành phần nhất định. Xem https://developers.google.com/places/web-service/place-id để tìm hiểu thêm về Mã địa điểm.

businessProfileLocations[]

object (BusinessProfileLocation)

Danh sách địa điểm doanh nghiệp của khách hàng. Hệ thống sẽ chỉ trả về giá trị này nếu Thành phần địa điểm đang đồng bộ hoá từ tài khoản Trang doanh nghiệp. Bạn có thể có nhiều trang thông tin Trang doanh nghiệp trong cùng một tài khoản trỏ đến cùng một Mã địa điểm.

locationOwnershipType

enum (LocationOwnershipType)

Loại quyền sở hữu vị trí. Nếu loại doanh nghiệp là BUSINESS_OWNER, loại doanh nghiệp này sẽ được phân phát dưới dạng phần mở rộng về địa điểm. Nếu loại là AFFLIATE, loại sản phẩm này sẽ được phân phát dưới dạng vị trí của đơn vị liên kết.

BusinessProfileLocation

Dữ liệu vị trí của Trang doanh nghiệp được đồng bộ hoá từ tài khoản Trang doanh nghiệp đã liên kết.

Biểu diễn dưới dạng JSON
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Trường
labels[]

string

Nhãn do nhà quảng cáo chỉ định cho vị trí trên tài khoản Trang doanh nghiệp. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp.

storeCode

string

Mã cửa hàng trên Trang doanh nghiệp của vị trí này. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp.

listingId

string (int64 format)

Mã trang thông tin của vị trí trên Trang doanh nghiệp này. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp đã liên kết.

LocationOwnershipType

Các loại quyền sở hữu vị trí có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
BUSINESS_OWNER Chủ doanh nghiệp của địa điểm(phần mở rộng về địa điểm cũ – LE).
AFFILIATE Địa điểm của đơn vị liên kết(Phần mở rộng về địa điểm của bên thứ ba – ALE).

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. Khi bạn thêm một AssetGroupAsset, một thành phần sẽ được liên kết với một nhóm thành phần.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Trường
resourceName

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 thành phần có dạng như sau:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

Nhóm thành phần mà thành phần của 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.

fieldType

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

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

AssetFieldType

Enum mô tả các vị trí có thể đặt một tài sản.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
HEADLINE Tài sản đó được liên kết để sử dụng làm dòng tiêu đề.
DESCRIPTION Tài sản được liên kết để sử dụng làm nội dung mô tả.
MANDATORY_AD_TEXT Thành phần đó được liên kết để sử dụng dưới dạng văn bản quảng cáo bắt buộc.
MARKETING_IMAGE Tài sản đó được liên kết để sử dụng làm hình ảnh tiếp thị.
MEDIA_BUNDLE Tài sản này được liên kết để sử dụng làm gói phương tiện.
YOUTUBE_VIDEO Tài sản này được liên kết để sử dụng dưới dạng video trên YouTube.
BOOK_ON_GOOGLE Thành phần này được liên kết để cho biết rằng một chiến dịch khách sạn đang bật tính năng "Đặt phòng trên Google".
LEAD_FORM Thành phần này được liên kết để sử dụng dưới dạng phần mở rộng về Biểu mẫu khách hàng tiềm năng.
PROMOTION Thành phần này được liên kết để dùng làm phần mở rộng về khuyến mãi.
CALLOUT Thành phần này được liên kết để sử dụng dưới dạng Phần mở rộng về chú thích.
STRUCTURED_SNIPPET Thành phần này được liên kết để sử dụng dưới dạng phần mở rộng về Đoạn thông tin có cấu trúc.
MOBILE_APP Thành phần này được liên kết để sử dụng dưới dạng Phần mở rộng về ứng dụng di động.
HOTEL_CALLOUT Thành phần này được liên kết để sử dụng làm phần mở rộng về chú thích cho khách sạn.
CALL Thành phần này được liên kết để sử dụng làm Phần mở rộng về cuộc gọi.
PRICE Thành phần này được liên kết để dùng làm phần mở rộng về giá.
LONG_HEADLINE Tài sản đó được liên kết để sử dụng dưới dạng dòng tiêu đề dài.
BUSINESS_NAME Thành phần này được liên kết để sử dụng làm tên doanh nghiệp.
SQUARE_MARKETING_IMAGE Thành phần này được liên kết để sử dụng làm hình ảnh tiếp thị dạng vuông.
PORTRAIT_MARKETING_IMAGE Thành phần này được liên kết để sử dụng làm hình ảnh tiếp thị dọc.
VIDEO Tài sản này được liên kết để sử dụng làm biểu trưng không phải của YouTube.
CALL_TO_ACTION_SELECTION Thành phần này được liên kết để có thể chọn một lời kêu gọi hành động.
AD_IMAGE Thành phần này được liên kết để có thể chọn hình ảnh quảng cáo.
HOTEL_PROPERTY Thành phần này được liên kết để sử dụng dưới dạng cơ sở lưu trú khách sạn trong chiến dịch Tối đa hoá hiệu suất cho các mục tiêu trong ngành du lịch.

AssetGroupSignal

AssetGroupSignal biểu thị tín hiệu trong một 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 để 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.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Trường
resourceName

string

Tên tài nguyên của tín hiệu về 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/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Nhóm thành phần chứa tín hiệu của nhóm thành phần này.

Trường hợp signal. Tín hiệu của nhóm thành phần. signal chỉ có thể là một trong những trạng thái sau:
audience

object (AudienceInfo)

Tín hiệu về đối tượng mà chiến dịch tối đa hoá hiệu suất sử dụng.

AudienceInfo

Tiêu chí đối tượng.

Biểu diễn dưới dạng JSON
{
  "audience": string
}
Trường
audience

string

Tên tài nguyên cho đối tượng.

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.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Trường
resourceName

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 của bộ lọc nhóm trang thông tin của nhóm thành phần có dạng:

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

assetGroup

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

string (int64 format)

Mã của ListGroupFilter.

type

enum (ListingGroupFilterType)

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

vertical

enum (ListingGroupFilterVertical)

Chiều dọc mà cây nút hiện tại đại diện. Tất cả các nút trong cùng một cây phải thuộc cùng một ngành dọc.

caseValue

object (ListingGroupFilterDimension)

Giá trị phương diện mà nhóm trang thông tin này đang tinh chỉnh lại giá trị gốc. Chưa xác định đối với nhóm gốc.

parentListingGroupFilter

string

Tên tài nguyên của nhóm trang thông tin gốc phụ. Có giá trị rỗng đối với nút bộ lọc nhóm trang thông tin gốc.

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SUBDIVISION Phân mục sản phẩm theo một số phương diện trang thông tin.
UNIT_INCLUDED Một nút lá bộ lọc cho nhóm trang thông tin được đưa vào.
UNIT_EXCLUDED Một nút lá bộ lọc của nhóm trang thông tin bị loại trừ.

ListingGroupFilterVertical

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SHOPPING Đại diện cho ngành dọc mua sắm. Bạn chỉ được phép sử dụng ngành dọc trong chiến dịch Tối đa hoá hiệu suất cho hoạt động bán lẻ.

ListingGroupFilterDimension

Các 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.

Biểu diễn dưới dạng JSON
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Trường
Trường hợp dimension. Phương diện thuộc một trong các loại bên dưới luôn hiển thị. dimension chỉ có thể là một trong những trạng thái sau:
productBiddingCategory

object (ProductBiddingCategory)

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

productBrand

object (ProductBrand)

Thương hiệu của sản phẩm.

productChannel

object (ProductChannel)

Thành phố của sản phẩm được chào bán.

productCondition

object (ProductCondition)

Điều kiện của sản phẩm.

productCustomAttribute

object (ProductCustomAttribute)

Thuộc tính tuỳ chỉnh của một sản phẩm.

productItemId

object (ProductItemId)

Mã mặt hàng của một sản phẩm.

productType

object (ProductType)

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

ProductBiddingCategory

Một yếu tố của danh mục đặt giá thầu ở cấp nhất định. Danh mục cấp cao nhất ở cấp 1, con của chúng ở 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).

Biểu diễn dưới dạng JSON
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Trường
level

enum (ListingGroupFilterBiddingCategoryLevel)

Cho biết cấp của danh mục trong cách phân loại.

id

string (int64 format)

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

ListingGroupFilterBiddingCategoryLevel

Cấp độ của danh mục đặt giá thầu theo bộ lọc nhóm trang thông tin.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LEVEL1 Cấp độ 1.
LEVEL2 Cấp độ 2.
LEVEL3 Cấp 3.
LEVEL4 Cấp 4.
LEVEL5 Cấp 5.

ProductBrand

Thương hiệu của sản phẩm.

Biểu diễn dưới dạng JSON
{
  "value": string
}
Trường
value

string

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

ProductChannel

Thành phố của sản phẩm được chào bán.

Biểu diễn dưới dạng JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Trường
channel

enum (ListingGroupFilterProductChannel)

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

ListingGroupFilterProductChannel

Enum mô tả vị trí của sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ONLINE Mặt hàng này được bán trên mạng.
LOCAL Mặt hàng này được bán tại các cửa hàng địa phương.

ProductCondition

Điều kiện của sản phẩm.

Biểu diễn dưới dạng JSON
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Trường
condition

enum (ListingGroupFilterProductCondition)

Giá trị của điều kiện.

ListingGroupFilterProductCondition

Enum mô tả điều kiện của ưu đãi sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
NEW Tình trạng sản phẩm là mới.
REFURBISHED Tình trạng sản phẩm là đã được tân trang.
USED Điều kiện sản phẩm được sử dụng.

ProductCustomAttribute

Thuộc tính tuỳ chỉnh của một sản phẩm.

Biểu diễn dưới dạng JSON
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Trường
index

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

ListingGroupFilterCustomAttributeIndex

Chỉ mục của các thuộc tính khách hàng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
INDEX0 Thuộc tính tuỳ chỉnh cho bộ lọc nhóm trang thông tin đầu tiên.
INDEX1 Thuộc tính tuỳ chỉnh của bộ lọc nhóm trang thông tin thứ hai.
INDEX2 Thuộc tính tuỳ chỉnh của bộ lọc nhóm trang thông tin thứ ba.
INDEX3 Thuộc tính tuỳ chỉnh của bộ lọc nhóm trang thông tin thứ tư.
INDEX4 Thuộc tính tuỳ chỉnh của bộ lọc nhóm trang thông tin thứ năm.

ProductItemId

Mã mặt hàng của một sản phẩm.

Biểu diễn dưới dạng JSON
{
  "value": string
}
Trường
value

string

Giá trị của mã nhận dạng.

ProductType

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

Biểu diễn dưới dạng JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Trường
level

enum (ListingGroupFilterProductTypeLevel)

Cấp của loại.

value

string

Giá trị của loại.

ListingGroupFilterProductTypeLevel

Enum mô tả cấp độ của loại sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LEVEL1 Cấp độ 1.
LEVEL2 Cấp độ 2.
LEVEL3 Cấp 3.
LEVEL4 Cấp 4.
LEVEL5 Cấp 5.

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.

Biểu diễn dưới dạng JSON
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Trường
dimensions[]

object (ListingGroupFilterDimension)

Đường dẫn đầy đủ của các phương diện thông qua hệ phân cấp bộ lọc của 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.

AssetGroupTopCombinationView

Chế độ xem về việc sử dụng tổ hợp thành phần quảng cáo của nhóm quảng cáo.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem kết hợp hàng đầu của nhóm thành phần. Tên tài nguyên chế độ xem kết hợp hàng đầu của AssetGroup có dạng: ""hotels/{customerId}/assetGroupTopỤViews/{asset_group_id}~{asset_join_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Những kiểu kết hợp thành phần quảng cáo hiệu quả nhất được phân phát cùng nhau.

AssetGroupAssetCombinationData

Dữ liệu kết hợp thành phần của nhóm thành phần

Biểu diễn dưới dạng JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Trường
assetCombinationServedAssets[]

object (AssetUsage)

Nội dung được phân phát.

AssetUsage

Chứa thông tin về việc sử dụng của tài sản.

Biểu diễn dưới dạng JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Trường
asset

string

Tên tài nguyên của tài sản.

servedAssetFieldType

enum (ServedAssetFieldType)

Loại trường phân phát của tài sản.

ServedAssetFieldType

Các loại trường tài sản có thể có.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

HEADLINE_1 Thành phần này được sử dụng trong dòng tiêu đề 1.
HEADLINE_2 Thành phần này được sử dụng trong dòng tiêu đề 2.
HEADLINE_3 Thành phần này được sử dụng trong dòng tiêu đề 3.
DESCRIPTION_1 Thành phần này được sử dụng trong dòng mô tả 1.
DESCRIPTION_2 Thành phần này được sử dụng trong dòng mô tả 2.
HEADLINE Tài sản này được sử dụng trong một dòng tiêu đề. Chỉ sử dụng thuộc tính này nếu quảng cáo chỉ có một dòng tiêu đề. Nếu không, hãy sử dụng HEADLINE_1, HEADLINE_2 hoặc HEADLINE_3 enum
HEADLINE_IN_PORTRAIT Thành phần này được dùng làm dòng tiêu đề trong hình ảnh dọc.
LONG_HEADLINE Thành phần này được dùng trong một dòng tiêu đề dài (dùng trong MultiAssetAssetAd).
DESCRIPTION Tài sản này được sử dụng trong nội dung mô tả. Chỉ sử dụng thuộc tính này nếu quảng cáo chỉ có một nội dung mô tả. Nếu không, hãy sử dụng giá trị enum DESCRIPTION_1 hoặc DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT Thành phần được dùng làm nội dung mô tả trong hình ảnh dọc.
BUSINESS_NAME_IN_PORTRAIT Thành phần này được dùng làm tên doanh nghiệp trong hình ảnh dọc.
BUSINESS_NAME Thành phần này được dùng làm tên doanh nghiệp.
MARKETING_IMAGE Tài sản này được dùng làm hình ảnh tiếp thị.
MARKETING_IMAGE_IN_PORTRAIT Thành phần này được dùng làm hình ảnh tiếp thị trong hình ảnh dọc.
SQUARE_MARKETING_IMAGE Thành phần này được dùng làm hình ảnh tiếp thị hình vuông.
PORTRAIT_MARKETING_IMAGE Thành phần này được dùng làm hình ảnh tiếp thị dọc.
CALL_TO_ACTION Thành phần này được dùng làm lời kêu gọi hành động.
YOU_TUBE_VIDEO Tài sản này được dùng làm video trên YouTube.
CALL Thành phần này được dùng làm một cuộc gọi.
MOBILE_APP Thành phần này được dùng làm ứng dụng di động.
CALLOUT Thành phần này được dùng làm chú thích.
STRUCTURED_SNIPPET Thành phần này được dùng làm đoạn thông tin có cấu trúc.
PRICE Thành phần này được dùng làm giá.
PROMOTION Thành phần này được dùng làm chương trình khuyến mãi.
AD_IMAGE Thành phần này được dùng làm hình ảnh.
LEAD_FORM Thành phần này được dùng làm biểu mẫu khách hàng tiềm năng.

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.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Trường
resourceName

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/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

Mã của nhóm tài sản.

campaign

string

Chiến dịch được liên kết với nhóm thành phần này. Tài sả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. Mã này phải có độ dài tối thiểu là 1 và tối đa là 128. Giá trị này phải là duy nhất trong một chiến dịch.

finalUrls[]

string

Danh sách các URL cuối cùng sau tất cả các lần chuyển hướng tên miền chéo. Trong chiến dịch Tối đa hoá hiệu suất, theo mặc định, các URL đủ điều kiện để mở rộng trừ phi bạn chọn không sử dụng.

finalMobileUrls[]

string

Danh sách các URL cuối cùng trên thiết bị di động sau tất cả các lần chuyển hướng nhiều miền. Trong chiến dịch Tối đa hoá hiệu suất, theo mặc định, các URL đủ điều kiện để mở rộng trừ phi bạn chọn không sử dụng.

status

enum (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 được 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 được hiển thị trong quảng cáo. Bạn chỉ có thể đặt trường này khi đã đặt đường dẫn 1.

adStrength

enum (AdStrength)

Độ mạnh tổng thể của quảng cáo trong nhóm thành phần này.

AssetGroupStatus

Các trạng thái có thể có của một nhóm thành phần.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận.
ENABLED Nhóm thành phần này đã được bật.
PAUSED Nhóm thành phần đã bị tạm dừng.
REMOVED Nhóm thành phần này đã bị xoá.

AdStrength

Enum liệt kê các độ mạnh của quảng cáo có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
PENDING Độ mạnh của quảng cáo hiện đang chờ xử lý.
NO_ADS Không tạo được quảng cáo nào.
POOR Sức mạnh kém.
AVERAGE Độ mạnh trung bình.
GOOD Sức mạnh tốt.
EXCELLENT Sức mạnh vượt trội.

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. Khi thêm một AssetSetAsset, những thành phần sẽ được liên kết với một nhóm thành phần.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Trường
resourceName

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

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

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

asset

string

Tài sản mà thành phần của nhóm thành phần này đang liên kết đến.

status

enum (AssetSetAssetStatus)

Trạng thái của thành phần nhóm thành phần. Chỉ đọc.

AssetSetAssetStatus

Các trạng thái có thể có của thành phần trong nhóm thành phần.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Phiên bản này không xác định giá trị đã nhận. Đây là giá trị chỉ phản hồi.
ENABLED Thành phần nhóm thành phần đã được bật.
REMOVED Thành phần bộ thành phần đã bị xoá.

AssetSet

Một tập hợp 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.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "resourceName": string
}
Trường
id

string (int64 format)

Mã của nhóm tài sản.

resourceName

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/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Chiến lược đặt giá thầu.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Trường
resourceName

string

Tên tài nguyên của chiến lược đặt giá thầu. Tên tài nguyên của chiến lược đặt giá thầu có dạng:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

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

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

type

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

currencyCode

string

Đơn vị tiền tệ mà chiến lược đặt giá thầu sử dụng (mã gồm ba chữ cái theo ISO 4217).

Đối với các chiến lược đặt giá thầu của khách hàng là người quản lý, đơn vị tiền tệ này có thể được đặt khi tạo và mặc định là đơn vị tiền tệ của khách hàng người quản lý. Để phân phát quảng cáo cho khách hàng, bạn không thể đặt trường này; tất cả các chiến lược của 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 đó. Trong mọi trường hợp, trường valid CurrencyCode sẽ trả về đơn vị tiền tệ mà chiến lược sử dụng.

id

string (int64 format)

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

name

string

Tên của chiến lược đặt giá thầu. Bạn phải đặt tên riêng biệt cho tất cả các chiến lược đặt giá thầu trong một tài khoản.

Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 255, tính bằng byte UTF-8, (được cắt bớt).

effectiveCurrencyCode

string

Đơn vị tiền tệ mà chiến lược đặt giá thầu sử dụng (mã gồm ba chữ cái theo ISO 4217).

Đối với các chiến lược đặt giá thầu dành cho khách hàng là người quản lý, đây là đơn vị tiền tệ do nhà quảng cáo đặt khi tạo chiến lược. Để phục vụ khách hàng, đây là CurrencyCode của khách hàng.

Các chỉ số về chiến lược đặt giá thầu được báo cáo bằng đơn vị tiền tệ này.

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

campaignCount

string (int64 format)

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

nonRemovedCampaignCount

string (int64 format)

Số lượng chiến dịch chưa bị xóa được đính kèm với chiến lược đặt giá thầu này.

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

Trường hợp scheme. Lược đồ đặt giá thầu.

Bạn chỉ có thể đặt một hành động. scheme chỉ có thể là một trong những trạng thái sau:

enhancedCpc

object (EnhancedCpc)

Chiến lược đặt giá thầu sẽ tăng giá thầu cho các nhấp chuột dường như có nhiều khả năng dẫn đến chuyển đổi và giảm giá thầu cho các nhấp chuột mà chúng dường như ít có khả năng dẫn đến chuyển đổi.

maximizeConversionValue

object (MaximizeConversionValue)

Một chiến lược đặt giá thầu tự động giúp nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách của bạn.

maximizeConversions

object (MaximizeConversions)

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.

targetCpa

object (TargetCpa)

Chiến lược đặt giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

targetImpressionShare

object (TargetImpressionShare)

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

targetOutrankShare

object (TargetOutrankShare)

Chiến lược đặt giá thầu sẽ đặt giá thầu dựa trên tỷ lệ phần trăm mục tiêu của phiên đấu giá mà nhà quảng cáo nên 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 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 chiến dịch. Bạn có thể thay đổi các chiến lược đã điền sẵn giao thức này.

targetRoas

object (TargetRoas)

Chiến lược đặt giá thầu giúp bạn tối đa hóa doanh thu trong khi tính trung bình Lợi tức chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

targetSpend

object (TargetSpend)

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.

BiddingStrategyStatus

Các trạng thái có thể có của một BiddingStrategy.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Chiến lược đặt giá thầu đã được bật.
REMOVED Chiến lược đặt giá thầu đã bị xóa.

BiddingStrategyType

Enum mô tả các loại chiến lược đặt giá thầu có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
COMMISSION Phí hoa hồng là một chiến lược đặt giá thầu tự động, trong đó nhà quảng cáo trả một phần nhất định của giá trị lượt chuyển đổi.
ENHANCED_CPC CPC nâng cao là chiến lược đặt giá thầu giúp tăng giá thầu cho các lần nhấp dường như có nhiều khả năng dẫn đến lượt chuyển đổi và giảm giá thầu cho các lần nhấp mà chúng dường như ít có khả năng dẫn đến lượt chuyển đổi.
INVALID Chỉ dùng cho giá trị trả về. Cho biết rằng chiến dịch không có chiến lược đặt giá thầu. Điều này ngăn chiến dịch phân phát. Ví dụ: bạn có thể đính kèm một chiến dịch với chiến lược đặt giá thầu của người quản lý và sau đó, tài khoản phân phát bị huỷ liên kết khỏi tài khoản người quản lý. Trong trường hợp này, chiến dịch sẽ tự động bị tách khỏi chiến lược đặt giá thầu hiện không thể truy cập của người quản lý và chuyển sang loại chiến lược đặt giá thầu KHÔNG HỢP LỆ.
MANUAL_CPA 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.
MANUAL_CPC Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.
MANUAL_CPM Đặt giá thầu dựa trên hiển thị thủ công, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị.
MANUAL_CPV Chiến lược đặt giá thầu sẽ trả một số tiền có thể định cấu hình cho mỗi lượt xem video.
MAXIMIZE_CONVERSIONS Chiến lược đặt giá thầu tự động tối đa hoá số lượt chuyển đổi trong phạm vi ngân sách hằng ngày.
MAXIMIZE_CONVERSION_VALUE Một chiến lược đặt giá thầu tự động giúp tự động đặt giá thầu để tối đa hoá doanh thu trong khi chi tiêu ngân sách của bạn.
PAGE_ONE_PROMOTED Lược đồ đặt giá thầu được quảng cáo trang một, đặt giá thầu cpc tối đa để nhắm mục tiêu các hiển thị trên trang một hoặc trang một vị trí được quảng cáo trên google.com. Giá trị enum này không được dùng nữa.
PERCENT_CPC Tỷ lệ phần trăm Cpc là chiến lược đặt giá thầu, trong đó giá thầu là một phần so với giá quảng cáo cho một số hàng hoá hoặc dịch vụ.
TARGET_CPA CPA mục tiêu là chiến lược giá thầu 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 giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.
TARGET_CPM CPM mục tiêu là một chiến lược 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 hiển thị nhất có thể với mức chi phí mục tiêu cho mỗi nghìn lượt hiển thị (CPM) mà bạn đã đặt.
TARGET_IMPRESSION_SHARE Chiến lược đặt giá thầu tự động giúp đặt giá thầu sao cho 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).
TARGET_OUTRANK_SHARE Chia sẻ nâng thứ hạng mục tiêu là chiến lược đặt giá thầu tự động. Chiến lược này sẽ đặ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 nên xếp hạng cao hơn một đối thủ cạnh tranh cụ thể. Giá trị enum này không được dùng nữa.
TARGET_ROAS Lợi tức mục tiêu trên chi tiêu quảng cáo là một chiến lược đặt giá thầu tự động giúp bạn tối đa hóa doanh thu trong khi tính trung bình Lợi tức chi tiêu trung bình (ROAS) mục tiêu cụ thể.
TARGET_SPEND Chi tiêu mục tiêu là một chiến lược giá thầu tự động đặt giá thầu để giúp bạn nhận được nhiều lần nhấp nhất có thể trong phạm vi ngân sách của mình.

EnhancedCpc

Loại này không có trường.

Chiến lược đặt giá thầu tự động sẽ tăng giá thầu cho các nhấp chuột dường như có nhiều khả năng dẫn đến chuyển đổi và giảm giá thầu cho các nhấp chuột mà chúng dường như ít có khả năng dẫn đến chuyển đổi.

Chiến lược đặt giá thầu này không được dùng nữa và không thể tạo được nữa. Sử dụng ManualCpc với enhancedCpcEnabled được đặt thành true cho chức năng tương đương.

MaximizeConversionValue

Một chiến lược đặt giá thầu tự động giúp nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách của bạn.

Biểu diễn dưới dạng JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Trường
cpcBidCeilingMicros

string (int64 format)

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ý. Chỉ có thể thay đổi cho chiến lược đặt giá thầu danh mục đầu tư.

cpcBidFloorMicros

string (int64 format)

Giới hạn giá thầu tối thiểu 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ý. Chỉ có thể thay đổi cho chiến lược đặt giá thầu danh mục đầu tư.

targetRoas

number

Tuỳ chọn lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS). Nếu được đặt, chiến lược giá thầu sẽ tối đa hoá doanh thu với mức lợi tức mục tiêu trên chi tiêu quảng cáo trung bình. 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 phạm vi ngân sách.

MaximizeConversions

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.

Biểu diễn dưới dạng JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Trường
cpcBidCeilingMicros

string (int64 format)

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ý. Chỉ có thể thay đổi cho chiến lược đặt giá thầu danh mục đầu tư.

cpcBidFloorMicros

string (int64 format)

Giới hạn giá thầu tối thiểu 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ý. Chỉ có thể thay đổi cho chiến lược đặt giá thầu danh mục đầu tư.

targetCpaMicros

string (int64 format)

Chiến lược đặt giá thầu chi phí mục tiêu trên mỗi hành độ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 hành động chuyển đổi, được chỉ định bằng đơn vị một phần triệu của đơn vị tiền tệ của chiến lược đặt giá thầu. Nếu được đặt, chiến lược giá thầu này sẽ 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 hành động bằng hoặc thấp hơn. Nếu bạn không đặt CPA mục tiêu, thì chiến lược giá thầu sẽ hướng đến việc đạt được CPA thấp nhất có thể trong phạm vi ngân sách.

TargetCpa

Chiến lược đặt giá thầu tự động giúp đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

Biểu diễn dưới dạng JSON
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Trường
targetCpaMicros

string (int64 format)

Mục tiêu CPA trung bình. Mục tiêu này phải lớn hơn hoặc bằng đơn vị phải thanh toán tối thiểu dựa trên đơn vị tiền tệ của tài khoản.

cpcBidCeilingMicros

string (int64 format)

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ý. Bạn chỉ nên đặt thuộc tính này cho chiến lược giá thầu danh mục đầu tư.

cpcBidFloorMicros

string (int64 format)

Giới hạn giá thầu tối thiểu 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ý. Bạn chỉ nên đặt thuộc tính này cho chiến lược giá thầu danh mục đầu tư.

TargetImpressionShare

Chiến lược đặt giá thầu tự động giúp đặt giá thầu sao cho 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).

Biểu diễn dưới dạng JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Trường
location

enum (TargetImpressionShareLocation)

Vị trí được nhắm mục tiêu trên trang kết quả tìm kiếm.

locationFractionMicros

string (int64 format)

Tỷ lệ quảng cáo đã chọn sẽ được hiển thị ở vị trí được nhắm mục tiêu theo cực nhỏ. Ví dụ: 1% tương đương với 10.000.

cpcBidCeilingMicros

string (int64 format)

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 theo đơn vị cực nhỏ cục bộ.

TargetImpressionShareLocation

Enum mô tả các mục tiêu có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ANYWHERE_ON_PAGE Vị trí bất kỳ trên trang web.
TOP_OF_PAGE Hộp quảng cáo trên cùng.
ABSOLUTE_TOP_OF_PAGE Vị trí hàng đầu trong ô quảng cáo trên cùng.

TargetOutrankShare

Chiến lược đặt giá thầu tự động sẽ đặt giá thầu dựa trên tỷ lệ phiên đấu giá mục tiêu mà nhà quảng cáo có thể xếp hạng cao hơn một đối thủ cạnh tranh cụ thể. Chiến lược này không được dùng nữa.

Biểu diễn dưới dạng JSON
{
  "cpcBidCeilingMicros": string
}
Trường
cpcBidCeilingMicros

string (Int64Value format)

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

TargetRoas

Chiến lược đặt giá thầu tự động giúp bạn tối đa hóa doanh thu trong khi tính trung bình lợi tức chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

Biểu diễn dưới dạng JSON
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Trường
targetRoas

number

Bắt buộc. 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. Giá trị phải nằm trong khoảng từ 0,01 đến 1000,0.

cpcBidCeilingMicros

string (int64 format)

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ý. Bạn chỉ nên đặt thuộc tính này cho chiến lược giá thầu danh mục đầu tư.

cpcBidFloorMicros

string (int64 format)

Giới hạn giá thầu tối thiểu 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ý. Bạn chỉ nên đặt thuộc tính này cho chiến lược giá thầu danh mục đầu tư.

TargetSpend

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

Biểu diễn dưới dạng JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Trường
targetSpendMicros
(deprecated)

string (int64 format)

Mục tiêu chi tiêu để tối đa hoá số lượt nhấp. Bên đặt giá thầu TargetSpend sẽ cố gắng chi tiêu ít hơn giá trị này hoặc mức chi tiêu điều tiết tự nhiên. Nếu bạn không chỉ định, ngân sách sẽ được dùng làm mục tiêu chi tiêu. Trường này không được dùng nữa và sẽ không được sử dụng nữa. Hãy tham khảo https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html để biết thông tin chi tiết.

cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Trường
resourceName

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/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

Cách phân phối xác định tỷ lệ chi tiêu ngân sách chiến dịch.

Giá trị mặc định là STANDARD nếu bạn không chỉ định trong tác vụ tạo.

period

enum (BudgetPeriod)

Khoảng thời gian để chi tiêu ngân sách. Giá trị mặc định là NGÀY nếu không được chỉ định.

amountMicros

string (int64 format)

Số tiền ngân sách, theo nội tệ cho tài khoản. Số tiền được chỉ định bằng micrô, 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 gấp 30,4 lần số tiền này.

BudgetDeliveryMethod

Các phương pháp phân phối Ngân sách có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
STANDARD Máy chủ ngân sách sẽ điều tiết hoạt động phân phát đồng đều trong toàn bộ khoảng thời gian.
ACCELERATED Máy chủ ngân sách sẽ không hạn chế việc phân phát và quảng cáo sẽ phân phát nhanh nhất có thể.

BudgetPeriod

Khoảng thời gian có thể có của Ngân sách.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
DAILY Ngân sách hàng ngày.
FIXED_DAILY Ngân sách hằng ngày cố định.
CUSTOM_PERIOD Bạn có thể sử dụng ngân sách tùy chỉnh cùng với total_amount để chỉ định giới hạn ngân sách toàn thời gian.

Chiến dịch

Chiến dịch.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Trường
resourceName

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/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

Trạng thái của chiến dịch.

Khi một chiến dịch mới được thêm vào, trạng thái mặc định là ĐÃ BẬT.

servingStatus

enum (CampaignServingStatus)

Trạng thái phân phát quảng cáo của chiến dịch.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Trạng thái hệ thống của chiến lược đặt giá thầu của chiến dịch.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Trạng thái tối ưu hóa việc phân phát quảng cáo của chiến dịch.

advertisingChannelType

enum (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 lựa chọn nhắm mục tiêu trong networkSettings.

Đâ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 khi đang tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Không bắt buộc phải điều chỉnh thành advertisingChannelType. Phải là loại phụ hợp lệ của loại kênh chính.

Bạn chỉ có thể đặt khi đang 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.

urlCustomParameters[]

object (CustomParameter)

Danh sách các mối liên kết dùng để thay thế các thẻ thông số tuỳ chỉnh trong trackingUrlTemplate, finalUrls hoặc mobile_final_urls.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Cài đặt cho Đặt giá thầu thời gian thực, một tính năng chỉ có sẵn cho các chiến dịch nhắm mục tiêu mạng Ad Exchange.

networkSettings

object (NetworkSettings)

Chế độ cài đặt mạng cho chiến dịch.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA).

shoppingSetting

object (ShoppingSetting)

Chế độ cài đặt để kiểm soát chiến dịch Mua sắm.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Chế độ cài đặt cho quảng cáo nhắm mục tiêu theo địa lý.

labels[]

string

Tên tài nguyên của các nhãn được đính kèm với chiến dịch này.

biddingStrategyType

enum (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 thiết lập lược đồ đặt giá thầu để tạo chiến lược đặt giá thầu chuẩn hoặc tạo trường biddingStrategy để tạo chiến lược giá thầu danh mục đầu tư.

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

accessibleBiddingStrategy

string

Tên tài nguyên của AccessibleBiddingStrategy, một chế độ xem chỉ có thể đọ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ư đính kèm được xác định bởi "biddingStrategy". 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 thuộc tính chiến lược không bị hạn chế từ tài nguyên AccessibleBiddingStrategy. Ngược lại, các thuộc tính bị hạn chế chỉ có sẵn cho khách hàng là chủ sở hữu của chiến lược và người quản lý của họ. Bạn chỉ có thể đọc các thuộc tính bị hạn chế từ tài nguyên BiddingStrategy.

frequencyCaps[]

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

selectiveOptimization

object (SelectiveOptimization)

Chế độ cài đặt tối ưu hoá có chọn lọc cho chiến dịch này, bao gồm một nhóm hành động chuyển đổi để tối ưu hoá chiến dịch này. Tính năng này chỉ áp dụng cho những chiến dịch quảng cáo ứng dụng sử dụng MULTI_CHANNEL dưới dạng AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT dưới dạng AdvertisingChannelSubType.

optimizationGoalSetting

object (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á.

trackingSetting

object (TrackingSetting)

Chế độ cài đặt cấp chiến dịch cho thông tin theo dõi.

engineId

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 tài khoản Google Ads (ví dụ: Yahoo Japan, Microsoft, Baidu, v.v.). Đối với pháp nhân Google Ads, hãy sử dụng "campaign.id".

excludedParentAssetFieldTypes[]

enum (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 ở cấp cao hơn.

createTime

string

Dấu thời gian khi chiến dịch này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss". Tính năng createTime sẽ không được dùng nữa trong phiên bản 1. Thay vào đó, hãy sử dụng createTime.

creationTime

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

lastModifiedTime

string

Ngày giờ khi chiến dịch này được sửa đổi lần cuối. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

id

string (int64 format)

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.

Mã không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD).

trackingUrlTemplate

string

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

campaignBudget

string

Ngân sách của chiến dịch.

startDate

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.

endDate

string

Ngày cuối cùng của chiến dịch phân phát theo múi giờ của khách hàng ở định dạng YYYY-MM-DD. Khi tạo, mặc định là 2037-12-30, có nghĩa là chiến dịch sẽ chạy vô thời hạn. Để đặt chiến dịch hiện tại chạy vô thời hạn, hãy đặt trường này thành 2037-12-30.

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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 bạn chọn không sử dụng (true), thì chỉ những URL cuối cùng trong nhóm thành phần hoặc các URL được chỉ định trong Google Merchant Center của nhà quảng cáo hoặc nguồn cấp dữ liệu doanh nghiệp 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 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 có giá trị mặc định là false.

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

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

biddingStrategy

string

Chiến lược giá thầu danh mục đầu tư mà chiến dịch sử dụng.

manualCpa

object (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. Tính năng này chỉ được hỗ trợ cho các chiến dịch Dịch vụ địa phương.

manualCpc

object (ManualCpc)

Chiến lược đặt giá thầu CPC thủ công thông thường. Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.

manualCpm

object (ManualCpm)

Chiến lược đặt giá thầu CPM thủ công chuẩn. Đặt giá thầu dựa trên lượt hiển thị thủ công, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị.

maximizeConversions

object (MaximizeConversions)

Chiến lược đặt giá thầu Tối đa hóa lượt chuyển đổi chuẩn sẽ tự động tối đa hóa số lượt chuyển đổi trong khi chi tiêu ngân sách của bạn.

maximizeConversionValue

object (MaximizeConversionValue)

Chiến lược đặt giá thầu Tối đa hoá giá trị lượt chuyển đổi chuẩn sẽ tự động đặt giá thầu để tối đa hoá doanh thu trong khi chi tiêu ngân sách của bạn.

targetCpa

object (TargetCpa)

Chiến lược đặt giá thầu CPA mục 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 giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

targetImpressionShare

object (TargetImpressionShare)

Chiến lược đặt giá thầu theo Tỷ lệ hiển thị mục tiêu. Chiến lược đặt giá thầu tự động giúp đặt giá thầu để đạt được tỷ lệ phần trăm lượt hiển thị đã chọn.

targetRoas

object (TargetRoas)

Chiến lược đặt giá thầu theo lợi tức mục tiêu trên chi tiêu quảng cáo chuẩn, giúp tự động tối đa hóa doanh thu trong khi vẫn tính trung bình 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ể.

targetSpend

object (TargetSpend)

Chiến lược đặt giá thầu Chi tiêu mục tiêu chuẩn tự động đặt giá thầu để giúp bạn nhận được nhiều lần nhấp nhất có thể trong phạm vi ngân sách của mình.

percentCpc

object (PercentCpc)

Chiến lược đặt giá thầu theo Tỷ lệ phần trăm Cpc chuẩn, trong đó giá thầu là một phần của giá quảng cáo cho một số hàng hoá hoặc dịch vụ.

targetCpm

object (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ị.

CampaignStatus

Trạng thái có thể có của chiến dịch.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Chiến dịch đang hoạt động và có thể hiển thị quảng cáo.
PAUSED Người dùng đã tạm dừng chiến dịch.
REMOVED Chiến dịch đã bị xóa.

CampaignServingStatus

Các trạng thái phân phát có thể có của chiến dịch.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

SERVING Đang phân phát.
NONE Không nội dung nào.
ENDED Đã kết thúc.
PENDING Pending.
SUSPENDED Đã tạm ngưng.

BiddingStrategySystemStatus

Các trạng thái hệ thống có thể có của một BiddingStrategy.

Enum
UNSPECIFIED Các tín hiệu cho thấy đã xảy ra lỗi ngoài dự kiến, ví dụ: không tìm thấy loại chiến lược đặt giá thầu hoặc không tìm thấy thông tin trạng thái.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Chiến lược giá thầu đang hoạt động và AdWords không thể tìm thấy bất kỳ vấn đề cụ thể nào với chiến lược.
LEARNING_NEW Chiến lược giá thầu đang được học vì chiến lược giá thầu đã được tạo gần đây hoặc gần đây đã được kích hoạt lại.
LEARNING_SETTING_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây về chế độ cài đặt.
LEARNING_BUDGET_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây về ngân sách.
LEARNING_COMPOSITION_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây về số chiến dịch, nhóm quảng cáo hoặc từ khoá đi kèm.
LEARNING_CONVERSION_TYPE_CHANGE Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và khách hàng đã sửa đổi các loại chuyển đổi liên quan đến chiến lược giá thầu trong thời gian gần đây.
LEARNING_CONVERSION_SETTING_CHANGE Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và gần đây, khách hàng đã thay đổi chế độ cài đặt lượt chuyển đổi của mình.
LIMITED_BY_CPC_BID_CEILING Chiến lược giá thầu bị giới hạn bởi mức trần giá thầu.
LIMITED_BY_CPC_BID_FLOOR Chiến lược giá thầu bị giới hạn bởi giá thầu sàn.
LIMITED_BY_DATA Chiến lược giá thầu bị giới hạn bởi vì không có đủ lưu lượng truy cập chuyển đổi trong những tuần qua.
LIMITED_BY_BUDGET Một phần đáng kể các từ khoá trong chiến lược giá thầu này bị giới hạn theo ngân sách.
LIMITED_BY_LOW_PRIORITY_SPEND Chiến lược giá thầu không thể đạt đến mức chi tiêu mục tiêu bởi vì mức chi tiêu của chiến lược đã bị giảm mức độ ưu tiên.
LIMITED_BY_LOW_QUALITY Một phần đáng kể các từ khóa trong chiến lược giá thầu này có Điểm chất lượng thấp.
LIMITED_BY_INVENTORY Chiến lược giá thầu không thể chi tiêu hết ngân sách do phạm vi nhắm mục tiêu hẹp.
MISCONFIGURED_ZERO_ELIGIBILITY Thiếu tính năng theo dõi lượt chuyển đổi (không có ping) và/hoặc danh sách tái tiếp thị cho SSC.
MISCONFIGURED_CONVERSION_TYPES Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi, và khách hàng đang thiếu các loại chuyển đổi có thể được báo cáo cho chiến lược này.
MISCONFIGURED_CONVERSION_SETTINGS Chiến lược giá thầu phụ thuộc vào báo cáo lượt chuyển đổi và chế độ cài đặt lượt chuyển đổi của khách hàng bị định cấu hình sai.
MISCONFIGURED_SHARED_BUDGET Có các chiến dịch nằm ngoài chiến lược giá thầu có chia sẻ ngân sách với các chiến dịch được đưa vào chiến lược này.
MISCONFIGURED_STRATEGY_TYPE Chiến dịch có loại chiến lược không hợp lệ và không được phân phát.
PAUSED Chiến lược giá thầu không hoạt động. Không có chiến dịch, nhóm quảng cáo hoặc từ khóa đang hoạt động nào đi kèm với chiến lược giá thầu. Hoặc không có ngân sách đang hoạt động nào được kết nối với chiến lược giá thầu.
UNAVAILABLE Chiến lược giá thầu này hiện không hỗ trợ báo cáo trạng thái.
MULTIPLE_LEARNING Có nhiều trạng thái hệ thốngLEARNING_* cho chiến lược giá thầu này trong thời gian được đề cập.
MULTIPLE_LIMITED Có nhiều trạng thái hệ thống LIMITED_* cho chiến lược giá thầu này trong thời gian được đề cập.
MULTIPLE_MISCONFIGURED Có nhiều trạng thái hệ thống MISCONFIGURED_* cho chiến lược giá thầu này trong thời gian được đề cập.
MULTIPLE Có nhiều trạng thái hệ thống cho chiến lược giá thầu này trong thời gian được đề cập.

AdServingOptimizationStatus

Enum mô tả các trạng thái phân phát có thể có.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

OPTIMIZE Hoạt động phân phát quảng cáo được tối ưu hoá dựa trên tỷ lệ nhấp (CTR) của chiến dịch.
CONVERSION_OPTIMIZE Hoạt động phân phát quảng cáo được tối ưu hoá dựa trên CTR * Lượt chuyển đổi cho chiến dịch. Nếu chiến dịch không ở trong chiến lược đặt giá thầu bằng trình tối ưu hóa chuyển đổi, chiến dịch sẽ mặc định là TỐI ƯU HOÁ.
ROTATE Quảng cáo được xoay vòng đồng đều trong 90 ngày, sau đó được tối ưu hoá cho lượt nhấp.
ROTATE_INDEFINITELY Hiển thị quảng cáo có hiệu suất thấp hơn đồng đều hơn với các quảng cáo hoạt động tốt hơn và không tối ưu hóa.
UNAVAILABLE Trạng thái tối ưu hóa phân phát quảng cáo không có sẵn.

AdvertisingChannelType

Enum mô tả các loại kênh quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SEARCH Mạng tìm kiếm. Bao gồm chiến dịch hiển thị theo nhóm và chiến dịch Tìm kiếm trở lên.
DISPLAY Chỉ Mạng Hiển thị của Google.
SHOPPING Chiến dịch Mua sắm phân phát trên tài sản mua sắm và trên kết quả tìm kiếm trên google.com.
HOTEL Chiến dịch Quảng cáo khách sạn.
VIDEO Chiến dịch Video.
MULTI_CHANNEL Chiến dịch Quảng cáo ứng dụng và Chiến dịch quảng cáo ứng dụng để thúc đẩy sự tương tác chạy trên nhiều kênh.
LOCAL Chiến dịch quảng cáo địa phương.
SMART Chiến dịch Thông minh.
PERFORMANCE_MAX Chiến dịch Tối đa hoá hiệu suất.
LOCAL_SERVICES Chiến dịch dịch vụ địa phương.
DISCOVERY Chiến dịch Khám phá.
TRAVEL Chiến dịch Du lịch.

AdvertisingChannelSubType

Enum mô tả các loại kênh phụ.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng làm giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SEARCH_MOBILE_APP Chiến dịch Quảng cáo ứng dụng dành cho thiết bị di động để Tìm kiếm.
DISPLAY_MOBILE_APP Chiến dịch Quảng cáo ứng dụng di động cho Mạng Hiển thị.
SEARCH_EXPRESS Chiến dịch AdWords Express cho tìm kiếm.
DISPLAY_EXPRESS Chiến dịch AdWords Express để hiển thị.
SHOPPING_SMART_ADS chiến dịch Mua sắm thông minh.
DISPLAY_GMAIL_AD Chiến dịch quảng cáo Gmail.
DISPLAY_SMART_CAMPAIGN Chiến dịch hiển thị thông minh. Bạn không thể tạo các chiến dịch mới thuộc loại phụ này.
VIDEO_OUTSTREAM Chiến dịch video ngoài luồng phát.
VIDEO_ACTION Chiến dịch Video TrueView cho hành động.
VIDEO_NON_SKIPPABLE Chiến dịch video có quảng cáo dạng video không thể bỏ qua.
APP_CAMPAIGN Chiến dịch quảng cáo ứng dụng giúp bạn dễ dàng quảng bá ứng dụng Android hoặc iOS của mình trên các sản phẩm hàng đầu của Google (bao gồm Mạng Tìm kiếm, Play, YouTube và Mạng Hiển thị của Google).
APP_CAMPAIGN_FOR_ENGAGEMENT Chiến dịch quảng cáo ứng dụng để thúc đẩy sự tương tác, tập trung vào việc thúc đẩy mức độ tương tác lại với ứng dụng trên một số sản phẩm hàng đầu của Google (như Google Tìm kiếm, YouTube và Mạng Hiển thị của Google).
LOCAL_CAMPAIGN Các chiến dịch dành riêng cho quảng cáo địa phương.
SHOPPING_COMPARISON_LISTING_ADS Chiến dịch danh sách so sánh mua sắm.
SMART_CAMPAIGN Chiến dịch Thông minh chuẩn.
VIDEO_SEQUENCE Chiến dịch Video có quảng cáo dạng video theo trình tự.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Chiến dịch quảng cáo ứng dụng để thu hút lượt đăng ký trước, chuyên dùng để quảng cáo lượt đăng ký trước trên ứng dụng di động, nhắm đến nhiều kênh quảng cáo trên Google Play, YouTube và Mạng Hiển thị.
VIDEO_REACH_TARGET_FREQUENCY Chiến dịch Video tăng cường phạm vi tiếp cận sử dụng chiến lược đặt giá thầu Tần suất mục tiêu.
TRAVEL_ACTIVITIES Chiến dịch Hoạt động du lịch.

CustomParameter

Mối liên kết mà thẻ thông số tuỳ chỉnh có thể sử dụng trong trackingUrlTemplate, finalUrls hoặc mobile_final_urls.

Biểu diễn dưới dạng JSON
{
  "key": string,
  "value": string
}
Trường
key

string

Khoá khớp với tên thẻ thông số.

value

string

Giá trị cần thay thế.

RealTimeBiddingSetting

Cài đặt cho Đặt giá thầu thời gian thực, một tính năng chỉ có sẵn cho các chiến dịch nhắm mục tiêu mạng Ad Exchange.

Biểu diễn dưới dạng JSON
{
  "optIn": boolean
}
Trường
optIn

boolean

Chiến dịch có sử dụng tính năng đặt giá thầu theo thời gian thực hay không.

NetworkSettings

Chế độ cài đặt mạng cho chiến dịch.

Biểu diễn dưới dạng JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Trường
targetSearchNetwork

boolean

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

targetContentNetwork

boolean

Liệu quảng cáo có được phân phát ở 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í.

targetPartnerSearchNetwork

boolean

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.

DynamicSearchAdsSetting

Chế độ cài đặt để kiểm soát Quảng cáo tìm kiếm động (DSA).

Biểu diễn dưới dạng JSON
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Trường
domainName

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

languageCode

string

Bắt buộc. Mã ngôn ngữ chỉ định ngôn ngữ của miền, ví dụ: "en".

useSuppliedUrlsOnly

boolean

Liệu chiến dịch có chỉ sử dụng URL do nhà quảng cáo cung cấp hay không.

ShoppingSetting

Chế độ cài đặt cho chiến dịch Mua sắm. Xác định nhóm sản phẩm có thể được quảng cáo bằng chiến dịch này 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.

Biểu diễn dưới dạng JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Trường
feedLabel

string

Nhãn nguồn cấp dữ liệu của sản phẩm để đưa vào chiến dịch. Bạn chỉ có thể đặt một trong số feedLabel hoặc salesCountry. Nếu được sử dụng thay cho salesCountry, trường feedLabel sẽ chấp nhận mã quốc gia có 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.

useVehicleInventory

boolean

Liệu có nhắm đến kho trang thông tin xe hay không.

merchantId

string (int64 format)

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

salesCountry

string

Quốc gia bán của sản phẩm để đưa vào chiến dịch.

campaignPriority

integer

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ố lượng 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 cho chiến dịch Mua sắm, có các giá trị từ 0 đến 2 (bao gồm cả hai giá trị này). Đây là trường không bắt buộc đối với chiến dịch Mua sắm thông minh, nhưng bạn phải đặt trường này thành 3.

enableLocal

boolean

Có thêm các sản phẩm tại cửa hàng địa phương hay không.

GeoTargetTypeSetting

Đại diện cho một tập hợp các cài đặt liên quan đến nhắm mục tiêu theo địa lý của quảng cáo.

Biểu diễn dưới dạng JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Trường
positiveGeoTargetType

enum (PositiveGeoTargetType)

Chế độ cài đặt được dùng để nhắm mục tiêu khẳng định theo địa lý trong chiến dịch cụ thể này.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Tùy chọn 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.

PositiveGeoTargetType

Các loại mục tiêu địa lý khẳng định có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
PRESENCE_OR_INTEREST Chỉ định rằng quảng cáo được kích hoạt nếu người dùng ở những vị trí được nhắm mục tiêu hoặc thể hiện sự quan tâm đến những vị trí được nhắm mục tiêu của nhà quảng cáo.
SEARCH_INTEREST Chỉ định rằng quảng cáo được kích hoạt nếu người dùng tìm kiếm vị trí được nhắm mục tiêu của nhà quảng cáo. Tính năng này chỉ dùng được cho chiến dịch Tìm kiếm và chiến dịch Mua sắm thông thường.
PRESENCE Chỉ định rằng quảng cáo được kích hoạt nếu người dùng ở những vị trí mà nhà quảng cáo nhắm mục tiêu hoặc thường xuyên ở những vị trí đó.

NegativeGeoTargetType

Các loại mục tiêu địa lý phủ định có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
PRESENCE_OR_INTEREST Chỉ định rằng người dùng sẽ không nhìn thấy quảng cáo nếu họ đang ở hoặc thể hiện sự quan tâm đến các vị trí bị loại trừ của nhà quảng cáo.
PRESENCE Chỉ định rằng người dùng sẽ không nhìn thấy quảng cáo nếu họ ở các vị trí bị loại trừ của nhà quảng cáo.

FrequencyCapEntry

Loại này không có trường.

Quy tắc chỉ định số lần tối đa một quảng cáo (hoặc một số nhóm quảng cáo) có thể hiển thị cho người dùng trong một khoảng thời gian cụ thể.

SelectiveOptimization

Chế độ cài đặt tối ưu hoá có chọn lọc cho chiến dịch này, bao gồm một nhóm hành động chuyển đổi để tối ưu hoá chiến dịch này. Tính năng này chỉ áp dụng cho những chiến dịch quảng cáo ứng dụng sử dụng MULTI_CHANNEL dưới dạng AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT dưới dạng AdvertisingChannelSubType.

Biểu diễn dưới dạng JSON
{
  "conversionActions": [
    string
  ]
}
Trường
conversionActions[]

string

Nhóm hành động chuyển đổi đã chọn để tối ưu hoá chiến dịch này.

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

Biểu diễn dưới dạng JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Trường
optimizationGoalTypes[]

enum (OptimizationGoalType)

Danh sách các loại mục tiêu tối ưu hoá.

OptimizationGoalType

Loại mục tiêu tối ưu hoá

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng làm giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
CALL_CLICKS Tối ưu hóa cho số lần nhấp dẫn đến cuộc gọi. Lượt chuyển đổi từ lượt nhấp dẫn đến cuộc gọi là số lần mọi người chọn "Gọi" để liên hệ với một cửa hàng sau khi xem quảng cáo.
DRIVING_DIRECTIONS Tối ưu hoá cho chỉ đường lái xe. Lượt chuyển đổi về đường đi lái xe là những lần mọi người chọn "Xem đường đi" để đi đến một cửa hàng sau khi xem quảng cáo.
APP_PRE_REGISTRATION Tối ưu hoá cho lượt đăng ký trước. Lượt chuyển đổi đăng ký trước là số lượt đăng ký trước nhận được thông báo khi ứng dụng được phát hành.

TrackingSetting

Chế độ cài đặt cấp chiến dịch cho thông tin theo dõi.

Biểu diễn dưới dạng JSON
{
  "trackingUrl": string
}
Trường
trackingUrl

string

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

ManualCpa

Loại này không có trường.

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.

ManualCpc

Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.

Biểu diễn dưới dạng JSON
{
  "enhancedCpcEnabled": boolean
}
Trường
enhancedCpcEnabled

boolean

Liệu giá thầu có được nâng cao dựa trên dữ liệu trình tối ưu hóa chuyển đổi hay không.

ManualCpm

Loại này không có trường.

Đặt giá thầu dựa trên lượt hiển thị thủ công, trong đó người dùng trả tiền cho mỗi nghìn lượt hiển thị.

PercentCpc

Chiến lược đặt giá thầu mà giá thầu là một phần giá được quảng cáo cho một số hàng hoá hoặc dịch vụ.

Biểu diễn dưới dạng JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Trường
cpcBidCeilingMicros

string (int64 format)

Giới hạn giá thầu tối đa mà chiến lược giá thầu có thể đặt. Đây là trường không bắt buộc do nhà quảng cáo nhập vào và được chỉ định trong đơn vị cực nhỏ tại địa phương. Lưu ý: Giá trị 0 được diễn giải theo cách tương tự như việc không xác định giá thầu trần.

enhancedCpcEnabled

boolean

Điều chỉnh giá thầu cho mỗi phiên đấu giá lên hoặc xuống, tuỳ thuộc vào khả năng chuyển đổi. Giá thầu riêng lẻ có thể vượt quá cpcBidCeilingMicros, nhưng số tiền giá thầu trung bình cho một chiến dịch thì không.

TargetCpm

Loại này không có trường.

CPM mục tiêu (chi phí mỗi nghìn lượt hiển thị) là một chiến lược đặt giá thầu tự động. Chiến lược này sẽ đặt giá thầu để tối ưu hoá hiệu suất dựa trên CPM mục tiêu mà bạn đặt.

CampaignAsset

Đường liên kết giữa Chiến dịch và Thành phần.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Trường
resourceName

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/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (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 tài sản này.

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Trường
resourceName

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 thành phần có dạng như sau:

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

campaign

string

Chiến dịch được liên kết với tập hợp thành phần này.

assetSet

string

Nhóm thành phần được liên kết với chiến dịch.

status

enum (AssetSetLinkStatus)

Trạng thái của thành phần 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ừ sở thích và danh sách tiếp thị lại cho quảng cáo trên Mạng hiển thị và Mạng YouTube cũng như danh sách tiếp thị lại dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp theo tiêu chí chiến dịch và đố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.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

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:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Trường
resourceName

string

Tên tài nguyên của tiêu chí chiến dịch. Tên tài nguyên của tiêu chí chiến dịch có dạng:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

Tên hiển thị của tiêu chí.

Trường này bị bỏ qua đối với các trường hợp biến đổi.

type

enum (CriterionType)

Loại tiêu chí.

status

enum (CampaignCriterionStatus)

Trạng thái của tiêu chí.

lastModifiedTime

string

Ngày tháng mà tiêu chí chiến dịch này được sửa đổi lần gần đây nhất. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

criterionId

string (int64 format)

Mã của tiêu chí.

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

bidModifier

number

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

negative

boolean

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

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

Bạn phải đặt chính xác một thuộc tính. criterion chỉ có thể là một trong những trạng thái sau:

keyword

object (KeywordInfo)

Từ khoá.

location

object (LocationInfo)

Vị trí.

device

object (DeviceInfo)

Thiết bị.

ageRange

object (AgeRangeInfo)

Độ tuổi.

gender

object (GenderInfo)

Giới tính.

userList

object (UserListInfo)

Danh sách người dùng.

language

object (LanguageInfo)

Ngôn ngữ.

webpage

object (WebpageInfo)

Trang web.

locationGroup

object (LocationGroupInfo)

Nhóm địa điểm

CampaignCriterionStatus

Các trạng thái có thể có của Tiêu chí chiến dịch.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Tiêu chí chiến dịch đã được bật.
PAUSED Tiêu chí chiến dịch đã bị tạm dừng.
REMOVED Tiêu chí chiến dịch đã bị xóa.

LanguageInfo

Tiêu chí ngôn ngữ.

Biểu diễn dưới dạng JSON
{
  "languageConstant": string
}
Trường
languageConstant

string

Tên tài nguyên hằng số về ngôn ngữ.

LocationGroupInfo

Bán kính xung quanh danh sách các vị trí được chỉ định thông qua nguồn cấp dữ liệu.

Biểu diễn dưới dạng JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Trường
geoTargetConstants[]

string

(Các) hằng số mục tiêu theo vị trí địa lý giới hạn phạm vi khu vực địa lý trong nguồn cấp dữ liệu. Hiện tại, chúng tôi chỉ cho phép một hằng số mục tiêu địa lý.

radiusUnits

enum (LocationGroupRadiusUnits)

Đơn vị của bán kính. Dặm và mét được hỗ trợ cho các hằng số mục tiêu địa lý. Mili dặm và mét được hỗ trợ cho các nhóm mục trong nguồn cấp dữ liệu. Đây là yêu cầu bắt buộc và phải được đặt trong thao tác CREATE.

feedItemSets[]

string

FeedItemSets có FeedItems được nhắm mục tiêu. Nếu bạn chỉ định nhiều mã nhận dạng, thì tất cả các mục xuất hiện trong ít nhất một nhóm đều được nhắm mục tiêu. Không thể sử dụng trường này với geoTargetConstants. Đây là tính năng không bắt buộc và chỉ có thể thiết lập trong thao tác CREATE.

radius

string (int64 format)

Khoảng cách tính bằng đơn vị xác định bán kính xung quanh các vị trí được nhắm mục tiêu. Đây là yêu cầu bắt buộc và phải được đặt trong thao tác CREATE.

LocationGroupRadiusUnits

Đơn vị khoảng cách bán kính trong nhóm vị trí (ví dụ: MILES)

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
METERS Mét
MILES Dặm
MILLI_MILES Mili Dặm

CampaignLabel

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
Trường
resourceName

string

Tên tài nguyên. Tên tài nguyên nhãn của chiến dịch có dạng: customers/{customerId}/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.

CartDataSalesView

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem Lượt bán hàng dựa trên dữ liệu giỏ hàng. Tên tài nguyên chế độ xem lượt bán dữ liệu giỏ hàng có dạng: customers/{customerId}/cartDataSalesView

Đối tượng người xem

Đố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 của phân khúc (chẳng hạn như thông tin chi tiết về nhân khẩu học và đối tượng chung sở thích) để tạo đối tượng đại diện cho những phần trong phân khúc mục tiêu của bạn.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Trường
resourceName

string

Tên tài nguyên của đối tượng. Tên đối tượng có dạng:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

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 là duy nhất cho mọi đối tượng. Ảnh phải có độ 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.

ConversionAction

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Trường
resourceName

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/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Dấu thời gian của thời điểm tạo hoạt động Floodlight, theo định dạng ISO 8601.

status

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

enum (ConversionActionType)

Loại hành động chuyển đổi này.

category

enum (ConversionActionCategory)

Danh mục lượt chuyển đổi được báo cáo cho hành động chuyển đổi này.

valueSettings

object (ValueSettings)

Chế độ cài đặt liên quan đến giá trị cho sự kiện chuyển đổi được liên kết với hành động chuyển đổi này.

attributionModelSettings

object (AttributionModelSettings)

Chế độ cài đặt liên quan đến mô hình phân bổ của hành động chuyển đổi này.

floodlightSettings

object (FloodlightSettings)

Chế độ cài đặt Floodlight cho loại chuyển đổi Floodlight.

id

string (int64 format)

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.

primaryForGoal

boolean

Nếu giá trị primaryForObjective 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ả cá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, mục tiêu lượt chuyển đổi tuỳ chỉnh không tuân theo primaryForTarget, vì vậy, nếu một chiến dịch có một mục tiêu lượt chuyển đổi tuỳ chỉnh được định cấu hình với hành động chuyển đổi primaryForTarget = false, thì hành động chuyển đổi đó vẫn có thể đặt giá thầu. Theo mặc định, primaryForTarget sẽ là true nếu không được đặt. Trong V9, primaryForTarget chỉ có thể được đặt thành false sau khi tạo thông qua thao tác "update" vì nó không được khai báo là không bắt buộc.

ownerCustomer

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 tên rỗng nếu đây là hành động chuyển đổi do hệ thống xác định.

includeInClientAccountConversionsMetric

boolean

Liệu hành động chuyển đổi này có được đưa vào chỉ số "clientAccountConversions" hay không.

includeInConversionsMetric

boolean

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.

clickThroughLookbackWindowDays

string (int64 format)

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) đến một sự kiện chuyển đổi.

appId

string

Mã ứng dụng cho một hành động chuyển đổi ứng dụng.

ConversionActionStatus

Các trạng thái có thể có của một hành động chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Lượt chuyển đổi sẽ được ghi lại.
REMOVED Lượt chuyển đổi sẽ không được ghi lại.
HIDDEN Lượt chuyển đổi sẽ không được ghi lại và hành động chuyển đổi đó sẽ không xuất hiện trong giao diện người dùng.

ConversionActionType

Các loại hành động chuyển đổi có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AD_CALL Lượt chuyển đổi xảy ra khi người dùng nhấp vào phần mở rộng về cuộc gọi của một quảng cáo.
CLICK_TO_CALL Lượt chuyển đổi xảy ra khi người dùng nhấp vào một số điện thoại trên thiết bị di động.
GOOGLE_PLAY_DOWNLOAD Lượt chuyển đổi xảy ra khi người dùng tải một ứng dụng di động xuống từ Cửa hàng Google Play.
GOOGLE_PLAY_IN_APP_PURCHASE Lượt chuyển đổi xảy ra khi người dùng mua hàng trong một ứng dụng thông qua hệ thống thanh toán trên Android.
UPLOAD_CALLS Lượt chuyển đổi cuộc gọi được nhà quảng cáo theo dõi và tải lên.
UPLOAD_CLICKS Lượt chuyển đổi được nhà quảng cáo theo dõi và tải lên cùng với lượt nhấp được phân bổ.
WEBPAGE Các lượt chuyển đổi xảy ra trên trang web.
WEBSITE_CALL Chuyển đổi xảy ra khi người dùng gọi đến một số điện thoại được tạo động từ trang web của nhà quảng cáo.
STORE_SALES_DIRECT_UPLOAD Lượt chuyển đổi dẫn đến lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu do bên thứ nhất hoặc bên thứ ba của người bán tải lên. Chỉ những khách hàng có trong danh sách cho phép mới có thể sử dụng các loại tệp tải lên trực tiếp cho lượt bán hàng tại cửa hàng thực tế.
STORE_SALES Lượt chuyển đổi dẫn đến Lượt bán hàng tại cửa hàng thực tế dựa trên dữ liệu do bên thứ nhất hoặc bên thứ ba tải lên của người bán và/hoặc từ các giao dịch mua hàng tại cửa hàng thực tế bằng thẻ của các mạng thanh toán. Chỉ những khách hàng có trong danh sách cho phép mới có thể sử dụng các loại lượt bán hàng tại cửa hàng thực tế. Chỉ có thể đọc.
FIREBASE_ANDROID_FIRST_OPEN Lượt chuyển đổi khi mở ứng dụng Android lần đầu được theo dõi thông qua Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua hàng trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_ANDROID_CUSTOM Lượt chuyển đổi tuỳ chỉnh trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_IOS_FIRST_OPEN Lượt chuyển đổi khi mở ứng dụng iOS lần đầu được theo dõi thông qua Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua hàng trong ứng dụng dành cho iOS được theo dõi thông qua Firebase.
FIREBASE_IOS_CUSTOM Lượt chuyển đổi tuỳ chỉnh trong ứng dụng iOS được theo dõi thông qua Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Lượt chuyển đổi khi mở ứng dụng Android lần đầu được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua hàng trong ứng dụng Android được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Lượt chuyển đổi tuỳ chỉnh trong ứng dụng Android được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Lượt chuyển đổi khi mở ứng dụng iOS lần đầu được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua ứng dụng iOS trong ứng dụng được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Lượt chuyển đổi tuỳ chỉnh trên ứng dụng iOS được theo dõi thông qua Phân tích ứng dụng bên thứ ba.
ANDROID_APP_PRE_REGISTRATION Lượt chuyển đổi xảy ra khi người dùng đăng ký trước một ứng dụng di động trên Cửa hàng Google Play. Chỉ có thể đọc.
ANDROID_INSTALLS_ALL_OTHER_APPS Lượt chuyển đổi theo dõi tất cả các lượt tải xuống trên Google Play nhưng không được theo dõi theo một loại ứng dụng cụ thể. Chỉ có thể đọc.
FLOODLIGHT_ACTION Hoạt động Floodlight tính số lần người dùng đã truy cập vào một trang web cụ thể sau khi xem hoặc nhấp vào một trong các quảng cáo của nhà quảng cáo. Chỉ có thể đọc.
FLOODLIGHT_TRANSACTION Hoạt động Floodlight theo dõi số lượt bán hàng được thực hiện hoặc số lượng mặt hàng được mua. Cũng có thể thu thập tổng giá trị của mỗi lượt bán hàng. Chỉ có thể đọc.
GOOGLE_HOSTED Lượt chuyển đổi giúp theo dõi hành động liên quan đến địa điểm thực tế từ các sản phẩm và dịch vụ của Google sau khi tương tác với quảng cáo. Chỉ có thể đọc.
LEAD_FORM_SUBMIT Lượt chuyển đổi sẽ được báo cáo khi người dùng gửi biểu mẫu khách hàng tiềm năng. Chỉ có thể đọc.
SALESFORCE Lượt chuyển đổi đến từ Salesforce. Chỉ có thể đọc.
SEARCH_ADS_360 Lượt chuyển đổi được nhập từ dữ liệu Floodlight của Search Ads 360. Chỉ có thể đọc.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Lượt chuyển đổi cuộc gọi xảy ra trên Quảng cáo chiến dịch Thông minh mà không cần thiết lập tính năng theo dõi cuộc gọi, bằng tiêu chí tùy chỉnh của Chiến dịch thông minh. Chỉ có thể đọc.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Người dùng nhấp vào một thành phần cuộc gọi trong Google Maps. Chỉ chiến dịch Thông minh. Chỉ có thể đọc.
SMART_CAMPAIGN_MAP_DIRECTIONS Người dùng yêu cầu chỉ đường đến vị trí của doanh nghiệp trong Google Maps. Chỉ chiến dịch Thông minh. Chỉ có thể đọc.
SMART_CAMPAIGN_TRACKED_CALLS Lượt chuyển đổi cuộc gọi xảy ra trên Quảng cáo chiến dịch Thông minh có chế độ thiết lập tính năng theo dõi cuộc gọi, bằng cách sử dụng tiêu chí tuỳ chỉnh của Chiến dịch thông minh. Chỉ có thể đọc.
STORE_VISITS Lượt chuyển đổi xảy ra khi người dùng ghé thăm cửa hàng bán lẻ của nhà quảng cáo. Chỉ có thể đọc.
WEBPAGE_CODELESS Lượt chuyển đổi được tạo từ các sự kiện trên trang web (chẳng hạn như gửi biểu mẫu hoặc tải trang) mà không sử dụng các đoạn mã sự kiện được mã hoá riêng. Chỉ có thể đọc.
UNIVERSAL_ANALYTICS_GOAL Lượt chuyển đổi đến từ mục tiêu Universal Analytics đã liên kết.
UNIVERSAL_ANALYTICS_TRANSACTION Lượt chuyển đổi đến từ các giao dịch Universal Analytics được liên kết.
GOOGLE_ANALYTICS_4_CUSTOM Lượt chuyển đổi đến từ lượt chuyển đổi sự kiện tuỳ chỉnh Google Analytics 4 được liên kết.
GOOGLE_ANALYTICS_4_PURCHASE Lượt chuyển đổi đến từ các lượt chuyển đổi giao dịch mua được liên kết trên Google Analytics 4.

ConversionActionCategory

Danh mục lượt chuyển đổi được liên kết với một hành động chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
DEFAULT Danh mục mặc định.
PAGE_VIEW Người dùng truy cập vào một trang.
PURCHASE Sự kiện mua hàng, bán hàng hoặc "đã đặt hàng".
SIGNUP Hành động đăng ký của người dùng.
LEAD Hành động tạo khách hàng tiềm năng.
DOWNLOAD Thao tác tải phần mềm xuống (như đối với ứng dụng).
ADD_TO_CART Thêm các mặt hàng vào giỏ hàng hoặc túi trên trang web của nhà quảng cáo.
BEGIN_CHECKOUT Khi có người tham gia quy trình thanh toán trên trang web của nhà quảng cáo.
SUBSCRIBE_PAID Bắt đầu gói thuê bao có tính phí cho một sản phẩm hoặc dịch vụ.
PHONE_CALL_LEAD Cuộc gọi để cho biết sự quan tâm đến sản phẩm/dịch vụ của nhà quảng cáo.
IMPORTED_LEAD Lượt chuyển đổi khách hàng tiềm năng được nhập từ một nguồn bên ngoài vào Google Ads.
SUBMIT_LEAD_FORM Lượt gửi biểu mẫu trên trang web của nhà quảng cáo cho thấy mối quan tâm đến doanh nghiệp.
BOOK_APPOINTMENT Đặt lịch hẹn với doanh nghiệp của một nhà quảng cáo.
REQUEST_QUOTE Yêu cầu báo giá hoặc yêu cầu ước tính giá.
GET_DIRECTIONS Lượt tìm kiếm địa điểm kinh doanh của một nhà quảng cáo có ý định ghé thăm.
OUTBOUND_CLICK Một lượt nhấp vào trang web của đối tác của nhà quảng cáo.
CONTACT Cuộc gọi, SMS, email, cuộc trò chuyện hoặc loại liên hệ khác với nhà quảng cáo.
ENGAGEMENT Một sự kiện tương tác trên trang web, chẳng hạn như thời gian trang web dài hoặc Mục tiêu thông minh của Google Analytics (GA). Dùng để nhập mục tiêu Vàng trên GA, Firebase và GA.
STORE_VISIT Lượt ghé thăm vị trí cửa hàng thực tế.
STORE_SALE Chương trình giảm giá diễn ra tại cửa hàng thực tế.
QUALIFIED_LEAD Lượt chuyển đổi tạo khách hàng tiềm năng được nhập từ một nguồn bên ngoài vào Google Ads và đã được nhà quảng cáo (nhóm tiếp thị/nhóm bán hàng) đủ tiêu chuẩn thêm. Trong hành trình đưa khách hàng tiềm năng đến quyết định mua hàng, nhà quảng cáo nhận được khách hàng tiềm năng, sau đó hành động dựa trên các khách hàng đó bằng cách tiếp cận người tiêu dùng. Nếu người tiêu dùng quan tâm và có thể quyết định mua sản phẩm, thì nhà quảng cáo sẽ đánh dấu những khách hàng tiềm năng đó là "khách hàng tiềm năng đủ tiêu chuẩn".
CONVERTED_LEAD Lượt chuyển đổi tạo khách hàng tiềm năng được nhập từ một nguồn bên ngoài vào Google Ads, đã hoàn thành thêm một giai đoạn do nhà quảng cáo tạo khách hàng tiềm năng xác định.

ValueSettings

Chế độ cài đặt liên quan đến giá trị cho sự kiện chuyển đổi được liên kết với hành động chuyển đổi này.

Biểu diễn dưới dạng JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Trường
defaultValue

number

Giá trị 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 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.

defaultCurrencyCode

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.

alwaysUseDefaultValue

boolean

Kiểm soát việc có 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 hay không.

AttributionModelSettings

Chế độ cài đặt liên quan đến mô hình phân bổ của hành động chuyển đổi này.

Biểu diễn dưới dạng JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Trường
attributionModel

enum (AttributionModel)

Loại mô hình phân bổ của hành động chuyển đổi này.

dataDrivenModelStatus

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

AttributionModel

Mô hình phân bổ mô tả cách phân bổ giá trị đóng góp cho một lượt chuyển đổi cụ thể trên nhiều lượt tương tác trước đó có thể xảy ra.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
EXTERNAL Sử dụng mô hình phân bổ bên ngoài.
GOOGLE_ADS_LAST_CLICK Phân bổ toàn bộ giá trị đóng góp để đạt được một lượt chuyển đổi cho lượt nhấp cuối cùng của lượt chuyển đổi đó.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Phân bổ toàn bộ giá trị đóng góp để đạt được một lượt chuyển đổi cho lượt nhấp đầu tiên của lượt chuyển đổi đó bằng mô hình phân bổ trên Google Tìm kiếm.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Phân bổ đều giá trị đóng góp cho một lượt chuyển đổi cho tất cả lượt nhấp vào lượt chuyển đổi đó bằng mô hình phân bổ trên Google Tìm kiếm.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Phân bổ giá trị đóng góp nhiều hơn theo cấp số nhân cho một lượt chuyển đổi cho các lượt nhấp gần đây hơn bằng cách sử dụng mô hình phân bổ của Google Tìm kiếm (chu kỳ phân nửa là 1 tuần).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 40% giá trị đóng góp để đạt được một lượt chuyển đổi đến từ lượt nhấp đầu tiên và lượt nhấp cuối cùng. 20% còn lại được phân bổ đồng đều cho tất cả các lượt nhấp khác. Chiến dịch này sử dụng mô hình phân bổ trên Google Tìm kiếm.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Mô hình linh hoạt sử dụng công nghệ học máy để xác định mức phân bổ giá trị đóng góp phù hợp cho các lượt nhấp bằng mô hình phân bổ trên Google Tìm kiếm.

DataDrivenModelStatus

Liệt kê các trạng thái của mô hình dựa trên dữ liệu.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AVAILABLE Hiện đã có mô hình dựa trên dữ liệu.
STALE Mô hình dựa trên dữ liệu đã lỗi thời. Thông tin này chưa được cập nhật trong ít nhất 7 ngày. Tệp này vẫn đang được sử dụng nhưng sẽ hết hạn nếu không được cập nhật trong 30 ngày.
EXPIRED Mô hình dựa trên dữ liệu đã hết hạn. Tệp này chưa được cập nhật trong ít nhất 30 ngày nên không thể sử dụng. Trường hợp phổ biến nhất là do chưa có đủ số lượng sự kiện cần thiết trong khoảng thời gian 30 ngày gần đây.
NEVER_GENERATED Mô hình dựa trên dữ liệu chưa từng được tạo. Trường hợp phổ biến nhất là do chưa từng có số lượng sự kiện cần thiết trong bất kỳ khoảng thời gian 30 ngày nào.

FloodlightSettings

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

Biểu diễn dưới dạng JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Trường
activityGroupTag

string

Chuỗi được dùng để xác định nhóm hoạt động Floodlight khi báo cáo lượt chuyển đổi.

activityTag

string

Chuỗi dùng để xác định một hoạt động Floodlight khi báo cáo lượt chuyển đổi.

activityId

string (int64 format)

Mã của hoạt động Floodlight trong Trình quản lý chiến dịch DoubleClick (DCM).

ConversionCustomVariable

Biến tuỳ chỉnh cho 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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Trường
resourceName

string

Tên tài nguyên của biến tuỳ chỉnh cho lượt chuyển đổi. Tên tài nguyên của biến tuỳ chỉnh cho lượt chuyển đổi có dạng:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

Mã của biến tuỳ chỉnh cho 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ư dấu cách trước và sau.

tag

string

Bắt buộc. Thẻ của biến tuỳ chỉnh cho lượt chuyển đổi. Thẻ phải là duy nhất và bao gồm trực tiếp ký tự "u" kèm theo một số nhỏ hơn hoặc bằng 100. Ví dụ: "u4".

status

enum (ConversionCustomVariableStatus)

Trạng thái của biến tuỳ chỉnh của lượt chuyển đổi cho tính năng tích luỹ sự kiện chuyển đổi.

ownerCustomer

string

Tên tài nguyên của khách hàng sở hữu biến tuỳ chỉnh của lượt chuyển đổi.

family

enum (ConversionCustomVariableFamily)

Nhóm của biến tuỳ chỉnh cho lượt chuyển đổi.

cardinality

enum (ConversionCustomVariableCardinality)

Lượng số của biến tuỳ chỉnh cho lượt chuyển đổi.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Các trường dành cho biến tuỳ chỉnh lượt chuyển đổi của Search Ads 360 sẽ Floodlight.

customColumnIds[]

string (int64 format)

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.

ConversionCustomVariableStatus

Các trạng thái có thể có của biến tuỳ chỉnh lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ACTIVATION_NEEDED

Biến tùy chỉnh của lượt chuyển đổi đang chờ kích hoạt và sẽ không tích lũy số liệu thống kê cho đến khi bạn đặt thành BẬT.

Bạn không thể dùng trạng thái này trong các yêu cầu TẠO và CẬP NHẬT.

ENABLED Biến tuỳ chỉnh của lượt chuyển đổi đã được bật và sẽ tích luỹ số liệu thống kê.
PAUSED Biến tùy chỉnh của lượt chuyển đổi đã bị tạm dừng và sẽ không tích luỹ số liệu thống kê cho đến khi bạn đặt thành BẬT lại.

ConversionCustomVariableFamily

Nhóm của một biến tuỳ chỉnh cho lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
STANDARD Biến tuỳ chỉnh cho lượt chuyển đổi chuẩn. Khách hàng phải kích hoạt trước khi sử dụng.
FLOODLIGHT Biến tuỳ chỉnh của lượt chuyển đổi được nhập từ một biến Floodlight tuỳ chỉnh.

ConversionCustomVariableCardinality

Lượng số của một biến tuỳ chỉnh lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
BELOW_ALL_LIMITS Biến tuỳ chỉnh về lượt chuyển đổi có số lượng giá trị riêng biệt thấp hơn tất cả các hạn mức. Bạn có thể dùng biến này để phân đoạn và số liệu thống kê có thể tích luỹ cho các giá trị mới nếu bạn bật biến này.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT Biến tuỳ chỉnh của lượt chuyển đổi có số lượng giá trị riêng biệt vượt quá hạn mức phân đoạn, nhưng không vượt quá giới hạn về số liệu thống kê. Phân đoạn sẽ bị vô hiệu hoá, nhưng số liệu thống kê có thể tích luỹ cho giá trị mới nếu biến được bật.
APPROACHES_STATS_LIMIT Biến tùy chỉnh của lượt chuyển đổi đã vượt quá giới hạn phân đoạn và sắp đạt đến giới hạn về số liệu thống kê (> 90%). Phân đoạn sẽ bị vô hiệu hoá, nhưng số liệu thống kê có thể tích luỹ cho giá trị mới nếu biến được bật.
EXCEEDS_STATS_LIMIT Biến tùy chỉnh của lượt chuyển đổi đã vượt quá cả giới hạn phân đoạn và giới hạn về số liệu thống kê. Tính năng phân đoạn sẽ bị vô hiệu hoá và số liệu thống kê cho biến đã bật chỉ có thể tích luỹ nếu các giá trị hiện tại không làm tăng thêm số lượng giá trị riêng biệt của biến.

FloodlightConversionCustomVariableInfo

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

Biểu diễn dưới dạng JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Trường
floodlightVariableType

enum (FloodlightVariableType)

Loại biến Floodlight được xác định trong Search Ads 360.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Loại dữ liệu biến Floodlight được xác định trong Search Ads 360.

FloodlightVariableType

Loại biến Floodlight, như xác định trong Search Ads 360. Hãy xem https://support.google.com/searchads/answer/4397154?hl=en để tìm hiểu thêm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
DIMENSION Loại biến Floodlight kích thước.
METRIC Loại biến Floodlight của chỉ số.
UNSET Chưa đặt loại biến Floodlight.

FloodlightVariableDataType

Loại dữ liệu của biến Floodlight, như xác định trong Search Ads 360. Hãy xem https://support.google.com/searchads/answer/4397154?hl=en để tìm hiểu thêm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
NUMBER Đại diện cho một biến Floodlight thuộc loại "Số". Biến này có thể được chỉ định cho các biến Floodlight thuộc loại DIMENSION hoặc METRIC.
STRING Đại diện cho một biến Floodlight thuộc loại "Chuỗi". Biến này có thể được chỉ định cho các biến Floodlight thuộc loại DIMENSION.

Khách hàng

Khách hàng.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Trường
resourceName

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/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Chế độ theo dõi lượt chuyển đổi cho khách hàng.

accountType

enum (AccountType)

Loại tài khoản công cụ, ví dụ: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track, v.v.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Cài đặt Trình quản lý chiến dịch DoubleClick (DCM) cho khách hàng là người quản lý.

accountStatus

enum (AccountStatus)

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

lastModifiedTime

string

Ngày giờ khi khách hàng này được sửa đổi lần gần đây nhất. Ngày giờ này theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss".

engineId

string

Mã của tài khoản trong tài khoản công cụ bên ngoài.

status

enum (CustomerStatus)

Trạng thái của khách hàng.

creationTime

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

string (int64 format)

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

descriptiveName

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.

currencyCode

string

Đơn vị tiền tệ mà tài khoản hoạt động. Có hỗ trợ một số mã đơn vị tiền tệ theo tiêu chuẩn ISO 4217.

timeZone

string

Mã múi giờ địa phương của khách hàng.

trackingUrlTemplate

string

Mẫu URL để tạo URL theo dõi ngoài các tham số.

finalUrlSuffix

string

Mẫu URL để thêm các tham số vào URL cuối cùng.

autoTaggingEnabled

boolean

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

manager

boolean

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

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.

Biểu diễn dưới dạng JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Trường
acceptedCustomerDataTerms

boolean

Liệu khách hàng đã chấp nhận các điều khoản về dữ liệu khách hàng hay chưa. Nếu bạn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị này sẽ được kế thừa từ người quản lý. Trường này chỉ để đọc. Để biết thêm thông tin, hãy xem https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

Trạng thái theo dõi lượt chuyển đổi. Thông tin 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à chủ sở hữu tính năng theo dõi lượt chuyển đổi của khách hàng này là ai. 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.

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

string

Tên tài nguyên của khách hàng nơi các lượt chuyển đổi được tạo và quản lý. Trường này chỉ để đọc.

conversionTrackingId

string (int64 format)

Mã theo dõi lượt chuyển đổi được 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 (conversionTrackingStatus). Trường này chỉ để đọc.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Mã theo dõi lượt chuyển đổi của người quản lý của khách hàng. Mã 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à ghi đè conversionTrackingId. 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.

crossAccountConversionTrackingId

string (int64 format)

Mã theo dõi lượt chuyển đổi của người quản lý của khách hàng. Mã 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à ghi đè conversionTrackingId.

ConversionTrackingStatus

Trạng thái Theo dõi lượt chuyển đổi của khách hàng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
NOT_CONVERSION_TRACKED Khách hàng không sử dụng bất kỳ tính năng theo dõi lượt chuyển đổi nào.
CONVERSION_TRACKING_MANAGED_BY_SELF Các hành động chuyển đổi do khách hàng này tạo và quản lý.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Các hành động chuyển đổi được tạo và quản lý bởi người quản lý được chỉ định trong login-customer-id của yêu cầu.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Các hành động chuyển đổi do người quản lý tạo và quản lý, không phải do khách hàng hoặc người quản lý được chỉ định trong login-customer-id của yêu cầu.

AccountType

Các loại tài khoản công cụ có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
BAIDU Tài khoản Baidu.
ENGINE_TRACK Tài khoản theo dõi công cụ.
FACEBOOK Tài khoản Facebook của bạn.
FACEBOOK_GATEWAY Tài khoản Facebook được quản lý thông qua cổng vào.
GOOGLE_ADS Tài khoản Google Ads của bạn.
MICROSOFT Tài khoản Microsoft Advertising.
SEARCH_ADS_360 Tài khoản người quản lý Search Ads 360.
YAHOO_JAPAN Tài khoản Yahoo Japan.

DoubleClickCampaignManagerSetting

Cài đặt Trình quản lý chiến dịch DoubleClick (DCM) cho khách hàng là người quản lý.

Biểu diễn dưới dạng JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Trường
advertiserId

string (int64 format)

Mã của nhà quảng cáo Campaign Manager được liên kết với khách hàng này.

networkId

string (int64 format)

Mã của mạng Campaign Manager được liên kết với khách hàng này.

timeZone

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ờ IANA, chẳng hạn như America/New_ xuyên.

AccountStatus

Trạng thái có thể có của một tài khoản.

Enum
UNSPECIFIED Giá trị mặc định.
UNKNOWN Giá trị không xác định.
ENABLED Tài khoản có thể phân phát quảng cáo.
PAUSED Người dùng đã huỷ kích hoạt tài khoản.
SUSPENDED Tài khoản đã bị huỷ kích hoạt theo quy trình nội bộ.
REMOVED Tài khoản bị vô hiệu hoá vĩnh viễn.
DRAFT Tài khoản vẫn đang trong quá trình thiết lập, chưa được BẬT.

CustomerStatus

Các trạng thái có thể có của khách hàng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Cho biết tài khoản đang hoạt động có thể phân phát quảng cáo.
CANCELED Cho biết tài khoản bị huỷ không thể phân phát quảng cáo. Người dùng quản trị có thể kích hoạt lại.
SUSPENDED Cho biết có tài khoản bị tạm ngưng không thể phân phát quảng cáo. Chỉ có nhóm hỗ trợ Google mới kích hoạt được.
CLOSED Cho biết có tài khoản đã đóng không thể phân phát quảng cáo. Tài khoản thử nghiệm cũng sẽ có trạng thái ĐÃ ĐÓNG. Trạng thái là vĩnh viễn và không thể mở lại được.

CustomerAsset

Mối liên kết giữa khách hàng và thành phần.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Trường
resourceName

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/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Bắt buộc. Thành phần được liên kết với khách hàng.

status

enum (AssetLinkStatus)

Trạng thái của thành phần khách hàng.

CustomerAssetSet

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Trường
resourceName

string

Tên tài nguyên của nhóm thành phần khách hàng. Tên tài nguyên thành phần của nhóm thành phần có dạng như sau:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Nhóm 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 tập hợp thành phần này.

status

enum (AssetSetLinkStatus)

Trạng thái của thành phần nhóm thành phần của khách hàng. Chỉ đọc.

AccessibleBiddingStrategy

Thể hiện chế độ xem Đấu thầu chiến lược thuộc sở hữu và được 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 thuộc sở hữu của người quản lý của khách hàng và được chia sẻ với khách hàng này, ngoài các chiến lược thuộc sở hữu của khách hàng này. Tài nguyên này không cung cấp các chỉ số và chỉ hiển thị một số ít các thuộc tính BiddingStrategy.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Trường
resourceName

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/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

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

enum (BiddingStrategyType)

Loại chiến lược đặt giá thầu.

ownerCustomerId

string (int64 format)

Mã của Khách hàng sở hữu chiến lược đặt giá thầu.

ownerDescriptiveName

string

descriptionName của Khách hàng sở hữu chiến lược đặt giá thầu.

Trường hợp scheme. Lược đồ đặt giá thầu.

Bạn chỉ có thể đặt một hành động. scheme chỉ có thể là một trong những trạng thái sau:

maximizeConversionValue

object (MaximizeConversionValue)

Một chiến lược đặt giá thầu tự động giúp nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách của bạn.

maximizeConversions

object (MaximizeConversions)

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.

targetCpa

object (TargetCpa)

Chiến lược đặt giá thầu sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

Chiến lược đặt giá thầu giúp bạn tối đa hóa doanh thu trong khi tính trung bình Lợi tức chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

targetSpend

object (TargetSpend)

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 nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách của bạn.

Biểu diễn dưới dạng JSON
{
  "targetRoas": number
}
Trường
targetRoas

number

Tuỳ chọn lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS). Nếu được đặt, chiến lược giá thầu sẽ tối đa hoá doanh thu với mức lợi tức mục tiêu trên chi tiêu quảng cáo trung bình. 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 phạm vi ngân sách.

MaximizeConversions

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.

Biểu diễn dưới dạng JSON
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Trường
targetCpa

string (int64 format)

Chi phí mục tiêu để 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 chuyển đổi.

targetCpaMicros

string (int64 format)

Chi phí mục tiêu để 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 chuyển đổi.

TargetCpa

Chiến lược đặt giá thầu tự động giúp đặt giá thầu để giúp bạn nhận được nhiều lượt chuyển đổi nhất có thể ở mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.

Biểu diễn dưới dạng JSON
{
  "targetCpaMicros": string
}
Trường
targetCpaMicros

string (int64 format)

Mục tiêu CPA trung bình. Mục tiêu này phải lớn hơn hoặc bằng đơn vị phải thanh toán 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 giúp đặt giá thầu sao cho 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).

Biểu diễn dưới dạng JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Trường
location

enum (TargetImpressionShareLocation)

Vị trí được nhắm mục tiêu trên trang kết quả tìm kiếm.

locationFractionMicros

string (int64 format)

Tỷ lệ quảng cáo đã chọn sẽ được hiển thị ở vị trí được nhắm mục tiêu theo cực nhỏ. Ví dụ: 1% tương đương với 10.000.

cpcBidCeilingMicros

string (int64 format)

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 theo đơn vị cực nhỏ cục bộ.

TargetRoas

Chiến lược đặt giá thầu tự động giúp bạn tối đa hóa doanh thu trong khi tính trung bình lợi tức chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

Biểu diễn dưới dạng JSON
{
  "targetRoas": number
}
Trường
targetRoas

number

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 giá thầu 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.

Biểu diễn dưới dạng JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Trường
targetSpendMicros
(deprecated)

string (int64 format)

Mục tiêu chi tiêu để tối đa hoá số lượt nhấp. Bên đặt giá thầu TargetSpend sẽ cố gắng chi tiêu ít hơn giá trị này hoặc mức chi tiêu điều tiết tự nhiên. Nếu bạn không chỉ định, ngân sách sẽ được dùng làm mục tiêu chi tiêu. Trường này không được dùng nữa và sẽ không được sử dụng nữa. Hãy tham khảo https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html để biết thông tin chi tiết.

cpcBidCeilingMicros

string (int64 format)

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

ManagerLinkStatus

Trạng thái có thể có của một đường liên kết.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ACTIVE Cho biết mối quan hệ hiện tại không có hiệu lực
INACTIVE Cho biết mối quan hệ bị chấm dứt
PENDING Cho biết mối quan hệ đã được người quản lý yêu cầu nhưng khách hàng chưa chấp nhận.
REFUSED Người quản lý đã yêu cầu mối quan hệ, nhưng khách hàng đã từ chối.
CANCELED Cho biết mối quan hệ đã được người quản lý yêu cầu nhưng người quản lý đã hủy mối quan hệ đó.

CustomerClient

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Trường
resourceName

string

Tên tài nguyên của khách hàng. Tên tài nguyên CustomerClient có dạng: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Tên tài nguyên của các nhãn thuộc sở hữu của khách hàng đưa ra yêu cầu được áp dụng cho khách hàng của khách hàng. Tên tài nguyên nhãn có dạng:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

Trạng thái của khách hàng là khách hàng. Chỉ có thể đọc.

clientCustomer

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

hidden

boolean

Chỉ định xem đây có phải là tài khoản ẩn hay không.

Chỉ có thể đọc.

level

string (int64 format)

Khoảng cách giữa một khách hàng nhất định và khách hàng đó. Đối với chế độ tự liên kết, giá trị cấp sẽ là 0. Chỉ có thể đọc.

timeZone

string

Chuỗi Kho lưu trữ dữ liệu ngôn ngữ chung (CLDR) thể hiện múi giờ của ứng dụng, ví dụ: America/Los_Angeles. Chỉ có thể đọc.

testAccount

boolean

Xác định xem khách hàng có phải là một tài khoản thử nghiệm hay không. Chỉ có thể đọc.

manager

boolean

Xác định xem khách hàng có phải là người quản lý hay không. Chỉ có thể đọc.

descriptiveName

string

Tên mô tả cho khách hàng. Chỉ có thể đọc.

currencyCode

string

Mã đơn vị tiền tệ (ví dụ: "USD", "EUR") của khách hàng. Chỉ có thể đọc.

id

string (int64 format)

Mã của khách hàng của khách hàng. Chỉ có thể đọc.

DynamicSearchAdsSearchTermView

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "landingPage": string
}
Trường
resourceName

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 chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động có dạng:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

URL trang đích được chọn linh động của lượt hiển thị.

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

GenderView

Chế độ xem theo giới tính. Tài nguyên giới tính phản ánh trạng thái phân phát hiệu quả, chứ không phải là tiêu chí nào được thêm. Một nhóm quảng cáo không có tiêu chí về giới tính theo mặc định hiển thị cho tất cả các giới tính, do đó, tất cả giới tính xuất hiện tronggenderView cùng với số liệu thống kê.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem giới tính. Tên tài nguyên chế độ xem theo giới tính có dạng:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Hằng số mục tiêu địa lý.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Trường
resourceName

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

enum (GeoTargetConstantStatus)

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

id

string (int64 format)

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

countryCode

string

Mã quốc gia theo ISO-3166-1 alpha-2 được liên kết với mục tiêu.

targetType

string

Loại mục tiêu hằng số mục tiêu địa lý.

canonicalName

string

Tên tiếng Anh đủ điều kiện, bao gồm tên của mục tiêu, tên gốc và quốc gia của mục tiêu.

parentGeoTarget

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}

GeoTargetConstantStatus

Trạng thái có thể có của một hằng số mục tiêu địa lý.

Enum
UNSPECIFIED Bạn chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định giá trị đã nhận.

Đây là giá trị chỉ phản hồi.

ENABLED Hằng số mục tiêu địa lý là hợp lệ.
REMOVAL_PLANNED Hằng số mục tiêu địa lý đã lỗi thời và sẽ bị xóa.

KeywordView

Chế độ xem từ khoá.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem từ khoá. Tên tài nguyên chế độ xem từ khoá có dạng:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Hãng nhạc

Nhãn.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Trường
resourceName

string

Tên tài nguyên. Tên tài nguyên nhãn có dạng: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

Trạng thái của nhãn. Chỉ có thể đọc.

textLabel

object (TextLabel)

Một loại nhãn hiển thị văn bản trên nền màu.

id

string (int64 format)

Mã nhận dạng của nhãn. Chỉ có thể đọc.

name

string

Tên nhãn.

Đây là trường bắt buộc và không được để trống khi tạo nhãn mới.

Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 80.

LabelStatus

Trạng thái có thể có của một nhãn.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Đã bật nhãn.
REMOVED Đã xóa nhãn.

TextLabel

Một loại nhãn hiển thị văn bản trên nền màu.

Biểu diễn dưới dạng JSON
{
  "backgroundColor": string,
  "description": string
}
Trường
backgroundColor

string

Màu nền của nhãn ở định dạng RGB. Chuỗi này phải khớp với biểu thức chính quy '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Lưu ý: Màu nền có thể không hiển thị cho tài khoản người quản lý.

description

string

Nội dung mô tả ngắn về nhãn. Độ dài không được quá 200 ký tự.

LanguageConstant

Ngôn ngữ.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Trường
resourceName

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/{criterionId}

id

string (int64 format)

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

boolean

Liệu ngôn ngữ có thể nhắm mục tiêu hay không.

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

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem vị trí. Tên tài nguyên chế độ xem vị trí có dạng:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Danh mục Đặt giá thầu sản phẩm.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Trường
resourceName

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/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Cấp của danh mục đặt giá thầu sản phẩm.

status

enum (ProductBiddingCategoryStatus)

Trạng thái của danh mục đặt giá thầu sản phẩm.

id

string (int64 format)

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.

countryCode

string

Mã quốc gia viết hoa gồm hai chữ cái của danh mục đặt giá thầu sản phẩm.

productBiddingCategoryConstantParent

string

Tên tài nguyên của danh mục đặt giá thầu sản phẩm chính.

languageCode

string

Mã ngôn ngữ của danh mục đặt giá thầu sản phẩm.

localizedName

string

Giá trị hiển thị của danh mục đặt giá thầu sản phẩm được bản địa hoá theo languageCode.

ProductBiddingCategoryLevel

Enum mô tả cấp của danh mục đặt giá thầu sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LEVEL1 Cấp độ 1.
LEVEL2 Cấp độ 2.
LEVEL3 Cấp 3.
LEVEL4 Cấp 4.
LEVEL5 Cấp 5.

ProductBiddingCategoryStatus

Enum mô tả trạng thái của danh mục đặt giá thầu sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ACTIVE Danh mục này đang hoạt động và có thể dùng để đặt giá thầu.
OBSOLETE Danh mục này đã lỗi thời. Chỉ dùng cho mục đích báo cáo.

ProductGroupView

Chế độ xem nhóm sản phẩm.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

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/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

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 ở nhiều 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 kể từ ngày và giờ khi sự kiện tương ứng được ghi lại.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem Hiệu suất mua sắm. Tên tài nguyên chế độ xem hiệu suất mua sắm có dạng: customers/{customerId}/shoppingPerformanceView

UserList

Danh sách người dùng. Đây là danh sách những người dùng mà khách hàng có thể nhắm đến.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Trường
resourceName

string

Tên tài nguyên của danh sách người dùng. Tên tài nguyên trong danh sách người dùng có dạng:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Loại danh sách này.

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

id

string (int64 format)

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)

UserListType

Enum chứa các loại danh sách người dùng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
REMARKETING Danh sách người dùng được biểu thị dưới dạng tập hợp các loại chuyển đổi.
LOGICAL Danh sách người dùng được biểu thị dưới dạng sự kết hợp của các danh sách/mối quan tâm khác của người dùng.
EXTERNAL_REMARKETING Danh sách người dùng được tạo trong nền tảng Google Ad Manager.
RULE_BASED Danh sách người dùng được liên kết với quy tắc.
SIMILAR Danh sách người dùng với những người dùng tương tự như người dùng của một Danh sách người dùng khác.
CRM_BASED Danh sách người dùng chứa dữ liệu CRM của bên thứ nhất do nhà quảng cáo cung cấp dưới dạng email hoặc các định dạng khác.

WebpageView

Lượt xem trang web.

Biểu diễn dưới dạng JSON
{
  "resourceName": string
}
Trường
resourceName

string

Tên tài nguyên của chế độ xem trang web. Tên tài nguyên lượt xem trang web có dạng:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Truy cập

Lượt truy cập.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Trường
resourceName

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/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

Mã của lượt truy cập.

criterionId

string (int64 format)

Mã từ khoá trên Search Ads 360. Giá trị 0 cho biết từ khoá chưa được phân bổ.

merchantId

string (int64 format)

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ảng không quảng cáo trong Search Ads 360.

adId

string (int64 format)

Mã quảng cáo. Giá trị 0 cho biết quảng cáo chưa được phân bổ.

clickId

string

Một chuỗi duy nhất cho mỗi lượt truy cập được chuyển tới trang đích dưới dạng tham số URL của mã lượt nhấp.

visitDateTime

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

productId

string

Mã của sản phẩm mà người dùng nhấp vào.

productChannel

enum (ProductChannel)

Kênh bán sản phẩm mà người dùng nhấp vào: Trực tuyến hoặc Địa phương.

productLanguageCode

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.

productStoreId

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 địa phương của bạn.

productCountryCode

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à khách hàng nhấp vào.

assetId

string (int64 format)

Mã của thành phần được tương tác trong sự kiện truy cập.

assetFieldType

enum (AssetFieldType)

Loại trường thành phần của sự kiện truy cập.

ProductChannel

Enum mô tả vị trí của sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ONLINE Mặt hàng này được bán trên mạng.
LOCAL Mặt hàng này được bán tại các cửa hàng địa phương.

Chuyển đổi

Lượt chuyển đổi.

Biểu diễn dưới dạng JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Trường
resourceName

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/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

Mã của lượt chuyển đổi

criterionId

string (int64 format)

Mã tiêu chí Search Ads 360. Giá trị 0 cho biết tiêu chí này chưa được phân bổ.

merchantId

string (int64 format)

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ảng không quảng cáo trong Search Ads 360.

adId

string (int64 format)

Mã quảng cáo. Giá trị 0 cho biết quảng cáo chưa được phân bổ.

clickId

string

Một chuỗi duy nhất (đối với lượt truy cập được phân bổ giá trị của lượt chuyển đổi) được chuyển đến trang đích dưới dạng tham số URL của mã lượt nhấp.

visitId

string (int64 format)

Mã lượt truy cập của Search Ads 360 mà lượt chuyển đổi được phân bổ.

advertiserConversionId

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 này, thì Search Ads 360 sẽ tạo mã đó. Đối với lượt chuyển đổi trực tuyến, giá trị này bằng cột mã nhận dạng hoặc cột FloodlightOrderId tuỳ thuộc vào hướng dẫn về Floodlight của nhà quảng cáo.

productId

string

Mã của sản phẩm mà người dùng nhấp vào.

productChannel

enum (ProductChannel)

Kênh bán sản phẩm mà người dùng nhấp vào: Trực tuyến hoặc Địa phương.

productLanguageCode

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.

productStoreId

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 địa phương của bạn.

productCountryCode

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à khách hàng nhấp vào.

attributionType

enum (AttributionType)

Mục đích của lượt chuyển đổi này: Lượt truy cập hoặc Từ khoá+Quảng cáo.

conversionDateTime

string

Dấu thời gian của sự kiện chuyển đổi.

conversionLastModifiedDateTime

string

Dấu thời gian của lần sửa đổi gần đây nhất.

conversionVisitDateTime

string

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

conversionQuantity

string (int64 format)

Số lượng mặt hàng được lượt chuyển đổi ghi lại, như được xác định bằng thông số url số lượng. Nhà quảng cáo chịu trách nhiệm điền thông số một cách linh động (chẳng hạn như số lượng mặt hàng bán được trong lượt chuyển đổi). Nếu không, giá trị mặc định sẽ là 1.

conversionRevenueMicros

string (int64 format)

Doanh thu được điều chỉnh theo phần cực nhỏ cho sự kiện chuyển đổi. Đơn vị tiền tệ này sẽ luôn có đơn vị tiền tệ của tài khoản phân phát quảng cáo.

floodlightOriginalRevenue

string (int64 format)

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 Floodlight sửa đổi chỉ dẫn về đơn vị tiền tệ.

floodlightOrderId

string

Mã đơn hàng Floodlight do nhà quảng cáo cung cấp cho lượt chuyển đổi.

status

enum (ConversionStatus)

Trạng thái của lượt chuyển đổi là ĐÃ BẬT hoặc ĐÃ XOÁ.

assetId

string (int64 format)

Mã của thành phần được tương tác trong sự kiện chuyển đổi.

assetFieldType

enum (AssetFieldType)

Loại trường thành phần của sự kiện chuyển đổi.

AttributionType

Loại phân bổ lượt chuyển đổi trong Search Ads360

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
VISIT Lượt chuyển đổi này được phân bổ cho một lượt truy cập.
CRITERION_AD Lượt chuyển đổi này được phân bổ cho một tiêu chí và một cặp quảng cáo.

ConversionStatus

Các trạng thái có thể có của lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Lượt chuyển đổi này đã được bật.
REMOVED Lượt chuyển đổi này đã bị xoá.

Chỉ số

Dữ liệu về chỉ số.

Biểu diễn dưới dạng JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Trường
allConversionsValueByConversionDate

number

Giá trị của tất cả lượt chuyển đổi. Khi cột này được chọn cùng với ngày, thì các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

Tổng số lần chuyển đổi. Chỉ số này bao gồm tất cả các lượt chuyển đổi, bất kể giá trị của includeInConversionsMetric. Khi cột này được chọn cùng với ngày, thì các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

Các chỉ số tuỳ chỉnh về lượt chuyển đổi.

conversionsValueByConversionDate

number

Tổng giá trị lượt chuyển đổi có thể đặt giá thầu theo ngày chuyển đổi. Khi cột này được chọn cùng với ngày, thì các giá trị trong cột ngày có nghĩa là ngày chuyển đổi.

conversionsByConversionDate

number

Tổng số lượt chuyển đổi theo ngày chuyển đổi cho các loại chuyển đổi có thể đặt giá thầu. Có thể là phân số do lập mô hình phân bổ. Khi cột này được chọn cùng với ngày, thì các giá trị trong cột ngày có nghĩa là ngày chuyển đổi.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Điểm chất lượng trước đây của mẫu quảng cáo.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

Chất lượng của trải nghiệm trang đích trước đây.

historicalSearchPredictedCtr

enum (QualityScoreBucket)

Tỷ lệ nhấp được dự đoán (CTR) trong quá khứ tìm kiếm.

interactionEventTypes[]

enum (InteractionEventType)

Các loại tương tác có thể thanh toán và tương tác miễn phí.

rawEventConversionMetrics[]

object (Value)

Chỉ số lượt chuyển đổi sự kiện chưa qua xử lý.

absoluteTopImpressionPercentage

number

Tỷ lệ hiển thị ở vị trí đầu tiên trên Mạng Tìm kiếm là tỷ lệ phần trăm lượt hiển thị quảng cáo Tìm kiếm tại vị trí nổi bật nhất trên Mạng Tìm kiếm.

allConversionsFromInteractionsRate

number

Tất cả lượt chuyển đổi từ lượt tương tác (ngược chiều với lượt chuyển đổi từ lượt xem hết) chia cho số lượt tương tác với quảng cáo.

allConversionsValue

number

Giá trị của tất cả lượt chuyển đổi.

allConversions

number

Tổng số lần chuyển đổi. Chỉ số này bao gồm tất cả các lượt chuyển đổi, bất kể giá trị của includeInConversionsMetric.

allConversionsValuePerCost

number

Giá trị của tất cả lượt chuyển đổi chia cho tổng chi phí của các lượt tương tác với quảng cáo (chẳng hạn như số lượt nhấp đối với quảng cáo dạng văn bản hoặc số lượt xem đối với quảng cáo dạng video).

allConversionsFromClickToCall

number

Số lần người dùng nhấp vào nút "Gọi" để gọi đến một cửa hàng trong hoặc sau khi nhấp vào quảng cáo. Số liệu này không cho biết cuộc gọi có được kết nối hay không hoặc thời lượng của cuộc gọi.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

allConversionsFromDirections

number

Số lần người dùng nhấp vào nút "Xem đường đi" để tìm đường đến một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

allConversionsFromInteractionsValuePerInteraction

number

Giá trị của tất cả chuyển đổi từ các lần tương tác chia cho tổng số lần tương tác.

allConversionsFromMenu

number

Số lần người dùng nhấp vào đường liên kết để xem thực đơn của một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

allConversionsFromOrder

number

Số lần người dùng đặt hàng tại một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

allConversionsFromOtherEngagement

number

Số lượt chuyển đổi khác (ví dụ: đăng bài đánh giá hoặc lưu vị trí của cửa hàng) xảy ra sau khi người dùng nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

allConversionsFromStoreVisit

number

Số lần ước tính mọi người đã ghé qua cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

visits

number

Các lượt nhấp mà Search Ads 360 đã ghi lại thành công và chuyển tiếp đến trang đích của nhà quảng cáo.

allConversionsFromStoreWebsite

number

Số lần mọi người được đưa đến URL của một cửa hàng sau khi nhấp vào quảng cáo.

Chỉ số này chỉ áp dụng cho các mục trong nguồn cấp dữ liệu.

averageCost

number

Số tiền trung bình mà bạn trả cho mỗi lượt tương tác. Số tiền này là tổng chi phí quảng cáo của bạn chia cho tổng số lượt tương tác.

averageCpc

number

Tổng chi phí của tất cả lượt nhấp chia cho tổng số lượt nhấp nhận được. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

averageCpm

number

Chi phí trung bình cho mỗi nghìn lượt hiển thị (CPM). Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

string (int64 format)

Số lượt nhấp.

contentBudgetLostImpressionShare

number

Phần trăm ước tính số lần quảng cáo của bạn đủ điều kiện để hiển thị trên Mạng hiển thị nhưng đã không do ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất của ngân sách nội dung được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

contentImpressionShare

number

Số lượt hiển thị mà bạn đã nhận được trên Mạng Hiển thị chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện để nhận. Lưu ý: Tỷ lệ hiển thị nội dung được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

contentRankLostImpressionShare

number

Tỷ lệ phần trăm số lượt hiển thị ước tính trên Mạng Hiển thị mà quảng cáo của bạn không nhận được do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị bị mất của thứ hạng nội dung được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

conversionsFromInteractionsRate

number

Số lượt chuyển đổi có thể đặt giá thầu trung bình (từ lượt tương tác) trên mỗi lượt tương tác đủ điều kiện đối với lượt chuyển đổi. Cho biết tần suất trung bình một lượt tương tác với quảng cáo dẫn đến một lượt chuyển đổi có thể đặt giá thầu.

clientAccountConversionsValue

number

Giá trị của các lượt chuyển đổi của tài khoản khách hàng. Giá trị này chỉ bao gồm những hành động chuyển đổi có thuộc tínhInClientAccountConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.

conversionsValuePerCost

number

Giá trị của lượt chuyển đổi có thể đặt giá thầu chia cho tổng chi phí của các lượt tương tác đủ điều kiện chuyển đổi.

conversionsFromInteractionsValuePerInteraction

number

Giá trị của các lượt chuyển đổi từ các lượt tương tác chia cho số lượt tương tác với quảng cáo. Giá trị này chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.

clientAccountConversions

number

Số lượt chuyển đổi của tài khoản khách hàng. Giá trị này chỉ bao gồm những hành động chuyển đổi có thuộc tínhInClientAccountConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.

costMicros

string (int64 format)

Tổng chi phí mỗi lượt nhấp (CPC) và giá mỗi nghìn lượt hiển thị (CPM) của bạn trong khoảng thời gian này. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

costPerAllConversions

number

Chi phí của các lượt tương tác với quảng cáo chia cho tất cả lượt chuyển đổi.

costPerConversion

number

Chi phí trung bình cho mỗi lượt chuyển đổi có thể đặt giá thầu đủ điều kiện cho lượt chuyển đổi.

costPerCurrentModelAttributedConversion

number

Chi phí của lượt tương tác với quảng cáo chia cho số lượt chuyển đổi được phân bổ theo mô hình hiện tại. Giá trị này chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.

crossDeviceConversions

number

Lượt chuyển đổi từ việc khách hàng nhấp vào quảng cáo trên một thiết bị, sau đó chuyển đổi trên một thiết bị hoặc trình duyệt khác. Lượt chuyển đổi thiết bị chéo đã được đưa vào tất cả các Lượt chuyển đổi.

crossDeviceConversionsValue

number

Tổng giá trị của các lượt chuyển đổi trên nhiều thiết bị.

ctr

number

Số lượt nhấp mà quảng cáo của bạn nhận được (Số lượt nhấp) chia cho số lần quảng cáo được hiển thị (Số lượt hiển thị).

conversions

number

Số chuyển đổi. Giá trị này chỉ bao gồm những hành động chuyển đổi có thuộc tính includeInConversionsMetric được đặt thành true. Nếu bạn sử dụng chiến lược đặt giá thầu dựa trên lượt chuyển đổi, thì các chiến lược giá thầu của bạn sẽ tối ưu hoá cho những lượt chuyển đổi này.

conversionsValue

number

Tổng giá trị chuyển đổi cho các chuyển đổi có trong trường "chuyển đổi". Chỉ số này chỉ hữu ích nếu bạn đã nhập một giá trị cho hành động chuyển đổi.

historicalQualityScore

string (int64 format)

Điểm chất lượng trong quá khứ.

impressions

string (int64 format)

Tần suất quảng cáo của bạn đã xuất hiện trên trang kết quả tìm kiếm hoặc trang web trên Mạng Google.

interactionRate

number

Tần suất mọi người tương tác với quảng cáo của bạn sau khi quảng cáo đó hiển thị cho họ. Đây là số lượt tương tác chia cho số lần quảng cáo của bạn hiển thị.

interactions

string (int64 format)

Số lần tương tác. Tương tác là hành động chính của người dùng được liên kết với một định dạng quảng cáo (lượt nhấp đối với quảng cáo dạng văn bản và quảng cáo mua sắm), lượt xem đối với quảng cáo dạng video, v.v.

invalidClickRate

number

Tỷ lệ phần trăm số lượt nhấp được lọc ra khỏi tổng số lượt nhấp (số lượt nhấp đã lọc + số lượt nhấp không được lọc) trong kỳ báo cáo.

invalidClicks

string (int64 format)

Số lượt nhấp mà Google coi là bất hợp pháp và không được tính cho bạn.

mobileFriendlyClicksPercentage

number

Tỷ lệ phần trăm số lần nhấp trên thiết bị di động chuyển đến một trang thân thiện với thiết bị di động.

searchAbsoluteTopImpressionShare

number

Tỷ lệ phần trăm số lượt hiển thị quảng cáo Mua sắm hoặc quảng cáo Tìm kiếm của khách hàng được hiển thị tại vị trí Mua sắm nổi bật nhất. Hãy xem https://support.google.com/sa360/answer/9566729 để biết thông tin chi tiết. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Con số ước tính tần suất quảng cáo của bạn không phải là quảng cáo đầu tiên trong số những quảng cáo hàng đầu trong kết quả tìm kiếm do ngân sách thấp. Lưu ý: Tỷ lệ hiển thị hàng đầu tuyệt đối bị mất của ngân sách tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

searchBudgetLostImpressionShare

number

Phần trăm số lần quảng cáo đủ điều kiện hiển thị trên Mạng tìm kiếm ước tính nhưng đã không do ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất của ngân sách tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

searchBudgetLostTopImpressionShare

number

Con số ước tính tần suất quảng cáo của bạn không xuất hiện bên cạnh các kết quả tìm kiếm tự nhiên hàng đầu do ngân sách thấp. Lưu ý: Tỷ lệ hiển thị hàng đầu bị mất của ngân sách tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

searchClickShare

number

Số lượt nhấp mà bạn đã nhận được trên Mạng Tìm kiếm chia cho số lượt nhấp ước tính mà bạn đủ điều kiện nhận được. Lưu ý: Tỷ lệ nhấp chuột tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchExactMatchImpressionShare

number

Số lần hiển thị bạn đã nhận được chia cho số lần hiển thị ước tính mà bạn đủ điều kiện nhận được trên Mạng tìm kiếm cho cụm từ tìm kiếm khớp chính xác với từ khóa của bạn (hoặc là các biến thể gần giống của từ khóa), bất kể kiểu so khớp từ khóa của bạn là gì. Lưu ý: Tỷ lệ hiển thị khớp chính xác trên Mạng Tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchImpressionShare

number

Số lượt hiển thị mà bạn đã nhận được trên Mạng Tìm kiếm chia cho số lượt hiển thị ước tính mà bạn đủ điều kiện để nhận. Lưu ý: Tỷ lệ hiển thị trên Mạng tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Con số ước tính tần suất quảng cáo của bạn không phải là quảng cáo đầu tiên xuất hiện đầu tiên trong số những quảng cáo hàng đầu trong kết quả tìm kiếm do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí đầu tiên nhất bị mất của thứ hạng tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

searchRankLostImpressionShare

number

Tỷ lệ phần trăm số lượt hiển thị ước tính trên Mạng Tìm kiếm mà quảng cáo của bạn không nhận được do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị bị mất của thứ hạng tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

searchRankLostTopImpressionShare

number

Con số ước tính tần suất quảng cáo của bạn không xuất hiện bên cạnh kết quả tìm kiếm tự nhiên hàng đầu do Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị hàng đầu bị mất của thứ hạng tìm kiếm được báo cáo trong khoảng từ 0 đến 0,9. Bất kỳ giá trị nào lớn hơn 0,9 được báo cáo là 0,9001.

searchTopImpressionShare

number

Số lượt hiển thị mà bạn nhận được trong số các quảng cáo hàng đầu so với số lượt hiển thị ước tính mà bạn đủ điều kiện nhận được trong những quảng cáo hàng đầu. Lưu ý: Tỷ lệ hiển thị hàng đầu trên Mạng tìm kiếm được báo cáo trong khoảng từ 0,1 đến 1. Bất kỳ giá trị nào nhỏ hơn 0,1 đều được báo cáo là 0,0999.

Quảng cáo hàng đầu thường nằm phía trên kết quả tự nhiên hàng đầu, mặc dù quảng cáo hàng đầu có thể hiển thị bên dưới kết quả tự nhiên hàng đầu đối với một số cụm từ tìm kiếm nhất định.

topImpressionPercentage

number

Tỷ lệ phần trăm số lượt hiển thị quảng cáo của bạn xuất hiện bên cạnh các kết quả tìm kiếm tự nhiên hàng đầu.

valuePerAllConversions

number

Giá trị của tất cả lượt chuyển đổi chia cho tổng số lượt chuyển đổi.

valuePerAllConversionsByConversionDate

number

Giá trị của tất cả lượt chuyển đổi chia cho tổng số lượt chuyển đổi. Khi cột này được chọn cùng với ngày, thì các giá trị trong cột ngày có nghĩa là ngày chuyển đổi. Thông tin chi tiết về các cột by_conversion_date có tại https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

Giá trị của lượt chuyển đổi có thể đặt giá thầu chia cho số lượt chuyển đổi có thể đặt giá thầu. Cho biết giá trị trung bình của mỗi lượt chuyển đổi có thể đặt giá thầu.

valuePerConversionsByConversionDate

number

Giá trị lượt chuyển đổi có thể đặt giá thầu theo ngày chuyển đổi chia cho số lượt chuyển đổi có thể đặt giá thầu cho ngày chuyển đổi. Cho biết giá trị trung bình của mỗi lượt chuyển đổi có thể đặt giá thầu (theo ngày chuyển đổi). Khi cột này được chọn cùng với ngày, thì các giá trị trong cột ngày có nghĩa là ngày chuyển đổi.

clientAccountViewThroughConversions

string (int64 format)

Tổng số lượt chuyển đổi từ lượt xem hết. Những hành động này xảy ra khi khách hàng nhìn thấy quảng cáo dạng hình ảnh hoặc quảng cáo đa phương tiện, sau đó hoàn tất lượt chuyển đổi trên trang web của bạn mà không tương tác với (ví dụ: nhấp vào) một quảng cáo khác.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán kèm (COGS) của tài khoản khách hàng là tổng chi phí cho việc bán sản phẩm nhờ quảng cáo một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Giá vốn hàng bán kèm là tổng giá vốn của những sản phẩm đã bán và không được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán kèm trong đơn đặt hàng này là 5 đô la Mỹ. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán kèm (COGS) là tổng chi phí cho việc bán sản phẩm nhờ quảng cáo một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Giá vốn hàng bán kèm là tổng giá vốn của những sản phẩm đã bán và không được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán kèm trong đơn đặt hàng này là 5 đô la Mỹ. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

Lợi nhuận gộp từ hoạt động bán kèm của tài khoản khách hàng là lợi nhuận bạn kiếm được từ những sản phẩm đã bán nhờ quảng cáo về một sản phẩm khác, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong giao dịch mua này đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Lợi nhuận gộp từ hoạt động bán kèm là doanh thu bạn kiếm được từ hoạt động bán kèm do quảng cáo của bạn mang lại, trừ đi giá vốn hàng bán. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc áo có giá 20 đô la và có giá vốn hàng bán là 5 đô la. Lợi nhuận gộp từ hoạt động bán kèm của đơn đặt hàng này là 20 - 5 = 15 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

Lợi nhuận gộp từ hoạt động bán kèm là lợi nhuận bạn kiếm được từ những sản phẩm đã bán nhờ quảng cáo về một sản phẩm khác, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong giao dịch mua này đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Lợi nhuận gộp từ hoạt động bán kèm là doanh thu bạn kiếm được từ hoạt động bán kèm do quảng cáo của bạn mang lại, trừ đi giá vốn hàng bán. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc áo có giá 20 đô la và có giá vốn hàng bán là 5 đô la. Lợi nhuận gộp từ hoạt động bán kèm của đơn đặt hàng này là 20 - 5 = 15 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

Doanh thu từ hoạt động bán kèm của tài khoản khách hàng là tổng số tiền bạn kiếm được từ những sản phẩm đã bán được nhờ quảng cáo cho một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Doanh thu từ hoạt động bán kèm là tổng giá trị mà bạn kiếm được từ hoạt động bán kèm mà quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Doanh thu từ hoạt động bán kèm trong đơn đặt hàng này là 20 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

Doanh thu từ hoạt động bán kèm là tổng số tiền bạn kiếm được từ những sản phẩm đã bán được nhờ quảng cáo về một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Doanh thu từ hoạt động bán kèm là tổng giá trị mà bạn kiếm được từ hoạt động bán kèm mà quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Doanh thu từ hoạt động bán kèm trong đơn đặt hàng này là 20 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

Số lượng sản phẩm đã bán kèm của tài khoản khách hàng là tổng số sản phẩm đã bán được nhờ quảng cáo một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Số lượng sản phẩm đã bán kèm là tổng số sản phẩm đã bán kèm trong tất cả các đơn đặt hàng do quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm đã bán kèm trong đơn đặt hàng này là 2. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.

crossSellUnitsSold

number

Số lượng sản phẩm đã bán kèm là tổng số sản phẩm đã bán được nhờ quảng cáo một sản phẩm khác. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo không phải là sản phẩm đã bán, thì sản phẩm đã bán được gọi là sản phẩm bán kèm. Số lượng sản phẩm đã bán kèm là tổng số sản phẩm đã bán kèm trong tất cả các đơn đặt hàng do quảng cáo của bạn mang lại. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm đã bán kèm trong đơn đặt hàng này là 2. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán (COGS) của tài khoản khách hàng tiềm năng là tổng giá vốn của những sản phẩm đã bán nhờ quảng cáo về sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo có một sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì chi phí của những hàng hoá này được tính vào mục giá vốn hàng bán của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán của sản phẩm được quảng cáo trong đơn đặt hàng này là 3 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

Giá vốn hàng bán (COGS) của sản phẩm được quảng cáo là tổng giá vốn của những sản phẩm đã bán nhờ quảng cáo về sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo có một sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì chi phí của những hàng hoá này được tính vào mục giá vốn hàng bán của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá vốn hàng bán là 3 đô la, chiếc áo có giá vốn hàng bán là 5 đô la. Giá vốn hàng bán của sản phẩm được quảng cáo trong đơn đặt hàng này là 3 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

Lợi nhuận gộp của khách hàng tiềm năng của tài khoản khách hàng là lợi nhuận bạn kiếm được từ những sản phẩm đã bán nhờ quảng cáo về sản phẩm đó, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì doanh thu bạn kiếm được từ doanh số bán hàng đó trừ đi giá vốn hàng bán sẽ là lợi nhuận gộp của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và có giá vốn hàng bán là 3 đô la. Lợi nhuận gộp của sản phẩm được quảng cáo trong đơn đặt hàng này là: 10 − 3 = 7 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

Lợi nhuận gộp của sản phẩm được quảng cáo là lợi nhuận bạn kiếm được từ những sản phẩm đã bán nhờ quảng cáo về sản phẩm đó, trừ đi giá vốn hàng bán (COGS). Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì doanh thu bạn kiếm được từ doanh số bán hàng đó trừ đi giá vốn hàng bán sẽ là lợi nhuận gộp của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và có giá vốn hàng bán là 3 đô la. Lợi nhuận gộp của sản phẩm được quảng cáo trong đơn đặt hàng này là: 10 − 3 = 7 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

Doanh thu của khách hàng tiềm năng của tài khoản khách hàng là tổng số tiền bạn kiếm được từ những sản phẩm đã bán được nhờ quảng cáo cho sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì tổng giá trị mà bạn kiếm được từ doanh số bán những sản phẩm này sẽ được đưa vào mục doanh thu của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Doanh thu của sản phẩm được quảng cáo trong đơn đặt hàng này là 10 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

Doanh thu của sản phẩm được quảng cáo là tổng số tiền bạn kiếm được từ những sản phẩm đã bán được nhờ quảng cáo cho sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì tổng giá trị mà bạn kiếm được từ doanh số bán những sản phẩm này sẽ được đưa vào mục doanh thu của sản phẩm được quảng cáo. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó và một chiếc áo sơ mi. Chiếc mũ có giá 10 đô la và áo sơ mi có giá 20 đô la. Doanh thu của sản phẩm được quảng cáo trong đơn đặt hàng này là 10 đô la. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng. Chỉ số này là một giá trị tiền tệ và được trả về bằng đơn vị tiền tệ của khách hàng theo mặc định. Hãy xem thông số Metrics_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

Số lượng sản phẩm được quảng cáo đã bán của tài khoản khách hàng là tổng số sản phẩm đã bán được nhờ quảng cáo về sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì tổng số lượng những sản phẩm đã bán này sẽ được đưa vào mục số lượng sản phẩm được quảng cáo đã bán. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm được quảng cáo đã bán trong đơn đặt hàng này là 1. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.

leadUnitsSold

number

Số lượng sản phẩm được quảng cáo đã bán là tổng số sản phẩm đã bán nhờ quảng cáo về sản phẩm đó. Cách hoạt động: Bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng cho các giao dịch mua hàng đã hoàn tất trên trang web của mình. Nếu người dùng tương tác với quảng cáo trước khi mua sản phẩm được liên kết (xem quảng cáo Mua sắm), thì sản phẩm này được coi là sản phẩm được quảng cáo. Mọi sản phẩm có trong đơn đặt hàng của khách hàng đều là sản phẩm đã bán. Nếu sản phẩm được quảng cáo và sản phẩm đã bán khớp với nhau, thì tổng số lượng những sản phẩm đã bán này sẽ được đưa vào mục số lượng sản phẩm được quảng cáo đã bán. Ví dụ: Một người dùng nhấp vào quảng cáo Mua sắm về một chiếc mũ. Sau đó, họ mua chiếc mũ đó, một chiếc áo sơ mi và một chiếc áo khoác. Số lượng sản phẩm được quảng cáo đã bán trong đơn đặt hàng này là 1. Chỉ số này chỉ có sẵn nếu bạn báo cáo lượt chuyển đổi có dữ liệu giỏ hàng.

Giá trị

Vùng chứa dữ liệu chung.

Biểu diễn dưới dạng JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Trường
Trường hợp value. Một giá trị. value chỉ có thể là một trong những trạng thái sau:
booleanValue

boolean

Một giá trị boolean.

int64Value

string (int64 format)

Int64.

floatValue

number

Một số thực.

doubleValue

number

Một cú đúp.

stringValue

string

Một chuỗi.

QualityScoreBucket

Enum liệt kê các nhóm điểm chất lượng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
BELOW_AVERAGE Chất lượng của mẫu quảng cáo dưới mức trung bình.
AVERAGE Chất lượng của mẫu quảng cáo ở mức trung bình.
ABOVE_AVERAGE Chất lượng của mẫu quảng cáo trên mức trung bình.

InteractionEventType

Enum mô tả các loại tương tác có thể trả và miễn phí.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
CLICK Nhấp vào trang web. Trong hầu hết các trường hợp, lượt tương tác này điều hướng đến một vị trí bên ngoài, thường là trang đích của nhà quảng cáo. Đây cũng là InteractionEventType mặc định cho các sự kiện nhấp chuột.
ENGAGEMENT Ý định đã thể hiện của người dùng để tương tác với quảng cáo tại chỗ.
VIDEO_VIEW Người dùng đã xem một quảng cáo dạng video.
NONE EngageEventType mặc định cho các sự kiện chuyển đổi quảng cáo. Tính năng này được sử dụng khi hàng lượt chuyển đổi quảng cáo KHÔNG cho biết rằng các lượt tương tác miễn phí (ví dụ: lượt chuyển đổi quảng cáo) cần được "quảng bá" và được báo cáo trong các chỉ số chính. Đây chỉ đơn giản là các chuyển đổi (quảng cáo) khác.

Phân đoạn

Các trường chỉ phân đoạn.

Biểu diễn dưới dạng JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Trường
adNetworkType

enum (AdNetworkType)

Loại mạng quảng cáo.

conversionActionCategory

enum (ConversionActionCategory)

Danh mục hành động chuyển đổi.

conversionCustomDimensions[]

object (Value)

Phương diện tuỳ chỉnh của lượt chuyển đổi.

dayOfWeek

enum (DayOfWeek)

Ngày trong tuần, ví dụ: MONDAY.

device

enum (Device)

Thiết bị áp dụng chỉ số.

keyword

object (Keyword)

Tiêu chí từ khóa.

productChannel

enum (ProductChannel)

Kênh của sản phẩm.

productChannelExclusivity

enum (ProductChannelExclusivity)

Kênh độc quyền của sản phẩm.

productCondition

enum (ProductCondition)

Tình trạng của sản phẩm.

productSoldCondition

enum (ProductCondition)

Tình trạng của sản phẩm đã bán.

rawEventConversionDimensions[]

object (Value)

Phương diện lượt chuyển đổi sự kiện chưa qua xử lý.

conversionAction

string

Tên tài nguyên của hành động chuyển đổi.

conversionActionName

string

Tên hành động chuyển đổi.

date

string

Ngày áp dụng các chỉ số. định dạng yyyy-MM-dd, ví dụ: 17-04-2018.

month

string

Tháng được biểu thị bằng ngày của ngày đầu tiên của tháng. Được định dạng là yyyy-MM-dd.

productBiddingCategoryLevel1

string

Danh mục đặt giá thầu (cấp 1) của sản phẩm.

productBiddingCategoryLevel2

string

Danh mục đặt giá thầu (cấp 2) của sản phẩm.

productBiddingCategoryLevel3

string

Danh mục đặt giá thầu (cấp 3) của sản phẩm.

productBiddingCategoryLevel4

string

Danh mục đặt giá thầu (cấp 4) của sản phẩm.

productBiddingCategoryLevel5

string

Danh mục đặt giá thầu (cấp 5) của sản phẩm.

productBrand

string

Thương hiệu của sản phẩm.

productCountry

string

Tên tài nguyên của hằng số mục tiêu địa lý cho quốc gia bán sản phẩm.

productCustomAttribute0

string

Thuộc tính tuỳ chỉnh 0 của sản phẩm.

productCustomAttribute1

string

Thuộc tính tuỳ chỉnh 1 của sản phẩm.

productCustomAttribute2

string

Thuộc tính tuỳ chỉnh 2 của sản phẩm.

productCustomAttribute3

string

Thuộc tính tuỳ chỉnh 3 của sản phẩm.

productCustomAttribute4

string

Thuộc tính tuỳ chỉnh 4 của sản phẩm.

productItemId

string

Mã mặt hàng của sản phẩm.

productLanguage

string

Tên tài nguyên của hằng số ngôn ngữ cho ngôn ngữ của sản phẩm.

productSoldBiddingCategoryLevel1

string

Danh mục đặt giá thầu (cấp 1) của sản phẩm đã bán.

productSoldBiddingCategoryLevel2

string

Danh mục đặt giá thầu (cấp 2) của sản phẩm đã bán.

productSoldBiddingCategoryLevel3

string

Danh mục đặt giá thầu (cấp 3) của sản phẩm đã bán.

productSoldBiddingCategoryLevel4

string

Danh mục đặt giá thầu (cấp 4) của sản phẩm đã bán.

productSoldBiddingCategoryLevel5

string

Danh mục đặt giá thầu (cấp 5) của sản phẩm đã bán.

productSoldBrand

string

Thương hiệu của sản phẩm đã bán.

productSoldCustomAttribute0

string

Thuộc tính tuỳ chỉnh 0 của sản phẩm đã bán.

productSoldCustomAttribute1

string

Thuộc tính tuỳ chỉnh 1 của sản phẩm đã bán.

productSoldCustomAttribute2

string

Thuộc tính tuỳ chỉnh 2 của sản phẩm đã bán.

productSoldCustomAttribute3

string

Thuộc tính tuỳ chỉnh 3 của sản phẩm đã bán.

productSoldCustomAttribute4

string

Thuộc tính tuỳ chỉnh 4 của sản phẩm đã bán.

productSoldItemId

string

Mã mặt hàng của sản phẩm đã bán.

productSoldTitle

string

Tiêu đề của sản phẩm đã bán.

productSoldTypeL1

string

Loại (cấp 1) của sản phẩm đã bán.

productSoldTypeL2

string

Loại (cấp 2) của sản phẩm đã bán.

productSoldTypeL3

string

Loại (cấp 3) của sản phẩm đã bán.

productSoldTypeL4

string

Loại (cấp 4) của sản phẩm đã bán.

productSoldTypeL5

string

Loại (cấp 5) của sản phẩm đã bán.

productStoreId

string

Mã cửa hàng của sản phẩm.

productTitle

string

Tiêu đề của sản phẩm.

productTypeL1

string

Loại (cấp 1) của sản phẩm.

productTypeL2

string

Loại (cấp 2) của sản phẩm.

productTypeL3

string

Loại (cấp 3) của sản phẩm.

productTypeL4

string

Loại (cấp 4) của sản phẩm.

productTypeL5

string

Loại (cấp 5) của sản phẩm.

quarter

string

Quý được biểu thị bằng ngày của ngày đầu tiên của quý. Sử dụng năm dương lịch cho các quý, ví dụ: quý hai của năm 2018 bắt đầu vào ngày 1/4/2018. Được định dạng là yyyy-MM-dd.

week

string

Tuần được định nghĩa là thứ Hai đến Chủ Nhật và được biểu thị bằng ngày thứ Hai. Được định dạng là yyyy-MM-dd.

year

integer

Năm, có định dạng là yyyy.

assetInteractionTarget

object (AssetInteractionTarget)

Chỉ được sử dụng với các chỉ số CustomerAsset, CampaignAsset và nhóm Nhóm quảng cáo. Cho biết liệu chỉ số về lượt tương tác xảy ra trên chính thành phần đó hay trên một thành phần hoặc đơn vị quảng cáo khác. Lượt tương tác (ví dụ: lượt nhấp) được tính trên tất cả các phần của quảng cáo được phân phát (ví dụ: Bản thân quảng cáo và các thành phần khác như Đường liên kết của trang web) khi chúng được phân phát cùng nhau. Khi engagementOnThisAsset là đúng, có nghĩa là các lượt tương tác có trên thành phần cụ thể này và khi engagementOnThisAsset là sai, có nghĩa là lượt tương tác không có trên thành phần này mà trên những phần khác của quảng cáo được phân phát cùng thành phần này.

AdNetworkType

Liệt kê các loại mạng Google Ads.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
SEARCH Tìm kiếm Google.
SEARCH_PARTNERS Các đối tác tìm kiếm.
CONTENT Mạng hiển thị
YOUTUBE_WATCH Video trên YouTube
MIXED Nhiều mạng.

Từ khoá

Phân đoạn Tiêu chí từ khóa.

Biểu diễn dưới dạng JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Trường
info

object (KeywordInfo)

Thông tin về từ khoá.

adGroupCriterion

string

Tên tài nguyên Tiêu chí nhóm quảng cáo.

ProductChannelExclusivity

Enum mô tả tình trạng còn hàng của sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
SINGLE_CHANNEL Mặt hàng này chỉ được bán thông qua một kênh, có thể là tại cửa hàng địa phương hoặc bán trực tuyến như trên ProductChannel.
MULTI_CHANNEL Mặt hàng này được so khớp với mặt hàng tương ứng trên mạng hoặc cửa hàng tại địa phương, cho biết rằng mặt hàng đó có thể mua được trong cả hai ShoppingProductChannels.

ProductCondition

Enum mô tả điều kiện của ưu đãi sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
OLD Tình trạng sản phẩm đã cũ.
NEW Tình trạng sản phẩm là mới.
REFURBISHED Tình trạng sản phẩm là đã được tân trang.
USED Điều kiện sản phẩm được sử dụng.

AssetInteractionTarget

Phân đoạn AssetinterfaceTarget.

Biểu diễn dưới dạng JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Trường
asset

string

Tên tài nguyên thành phần.

interactionOnThisAsset

boolean

Chỉ được sử dụng với các chỉ số CustomerAsset, CampaignAsset và nhóm Nhóm quảng cáo. Cho biết liệu chỉ số về lượt tương tác xảy ra trên chính thành phần đó hay trên một thành phần hoặc đơn vị quảng cáo khác.