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
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- Biểu diễn dưới dạng JSON

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`) ], "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)
  ],
  "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
}

Các 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 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ục ánh xạ dùng để thay thế các thẻ tham 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 thứ nguyê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 đến mạng hiển thị chứ không nhắm đến 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 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 đường liên kết thành phần có các 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 đường liên kết đến nhóm thành phần thuộc các loại này từ các cấp cao hơn. Loại nhóm vị trí (GMB_ nghị_LOCATION_GROUP, CHAIN_ACTIVE_LOCATION_GROUP và REQUESTIC_LOCATION_GROUP) là các loại 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 sẽ 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.
`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 phải chứa ít hơn 255 ký tự có độ rộng đầy đủ UTF-8. Mã không được chứa bất kỳ ký tự rỗng (mã điểm 0x0), nguồn cấp dữ liệu dòng NL (mã điểm 0xA) hoặc ký tự trả lại vị trí đầu dòng (mã điể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ở nơi 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 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 sử dụng cpc thủ công, cpc nâng cao, trang một được quảng bá hoặc tỷ lệ xếp hạng cao hơn mục tiêu, nếu không thì giá trị sẽ rỗng.
`cpmBidMicros`	`string (int64 format)` Giá thầu CPM (chi phí mỗi nghìn lượt hiển thị có thể xem) tối đa.
`targetCpaMicros`	`string (int64 format)` CPA (chi phí thu nạp khách hàng) mục tiêu. Nếu chiến lược đặt giá thầu 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 1000 lượt hiển thị quảng cáo.
`targetRoas`	`number` Ghi đè lợi tức mục tiêu trên chi tiêu quảng cáo (ROAS mục tiêu). Nếu chiến lược đặt giá thầu cho chiến dịch của nhóm quảng cáo là TargetRoas hoặc Tối đa hoá lượt chuyển đổi (với nhóm 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ị dưới dạng một phần của giá được 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 các 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. ROAS mục tiêu hiệu quả (lợi tức trên chi tiêu quảng cáo). Trường này chỉ để đọc.

AdGroupStatus

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`	Không xác định được giá trị đã nhận trong phiên bản này. Đây là giá trị chỉ để phản hồi.
`ENABLED`	Nhóm quảng cáo đã được bật.
`PAUSED`	Nhóm quảng cáo bị tạm dừng.
`REMOVED`	Nhóm quảng cáo bị xóa.

AdGroupType

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

Enum
`UNSPECIFIED`	Loại chưa được chỉ định.
`UNKNOWN`	Không xác định được giá trị đã nhận trong phiên bản này. Đâ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 dành cho chiến dịch Mua sắm phân phát quảng cáo sản phẩm chuẩn.
`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 dạng video trong luồng phát TrueView (có thể bỏ qua).
`VIDEO_TRUE_VIEW_IN_DISPLAY`	Quảng cáo video TrueView trong hiển thị.
`VIDEO_NON_SKIPPABLE_IN_STREAM`	Quảng cáo dạng video trong luồng phát không thể bỏ qua.
`VIDEO_OUTSTREAM`	Quảng cáo dạng video ngoài luồng phát.
`SEARCH_DYNAMIC_ADS`	Loại nhóm quảng cáo cho nhóm quảng cáo Quảng cáo tìm kiếm động.
`SHOPPING_COMPARISON_LISTING_ADS`	Loại nhóm quảng cáo trong chiến dịch So sánh sản phẩm mua sắm.
`PROMOTED_HOTEL_ADS`	Loại nhóm quảng cáo cho nhóm quảng cáo Khách sạn được quảng cáo.
`VIDEO_RESPONSIVE`	Nhóm quảng cáo thích ứng dạng video.
`VIDEO_EFFICIENT_REACH`	Nhóm quảng cáo có phạm vi tiếp cận hiệu quả của 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`	Bạn chưa chỉ định chế độ xoay vòng quảng cáo.
`UNKNOWN`	Không xác định được giá trị đã nhận trong phiên bản này. Đâ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 }

Các trường

Các 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 sai, nhóm quảng cáo này có thể sử dụng tiêu chí phân khúc đối tượng thay thế.

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 sai, nhóm quảng cáo này có thể sử dụng tiêu chí phân khúc đối tượng thay thế.