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)

Tập hợp thành phần của 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 đề cập trong truy vấn.

adGroupBidModifier

object (AdGroupBidModifier)

Công cụ 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 kiểu kết hợp hàng đầu của nhóm thành phần được đề cập 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 của nhóm thành phần được tham chiếu trong truy vấn.

assetSet

object (AssetSet)

Tập hợp 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)

Tập hợp 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 đề cập 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 lượt bán hàng trong 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 tham chiếu 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)

Tập hợp thành phần của 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 đề cập 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 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 đề cập 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ác cột tuỳ chỉnh.

Nhóm Quảng cáo

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 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 được tính 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 tiêu chí nhắm mục tiêu.

labels[]

string

Tên tài nguyên của các nhãn được đính kèm với nhóm quảng cáo này.

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 thực thể Google Ads, hãy sử dụng "adGroup.id" thay thế.

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, ngày bắt đầu của nhóm quảng cáo hoặc ngày bắt đầu của nhóm quảng cáo, tuỳ vào ngày nào đến sau. Nếu bạn đặt trường này, thì nhóm quảng cáo sẽ bắt đầu vào đầu ngày được chỉ định theo múi giờ của khách hàng. Trường này chỉ dành cho các tài khoản cổng vào Microsoft Advertising và Facebook.

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

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 các tài khoản cổng vào Microsoft Advertising và Facebook.

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

languageCode

string

Ngôn ngữ của quảng cáo và từ khoá trong nhóm quảng cáo. Trường này chỉ dành cho tài khoản Microsoft Advertising. Thêm chi tiết: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

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

Trường này là bắt buộc và không được để trống khi tạo nhóm quảng cáo mới.

Mã này phải chứa ít hơn 255 ký tự có độ rộng đầy đủ UTF-8.

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

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

AdGroupStatus

Các trạng thái có thể có của 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 được 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 hình chưa được chỉ định.
UNKNOWN

Phiên bản này không xác định được 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 các 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 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 của 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 ngắn dạng video trong luồng phát không thể bỏ qua.
VIDEO_TRUE_VIEW_IN_STREAM Quảng cáo trong 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 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 trang thông tin so sánh giá.
PROMOTED_HOTEL_ADS Loại nhóm quảng cáo cho các 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 có phạm vi tiếp cận hiệu quả bằng video.
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 một 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 được giá trị đã nhận.

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

OPTIMIZE Tối ưu hoá quảng cáo của 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ề. Biểu thị 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 chạy cho nhóm quảng cáo này, bởi 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ị xóa.
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 ở 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 này đ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

Chế độ cài đặt cho các tính năng liên quan đến tiêu chí 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 chi tiết về chế độ cài đặt 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 theo phương diện nhắm mục tiêu để 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 tiêu chí nhắm mục tiêu theo mỗi 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 muốn 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 sẽ 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 tiêu chí 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 phương diệ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ề. Biểu thị giá trị không xác định trong phiên bản này.
KEYWORD Tiêu chí từ khoá, ví dụ: 'du thuyền sao Hoả'. KEYWORD 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, vì vậy có thể không được đặt làm mục tiêu "TẤT CẢ" thứ nguyên với 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 đang cân nhắc mua hàng tuỳ chỉnh.
TOPIC Tiêu chí theo chủ đề để nhắm mục tiêu các danh mục nội dung, ví dụ: 'danh mục::Động vật>Thú cưng' Dùng để nhắm mục tiêu Hiển thị và Video.
GENDER Tiêu chí nhắm mục tiêu về 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ư ứ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í cho 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ờ theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss.ssssss" .

labels[]

string

Tên tài nguyên của các nhãn được đính kèm với quảng cáo trong nhóm quảng cáo này.

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 Japan, Microsoft, Baidu, v.v. Đối với thực thể không phải Search Ads 360, hãy sử dụng "adGroupAd.ad.id" thay thế.

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

lastModifiedTime

string

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

AdGroupAdStatus

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

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

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

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

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

AdType

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

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

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

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

TEXT_AD Quảng cáo là quảng cáo 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 chỉ là quảng cáo tạo cuộc gọi điện thoại.
EXPANDED_DYNAMIC_SEARCH_AD Quảng cáo này là một quảng cáo tìm kiếm động mở rộng.
HOTEL_AD Quảng cáo 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 là quảng cáo Mua sắm thông thường.
VIDEO_AD Quảng cáo là quảng cáo video.
GMAIL_AD Quảng cáo này là một 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 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 là quảng cáo hiển thị thích ứng.
LOCAL_AD Quảng cáo là quảng cáo địa phương.
HTML5_UPLOAD_AD Quảng cáo là quảng cáo hiển thị tải lên 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ị tải lên có 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 danh sách so sánh giá.
VIDEO_BUMPER_AD Quảng cáo đệm dạng video.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Quảng cáo dạng video trong luồng phát không thể bỏ qua.
VIDEO_OUTSTREAM_AD Quảng cáo video ngoài luồng phát.
VIDEO_TRUEVIEW_DISCOVERY_AD Quảng cáo TrueView trong hiển thị video.
VIDEO_TRUEVIEW_IN_STREAM_AD Quảng cáo TrueView trong luồng video.
VIDEO_RESPONSIVE_AD Quảng cáo đáp ứ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 nội dung.
TRAVEL_AD Quảng cáo du lịch.
DISCOVERY_VIDEO_RESPONSIVE_AD Quảng cáo thích ứng dạng video của chiến dịch Khám phá.
MULTIMEDIA_AD Quảng cáo đa phương tiện.

SearchAds360TextAdInfo

Quảng cáo dạng văn bả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 nội dung 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 hiển thị của quảng cáo.

displayMobileUrl

string

URL được hiển thị trên thiết bị di động 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 của 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 nội dung 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 bằng một dấu phân cách.

path2

string

Đã thêm văn bản 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 trong Search Ads 360.

Biểu diễn dưới dạng JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Trường
headlines[]

object (AdTextAsset)

Danh sách thành phần văn bản cho dòng tiêu đề. Khi quảng cáo phân phát, dòng tiêu đề sẽ được chọn từ danh sách này.

descriptions[]

object (AdTextAsset)

Danh sách thành phần văn bản cho nội dung mô tả. Khi quảng cáo phân phát, nội dung mô tả sẽ được chọn từ danh sách này.

path1

string

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

path2

string

Đã thêm văn bản 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.

AdTextAsset

Thành phần văn bản được sử dụng trong một quảng cáo.

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

string

Văn bản nội dung.

SearchAds360ProductAdInfo

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

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 nội dung 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ủa công cụ Nhóm quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định giá trị nào.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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. Gemini từng dùng

AD_GROUP_AD_PAUSED Quảng cáo đã bị tạm dừng.
AD_GROUP_AD_REMOVED Quảng cáo đã bị xóa.
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 Quảng cáo đã bị tạm dừng do tài khoản bị tạm dừng.
AD_GROUP_AD_CAMPAIGN_PAUSED 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 Quảng cáo đã bị tạm dừng do nhóm quảng cáo bị tạm dừng.

AdGroupAdLabel

Mối quan hệ giữa quảng cáo của 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 trong nhóm quảng cáo. Tên tài nguyên nhãn quảng cáo của nhóm quảng cáo có dạng: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Quảng cáo trong nhóm quảng cáo mà nhãn được đính kèm.

label

string

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

AdGroupAsset

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

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 AdGroupAsset có dạng như sau:

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

adGroup

string

Bắt buộc. Nhóm quảng cáo mà tài sản được liên kết.

asset

string

Bắt buộc. Thành phần được liên kết với nhóm quảng cáo.

status

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 một mối liên kết thành phần.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 tài sản đã bị tạm dừng.

AdGroupAssetSet

Nhóm quảng cáo thành phần là mối liên kết giữa một nhóm quảng cáo và một nhóm thành phần. Việc tạo một Nhóm thành phần quảng cáo sẽ liên kết một bộ thành phần với một nhóm quảng cáo.

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 mà tập hợp thành phần này được liên kết.

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

AssetSetLinkStatus

Các trạng thái có thể có 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 đó.

Enum
UNSPECIFIED Trạng thái chưa được chỉ định.
UNKNOWN Phiên bản này không xác định được 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 này đang đượ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ị loại bỏ.

AdGroupAudienceView

Chế độ xem đối tượng của một nhóm quảng cáo. Bao gồm dữ liệu hiệu suất từ các mối quan tâm, danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và quảng cáo trên Mạng YouTube cũng như danh sách tái tiếp thị dành cho quảng cáo đi kèm kết quả 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 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 cho 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 cho nhóm quảng cáo. Tên tài nguyên hệ số sửa đổi giá thầu của nhóm quảng cáo có dạng như sau:

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

bidModifier

number

Công cụ sửa đổi cho giá thầu khi tiêu chí phù hợp. Công cụ sửa đổi phải nằm trong khoảng: 0,1 – 10,0. Phạm vi là từ 1.0 - 6.0 cho PreferredContent. Sử dụng số 0 để chọn không sử dụng một Loại thiết bị.

Trường kết hợp criterion. Tiêu chí của hệ số sửa đổi giá thầu nhóm quảng cáo này.

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

device

object (DeviceInfo)

Tiêu chí thiết bị.

DeviceInfo

Tiêu chí 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 Phiên bản này không xác định được giá trị.
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

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

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

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 được tính 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êm thông tin ảnh hưởng đến việc một tiêu chí có đủ điều kiện chạy hay không. Trong một số trường hợp, một tiêu chí đã bị XOÁ trong API vẫn có thể hiển thị là đã bật trong giao diện người dùng. Ví dụ: các chiến dịch theo mặc định hiển thị cho người dùng thuộc tất cả các độ tuổi trừ khi bị loại trừ. Giao diện người dùng sẽ hiển thị từng độ tuổi là "đã bật", vì người dùng đủ điều kiện xem quảng cáo; nhưng AdGroupCriterion.status sẽ hiển thị "đã xoá", vì không có tiêu chí khẳng định nào được thêm vào.

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

