- Tài nguyên: InsertOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Phương thức
Tài nguyên: InsertOrder
Một đơn đặt hàng quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của đơn đặt hàng quảng cáo. |
advertiserId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo chứa đơn đặt hàng quảng cáo. |
campaignId |
Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của chiến dịch chứa đơn đặt hàng quảng cáo. |
insertionOrderId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của đơn đặt hàng quảng cáo. Do hệ thống chỉ định. |
displayName |
Bắt buộc. Tên hiển thị của đơn đặt hàng quảng cáo. Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte. |
insertionOrderType |
Loại đơn đặt hàng quảng cáo. Nếu bạn không chỉ định trường này khi tạo, giá trị mặc định sẽ là |
entityStatus |
Bắt buộc. Kiểm soát việc đơn đặt hàng quảng cáo có thể chi tiêu ngân sách và đặt giá thầu trên khoảng không quảng cáo hay không.
|
updateTime |
Chỉ có đầu ra. Dấu thời gian khi đơn đặt hàng quảng cáo được cập nhật lần gần đây nhất. Do hệ thống chỉ định. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
partnerCosts[] |
Chi phí đối tác liên quan đến đơn đặt hàng quảng cáo. Nếu không có hoặc trống trong phương thức |
pacing |
Bắt buộc. Chế độ cài đặt tốc độ chi tiêu ngân sách của đơn đặt hàng quảng cáo. |
frequencyCap |
Bắt buộc. Chế độ cài đặt giới hạn tần suất của đơn đặt hàng quảng cáo. |
integrationDetails |
Thông tin chi tiết khác về việc tích hợp của đơn đặt hàng quảng cáo. |
performanceGoal |
Bắt buộc. Mục tiêu về hiệu suất của đơn đặt hàng quảng cáo. |
budget |
Bắt buộc. Chế độ cài đặt phân bổ ngân sách của đơn đặt hàng quảng cáo. |
bidStrategy |
Chiến lược đặt giá thầu của đơn đặt hàng quảng cáo. Theo mặc định, |
reservationType |
Chỉ có đầu ra. Loại đặt trước của đơn đặt hàng quảng cáo. |
billableOutcome |
Không thể thay đổi. Kết quả có thể lập hoá đơn của đơn đặt hàng quảng cáo. Tính năng mua dựa trên kết quả không được dùng nữa. |
InsertionOrderType
Các loại Đơn đặt hàng quảng cáo có thể có.
Loại Đơn đặt hàng quảng cáo xác định những chế độ cài đặt và lựa chọn có thể áp dụng, chẳng hạn như định dạng của quảng cáo hoặc lựa chọn nhắm mục tiêu.
Enum | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
Loại đơn đặt hàng quảng cáo chưa được chỉ định hoặc không xác định. |
RTB |
Đặt giá thầu theo thời gian thực. |
OVER_THE_TOP |
Trực tiếp qua Internet. |
InsertionOrderBudget
Chế độ cài đặt kiểm soát cách phân bổ ngân sách đơn đặt hàng quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "budgetUnit": enum ( |
Trường | |
---|---|
budgetUnit |
Bắt buộc. Không thể thay đổi. Đơn vị ngân sách chỉ định ngân sách dựa trên đơn vị tiền tệ hay dựa trên lượt hiển thị. |
automationType |
Loại tự động dùng để quản lý giá thầu và ngân sách cho đơn đặt hàng quảng cáo. Nếu bạn không chỉ định trường này khi tạo, giá trị mặc định sẽ là |
budgetSegments[] |
Bắt buộc. Danh sách phân đoạn ngân sách. Sử dụng phân đoạn ngân sách để chỉ định ngân sách cụ thể trong một khoảng thời gian nhất định mà đơn đặt hàng quảng cáo đang chạy. |
InsertionOrderAutomationType
Các lựa chọn có thể sử dụng để tự động hoá ngân sách và giá thầu cho đơn đặt hàng quảng cáo.
Enum | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
Tuỳ chọn tự động hoá đơn đặt hàng quảng cáo chưa được chỉ định hoặc không xác định trong phiên bản này. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Tự động phân bổ ngân sách. Cho phép hệ thống tự động chuyển ngân sách sang việc sở hữu các mục hàng để tối ưu hoá hiệu suất do performanceGoal xác định. Không có tự động hóa cài đặt giá thầu. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Không tự động hoá giá thầu hoặc ngân sách ở cấp đơn đặt hàng quảng cáo. Bạn phải định cấu hình giá thầu và ngân sách theo cách thủ công ở cấp mục hàng. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Cho phép hệ thống tự động điều chỉnh giá thầu và chuyển ngân sách sang việc sở hữu các mục hàng để tối ưu hoá hiệu suất do performanceGoal xác định. |
InsertionOrderBudgetSegment
Các chế độ cài đặt kiểm soát ngân sách của một phân đoạn ngân sách.
Biểu diễn dưới dạng JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Trường | |
---|---|
budgetAmountMicros |
Bắt buộc. Số tiền ngân sách mà đơn đặt hàng quảng cáo sẽ chi tiêu trong |
description |
Nội dung mô tả về phân khúc ngân sách. Bạn có thể sử dụng thuộc tính này để nhập thông tin Đơn đặt hàng cho từng phân đoạn ngân sách và in thông tin đó trên hoá đơn. Phải được mã hoá UTF-8. |
dateRange |
Bắt buộc. Chế độ cài đặt ngày bắt đầu và ngày kết thúc của phân đoạn ngân sách. Các thông báo này được phân giải theo múi giờ của nhà quảng cáo gốc.
|
campaignBudgetId |
|
BillableOutcome
Kết quả có thể phải trả cho một đơn đặt hàng quảng cáo.
Enum | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Kết quả có thể lập hoá đơn không được chỉ định. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Trả tiền cho mỗi lượt hiển thị. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Trả tiền cho mỗi lượt nhấp. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Trả tiền cho mỗi lượt xem đang kích hoạt. |
Phương thức |
|
---|---|
|
Tạo một đơn đặt hàng quảng cáo mới. |
|
Xoá đơn đặt hàng quảng cáo. |
|
Lấy đơn đặt hàng quảng cáo. |
|
Liệt kê các đơn đặt hàng quảng cáo trong một nhà quảng cáo. |
|
Liệt kê các lựa chọn nhắm mục tiêu được chỉ định của một đơn đặt hàng quảng cáo trên các loại tiêu chí nhắm mục tiêu. |
|
Cập nhật một đơn đặt hàng quảng cáo hiện có. |