AdGroupCriterion

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

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của tiêu chí nhóm quảng cáo. Tên tài nguyên tiêu chí của nhóm quảng cáo có dạng:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Chỉ có đầu ra. Tên hiển thị của tiêu chí.

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

enum (AdGroupCriterionStatus)

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

Đây là trạng thái của thực thể tiêu chí nhóm quảng cáo do khách hàng đặt. Lưu ý: báo cáo giao diện người dùng có thể kết hợp thông tin bổ sung ảnh hưởng đến việc một tiêu chí có đủ điều kiện để chạy hay không. Trong một số trường hợp, tiêu chí đã bị XOÁ trong API vẫn có thể hiển thị là đã bật trong giao diện người dùng. Ví dụ: theo mặc định, các chiến dịch sẽ hiển thị cho người dùng ở tất cả độ tuổi trừ phi bị loại trừ. Giao diện người dùng sẽ hiển thị từng độ tuổi là "đã bật" vì người dùng đủ điều kiện xem quảng cáo; nhưng nhóm AdsCriterion.status sẽ hiển thị trạng thái "đã xoá", vì họ chưa thêm tiêu chí khẳng định nào.
qualityInfo

object (QualityInfo)

Chỉ có đầu ra. Thông tin về chất lượng của tiêu chí.
type

enum (CriterionType)

Chỉ có đầu ra. Loại tiêu chí.
systemServingStatus

enum (CriterionSystemServingStatus)

Chỉ có đầu ra. Trạng thái phân phát của tiêu chí.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Chỉ có đầu ra. Trạng thái phê duyệt của tiêu chí.
disapprovalReasons[]

string

Chỉ có đầu ra. Danh sách lý do từ chối của tiêu chí.

Bạn có thể tìm thấy những lý do khác nhau khiến bạn từ chối một tiêu chí tại đây: https://support.google.com/adspolicy/answer/6008942

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

string

Chỉ có đầu ra. Tên tài nguyên của các nhãn được đính kèm với tiêu chí nhóm quảng cáo này.
effectiveCpcBidSource

enum (BiddingSource)

Chỉ có đầu ra. Nguồn của giá thầu CPC hiệu quả.
effectiveCpmBidSource

enum (BiddingSource)

Chỉ có đầu ra. Nguồn của giá thầu CPM hiệu dụng.
effectiveCpvBidSource

enum (BiddingSource)

Chỉ có đầu ra. Nguồn của giá thầu CPV hiệu dụng.
effectivePercentCpcBidSource

enum (BiddingSource)

Chỉ có đầu ra. Nguồn của giá thầu % CPC có hiệu lực.
positionEstimates

object (PositionEstimates)

Chỉ có đầu ra. Ước tính cho giá thầu tiêu chí ở các vị trí khác nhau.
finalUrls[]

string

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

string

Danh sách các URL cuối cùng trên thiết bị di động có thể có sau tất cả các lần chuyển hướng nhiều miền.
urlCustomParameters[]

object (CustomParameter)

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

string (int64 format)

Chỉ có đầu ra. Mã của tiêu chí.

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

string

Không thể thay đổi. Nhóm quảng cáo chứa tiêu chí.
negative

boolean

Không thể thay đổi. Liệu sẽ nhắm mục tiêu (false) hay loại trừ (true) tiêu chí này.

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

number

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

string (int64 format)

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

string (int64 format)

Giá thầu CPM (giá mỗi nghìn lượt hiển thị có thể xem).
cpvBidMicros

string (int64 format)

Giá thầu CPV (chi phí mỗi lượt xem).
percentCpcBidMicros

string (int64 format)

Số tiền giá thầu CPC, được biểu thị bằng một phần giá quảng cáo cho một số hàng hoá hoặc dịch vụ. Phạm vi hợp lệ cho phân số là [0,1) và giá trị được lưu trữ ở đây là 1.000.000 * [phân số].
effectiveCpcBidMicros

string (int64 format)

Chỉ có đầu ra. Giá thầu CPC (chi phí mỗi lượt nhấp) hiệu quả.
effectiveCpmBidMicros

string (int64 format)

Chỉ có đầu ra. Giá thầu CPM (giá mỗi nghìn lượt hiển thị có thể xem) hiệu dụng.
effectiveCpvBidMicros

string (int64 format)

Chỉ có đầu ra. Giá thầu CPV (chi phí mỗi lượt xem) hiệu quả.
effectivePercentCpcBidMicros

string (int64 format)

Chỉ có đầu ra. Số tiền giá thầu % CPC hiệu quả.
finalUrlSuffix

string

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

string

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

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

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

object (KeywordInfo)

Không thể thay đổi. Từ khoá.
placement

object (PlacementInfo)

Không thể thay đổi. Vị trí.
mobileAppCategory

object (MobileAppCategoryInfo)

Không thể thay đổi. Danh mục ứng dụng dành cho thiết bị di động.
mobileApplication

object (MobileApplicationInfo)

Không thể thay đổi. Ứng dụng dành cho thiết bị di động.
listingGroup

object (ListingGroupInfo)

Không thể thay đổi. Nhóm trang thông tin.
ageRange

object (AgeRangeInfo)

Không thể thay đổi. Độ tuổi.
gender