positionEstimates

object (PositionEstimates)

Số liệu ướ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ể có sau tất cả các lần chuyển hướng giữa 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 thực thể Google Ads, hãy sử dụng "adGroupCriterion.criterion_id" thay thế.

lastModifiedTime

string

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

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

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

bidModifier

number

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

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 dụng.

engineStatus

enum (AdGroupCriterionEngineStatus)

Trạng thái công cụ cho tiêu chí 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 kết hợp criterion. Tiêu chí nhóm quảng cáo.

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

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 Chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định được 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 thông tin về chất lượng theo tiêu chí của 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 sẵn nếu Google không có đủ thông tin để xác định 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ề. Biểu thị giá trị không xác định trong phiên bản này.
KEYWORD Ví dụ: từ khoá 'du lịch trên sao Hoả'.
PLACEMENT Vị trí, chẳng hạn như Trang web, "www.flowers4sale.com"
MOBILE_APP_CATEGORY Các 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 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 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 kết hợp
KEYWORD_THEME Chủ đề từ khoá của chiến dịch Thông minh
AUDIENCE Đối tượng
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

Số liệu ướ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ề. Biểu thị 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: Do Baidu tạm dừng do có 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ị là không hợp lệ, trong khi trang đích cho thiết bị còn lại là hợp lệ.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Từ khoá đã được tính năng quản lý tài khoản Baidu tạo và tạm dừng. Bạn hiện có thể kích hoạt từ khoá này.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Đang chờ Baidu xem xét. Gemini: 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. Gemini từng dùng

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 phân phát.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Tiêu chí đã bị tạm dừng vì tài khoản bị tạm dừng.

KeywordInfo

Tiêu chí từ khoá.

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

enum (KeywordMatchType)

Loại đối sánh của từ khóa.

text

string

Văn bản 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ề. Biểu thị giá trị không xác định trong phiên bản này.
EXACT Kiểu khớp chính xác.
PHRASE Đối sánh cụm từ.
BROAD Kiểu khớp mở rộng.

ListingGroupInfo

Tiêu chí của 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ề. Biểu thị giá trị không xác định trong phiên bản này.
SUBDIVISION Phân mục sản phẩm cùng với một số phương diện của trang thông tin. Các nút này không được sử dụng bằng cách phân phát để nhắm mục tiêu các mục nhập danh sách, mà chỉ dùng để xác định cấu trúc của cây.
UNIT Đơn vị của nhóm trang thông tin xác định giá thầu.

AgeRangeInfo

Tiêu chí nhóm 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 của 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ề. Biểu thị 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 Từ 25 đến 34 tuổi.
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í về 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 trong nhân khẩu học (ví dụ: nữ).

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 do nhà quảng cáo xác định để 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 web thuộc trang web của một 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 các điều kiện trống cho biết rằng tất cả các trang trên 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 cho các thao tác CREATE và bị cấm trong các thao tác 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ề giá trị là 1, thì tức là mức độ bao phủ đó có mức độ phù hợp 100%. Trường này ở chế độ chỉ đọc.

criterionName

string

Tên của tiêu chí do 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í với loại thông số này.

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

WebpageConditionInfo

Biểu thức logic để nhắm mục tiêu các trang web 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 đ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ề. Biểu thị giá trị không xác định trong phiên bản này.
URL Toán hạng biểu thị điều kiện nhắm mục tiêu URL trang web.
CATEGORY Toán hạng biểu thị điều kiện nhắm mục tiêu theo danh mục trang web.
PAGE_TITLE Toán hạng biểu thị điều kiện nhắm mục tiêu tiêu đề trang web.
PAGE_CONTENT Toán hạng biểu thị điều kiện nhắm mục tiêu theo nội dung trang web.
CUSTOM_LABEL Toán hạng biểu thị điều kiện nhắm mục tiêu theo nhãn tuỳ chỉnh của trang web.

WebpageConditionOperator

Toán tử đ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ề. Biểu thị 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 của hằng số mục tiêu đị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 tiêu chí của 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 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 của chế độ xem độ tuổi có dạng như sau:

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

Thành phần

Thành phần là một phần của một quảng cáo và có thể được chia sẻ trên nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YouTubeVideoAsset), v.v. Các thành phần không thể thay đổi và không thể xoá được. Để ngừng phân phát một thành phần, hãy xoá thành phần đó khỏi thực thể đang sử dụng thành phần đó.

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Loại nội dung.

finalUrls[]

string

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

status

enum (AssetStatus)

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

creationTime

string

Dấu thời gian khi thành phần này được tạo. Dấu thời gian được tính theo múi giờ của khách hàng và ở định dạng "yyyy-MM-dd HH:mm:ss" .

lastModifiedTime

string

Ngày giờ khi thành phần này được sửa đổi lần gần đây nhất. Ngày giờ 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ủa công cụ cho một tài sản.

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

object (YoutubeVideoAsset)

Nội dung 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)

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

pageFeedAsset

object (UnifiedPageFeedAsset)

Một 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)

Một 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)

Một 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ể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
YOUTUBE_VIDEO Nội dung 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 của tính năng Đặ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 linh động về Giáo dục.
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à phòng 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ể có 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 được giá trị đã nhận. Đây là giá trị chỉ phản hồi.
ENABLED Đã bật thành phần.
REMOVED Thành phần đó đã bị xoá.
ARCHIVED Tài sản đã được lưu trữ.
PENDING_SYSTEM_GENERATED Thành phần này đang chờ người dùng tạo ra hệ thống.

AssetEngineStatus

Mã tiếp theo = 11

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
SERVING Tài sả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 này bị từ chối (không đủ điều kiện).
DISABLED Thành phần đó không hoạt động (đang chờ xử lý).
REMOVED Thành phần đó đã 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 11 ký tự được sử dụng trong URL 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 gốc.

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 được 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 MIME của văn bản/html.
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 về hình ảnh ở một kích thước nhất định, dù là 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

Một 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 lịch biểu không chồng chéo xác đị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 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 một tiêu chí AdSchedule.

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

Bạn không thể thêm quá 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)

Số 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 cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

endMinute

enum (MinuteOfHour)

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

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

dayOfWeek

enum (DayOfWeek)

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

Trường này là bắt buộc cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

startHour

integer

Giờ bắt đầu sau 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 cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

endHour

integer

Giờ kết thúc sau 24 giờ; 24 biểu thị cuối 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 cho các thao tác CREATE và bị cấm trong các thao tác CẬP NHẬT.

MinuteOfHour

Bảng liệt kê các quý trong giờ. Ví dụ: "FIFTEEN"

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
ZERO 0 phút trước giờ.
FIFTEEN 15 phút trước.
THIRTY 30 phút trước một giờ.
FORTY_FIVE 45 phút trước một giờ.

DayOfWeek

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
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 hợp nhất của trang web.

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 trong nội dung mô tả cho đường liên kết của trang web. Nếu được thiết lập, thì độ dài phải nằm trong khoảng từ 1 đến 35 (tính cả 2 giá trị đầu cuối) và cũng phải thiết lập đoạn mô tả 2.

description2

string

Dòng thứ hai trong nội dung mô tả cho đường liên kết của trang web. Nếu được đặt, độ dài phải nằm trong khoảng từ 1 đến 35 (tính cả 2 giá trị đầu cuối) và cũng phải đặt thuộc tính 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 lịch biểu không chồng chéo xác đị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ã nhận dạng đượ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à ứng dụng Yahoo! trường 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ó hiển thị thành phần đường liên kết của trang web 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 của trang.

MobileAppAsset

Thành phần đại diện cho một ứ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. 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 mã nhận dạng gốc của nền tảng, chẳng hạn như "com.android.ebay" dành cho Android hoặc "12345689" cho 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ề. Biểu thị 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 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

Một 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 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, thì hành động chuyển đổi mặc định sẽ được sử dụng. Trường này chỉ có hiệu lực nếu gọi

adScheduleTargets[]

object (AdScheduleInfo)

Danh sách lịch biểu không chồng chéo xác đị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 không có đường liên kết đến trang web hay không. Áp dụng cho Microsoft Ads.

callTrackingEnabled

boolean

Liệu cuộc gọi có được bật 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ề. Biểu thị 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ị tắt.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION Hành động chuyển đổi dẫn đến 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ề. Biểu thị 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 là 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 sẽ được áp dụng ngay bây giờ.
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à "book now".
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 Loại lời kêu gọi hành động là quyên góp ngay bây giờ.
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 về loại lời kêu gọi hành động trong phần này.
START_NOW Loại lời kêu gọi hành động là bắt đầu ngay bây giờ.
VISIT_SITE Loại lời kêu gọi hành động là hãy truy cập vào trang web.
WATCH_NOW Loại lời kêu gọi hành động là xem ngay.

UnifiedLocationAsset

Một 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 giúp xác định riêng một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Đây là trường dành riêng cho một mã khách hàng và loại thành phần nhất định. Hãy xem https://developers.google.com/places/web-service/place-id để tìm hiểu thêm về ID địa điểm.

businessProfileLocations[]

object (BusinessProfileLocation)

Danh sách các địa điểm doanh nghiệp của khách hàng. Thông tin này chỉ được trả về 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 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 là BUSINESS_OWNER, 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à LIÊN KẾT, thì vị trí đó sẽ được phân phát dưới dạng vị trí đơn vị liên kết.

BusinessProfileLocation

Dữ liệu vị trí trên 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 của 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ề. Biểu thị giá trị không xác định trong phiên bản này.
BUSINESS_OWNER Chủ doanh nghiệp có địa điểm(phần mở rộng về địa điểm cũ - LE).
AFFILIATE Vị trí đơ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à mối liên kết giữa một thành phần và một nhóm thành phần. Khi bạn thêm một AssetGroupAsset sẽ liên kết một thành phần với một nhóm thành phần.

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:

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

assetGroup

string

Nhóm thành phần mà thành phần trong nhóm thành phần này đang liên kết.

asset

string

