Display & Video 360 API phiên bản 1beta2 đã ngừng hoạt động. Các yêu cầu gửi đến phiên bản ngừng hoạt động có thể trả về lỗi.

Bạn phải sử dụng Display & Video 360 API phiên bản 2. Xem hướng dẫn di chuyển của chúng tôi để biết các bước di chuyển từ phiên bản 1 sang phiên bản 2.

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

BiddingStrategy

Biểu diễn dưới dạng JSON
FixedBidStrategy
- Biểu diễn dưới dạng JSON
MaximizeSpendBidStrategy
- Biểu diễn dưới dạng JSON
BiddingStrategyPerformanceGoalType
PerformanceGoalBidStrategy
- Biểu diễn dưới dạng JSON

Chế độ cài đặt kiểm soát chiến lược giá thầu. Chiến lược giá thầu xác định giá thầu.

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

Biểu diễn dưới dạng JSON
{ // Union field `bid_strategy_scheme` can be only one of the following: "fixedBid": { object (`FixedBidStrategy`) }, "maximizeSpendAutoBid": { object (`MaximizeSpendBidStrategy`) }, "performanceGoalAutoBid": { object (`PerformanceGoalBidStrategy`) } // End of list of possible types for union field `bid_strategy_scheme`. }

{

  // Union field bid_strategy_scheme can be only one of the following:
  "fixedBid": {
    object (FixedBidStrategy)
  },
  "maximizeSpendAutoBid": {
    object (MaximizeSpendBidStrategy)
  },
  "performanceGoalAutoBid": {
    object (PerformanceGoalBidStrategy)
  }
  // End of list of possible types for union field bid_strategy_scheme.
}

Các trường
Trường nhóm `bid_strategy_scheme`. Bắt buộc. `bid_strategy_scheme` chỉ có thể là một trong những trạng thái sau đây:
`fixedBid`	`object (FixedBidStrategy)` Chiến lược sử dụng giá thầu cố định.
`maximizeSpendAutoBid`	`object (MaximizeSpendBidStrategy)` Chiến lược tự động điều chỉnh giá thầu để tối ưu hoá mục tiêu hiệu suất trong khi chi tiêu toàn bộ ngân sách. Ở cấp đơn đặt hàng quảng cáo, bạn không thể đặt `markupType` của mục hàng thành `PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM`. Ngoài ra, khi `performanceGoalType` là một trong: `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA` `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED` , `lineItemType` của mục hàng trong đơn đặt hàng quảng cáo phải là: `LINE_ITEM_TYPE_DISPLAY_DEFAULT` `LINE_ITEM_TYPE_VIDEO_DEFAULT` , và khi `performanceGoalType` là: `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA` `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN` `lineItemType` của mục hàng trong đơn đặt hàng quảng cáo phải là `LINE_ITEM_TYPE_VIDEO_DEFAULT`.
`performanceGoalAutoBid`	`object (PerformanceGoalBidStrategy)` Chiến lược tự động điều chỉnh giá thầu để đáp ứng hoặc vượt mục tiêu hiệu suất đã chỉ định. Chỉ sử dụng giá trị này cho mục hàng.

FixedBidStrategy

Chiến lược sử dụng giá đặt giá thầu cố định.

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

Các trường

Các trường
`bidAmountMicros`	`string (int64 format)` Số tiền giá thầu cố định, theo đơn vị tiền tệ của nhà quảng cáo. Đối với thực thể đơn đặt hàng quảng cáo, bạn phải đặt `bidAmountMicros` là 0. Đối với thực thể mục hàng, `bidAmountMicros` phải lớn hơn hoặc bằng đơn vị có thể lập hoá đơn của đơn vị tiền tệ nhất định và nhỏ hơn hoặc bằng giới hạn trên 1000000000. Ví dụ: 1500000 đại diện cho 1, 5 đơn vị tiền tệ chuẩn.

bidAmountMicros

string (int64 format)

Số tiền giá thầu cố định, theo đơn vị tiền tệ của nhà quảng cáo. Đối với thực thể đơn đặt hàng quảng cáo, bạn phải đặt bidAmountMicros là 0. Đối với thực thể mục hàng, bidAmountMicros phải lớn hơn hoặc bằng đơn vị có thể lập hoá đơn của đơn vị tiền tệ nhất định và nhỏ hơn hoặc bằng giới hạn trên 1000000000.

Ví dụ: 1500000 đại diện cho 1, 5 đơn vị tiền tệ chuẩn.

MaximizeSpendBidStrategy

Chiến lược tự động điều chỉnh giá thầu để tối ưu hoá một mục tiêu hiệu suất cụ thể trong khi chi tiêu toàn bộ ngân sách.

Biểu diễn dưới dạng JSON
{ "performanceGoalType": enum (`BiddingStrategyPerformanceGoalType`), "maxAverageCpmBidAmountMicros": string, "raiseBidForDeals": boolean, "customBiddingAlgorithmId": string }

Các trường
`performanceGoalType`	`enum (BiddingStrategyPerformanceGoalType)` Bắt buộc. Loại mục tiêu hiệu suất mà chiến lược đặt giá thầu cố gắng giảm thiểu trong khi chi tiêu toàn bộ ngân sách. `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` không được hỗ trợ cho chiến lược này.
`maxAverageCpmBidAmountMicros`	`string (int64 format)` CPM trung bình tối đa có thể là giá thầu, tính theo phần triệu đơn vị tiền tệ của nhà quảng cáo. Phải lớn hơn hoặc bằng đơn vị có thể lập hoá đơn của đơn vị tiền tệ cụ thể. Ví dụ: 1500000 đại diện cho 1, 5 đơn vị tiền tệ chuẩn.
`raiseBidForDeals`	`boolean` Liệu chiến lược có tính đến giá sàn giao dịch hay không.
`customBiddingAlgorithmId`	`string (int64 format)` Mã của Thuật toán đặt giá thầu tuỳ chỉnh mà chiến lược này sử dụng. Chỉ áp dụng khi bạn đặt `performanceGoalType` thành `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`.

BiddingStrategyPerformanceGoalType

Các loại mục tiêu hiệu suất có thể có cho chiến lược đặt giá thầu.

Enum
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_UNSPECIFIED`	Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA`	Chi phí mỗi hành động.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC`	Chi phí mỗi lượt nhấp.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`	CPM có thể xem.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`	Thuật toán đặt giá thầu tuỳ chỉnh.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA`	Lượt xem có thể nghe và được xem đã hoàn tất.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN`	Thời gian xem trong hơn 10 giây.
`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED`	Số lượt hiển thị có thể xem.

PerformanceGoalBidStrategy

Chiến lược tự động điều chỉnh giá thầu để đáp ứng hoặc vượt mục tiêu hiệu suất đã chỉ định.

Biểu diễn dưới dạng JSON
{ "performanceGoalType": enum (`BiddingStrategyPerformanceGoalType`), "performanceGoalAmountMicros": string, "maxAverageCpmBidAmountMicros": string, "customBiddingAlgorithmId": string }

Các trường
`performanceGoalType`	`enum (BiddingStrategyPerformanceGoalType)` Bắt buộc. Loại mục tiêu hiệu suất mà chiến lược đặt giá thầu sẽ cố gắng đạt được hoặc vượt qua. Để sử dụng ở cấp mục hàng, giá trị phải là một trong: `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA` `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC` `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`.
`performanceGoalAmountMicros`	`string (int64 format)` Bắt buộc. Mục tiêu về hiệu suất mà chiến lược đặt giá thầu sẽ cố gắng đạt được hoặc vượt qua mục tiêu, tính theo phần triệu đơn vị tiền tệ của nhà quảng cáo hoặc giá trị một phần triệu của ROAS (Lợi tức trên chi tiêu quảng cáo), tính theo đơn vị tiền tệ của nhà quảng cáo. Phải lớn hơn hoặc bằng đơn vị có thể lập hoá đơn của đơn vị tiền tệ nhất định và nhỏ hơn hoặc bằng giới hạn trên. Mỗi `performanceGoalType` đều có giới hạn trên: khi `performanceGoalType` là `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPA`, giới hạn trên là 10.000 USD. khi `performanceGoalType` là `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CPC`, giới hạn trên là 1.000 USD. khi `performanceGoalType` là `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`, giới hạn trên là 1.000 USD. khi `performanceGoalType` là `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`, giới hạn trên là 1000 và giới hạn dưới là 0,01. Ví dụ: Nếu bạn đặt thành `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`, giá thầu sẽ dựa trên xác suất mỗi lượt hiển thị có thể xem được. Ví dụ: nếu mục tiêu CPM có thể xem là 2 đô la Mỹ và một lượt hiển thị có khả năng xem là 40%, thì giá thầu sẽ là 0, 8 đô la CPM (tức là 40% của 2 đô la Mỹ). Ví dụ: 1500.000 đại diện cho 1, 5 đơn vị chuẩn của tiền tệ hoặc giá trị ROAS.
`maxAverageCpmBidAmountMicros`	`string (int64 format)` CPM trung bình tối đa có thể là giá thầu, tính theo phần triệu đơn vị tiền tệ của nhà quảng cáo. Phải lớn hơn hoặc bằng đơn vị có thể lập hoá đơn của đơn vị tiền tệ cụ thể. Không áp dụng khi bạn đặt `performanceGoalType` thành `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM`. Ví dụ: 1500000 đại diện cho 1, 5 đơn vị tiền tệ chuẩn.
`customBiddingAlgorithmId`	`string (int64 format)` Mã của Thuật toán đặt giá thầu tuỳ chỉnh mà chiến lược này sử dụng. Chỉ áp dụng khi bạn đặt `performanceGoalType` thành `BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO`.