Chú ý: Bạn đang xem tài liệu về giao diện REST của API. Hầu hết các thư viện ứng dụng chính thức của chúng tôi đều sử dụng gRPC. Hãy xem Giới thiệu về REST để biết chi tiết.

Trang này được dịch bởi Cloud Translation API.

AdGroup

Biểu diễn dưới dạng JSON
AdGroupStatus
AdGroupAdRotationMode
AudienceSetting
- Biểu diễn dưới dạng JSON
AdGroupPrimaryStatus
AdGroupPrimaryStatusReason

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

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

Biểu diễn dưới dạng JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "primaryStatus": enum (`AdGroupPrimaryStatus`), "primaryStatusReasons": [ enum (`AdGroupPrimaryStatusReason`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Trường
`resourceName`	`string` Không thể thay đổi. Tên tài nguyên của nhóm quảng cáo. Tên tài nguyên của nhóm quảng cáo có dạng: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` Trạng thái của nhóm quảng cáo.
`type`	`enum (AdGroupType)` Không thể thay đổi. 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.
`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`.
`optimizedTargetingEnabled`	`boolean` Đúng nếu bạn bật tính năng tối ưu hoá tiêu chí nhắm mục tiêu. Tính năng Tối ưu hoá tiêu chí nhắm mục tiêu sẽ thay thế tính năng Mở rộng đối tượng.
`displayCustomBidDimension`	`enum (TargetingDimension)` Cho phép nhà quảng cáo chỉ định phương diện nhắm mục tiêu để đặt giá thầu tuyệt đối. Điều này chỉ áp dụng cho các chiến dịch chỉ nhắm mục tiêu mạng hiển thị chứ không nhắm mục tiêu mạng tìm kiếm.
`targetingSetting`	`object (TargetingSetting)` Chế độ cài đặt cho các tính năng liên quan đến việc nhắm mục tiêu.
`audienceSetting`	`object (AudienceSetting)` Không thể thay đổi. Chế độ cài đặt cho các tính năng liên quan đến đối tượng.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Chỉ có đầu ra. Nguồn CPA mục tiêu hiệu quả. Trường này chỉ để đọc.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Chỉ có đầu ra. Nguồn lợi tức mục tiêu trên chi tiêu quảng cáo hiệu quả. 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ào nhóm quảng cáo này.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Các loại trường thành phần cần được loại trừ khỏi nhóm quảng cáo này. Nhóm quảng cáo này sẽ không kế thừa các đường liên kết đến thành phần có những loại trường này từ các cấp cao hơn.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Các loại nhóm thành phần cần được loại trừ khỏi nhóm quảng cáo này. Nhóm quảng cáo này sẽ không kế thừa những đường liên kết đến nhóm thành phần thuộc những loại này từ các cấp cao hơn. Loại nhóm vị trí (GMB_Mô hình khách sạn LOCATION_GROUP, CHAIN_dynamic_LOCATION_GROUP và StatIC_LOCATION_GROUP) là các loại nhóm vị trí con của LOCATION_SYNC. Do đó, nếu bạn đặt LOCATION_SYNC cho trường này, thì tất cả nhóm thành phần nhóm địa điểm đều không được phép liên kết với nhóm quảng cáo này, đồng thời tất cả Phần mở rộng về địa điểm (LE) và Phần mở rộng về địa điểm của đơn vị liên kết (ALE) sẽ không được phân phát trong nhóm quảng cáo này. Hiện chỉ hỗ trợ LOCATION_SYNC.
`primaryStatus`	`enum (AdGroupPrimaryStatus)` Chỉ có đầu ra. Cung cấp thông tin tổng hợp về lý do khiến một nhóm quảng cáo không phân phát hoặc không phân phát một cách tối ưu.
`primaryStatusReasons[]`	`enum (AdGroupPrimaryStatusReason)` Chỉ có đầu ra. Đưa ra lý do khiến nhóm quảng cáo không phân phát hoặc không phân phát một cách tối ưu.
`id`	`string (int64 format)` Chỉ có đầu ra. Mã của nhóm quảng cáo.
`name`	`string` Tên của nhóm quảng cáo. Đây là trường bắt buộc và không được để trống khi tạo nhóm quảng cáo mới. Mã này chỉ được chứa dưới 255 ký tự có độ rộng đầy đủ theo UTF-8. Mã không được chứa bất kỳ ký tự rỗng (điểm mã 0x0), nguồn cấp dữ liệu dòng NL (điểm mã 0xA) hoặc ký tự trả lại vị trí đầu dòng (điểm mã 0xD).
`baseAdGroup`	`string` Chỉ có đầu ra. Đối với nhóm quảng cáo dự thảo hoặc thử nghiệm, trường này là tên tài nguyên của nhóm quảng cáo cơ sở mà nhóm quảng cáo này được tạo. Nếu nhóm quảng cáo dự thảo hoặc thử nghiệm không có nhóm quảng cáo cơ sở, thì trường này rỗng. Đối với các nhóm quảng cáo cơ sở, trường này bằng tên tài nguyên của nhóm quảng cáo. Trường này chỉ để đọc.
`trackingUrlTemplate`	`string` Mẫu URL để tạo URL theo dõi.
`campaign`	`string` Không thể thay đổi. Chiến dịch chứa nhóm quảng cáo.
`cpcBidMicros`	`string (int64 format)` Giá thầu CPC (chi phí mỗi lượt nhấp) tối đa.
`effectiveCpcBidMicros`	`string (int64 format)` Chỉ có đầu ra. Giá trị sẽ giống với giá trị giá thầu CPC (chi phí mỗi lượt nhấp) khi chiến lược đặt giá thầu là một trong các cpc thủ công, cpc nâng cao, trang một được quảng bá hoặc chia sẻ nâng thứ hạng mục tiêu, nếu không giá trị sẽ rỗng.
`cpmBidMicros`	`string (int64 format)` Giá thầu CPM (giá mỗi nghìn lượt hiển thị có thể xem) tối đa.
`targetCpaMicros`	`string (int64 format)` Chi phí mục tiêu để thu nạp khách hàng (CPA mục tiêu). Nếu chiến lược đặt giá thầu trong chiến dịch của nhóm quảng cáo là TargetCpa hoặc Tối đa hoá lượt chuyển đổi (có đặt trường targetCpa), thì trường này sẽ ghi đè CPA mục tiêu được chỉ định trong chiến lược đặt giá thầu của chiến dịch. Nếu không, giá trị này sẽ bị bỏ qua.
`cpvBidMicros`	`string (int64 format)` Giá thầu CPV (chi phí mỗi lượt xem).
`targetCpmMicros`	`string (int64 format)` Số tiền trung bình cực nhỏ mà nhà quảng cáo sẵn sàng trả cho mỗi nghìn lượt hiển thị quảng cáo.
`targetRoas`	`number` Ghi đè ROAS (lợi tức trên chi tiêu quảng cáo) mục tiêu. Nếu chiến lược đặt giá thầu trong chiến dịch của nhóm quảng cáo là TargetRoas hoặc OptimizedConversionsValue (với tập hợp trường targetRoas), thì trường này sẽ ghi đè lợi tức mục tiêu trên chi tiêu quảng cáo được chỉ định trong chiến lược đặt giá thầu của chiến dịch. Nếu không, giá trị này sẽ bị bỏ qua.
`percentCpcBidMicros`	`string (int64 format)` Số tiền giá thầu cpc theo phần trăm, được biểu thị bằng một phần của giá quảng cáo cho một số hàng hóa 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ố].
`finalUrlSuffix`	`string` Mẫu URL để thêm tham số vào URL cuối cùng.
`effectiveTargetCpaMicros`	`string (int64 format)` Chỉ có đầu ra. Chi phí mục tiêu để thu nạp khách hàng (CPA mục tiêu hiệu quả). Trường này chỉ để đọc.
`effectiveTargetRoas`	`number` Chỉ có đầu ra. Lợi tức mục tiêu trên chi tiêu quảng cáo hiệu quả. Trường này chỉ để đọc.

AdGroupStatus

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

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

AdGroupAdRotationMode

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

Enum
`UNSPECIFIED`	Chế độ xoay vòng quảng cáo chưa được chỉ định.
`UNKNOWN`	Phiên bản này không xác định giá trị đã nhận. Đây là giá trị chỉ phản hồi.
`OPTIMIZE`	Tối ưu hoá quảng cáo trong nhóm quảng cáo dựa trên số lượt nhấp hoặc lượt chuyển đổi.
`ROTATE_FOREVER`	Xoay vòng đồng đều vĩnh viễn.

AudienceSetting

Chế độ cài đặt cho tính năng nhắm mục tiêu theo đối tượng.

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

Trường

Trường
`useAudienceGrouped`	`boolean` Không thể thay đổi. Nếu đúng, nhóm quảng cáo này sẽ sử dụng tài nguyên Đối tượng để nhắm mục tiêu theo đối tượng. Nếu giá trị là sai, nhóm quảng cáo này có thể sử dụng tiêu chí phân khúc đối tượng.

useAudienceGrouped

boolean

Không thể thay đổi. Nếu đúng, nhóm quảng cáo này sẽ sử dụng tài nguyên Đối tượng để nhắm mục tiêu theo đối tượng. Nếu giá trị là sai, nhóm quảng cáo này có thể sử dụng tiêu chí phân khúc đối tượng.

AdGroupPrimaryStatus

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

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`ELIGIBLE`	Nhóm quảng cáo đủ điều kiện để phân phát.
`PAUSED`	Nhóm quảng cáo đã bị tạm dừng.
`REMOVED`	Nhóm quảng cáo đã bị xóa.
`PENDING`	Nhóm quảng cáo đó có thể phân phát trong tương lai.
`NOT_ELIGIBLE`	Nhóm quảng cáo không đủ điều kiện để phân phát.
`LIMITED`	Nhóm quảng cáo có khả năng phân phát hạn chế.

AdGroupPrimaryStatusReason

Nguyên nhân có thể xảy ra đối với trạng thái nhóm quảng cáo.

Enum
`UNSPECIFIED`	Chưa chỉ định.
`UNKNOWN`	Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
`CAMPAIGN_REMOVED`	Trạng thái chiến dịch do người dùng chỉ định sẽ bị xoá. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`CAMPAIGN_PAUSED`	Trạng thái chiến dịch do người dùng chỉ định bị tạm dừng. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`CAMPAIGN_PENDING`	Thời gian do người dùng chỉ định để bắt đầu chiến dịch này là thời gian trong tương lai. Đóng góp cho PARTNERPrimaryStatus.NOT_ELIGIBLE
`CAMPAIGN_ENDED`	Thời gian do người dùng chỉ định để kết thúc chiến dịch này đã trôi qua. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_PAUSED`	Trạng thái nhóm quảng cáo do người dùng chỉ định bị tạm dừng. Đóng góp vào AdvertisingPrimaryStatus.PAUSED.
`AD_GROUP_REMOVED`	Trạng thái nhóm quảng cáo do người dùng chỉ định sẽ bị xoá. Đóng góp vào NhómAdPrimaryStatus.REMOVED.
`AD_GROUP_INCOMPLETE`	Quá trình tạo nhóm quảng cáo này chưa hoàn tất. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`KEYWORDS_PAUSED`	Tất cả các trạng thái từ khóa do người dùng chỉ định trong nhóm quảng cáo này đều bị tạm dừng. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`NO_KEYWORDS`	Không có từ khoá đủ điều kiện nào trong nhóm quảng cáo này. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_ADS_PAUSED`	Tất cả trạng thái của nhóm quảng cáo do người dùng chỉ định trong nhóm quảng cáo này đều bị tạm dừng. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`NO_AD_GROUP_ADS`	Không có quảng cáo nhóm quảng cáo đủ điều kiện nào trong nhóm quảng cáo này. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`HAS_ADS_DISAPPROVED`	Lý do trạng thái tuân thủ chính sách khi có ít nhất một quảng cáo bị từ chối. Đóng góp cho nhiều APIPrimaryStatus.
`HAS_ADS_LIMITED_BY_POLICY`	Lý do trạng thái tuân thủ chính sách khi ít nhất một quảng cáo bị hạn chế do vấn đề về chính sách. Đóng góp cho nhiều APIPrimaryStatus.
`MOST_ADS_UNDER_REVIEW`	Lý do hiển thị trạng thái tuân thủ chính sách khi hầu hết quảng cáo đang chờ xem xét. Đóng góp cho AdvertisingPrimaryStatus.PENDING.
`CAMPAIGN_DRAFT`	Nhóm quảng cáo thuộc về chiến dịch Dự thảo. Đóng góp vào APIPrimaryStatus.NOT_ELIGIBLE.
`AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY`	Nhóm quảng cáo đã bị tạm dừng do hoạt động phân phát ít trong thời gian dài. Đóng góp vào AdvertisingPrimaryStatus.PAUSED.