Thành phần mà thành phần trong nhóm thành phần này đang liên kết.

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ể có của một tài sản.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
HEADLINE Thành phần này được liên kết để sử dụng làm dòng tiêu đề.
DESCRIPTION Tài sản này được liên kết để dùng làm nội dung mô tả.
MANDATORY_AD_TEXT Thành phần này đượ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 Thành phần này đượ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 dưới dạng gói phương tiện.
YOUTUBE_VIDEO Tài sản này được liên kết để sử dụng làm video trên YouTube.
BOOK_ON_GOOGLE Thành phần này được liên kết để cho biết rằng chiến dịch khách sạn là "Đặt phòng trên Google" bật.
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 để sử dụng dưới dạng 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.
HOTEL_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 cho khách sạn.
CALL Thành phần này được liên kết để sử dụng dưới dạng Phần mở rộng về cuộc gọi.
PRICE Thành phần này được liên kết để sử dụng dưới dạng Phần mở rộng về giá.
LONG_HEADLINE Thành phần này được liên kết để sử dụng làm 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ị hình 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 để sử dụng cho việc 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 để 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 làm cơ sở lưu trú khách sạn trong chiến dịch Tối đa hoá hiệu suất cho mục tiêu về du lịch.

AssetGroupSignal

AssetGroupSignal thể hiện một tín hiệu trong nhóm thành phần. Sự tồn tại của tín hiệu cho chiến dịch tối đa hoá hiệu suất biết ai có nhiều khả năng chuyển đổi nhất. Chiến dịch Tối đa hoá hiệu suất sử dụng tín hiệu này để tìm những người dùng mới có ý định tương tự hoặc rõ ràng hơn nhằm thu hút các lượt chuyển đổi trên Mạng Tìm kiếm, Mạng Hiển thị, Video, v.v.

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 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 kết hợp signal. Tín hiệu của nhóm thành phần. signal chỉ có thể là một trong những trạng thái sau đây:
audience

object (AudienceInfo)

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

AudienceInfo

Một 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 về Đối tượng.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter thể hiện một nút cây bộ lọc nhóm trang thông tin trong một nhóm thành phần.

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

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

assetGroup

string

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

id

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)

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 thành phần mẹ. Không xác định cho nhóm gốc.

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

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ề. Biểu thị 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 của trang thông tin.
UNIT_INCLUDED Một nút lá bộ lọc nhóm trang thông tin đi kèm.
UNIT_EXCLUDED Một nút lá của bộ lọc nhóm trang thông tin bị loại trừ.

ListingGroupFilterVertical

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 về 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 kết hợp dimension. Phương diện thuộc một trong các loại bên dưới luôn hiển thị. dimension chỉ có thể là một trong những trạng thái sau đây:
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 được chào bán.

productChannel

object (ProductChannel)

Thành phố của sản phẩm.

productCondition

object (ProductCondition)

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

productCustomAttribute

object (ProductCustomAttribute)

Thuộc tính tuỳ chỉnh của ưu đãi sản phẩm.

productItemId

object (ProductItemId)

Mã mặt hàng của ưu đãi sản phẩm.

productType

object (ProductType)

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

ProductBiddingCategory

Một phần tử của danh mục đặt giá thầu ở một cấp nhất định. Các danh mục cấp cao nhất là cấp 1, con của họ ở cấp 2, v.v. Chúng tôi hiện hỗ trợ tối đa 5 cấp. Người dùng phải chỉ định một loại phương diện cho biết cấp của danh mục. Tất cả các trường hợp của cùng một phân mục phải có cùng loại phương diện (cấp danh mục).

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 thông tin phân loại.

id

string (int64 format)

Mã nhận dạng của danh mục đặt giá thầu cho sản phẩm.

Mã này tương đương với mã google_product_category [danh_mục_sản_phẩm_của_Google] như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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.

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ả địa phương của sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 ưu đãi 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 một sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 đã được tân trang.
USED Tình trạng sản phẩm được sử dụng.

ProductCustomAttribute

Thuộc tính tuỳ chỉnh của ưu đãi 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 thuộc tính khách hàng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị giá trị không xác định trong phiên bản này.
INDEX0 Thuộc tính tuỳ chỉnh của 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 ưu đãi sản phẩm.

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

string

Giá trị của id.

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 kiểu.

ListingGroupFilterProductTypeLevel

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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

Lộ trình xác định các phương diện sẽ xác định một bộ lọc nhóm trang thông tin.

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ệ thống phân cấp bộ lọc nhóm trang thông tin (ngoại trừ nút gốc) đến bộ lọc nhóm trang thông tin này.

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 tổ hợp hàng đầu của nhóm thành phần. Tên tài nguyên của chế độ xem Kết hợp hàng đầu của AssetGroup có dạng: ""customer/{customerId}/assetGroupTopKết hợpViews/{asset_group_id}~{asset_results_category}"

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

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

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)

Thành phần được phân phát.

AssetUsage

Chứa thông tin về việc sử dụng 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 thành phầ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 thành phần có thể có.

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

Phiên bản này không xác định được 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 nội dung mô tả 1.
DESCRIPTION_2 Thành phần này được sử dụng trong nội dung mô tả 2.
HEADLINE Thành phần này được sử dụng trong một dòng tiêu đề. Chỉ sử dụng loại 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 các enum HEADLINE_1, HEADLINE_2 hoặc HEADLINE_3
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 sử dụng trong một dòng tiêu đề dài (dùng trong MultiAssetAdaptiveAd).
DESCRIPTION Nội dung được sử dụng trong phần mô tả. Chỉ sử dụng loại này nếu quảng cáo chỉ có một dòng mô tả. Nếu không, hãy sử dụng enum DESCRIPTION_1 hoặc DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT Thành phần này đượ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 ở dạng 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 Thành phầ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ị ở dạng 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 sử dụng làm video trên YouTube.
CALL Thành phần này được dùng làm 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 dưới dạng đ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 sử dụng dưới dạng 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 dùng để liên kết một thành phần với nhóm thành phần. AssetGroupSignal dùng để liên kết một tín hiệu với một nhóm thành phần.

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

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. Thành phần được liên kết với nhóm thành phần.

name

string

Bắt buộc. Tên của nhóm tài sản. Bắt buộc. Phải có độ dài tối thiểu là 1 và chiều dài tối đa là 128. Mã này phải là mã riêng biệt trong một chiến dịch.

finalUrls[]

string

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

finalMobileUrls[]

string

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

status

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 nối thêm vào url hiển thị trong quảng cáo.

path2

string

Phần thứ hai của văn bản có thể xuất hiện được nối thêm vào url hiển thị trong quảng cáo. Bạn chỉ có thể đặt trường này khi đã đặt path1.

adStrength

enum (AdStrength)

Độ mạnh tổng thể của quảng cáo của 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 được giá trị đã nhận.
ENABLED Nhóm thành phần đã được bật.
PAUSED Nhóm thành phần đã bị tạm dừng.
REMOVED Nhóm thành phần đã bị xoá.

AdStrength

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 thể tạo quảng cáo.
POOR Sức mạnh kém.
AVERAGE Cường độ trung bình.
GOOD Sức mạnh tốt.
EXCELLENT Sức mạnh rất tốt.

AssetSetAsset

AssetSetAsset là mối liên kết giữa một tài sản và một nhóm tài sản. Khi bạn thêm một AssetSetAsset, một tài sản sẽ được liên kết với một nhóm thành phần.

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

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

AssetSetAssetStatus

Các trạng thái có thể có của thành phần 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 được 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 của nhóm thành phần bị xoá.

AssetSet

Một nhóm thành phần đại diện cho một tập hợp các thành phần. Sử dụng AssetSetAsset để liên kết một thành phần với nhóm thành phần.

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

string (int64 format)

Mã của nhóm thành phầ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 như sau:

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 chiến lược đặt giá thầu có dạng như sau:

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ế độ 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 đặt lược đồ đặt giá thầu.

Trường này ở chế độ 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 chiến lược đặt giá thầu đối với khách hàng là người quản lý, bạn có thể thiết lập đơn vị tiền tệ này khi tạo và đặt đơn vị tiền tệ mặc định theo đơn vị tiền tệ của khách hàng là người quản lý. Để phục vụ khách hàng, bạn không được đặt trường này; tất cả các chiến lược trong một khách hàng phân phát đều ngầm sử dụng đơn vị tiền tệ của khách hàng phân phát. Trong mọi trường hợp, trường hiệu quảMã đơn vị tiền tệ 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. Tất cả chiến lược đặt giá thầu trong tài khoản phải được đặt tên riêng biệt.

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

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 chiến lược đặt giá thầu của khách hàng là người quản lý, đây là đơn vị tiền tệ do nhà quảng cáo đặt khi tạo chiến lược. Để phục vụ khách hàng, đây là mã đơn vị tiền tệ của khách hàng.

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

Trường này ở chế độ chỉ đọc.

campaignCount

string (int64 format)

Số lượng chiến dịch sử dụng chiến lược đặt giá thầu này.

Trường này ở chế độ chỉ đọc.

nonRemovedCampaignCount

string (int64 format)

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

Trường này ở chế độ chỉ đọc.

Trường kết hợp scheme. Giao thức đặt giá thầu.

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

enhancedCpc

object (EnhancedCpc)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

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á theo 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ệ mục tiêu của phiên đấu giá mà nhà quảng cáo phải nâng thứ hạng của một đối thủ cạnh tranh cụ thể. Trường này không được dùng nữa. Bạn sẽ không thể tạo chiến lược đặt giá thầu mới với trường này hoặc đính kèm chiến lược đặt giá thầu có trường này vào chiến dịch. Bạn có thể thay đổi các chiến lược đã điền sẵn lược đồ này.

targetRoas

object (TargetRoas)

Chiến lược đặt giá thầu giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được lợi tức trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

Các trạng thái có thể có của một Chiến lược đặt giá thầu.

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