object (GenderInfo)

Không thể thay đổi. Giới tính.
incomeRange

object (IncomeRangeInfo)

Không thể thay đổi. Phạm vi thu nhập.
parentalStatus

object (ParentalStatusInfo)

Không thể thay đổi. Tình trạng con cái.
userList

object (UserListInfo)

Không thể thay đổi. Danh sách người dùng.
youtubeVideo

object (YouTubeVideoInfo)

Không thể thay đổi. Video trên YouTube.
youtubeChannel

object (YouTubeChannelInfo)

Không thể thay đổi. Kênh YouTube.
topic

object (TopicInfo)

Không thể thay đổi. Chủ đề.
userInterest

object (UserInterestInfo)

Không thể thay đổi. Sở thích của người dùng.
webpage

object (WebpageInfo)

Không thể thay đổi. Trang web
appPaymentModel

object (AppPaymentModelInfo)

Không thể thay đổi. Mô hình thanh toán qua ứng dụng.
customAffinity

object (CustomAffinityInfo)

Không thể thay đổi. Đối tượng chung sở thích tùy chỉnh.
customIntent

object (CustomIntentInfo)

Không thể thay đổi. Đối tượng có mục đích tùy chỉnh.
customAudience

object (CustomAudienceInfo)

Không thể thay đổi. Đối tượng tuỳ chỉnh.
combinedAudience

object (CombinedAudienceInfo)

Không thể thay đổi. Đối tượng được kết hợp.
audience

object (AudienceInfo)

Không thể thay đổi. Đối tượng người xem.
location

object (LocationInfo)

Không thể thay đổi. Vị trí.
language

object (LanguageInfo)

Không thể thay đổi. Ngôn ngữ.

AdGroupCriterionStatus

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

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

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

Đây là giá trị chỉ phản hồi.
ENABLED Tiêu chí nhóm quảng cáo đã được bật.
PAUSED Tiêu chí nhóm quảng cáo đã bị tạm dừng.
REMOVED Tiêu chí nhóm quảng cáo đã bị xóa.

QualityInfo

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

Biểu diễn dưới dạng JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Trường
creativeQualityScore

enum (QualityScoreBucket)

Chỉ có đầu ra. Hiệu suất quảng cáo so với các nhà quảng cáo khác.
postClickQualityScore

enum (QualityScoreBucket)

Chỉ có đầu ra. Điểm chất lượng của trang đích.
searchPredictedCtr

enum (QualityScoreBucket)

Chỉ có đầu ra. Tỷ lệ nhấp so với tỷ lệ nhấp của các nhà quảng cáo khác.
qualityScore

integer

Chỉ có đầu ra. Điểm chất lượng.

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

CriterionSystemServingStatus

Liệt kê các trạng thái phân phát của hệ thống tiêu chí.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
ELIGIBLE Đủ điều kiện.
RARELY_SERVED Lượng tìm kiếm thấp.

AdGroupCriterionApprovalStatus

Liệt kê các trạng thái phê duyệt Tiêu chí nhóm quảng cáo.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Giá trị không xác định trong phiên bản này.
APPROVED Được chấp thuận.
DISAPPROVED Bị từ chối.
PENDING_REVIEW Đang chờ xem xét.
UNDER_REVIEW Đang được xem xét.

PositionEstimates

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

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

string (int64 format)

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

string (int64 format)

Chỉ có đầu ra. Ước tính giá thầu CPC cần thiết để quảng cáo được hiển thị ở vị trí đầu tiên, trên đầu trang đầu tiên của kết quả tìm kiếm.
topOfPageCpcMicros

string (int64 format)

Chỉ có đầu ra. Ướ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.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Chỉ có đầu ra. Ước tính số lượt nhấp mỗi tuần bạn có thể nhận được bằng cách thay đổi giá thầu từ khoá thành giá trị trong firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Chỉ có đầu ra. Ước tính chi phí mỗi tuần có thể thay đổi như thế nào khi thay đổi giá thầu từ khóa của bạn thành giá trị trong firstPositionCpcMicros.

ListingGroupInfo

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

Biểu diễn dưới dạng JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Trường
type

enum (ListingGroupType)

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

object (ListingDimensionInfo)

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

string

Tên tài nguyên của tiêu chí nhóm quảng cáo (tức là nhóm phụ của nhóm trang thông tin gốc). Rỗng đối với nhóm gốc.
path

object (ListingDimensionPath)

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

ListingGroupType

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

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

ListingDimensionPath

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

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

object (ListingDimensionInfo)

Đường dẫn đầy đủ của các phương diện thông qua hệ phân cấp nhóm trang thông tin, từ thư mục gốc (không bao gồm thư mục gốc) đến nhóm trang thông tin này.

AppPaymentModelInfo

Tiêu chí mô hình thanh toán cho ứng dụng.

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

enum (AppPaymentModelType)

Loại mô hình thanh toán qua ứng dụng.

AppPaymentModelType

Enum mô tả các mô hình thanh toán có thể có cho ứng dụng.

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

CustomIntentInfo

Tiêu chí đối tượng có ý định tuỳ chỉnh. Loại tiêu chí này chỉ có thể nhắm mục tiêu.

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

string

Tên tài nguyên Custominterest.