Phiên bản này không xác định được 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 này sẽ bị xoá.

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ề. Biểu thị 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 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 hơn và giảm giá thầu cho các nhấp chuột mà chúng có vẻ ít có khả năng dẫn đến chuyển đổi hơn.
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ụ: một chiến dịch có thể được liên kết 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 quảng cáo 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 dành cho người quản lý (hiện không thể truy cập) 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 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ị.
MANUAL_CPV Chiến lược đặt giá thầu trả 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 hiển thị trên trang một hoặc trang một vùng được quảng cáo trên google.com.vn. Giá trị enum này không được dùng nữa.
PERCENT_CPC Percent Cpc là chiến lược đặt giá thầu, trong đó giá thầu bằng một phần nhỏ 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à 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 chuyển đổi nhất có thể với mức giá mỗi chuyển đổi (CPA) mục tiêu mà bạn đã đặt.
TARGET_CPM CPM mục tiêu là một chiến lược đặt giá thầu tự động. Chiến lược này sẽ đặt giá thầu để giúp bạn nhận được nhiều lượt 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 Một chiến lược đặt giá thầu tự động sẽ đặt giá thầu sao cho một tỷ lệ phần trăm quảng cáo tìm kiếm nhất định xuất hiện ở đầu trang đầu tiên (hoặc vị trí khác được nhắm mục tiêu).
TARGET_OUTRANK_SHARE Tỷ lệ xếp hạng mục tiêu cao hơn là một 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 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 ROAS mục tiêu là một chiến lược đặt giá thầu tự động giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được ROAS mục tiêu cụ thể.
TARGET_SPEND Mức chi tiêu mục tiêu là một chiến lược giá thầu tự động. Chiến lược này đặ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.

EnhancedCpc

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

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

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 HandCpc với nâng caoCpcEnabled đượ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 bạn nhận được giá trị chuyển đổi cao nhất cho chiến dịch khi chi tiêu ngân sách.

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

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý. Chỉ có thể thay đổi cho chiến lược đặt giá thầu danh mục đầu tư.

cpcBidFloorMicros

string (int64 format)

Hạn mức 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 trong khi vẫn đạt được mức lợi tức mục tiêu trên chi tiêu quảng cáo. Nếu ROAS mục tiêu cao, chiến lược giá thầu có thể không chi tiêu được toàn bộ ngân sách. Nếu bạn không đặt ROAS mục tiêu, chiến lược giá thầu sẽ nhắm đến việc đạt được ROAS cao nhất có thể trong phạm vi ngân sách.

MaximizeConversions

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

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

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý. Chỉ có thể thay đổi cho chiến lược đặt giá thầu danh mục đầu tư.

cpcBidFloorMicros

string (int64 format)

Hạn mức 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 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ệ trong chiến lược đặt giá thầu. Nếu được đặt, chiến lược giá thầu 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ẽ cố gắng đạt được CPA thấp nhất có thể trong phạm vi ngân sách.

TargetCpa

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

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

cpcBidCeilingMicros

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý. 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)

Hạn mức 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

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

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ệ phần trăm quảng cáo được chọn sẽ hiển thị ở vị trí được nhắm mục tiêu tính theo micro giây. Ví dụ: 1% bằng 10.000.

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 giá trị trần và được chỉ định trong phạm vi cục bộ.

TargetImpressionShareLocation

Enum mô tả các mục tiêu có thể đạt được.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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í trên cùng trong hộp quảng cáo trên cùng.

TargetOutrankShare

Chiến lược đặt giá thầu tự động đặt giá thầu dựa trên tỷ lệ mục tiêu của phiên đấu giá mà nhà quảng cáo nên 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)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý.

TargetRoas

Một chiến lược đặt giá thầu tự động giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được một mức lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

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, gồm cả hai giá trị đó.

cpcBidCeilingMicros

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý. 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)

Hạn mức 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 đặt giá thầu tự động giúp bạn đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình.

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý.

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)

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

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

period

enum (BudgetPeriod)

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

amountMicros

string (int64 format)

Số tiền ngân sách, bằng nội tệ cho tài khoản. Số tiền được chỉ định bằng phần triệu, trong đó một triệu tương đương với một đơn vị tiền tệ. Giới hạn chi tiêu hằng tháng tối đa là 30,4 lần số tiền này.

BudgetDeliveryMethod

Phương thức phân phối có thể có của Ngân sách.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 việc 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 điều tiết 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ủa Ngân sách.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 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 thêm một chiến dịch mới, 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 hoá 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 các quảng cáo trong chiến dịch. Bạn có thể tinh chỉnh các lựa chọn nhắm mục tiêu trong networkSettings.

Đây là trường bắt buộc và không được để trống khi tạo chiến dịch mới.

Chỉ có thể thiết lập khi tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường này.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

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

Chỉ có thể thiết lập khi tạo chiến dịch. Sau khi tạo chiến dịch, bạn không thể thay đổi trường này.

urlCustomParameters[]

object (CustomParameter)

Danh sách 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 theo thời gian thực, tính năng chỉ có sẵn cho các chiến dịch nhắm mục tiêu mạng Ad Exchange.

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 tiêu chí nhắm mục tiêu theo địa lý của quảng cáo.

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 trường biddingStrategy để tạo chiến lược giá thầu danh mục đầu tư.

Trường này ở chế độ chỉ đọc.

accessibleBiddingStrategy

string

Tên tài nguyên của Accessible BiddingStrategy, một chế độ xem chỉ có thể đọc cho các thuộc tính không bị hạn chế của chiến lược đặt giá thầu danh mục đầu tư đính kèm được xác định bằng "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 này đều có thể sử dụng các thuộc tính chiến lược không bị hạn chế cũng như được đọc trong tài nguyên AccessibleBidStrategy. Ngược lại, các thuộc tính bị hạn chế chỉ được cung cấp cho khách hàng là chủ sở hữu của chiến lược và người quản lý của chiến lược đó. Bạn chỉ có thể đọc các thuộc tính bị hạn chế trong tài nguyên BiddingStrategy.

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 ứng dụng sử dụng MULTI_CHANNEL làm AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT làm 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 thực thể Google Ads, hãy sử dụng "campaign.id" thay thế.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Các loại trường thành phần sẽ bị loại trừ khỏi chiến dịch này. Chiến dịch này sẽ không kế thừa những đường liên kết tài sản có các loại trường này ở cấp cao hơn.

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" . createTime sẽ không được dùng nữa trong phiên bản 1. Thay vào đó, hãy sử dụng creatorTime.

creationTime

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

lastModifiedTime

string

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

id

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.

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

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 chiến dịch bắt đầu phân phát theo múi giờ của khách hàng theo định dạng YYYY-MM-DD.

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 theo định dạng YYYY-MM-DD. Khi tạo, giá trị mặc định là 2037-12-30, nghĩa là chiến dịch sẽ chạy vô thời hạn. Để đặt một chiến dịch hiện tại chạy vô thời hạn, hãy đặt trường này thành 2037-12-30.

finalUrlSuffix

string

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

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 cụ thể hơn. Nếu bạn chọn không sử dụng (true), thì chỉ các URL cuối cùng trong nhóm thành phần hoặc các URL được chỉ định trong Google Merchant Center hoặc nguồn cấp dữ liệu doanh nghiệp của nhà quảng cáo mới được nhắm đến. Nếu chọn sử dụng (false), toàn bộ miền sẽ được nhắm mục tiêu. Bạn chỉ có thể đặt trường này cho những chiến dịch Tối đa hoá hiệu suất có giá trị mặc định là false.

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

Phải là danh mục đầu tư (được tạo thông qua dịch vụ Đặt giá thầu) hoặc danh mục chuẩn được nhúng vào chiến dịch. campaign_bidding_strategy chỉ có thể là một trong những trạng thái sau đây:

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. Chỉ được hỗ trợ cho 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 chuẩn. Đặt giá thầu dựa trên lượt nhấp thủ công, trong đó người dùng trả tiền cho mỗi lượt nhấp.

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 hoá lượt chuyển đổi chuẩn tự động tối đa hoá số lượt chuyển đổi trong khi chi tiêu ngân sách của bạn.

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

Chiến lược đặt giá thầu ROAS mục tiêu chuẩn giúp tự động tối đa hoá doanh thu trong khi vẫn đạt được một mức lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

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

Các 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ề. Biểu thị 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 Chiến dịch đã bị người dùng tạm dừng.
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 Chưa chỉ định giá trị nào.
UNKNOWN

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

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

SERVING Đang phân phát.
NONE Không có.
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 chiến lược Đặt giá thầu.

Enum
UNSPECIFIED 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 về trạng thái.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 này mới được tạo hoặc kích hoạt lại gần đây.
LEARNING_SETTING_CHANGE Chiến lược giá thầu đang học do có sự thay đổi gần đây đối với chế độ cài đặt.
LEARNING_BUDGET_CHANGE Chiến lược giá thầu đang học do có sự thay đổi về ngân sách gần đây.
LEARNING_COMPOSITION_CHANGE Chiến lược giá thầu đang học do thay đổi gần đây về số lượng chiến dịch, nhóm quảng cáo hoặc từ khoá đi kèm với chiến lược đó.
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à những loại chuyển đổi đã sửa đổi gần đây của khách hàng có liên quan đến chiến lược giá thầu.
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.
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 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ể 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 được mức chi tiêu mục tiêu 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 Chiến dịch mua sắm thông minh (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 thiếu loại chuyển đổi có thể được báo cáo theo 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 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à hiện không phân phát.
PAUSED Chiến lược giá thầu hiện 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 được đính kèm với chiến lược giá thầu. Hoặc không có ngân sách nào đang hoạt động đượ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ợ tính năng báo cáo trạng thái.
MULTIPLE_LEARNING Có nhiều trạng thái hệ thống LearnING_* cho chiến lược giá thầu này trong khoảng 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 khoảng 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 Chưa chỉ định giá trị nào.
UNKNOWN

Phiên bản này không xác định được 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 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 nằm trong chiến lược đặt giá thầu của trình tối ưu hóa chuyển đổi, thì 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 có hiệu suất cao hơn và không tối ưu hoá.
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 khác nhau.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 gói và chiến dịch Tìm kiếm+.
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.
SOCIAL Chiến dịch trên trang xã hội.

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ề. Biểu thị 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 di động cho Tìm kiếm.
DISPLAY_MOBILE_APP Chiến dịch Quảng cáo ứng dụng di động cho Hiển thị.
SEARCH_EXPRESS Chiến dịch AdWords express cho tìm kiếm.
DISPLAY_EXPRESS Chiến dịch AdWords Express cho 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. Không thể tạo 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 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 cho phé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 (bao gồm Mạng Tìm kiếm, YouTube và Mạng Hiển thị của Google).
LOCAL_CAMPAIGN Các chiến dịch chuyên về quảng cáo địa phương.
SHOPPING_COMPARISON_LISTING_ADS Chiến dịch danh sách so sánh giá.
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 quảng cáo lượt đăng ký trước ứng dụng di động và 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.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook chỉ theo dõi các chiến dịch trên mạng xã hội.

CustomParameter

Ánh xạ có thể được các thẻ thông số tùy chỉnh 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 thay thế.

RealTimeBiddingSetting

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

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

boolean

Liệu chiến dịch có được chọn 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 trên các vị trí cụ thể trong Mạng Hiển thị của Google hay không. Vị trí được chỉ định bằng tiêu chí Vị trí.

targetPartnerSearchNetwork

boolean

Quảng cáo có được phân phát trên Mạng đối tác của Google hay không. Tính năng này chỉ dành cho một số tài khoản đối tác của Google được chọn.

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, chẳng hạn như "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

Chiến dịch có sử dụng URL độc quyền 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 nhiều loại sản phẩm mà chiến dịch có thể quảng cáo và cách chiến dịch này tương tác với các chiến dịch Mua sắm khác.

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 cần thêm vào chiến dịch. Bạn chỉ có thể đặt một trong hai giá trị feedLabel hoặc salesCountry. Nếu được dùng thay cho salesCountry, thì trường feedLabel sẽ chấp nhận mã quốc gia ở cùng định dạng, ví dụ như "XX". Nếu không, có thể là bất kỳ chuỗi nào dùng cho nhãn nguồn cấp dữ liệu trong Google Merchant Center.

useVehicleInventory

boolean

Liệu có nhắm đến khoảng không quảng cáo của 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 cho các thao tác tạo. Trường này không thể thay đổi cho chiến dịch Mua sắm.

salesCountry

string

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

campaignPriority

integer

Mức độ ưu tiên của chiến dịch. Các chiến dịch có mức độ ưu tiên cao hơn về mặt số lượng sẽ được ưu tiên hơn các chiến dịch có mức độ ưu tiên thấp hơn. Đây là trường bắt buộc đối với chiến dịch Mua sắm, có giá trị từ 0 đến 2. Trường này không bắt buộc đối với chiến dịch Mua sắm thông minh, nhưng nếu bạn đặt trường này thì giá trị phải bằng 3.

enableLocal

boolean

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

GeoTargetTypeSetting

Trình bày tập hợp các chế độ cài đặt liên quan đến việc nhắm mục tiêu theo địa lý của quảng cáo.

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
PRESENCE_OR_INTEREST Chỉ định rằng một quảng cáo sẽ được kích hoạt nếu người dùng ở trong 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 một quảng cáo được kích hoạt khi người dùng tìm kiếm vị trí được nhắm mục tiêu của nhà quảng cáo. Bạn chỉ có thể sử dụng tính năng này cho chiến dịch Tìm kiếm và chiến dịch Mua sắm thông thường.
PRESENCE Chỉ định một quảng cáo được kích hoạt nếu người dùng đang ở hoặc thường xuyên ở vị trí mà nhà quảng cáo nhắm mục tiêu.

NegativeGeoTargetType

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Phiên bản này không xác định được giá trị.
PRESENCE_OR_INTEREST Chỉ định rằng người dùng bị loại trừ khỏi việc nhìn thấy quảng cáo nếu họ ở trong 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ọ ở vị trí bị loại trừ của nhà quảng cáo.

FrequencyCapEntry

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

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 ứng dụng sử dụng MULTI_CHANNEL làm AdvertisingChannelType và APP_CAMPAIGN hoặc APP_CAMPAIGN_FOR_ENGAGEMENT làm 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ề. Biểu thị 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. Số 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 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 chỉ đường lái xe là số lần mọi người đã chọn "Xem đường đi" để điều hướng đến 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. Số 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 dùng để theo dõi linh động.

ManualCpa

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

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 nào.

Đặ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 trong đó giá thầu bằng một phần giá quảng cáo đối với một số hàng hóa hoặc dịch vụ.

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

string (int64 format)

Hạn mức 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 phần cực nhỏ cục bộ. Lưu ý: Giá trị bằng 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á tăng hoặc giảm, 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 nào.

CPM (chi phí mỗi nghìn lượt hiển thị) mục tiêu 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

Mối liên kết giữa Chiến dịch và Tài sả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 với tài sản.

asset

string

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

CampaignAssetSet

CampaignAssetSet là mối liên kết giữa một chiến dịch và một nhóm thành phần. Khi bạn thêm CampaignAssetSet, một nhóm thành phần sẽ được liên kết với một chiến dịch.

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 mà tập hợp thành phần này được liên kết.

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 chiến dịch. Chỉ có thể đọc.

CampaignAudienceView

Chế độ xem đối tượng chiến dịch. Bao gồm dữ liệu hiệu suất từ các mối quan tâm, danh sách tái tiếp thị cho quảng cáo trên Mạng Hiển thị và quảng cáo trên Mạng YouTube, cũng như danh sách tái tiếp thị dành cho quảng cáo tìm kiếm (RLSA), được tổng hợp theo tiêu chí chiến dịch và tiêu chí đối tượng. Chế độ xem này chỉ bao gồm đối tượng được đính kèm ở cấp chiến dịch.

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

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

criterionId

string (int64 format)

Mã của tiêu chí.

Trường này bị bỏ qua khi thay đổi.

bidModifier

number

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

negative

boolean

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

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

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

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 vị trí

CampaignCriterionStatus

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

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

Phiên bản này không xác định được 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 của hằng số ngôn ngữ.

LocationGroupInfo

Bán kính xung quanh một danh sách 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 địa lý giúp hạn chế phạm vi khu vực địa lý trong nguồn cấp dữ liệu. Hiện 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 nguồn cấp dữ liệu. Đây là yêu cầu bắt buộc và phải được thiết lập trong thao tác CREATE.

feedItemSets[]

string

FeedItemSets có nguồn cấp dữ liệu đượ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 trong các đơn vị xác định bán kính xung quanh vị trí được nhắm mục tiêu. Đây là yêu cầu bắt buộc và phải được thiết lập 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ề. Biểu thị 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 của tài nguyên. Tên tài nguyên nhãn 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 lượt bán hàng trong 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 hàng trong dữ liệu giỏ hàng có dạng: customers/{customerId}/cartDataSalesView

Đối tượng

Đối tượng là một lựa chọn nhắm mục tiêu hiệu quả, cho phép bạn phân tách các thuộc tính phân khúc (chẳng hạn như thông tin chi tiết về nhân khẩu học và đối tượng chung sở thích) để tạo đối tượng đại diện cho các phần trong phân khúc mục tiêu của bạn.

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. Thông tin này cần phải khác biệt với tất cả các đối tượng. Phải có độ dài tối thiểu là 1 và chiều dài tối đa là 255.

description

string

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

ConversionAction

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

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Dấu thời gian tạo hoạt động Floodlight, được định dạng theo 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 của 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 các 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ị PrimaryForTarget của hành động chuyển đổi là false, thì bạn không thể đặt giá thầu cho hành động chuyển đổi đó cho tất cả các chiến dịch, bất kể mục tiêu lượt chuyển đổi của khách hàng hoặc mục tiêu lượt chuyển đổi của chiến dịch. Tuy nhiên, mục tiêu lượt chuyển đổi tuỳ chỉnh không tuân theo nguyên tắc PrimaryForTarget. Vì vậy, nếu một chiến dịch có mục tiêu lượt chuyển đổi tuỳ chỉnh được định cấu hình với hành động chuyển đổi primaryForTarget = sai, thì hành động chuyển đổi đó vẫn có thể đặt giá thầu. Theo mặc định, primaryForTarget sẽ có giá trị 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 'cập nhật' vì 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 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 cột "clientAccountConversions" hay không chỉ số.

includeInConversionsMetric

boolean

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

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

appId

string

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

ConversionActionStatus

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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ề. Biểu thị giá trị không xác định trong phiên bản này.
AD_CALL 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 quảng cáo.
CLICK_TO_CALL Lượt chuyển đổi xảy ra khi người dùng trên thiết bị di động nhấp vào một số điện thoại.
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 bằng các lượt nhấp được phân bổ.
WEBPAGE Lượt chuyển đổi xảy ra trên một trang web.
WEBSITE_CALL Lượt chuyển đổi xảy ra khi người dùng gọi đến một số điện thoại được tạo tự độ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 người bán của bên thứ nhất hoặc bên thứ ba mà bạn tải lên. Chỉ những khách hàng 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 từ 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 người bán của bên thứ nhất hoặc bên thứ ba được tải lên và/hoặc từ các lượt mua hàng tại cửa hàng thực tế bằng thẻ từ 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 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 mở lần đầu trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua trong ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_ANDROID_CUSTOM Lượt chuyển đổi tuỳ chỉnh của ứng dụng Android được theo dõi thông qua Firebase.
FIREBASE_IOS_FIRST_OPEN Lượt chuyển đổi lần mở đầu tiên trong ứng dụng iOS được theo dõi thông qua Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Lượt chuyển đổi giao dịch mua 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 đối với ứng dụng iOS được theo dõi thông qua Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Lượt chuyển đổi lần mở đầu tiên trong ứng dụng Android được theo dõi thông qua dịch vụ 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 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 đối với ứng dụng Android được theo dõi thông qua công cụ Phân tích ứng dụng bên thứ ba.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Lượt chuyển đổi mở lần đầu trong ứng dụng iOS được theo dõi thông qua công cụ 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 trong ứng dụng iOS đượ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 trong ứng dụng iOS được theo dõi thông qua công cụ 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ả lượt tải xuống trên Google Play không được theo dõi theo 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 đã 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 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 đượ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 của chiến dịch Thông minh mà không thiết lập tính năng theo dõi cuộc gọi, sử dụ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 xem đường đi đến một địa điểm 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 diễn ra trên Quảng cáo trong chiến dịch Thông minh được thiết lập tính năng theo dõi cuộc gọi, sử dụng tiêu chí tùy 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 một 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 được 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ừ lượt chuyển đổi giao dịch mua trên Google Analytics 4 được liên kết.

ConversionActionCategory

Danh mục chuyển đổi được liên kết với một ConversionAction.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 Lượt mua hàng, lượt bán hàng hoặc "đã đặt hàng" sự kiện.
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 túi hoặc giỏ hàng 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 Lệnh gọi để cho biết họ 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 một trang web của nhà quảng cáo cho thấy mối quan tâm kinh doanh.
BOOK_APPOINTMENT Lượt đặ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 ước tính giá.
GET_DIRECTIONS Lượt tìm kiếm địa điểm doanh nghiệp của một nhà quảng cáo và 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, tin nhắn SMS, email, cuộc trò chuyện hoặc các loại thông tin 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 dài trên trang web hoặc Mục tiêu thông minh trên Google Analytics (GA). Dành để sử dụng để nhập mục tiêu Vàng GA, Firebase, GA.
STORE_VISIT Lượt ghé qua vị trí cửa hàng thực tế.
STORE_SALE Bán hàng diễn ra tại cửa hàng thực tế.
QUALIFIED_LEAD Một 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 và đã được nhà quảng cáo (nhóm tiếp thị/bán hàng) đủ điều kiện hơn nữa. 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 thu hút khách hàng tiềm năng, sau đó tiếp cận người tiêu dùng dựa vào dữ liệu khách hàng tiềm năng để hành độ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 Một 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 và đã hoàn thành thêm một giai đoạn đã chọ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 các sự kiện chuyển đổi cho hành động chuyển đổi này được gửi kèm theo một giá trị không hợp lệ, không được phép hoặc bị thiếu, hoặc khi hành động chuyển đổi này được định cấu hình để luôn sử dụng giá trị mặc định.

defaultCurrencyCode

string

Mã đơn vị tiền tệ để sử dụng khi sự kiện chuyển đổi cho hành động chuyển đổi này được gửi cùng với mã đơn vị tiền tệ không hợp lệ hoặc bị thiếu mã đơn vị tiền tệ hoặc khi hành động chuyển đổi này được định cấu hình để luôn sử dụng giá trị mặc định.

alwaysUseDefaultValue

boolean

Kiểm soát việc có sử dụng giá trị mặc định và mã đơn vị tiền tệ mặc định thay cho giá trị và mã đơn vị tiền tệ được chỉ định trong các sự kiện chuyển đổi cho hành động chuyển đổi này hay không.

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ổ này 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 đó.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 của 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 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 bằng cách sử dụng mô hình phân bổ của 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 (thời gian 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 sẽ đượ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 cách phân bổ hợp lý giá trị đóng góp cho các lượt nhấp bằng cách sử dụng mô hình phân bổ của Google Tìm kiếm.

DataDrivenModelStatus

Liệt kê 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ề. Biểu thị giá trị không xác định trong phiên bản này.
AVAILABLE Bạn có thể sử dụng 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. Chưa được cập nhật trong ít nhất 7 ngày. Mã 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. Bạn chưa cập nhật ứng dụng này trong ít nhất 30 ngày nên bạn không thể dùng thẻ này. Trường hợp này thường xảy ra nhất do không 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 Chưa từng tạo mô hình dựa trên dữ liệu. Trường hợp này phổ biến nhất là do chưa từng có đủ số lượng sự kiện được yêu cầu trong khoảng thời gian 30 ngày bất kỳ.

FloodlightSettings

Chế độ cài đặt liên quan đến hành động chuyển đổi 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 một nhóm hoạt động Floodlight khi báo cáo lượt chuyển đổi.

activityTag

string

Chuỗi được dùng để xác định 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 phương diện và chỉ số Floodlight tuỳ chỉnh trong Search Ads 360 mới" tại https://support.google.com/sa360/answer/13567857

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 tùy chỉnh lượt chuyển đổi. Tên tài nguyên biến tùy chỉnh của lượt chuyển đổi có dạng như sau:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

Mã của biến tuỳ chỉnh lượt chuyển đổi.

name

string

Bắt buộc. Tên của biến tuỳ chỉnh cho lượt chuyển đổi. Tên phải là duy nhất. Độ dài tối đa của tên là 100 ký tự. Không được có thêm dấu cách ở trước và sau.

tag

string

Bắt buộc. Thẻ của biến tùy chỉnh lượt chuyển đổi. Thẻ phải là duy nhất và chứa chữ "u" ký tự trực tiếp theo sau bằng một số nhỏ hơn hoặc bằng 100. Ví dụ: "u4".

status

enum (ConversionCustomVariableStatus)

Trạng thái của biến tuỳ chỉnh lượt chuyển đổi để tích luỹ sự kiện chuyển đổi.

ownerCustomer

string

Tên tài nguyên của khách hàng sở hữu biến tuỳ chỉnh cho lượt chuyển đổi.

family

enum (ConversionCustomVariableFamily)

Nhóm biến tuỳ chỉnh cho lượt chuyển đổi.

cardinality

enum (ConversionCustomVariableCardinality)

Số lượng giá trị riêng biệt của biến tuỳ chỉnh lượt chuyển đổi.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Các trường dành cho biến tuỳ chỉnh của lượt chuyển đổi Floodlight trong Search Ads 360.

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 tùy chỉnh lượt chuyển đổi.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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.

Không thể dùng trạng thái này trong 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 lượt chuyển đổi đã bị tạm dừng và sẽ không tích lũy số liệu thống kê cho đến khi bạn đặt lại thành BẬT.

ConversionCustomVariableFamily

Nhóm 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ề. Biểu thị giá trị không xác định trong phiên bản này.
STANDARD Biến tuỳ chỉnh của 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

Số lượng giá trị riêng biệt 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ề. Biểu thị giá trị không xác định trong phiên bản này.
BELOW_ALL_LIMITS Biến tuỳ chỉnh của 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 biến đó được bật.
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 số liệu thống kê. Phân đoạn sẽ bị vô hiệu hoá, nhưng thống kê có thể tích luỹ cho các giá trị mới nếu biến được bật.
APPROACHES_STATS_LIMIT Biến tùy chỉnh 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 của số liệu thống kê (> 90%). Phân đoạn sẽ bị vô hiệu hoá, nhưng thống kê có thể tích luỹ cho các 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 của số liệu thống kê. Phân đoạn sẽ bị vô hiệu hoá và số liệu thống kê cho các 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 số lượng giá trị riêng biệt của biến thêm nữa.

FloodlightConversionCustomVariableInfo

Thông tin về Biến tuỳ chỉnh của 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 của 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ề. Biểu thị giá trị không xác định trong phiên bản này.
DIMENSION Loại biến Floodlight phương diện.
METRIC Loại biến floodlight 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ề. Biểu thị giá trị không xác định trong phiên bản này.
NUMBER Đại diện cho một biến floodlight "Số" loại. Bạn có thể chỉ định biến này cho các biến Floodlight thuộc loại DIMENSION hoặc METRIC.
STRING Đại diện cho một biến floodlight của "Chuỗi" loạ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 dành cho khách hàng có dạng:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Cài đặt theo dõi 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 Nhật Bản, Baidu, Facebook, Engine Track, v.v.

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Cài đặt Trình quản lý chiến dịch DoubleClick (DCM) cho một khách hàng là người quản lý.

accountStatus

enum (AccountStatus)

Trạng thái tài khoản, ví dụ: Đã 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ờ 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 được tính 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. Một số mã đơn vị tiền tệ theo tiêu chuẩn ISO 4217 sẽ được hỗ trợ.

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 từ 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ế độ 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. Mã này cho biết liệu khách hàng có đang sử dụng tính năng theo dõi lượt chuyển đổi hay không và ai là chủ sở hữu tính năng theo dõi lượt chuyển đổi của khách hàng này. Nếu khách hàng này đang sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản, thì giá trị được trả về sẽ khác nhau dựa trên 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ế độ chỉ đọc.

googleAdsConversionCustomer

string

Tên tài nguyên của khách hàng nơi tạo và quản lý lượt chuyển đổi. Trường này ở chế độ chỉ đọc.

conversionTrackingId

string (int64 format)

Id theo dõi chuyển đổi được sử dụng cho tài khoản này. Mã này không cho biết liệu khách hàng có sử dụng tính năng theo dõi lượt chuyển đổi hay không (conversionTrackingStatus). Trường này ở chế độ chỉ đọc.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

Id theo dõi chuyển đổi của người quản lý của khách hàng. Thuộc tính này được đặt khi khách hàng chọn sử dụng tính năng theo dõi lượt chuyển đổi và sẽ ghi đè 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ế độ chỉ đọc.

crossAccountConversionTrackingId

string (int64 format)

Id theo dõi chuyển đổi của người quản lý của khách hàng. Giá trị này được đặt khi khách hàng chọn sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản và sẽ ghi đè 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ề. Biểu thị 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 Hành động chuyển đổi do người quản lý được chỉ định trong login-customer-id của yêu cầu tạo và quản lý.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Hành động chuyển đổi do một người quản lý tạo và quản lý, khác với 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ề. Biểu thị 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.
FACEBOOK_GATEWAY Tài khoản Facebook được quản lý qua cổng vào.
GOOGLE_ADS Tài khoản Google Ads.
MICROSOFT Tài khoản Microsoft Advertising của bạn.
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 một 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ã nhận dạng của nhà quảng cáo Campaign Manager được liên kết với khách hàng này.

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ờ của IANA, chẳng hạn như America/New_ Được.

AccountStatus

Các trạng thái có thể có của 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ị vô hiệu hoá theo một 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 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ề. Biểu thị 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 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.
CLOSED Cho biết một 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 CỬA. Trạng thái là vĩnh viễn và có thể không 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 thành phần khách hàng.

CustomerAssetSet

CustomerAssetSet là mối liên kết giữa khách hàng và nhóm thành phần. Khi bạn thêm một CustomerAssetSet, một nhóm thành phần sẽ được liên kết với một khách hàng.

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 khách hàng. Chỉ có thể đọc.

AccessibleBiddingStrategy

Thể hiện chế độ xem Đặt giá thầu do khách hàng sở hữu và chia sẻ với khách hàng.

Trái ngược với BiddingStrategy, tài nguyên này bao gồm các chiến lược do người quản lý của khách hàng sở hữu và được chia sẻ với khách hàng này, ngoài các chiến lược mà khách hàng này sở hữu. Tài nguyên này không cung cấp các chỉ số và chỉ trình bày một số ít thuộc tính Đặt giá thầu.

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 có thể truy cập. Tên tài nguyên AccessibleBidStrategy 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 kết hợp scheme. Giao thức đặt giá thầu.

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

maximizeConversionValue

object (MaximizeConversionValue)

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

maximizeConversions

object (MaximizeConversions)

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

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á theo 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 hoá doanh thu trong khi vẫn đạt được lợi tức trên chi tiêu quảng cáo (ROAS) mục tiêu cụ thể.

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

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 trong khi vẫn đạt được mức lợi tức mục tiêu trên chi tiêu quảng cáo. Nếu ROAS mục tiêu cao, chiến lược giá thầu có thể không chi tiêu được toàn bộ ngân sách. Nếu bạn không đặt ROAS mục tiêu, chiến lược giá thầu sẽ nhắm đến việc đạt được ROAS cao nhất có thể trong phạm vi ngân sách.

MaximizeConversions

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

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

string (int64 format)

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

targetCpaMicros

string (int64 format)

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

TargetCpa

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

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

TargetImpressionShare

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

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ệ phần trăm quảng cáo được chọn sẽ hiển thị ở vị trí được nhắm mục tiêu tính theo micro giây. Ví dụ: 1% bằng 10.000.

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 giá trị trần và được chỉ định trong phạm vi cục bộ.

TargetRoas

Một chiến lược đặt giá thầu tự động giúp bạn tối đa hoá doanh thu trong khi vẫn đạt được 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ể.

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 đặt giá thầu tự động giúp bạn đặt giá thầu để giúp bạn nhận được nhiều lượt nhấp nhất có thể trong phạm vi ngân sách của mình.

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

cpcBidCeilingMicros

string (int64 format)

Hạn mức giá thầu tối đa mà chiến lược giá thầu có thể đặt. Giới hạn này áp dụng cho tất cả từ khóa do chiến lược quản lý.

ManagerLinkStatus

Các 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ề. Biểu thị giá trị không xác định trong phiên bản này.
ACTIVE Cho biết mối quan hệ có hiệu lực hiện tại
INACTIVE Cho biết mối quan hệ đã kết thúc
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 Mối quan hệ đã được người quản lý yêu cầu, 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 khách hàng cụ thể và khách hàng của khách hàng. Đối tượng CustomerClient chỉ dành cho khách hàng là người quản lý. Tất cả khách hàng trực tiếp và gián tiếp của khách hàng đều được bao gồm, cũng như bản thân người quản lý.

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 ứng dụng 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 những nhãn thuộc sở hữu của khách hàng đưa ra yêu cầu được áp dụng cho khách hàng của khách hàng. Tên tài nguyên nhãn có dạng:

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 một khách hàng cụ thể. Chỉ có thể đọc.

hidden

boolean

Chỉ định xem đây có phải là tài khoản bị ẩn hay không.

Chỉ có thể đọc.

level

string (int64 format)

Khoảng cách giữa khách hàng và khách hàng nhất định. Đối với bản thân liên kết, giá trị cấp sẽ là 0. Chỉ có thể đọc.

timeZone

string

Chuỗi Kho lưu trữ dữ liệu ngôn ngữ phổ biến (CLDR) biểu thị múi giờ của ứng dụng, ví dụ: America/Los_Angeles. Chỉ có thể đọc.

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à một người quản lý hay không. Chỉ có thể đọc.

descriptiveName

string

Tên mô tả của 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 trong quảng cáo tìm kiếm động. Tên tài nguyên của chế độ xem cụm từ tìm kiếm của quảng cáo tìm kiếm động có dạng như sau:

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ế độ chỉ đọc.

GenderView

Chế độ xem theo giới tính. Tài nguyêngenderView phản ánh trạng thái phân phát hiệu quả, thay vì tiêu chí nào được thêm vào. Theo mặc định, nhóm quảng cáo không có tiêu chí giới tính hiển thị cho tất cả giới tính, do đó, tất cả giới tính đều 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 theo giới tính. Tên tài nguyên chế độ xem giới tính có dạng như sau:

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

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

Các trạng thái có thể có của một hằng số mục tiêu địa lý.

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

Phiên bản này không xác định được 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ị xoá.

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

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

Hãng nhạc

Một 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 của 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 có 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

Các 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ề. Biểu thị 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 có 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 HEX. 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 ý: Tài khoản người quản lý có thể không thấy được màu nền.

description

string

Mô tả ngắn về nhãn. Độ dài không được vượt quá 200 ký tự.

LanguageConstant

Một 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ã 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 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 cho sản phẩm. Tên tài nguyên danh mục đặt giá thầu cho sản phẩm có dạng:

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ã nhận dạng của danh mục đặt giá thầu cho sản phẩm.

Mã này tương đương với mã google_product_category [danh_mục_sản_phẩm_của_Google] như mô tả trong bài viết này: https://support.google.com/merchants/answer/6324436.

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 cho sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 trong 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ê tổng hợp về chiến dịch Mua sắm ở một số cấp thứ nguyên sản phẩm. Các giá trị phương diện sản phẩm trong Merchant Center như thương hiệu, danh mục, thuộc tính tuỳ chỉnh, tình trạng sản phẩm và loại sản phẩm sẽ thể hiện trạng thái của từng phương diện kể từ ngày và giờ ghi lại sự kiện tương ứng.

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 người dùng mà khách hàng có thể nhắm mục tiêu.

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 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ế độ 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ề. Biểu thị giá trị không xác định trong phiên bản này.
REMARKETING Danh sách người dùng được trình bày dưới dạng tập hợp các loại chuyển đổi.
LOGICAL Danh sách người dùng được thể hiện 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 Đã tạo Danh sách người dùng trong nền tảng Google Ad Manager.
RULE_BASED Danh sách người dùng được liên kết với một quy tắc.
SIMILAR Danh sách người dùng có những người dùng tương tự với 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 gồm 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

Chế độ 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 khung hiển thị 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 ghé thăm.

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 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á không được phân bổ.

merchantId

string (int64 format)

Mã tài khoản kho hàng Search Ads 360 chứa sản phẩm mà người dùng đã nhấp vào. Search Ads 360 tạo mã này khi bạn liên kết một tài khoản kho hàng trong Search Ads 360.

adId

string (int64 format)

Mã quảng cáo. Giá trị 0 cho biết rằng quảng cáo không được phân bổ.

clickId

string

Một chuỗi riêng biệt cho mỗi lượt truy cập được chuyển đến trang đích dưới dạng tham số URL mã lượt nhấp.

visitDateTime

string

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

productId

string

Mã của sản phẩm được nhấp vào.

productChannel

enum (ProductChannel)

Kênh bán hàng của sản phẩm mà người dùng nhấp vào: Trực tuyến hoặc Địa phương.

productLanguageCode

string

Ngôn ngữ (ISO-639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center có chứa dữ liệu về sản phẩm.

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. Giá trị này phải khớp với mã cửa hàng dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn.

productCountryCode

string

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

assetId

string (int64 format)

Mã của tài sả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ả địa phương của sản phẩm.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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í đó chưa được phân bổ.

merchantId

string (int64 format)

Mã tài khoản kho hàng Search Ads 360 chứa sản phẩm mà người dùng đã nhấp vào. Search Ads 360 tạo mã này khi bạn liên kết một tài khoản kho hàng trong Search Ads 360.

adId

string (int64 format)

Mã quảng cáo. Giá trị 0 cho biết rằng quảng cáo không được phân bổ.

clickId

string

Một chuỗi riêng biệt dành cho lượt truy cập mà lượt chuyển đổi được phân bổ, được chuyển đến trang đích dưới dạng tham số URL mã lượt nhấp.

visitId

string (int64 format)

Mã lượt truy cập 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ột mã nhận dạng như vậy, thì Search Ads 360 sẽ tạo một mã. Đối với lượt chuyển đổi trực tuyến, giá trị này bằng cột mã nhận dạng hoặc cột floodlightOrderId, tuỳ thuộc vào chỉ dẫn Floodlight của nhà quảng cáo.

productId

string

Mã của sản phẩm được nhấp vào.

productChannel

enum (ProductChannel)

Kênh bán hàng của sản phẩm mà người dùng nhấp vào: Trực tuyến hoặc Địa phương.

productLanguageCode

string

Ngôn ngữ (ISO-639-1) đã được đặt cho nguồn cấp dữ liệu Merchant Center có chứa dữ liệu về sản phẩm.

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. Giá trị này phải khớp với mã cửa hàng dùng trong nguồn cấp dữ liệu sản phẩm địa phương của bạn.

productCountryCode

string

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

attributionType

enum (AttributionType)

Chuyển đổi được phân bổ cho: 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 lượt chuyển đổ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 ghi lại bởi lượt chuyển đổi, như được xác định bởi thông số url số lượng. Nhà quảng cáo có trách nhiệm tự động điền thông số (chẳng hạn như số lượng mặt hàng đã bán trong lượt chuyển đổi), nếu không, giá trị mặc định sẽ là 1.

conversionRevenueMicros

string (int64 format)

Doanh thu đã điều chỉnh tính bằng phần triệu cho sự kiện chuyển đổi. Đơn vị tiền tệ này sẽ luôn sử dụng đơn vị tiền tệ của tài khoản phân phát quảng cáo.

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 chỉ định về đơn vị tiền tệ của Floodlight sửa đổi.

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: ĐÃ BẬT hoặc ĐÃ LOẠI BỎ.

assetId

string (int64 format)

Mã của tài sả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 SearchAds360

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 cặp tiêu chí và 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ề. Biểu thị giá trị không xác định trong phiên bản này.
ENABLED Đã bật chuyển đổi.
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,
  "averageQualityScore": 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 bạn chọn cột này có ngày, 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. Số liệu này bao gồm tất cả các lượt chuyển đổi bất kể giá trị của includeInConversionsMetric. Khi bạn chọn cột này có ngày, 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)

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 bạn chọn cột này có ngày, 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à một phần nhỏ do mô hình phân bổ. Khi bạn chọn cột này có ngày, 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 của mẫu quảng cáo trước đây.

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 (CTR) được dự đoán trong tìm kiếm trong quá khứ.

interactionEventTypes[]

enum (InteractionEventType)

Các loại tương tác có thể thanh toán và miễn phí.

rawEventConversionMetrics[]

object (Value)

Chỉ số về 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 (trái ngược 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. Số liệu 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 mọi người nhấp vào nút "Gọi" để gọi 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" để điều hướng đến 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ả các lượt chuyển đổi từ các lượt tương tác chia cho tổng số lượt 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 mọi người đặ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 và chuyển tiếp thành công đế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ần 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ố metric_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ố metric_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

Tỷ lệ 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 hiển thị vì ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất do 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 đều đượ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 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.

contentRankLostImpressionShare

number

Phần trăm 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 Xếp hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị bị mất theo 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 đều đượ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 chuyển đổi. Cho biết tần suất trung bình mà 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. Chỉ số này chỉ áp dụng cho những hành động chuyển đổi bao gồm 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ị chuyển đổi từ số lần tương tác chia cho số lần tương tác với quảng cáo. Chỉ số 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. Chỉ số này chỉ áp dụng cho những hành động chuyển đổi bao gồm 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í chi phí mỗi lượt nhấp (CPC) và chi phí mỗi nghìn lượt hiển thị (CPM) 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ố metric_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ả các lượt chuyển đổi.

costPerConversion

number

Chi phí trung bình đủ điều kiện cho mỗi lượt chuyển đổi có thể đặt giá thầu.

costPerCurrentModelAttributedConversion

number

Chi phí của các lượt tương tác với quảng cáo chia cho số lượt chuyển đổi được phân bổ của mô hình hiện tại. Chỉ số 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 khi 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ả 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. Chỉ số 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 lượt chuyển đổi có trong "lượt 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.

averageQualityScore

number

Điểm chất lượng trung bình.

historicalQualityScore

string (int64 format)

Điểm chất lượng trong quá khứ.

impressions

string (int64 format)

Tính 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ần tương tác chia cho số lần quảng cáo của bạn được hiển thị.

interactions

string (int64 format)

Số lượt 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 chưa đượ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 bị tính phí.

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 xuất hiện tại vị trí Mua sắm nổi bật nhất. Hãy tham khảo https://support.google.com/sa360/answer/9566729 để biết thông tin chi tiết. Bất kỳ giá trị nào dưới 0,1 được báo cáo là 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Con số này ướ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ị ở vị trí đầu tiên bị mất do 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 đều được báo cáo là 0,9001.

searchBudgetLostImpressionShare

number

Tỷ lệ 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 Tìm kiếm nhưng lại không hiển thị vì ngân sách quá thấp. Lưu ý: Tỷ lệ hiển thị bị mất 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 đều được báo cáo là 0,9001.

searchBudgetLostTopImpressionShare

number

Con số này ướ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 ngân sách thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí hàng đầu bị mất ngân sách trên Mạ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 đều đượ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. Lưu ý: Tỷ lệ nhấp chuột 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 dưới 0,1 được báo cáo là 0,0999.

searchExactMatchImpressionShare

number

Số lượt hiển thị bạn đã nhận được chia cho số lượt 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ừ khoá (hoặc là các biến thể gần giống của từ khoá), bất kể kiểu khớp từ khoá của bạn là gì. Lưu ý: Tỷ lệ hiển thị đối sánh chính xác trên Mạng Tìm kiếm được báo cáo trong khoảng 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 đượ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 dưới 0,1 được báo cáo là 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Con số này ướ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 Thứ hạng quảng cáo thấp. Lưu ý: Tỷ lệ hiển thị ở vị trí đầu tiên bị mất thứ hạng trên Mạ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 đều được báo cáo là 0,9001.

searchRankLostImpressionShare

number

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 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 đều được báo cáo là 0,9001.

searchRankLostTopImpressionShare

number

Con số này ướ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ị ở vị trí hàng đầu bị mất thứ hạng trên Mạ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 đều được báo cáo là 0,9001.

searchTopImpressionShare

number

Số lượt hiển thị mà bạn nhận được trong số những 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 số những quảng cáo hàng đầu. Lưu ý: Tỷ lệ hiển thị ở vị trí hàng đầu trên Mạng Tìm kiếm được báo cáo trong khoảng 0,1 đến 1. Bất kỳ giá trị nào dưới 0,1 đượ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 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 số lượt chuyển đổi.

valuePerAllConversionsByConversionDate

number

Giá trị của tất cả lượt chuyển đổi chia cho số lượt chuyển đổi. Khi bạn chọn cột này có ngày, 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 theo 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 bạn chọn cột này có ngày, 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 điều này xảy ra khi khách hàng xem quảng cáo hình ảnh hoặc quảng cáo đa phương tiện, sau đó hoàn thành chuyển đổi trên trang web của bạn mà không tương tác (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ũ, rồi 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 cho đơn đặt hàng này là 5 đô 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ố metric_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ũ, rồi 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 cho đơn đặt hàng này là 5 đô 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ố metric_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ũ, rồi 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ố metric_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ũ, rồi 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ố metric_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 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ũ, rồi 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ố metric_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ũ, rồi 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ố metric_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ũ, rồi 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ũ, rồi 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 chi phí cho việc bán sản phẩm 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ũ, rồi 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ố metric_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ũ, rồi 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ố metric_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 sản phẩm được quảng cáo 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ũ, rồi 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ố metric_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ũ, rồi 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ố metric_currency tại https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

Doanh thu của sản phẩm được quảng cáo 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ũ, rồi 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ố metric_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ũ, rồi 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ố metric_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 của tài khoản khách hàng đã bán 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ũ, rồi 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ũ, rồi 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 kết hợp value. Một giá trị. value chỉ có thể là một trong những trạng thái sau đây:
booleanValue

boolean

Giá trị boolean.

int64Value

string (int64 format)

Một int64.

floatValue

number

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ề. Biểu thị 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 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 giao dịch có thể thanh toán và miễn phí.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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à InteropEventType mặc định cho sự kiện nhấp chuột.
ENGAGEMENT Ý định rõ ràng của người dùng về việc 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 SubscriptionEventType mặc định cho các sự kiện chuyển đổi quảng cáo. Lựa chọn 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 lượt tương tác miễn phí (ví dụ: lượt chuyển đổi quảng cáo) phải được "quảng cáo" và được báo cáo như một phần của các chỉ số chính. Đây đơn giản là các lượt chuyển đổi (quảng cáo) khác.

Phân đoạn

Các trường chỉ dành cho 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,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "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 cho 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ừ khoá.

productChannel

enum (ProductChannel)

Kênh của sản phẩm.

productChannelExclusivity

enum (ProductChannelExclusivity)

Kênh độc quyền cho 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ụ: 2018-04-17.

geoTargetCity

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một thành phố.

geoTargetCountry

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một quốc gia.

geoTargetMetro

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một thành phố lớn.

geoTargetRegion

string

Tên tài nguyên của hằng số mục tiêu địa lý đại diện cho một khu vực.

hour

integer

Giờ trong ngày dưới dạng số từ 0 đến 23.

month

string

Tháng được thể hiện bằng ngày đầu tiên của một 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 của 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 tùy 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

Một quý được thể hiện bằng ngày đầu tiên của một quý. Sử dụng năm dương lịch cho các quý, ví dụ: quý 2 năm 2018 bắt đầu vào 2018-04-01. Đượ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à AdGroupAsset. 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 hay đơ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ụ: chính Quảng cáo và các thành phần khác như Đường liên kết của trang web) khi các thành phần đó được phân phát cùng nhau. Khi engagementOnThisAsset là true, có nghĩa là các lượt tương tác diễn ra trên thành phần cụ thể này và khi engagementOnThisAsset là false, tức là các lượt tương tác không xuất hiện trên thành phần cụ thể này, mà trên các phần khác của quảng cáo được phân phát cùng với 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 Phiên bản này không xác định được giá trị.
SEARCH Tìm kiếm Google.
SEARCH_PARTNERS Đố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ừ khóa

Phân đoạn theo Tiêu chí từ khoá.

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ề. Biểu thị giá trị không xác định trong phiên bản này.
SINGLE_CHANNEL Mặt hàng chỉ được bán thông qua một kênh, cửa hàng địa phương hoặc trực tuyến theo chỉ định của ProductChannel.
MULTI_CHANNEL Mặt hàng này được so khớp với mặt hàng tương ứng tại cửa hàng trực tuyến hoặc cửa hàng tại địa phương, cho biết rằng mặt hàng đó có sẵn để mua trên cả ShoppingProductChannel.

ProductCondition

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

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Biểu thị 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 đã được tân trang.
USED Tình trạng sản phẩm được sử dụng.

AssetInteractionTarget

Phân đoạn AssetConversionsTarget.

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à AdGroupAsset. 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 hay đơn vị quảng cáo khác.