- Tài nguyên: Mục hàng
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Nền tảng
- Phương thức
Tài nguyên: Mục hàng
Một mục hàng duy nhất.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của mục hàng. |
advertiserId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo chứa mục hàng. |
campaignId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của chiến dịch chứa mục hàng. |
insertionOrderId |
Bắt buộc. Không thể thay đổi. Mã nhận dạng duy nhất của đơn đặt hàng quảng cáo chứa mục hàng. |
lineItemId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của mục hàng. Do hệ thống chỉ định. |
displayName |
Bắt buộc. Tên hiển thị của mục hàng. Phải là mã UTF-8 với kích thước tối đa là 240 byte. |
lineItemType |
Bắt buộc. Không thể thay đổi. Loại mục hàng. |
entityStatus |
Bắt buộc. Kiểm soát việc mục hàng 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 mục hàng đượ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 kết với mục hàng. Nếu không có hoặc trống trong phương thức |
flight |
Bắt buộc. Thời gian bắt đầu và kết thúc giai đoạn hiển thị của mục hàng. |
budget |
Bắt buộc. Chế độ cài đặt phân bổ ngân sách của mục hàng. |
pacing |
Bắt buộc. Chế độ cài đặt tốc độ chi tiêu ngân sách của mục hàng. |
frequencyCap |
Bắt buộc. Chế độ cài đặt giới hạn tần suất hiển thị của mục hàng. Bạn phải sử dụng trường |
partnerRevenueModel |
Bắt buộc. Chế độ cài đặt mô hình doanh thu của mục hàng đối tác. |
conversionCounting |
Chế độ theo dõi lượt chuyển đổi của mục hàng. |
creativeIds[] |
Mã của mẫu quảng cáo liên kết với mục hàng. |
bidStrategy |
Bắt buộc. Chiến lược đặt giá thầu của mục hàng. |
integrationDetails |
Thông tin tích hợp chi tiết của mục hàng. |
inventorySourceIds[] |
Mã của các nguồn khoảng không quảng cáo riêng tư được chỉ định cho mục hàng. |
targetingExpansion |
Chế độ cài đặt tối ưu hoá tiêu chí nhắm mục tiêu của mục hàng. Cấu hình này chỉ áp dụng cho mục hàng hiển thị, video hoặc âm thanh sử dụng tính năng đặt giá thầu tự động và nhắm mục tiêu tích cực đến danh sách đối tượng đủ điều kiện. |
warningMessages[] |
Chỉ có đầu ra. Thông báo cảnh báo do mục hàng tạo. Những cảnh báo này không chặn việc lưu mục hàng nhưng một số cảnh báo có thể chặn mục hàng chạy. |
mobileApp |
Ứng dụng dành cho thiết bị di động được mục hàng quảng bá. Điều này chỉ áp dụng khi |
reservationType |
Chỉ có đầu ra. Loại đặt trước của mục hàng. |
excludeNewExchanges |
Liệu có loại trừ các đối tác trao đổi mới khỏi mục hàng tự động nhắm mục tiêu hay không. Trường này là false theo mặc định. |
LineItemType
Các loại mục hàng có thể có.
Loại mục hàng xác định các chế độ cài đặt và tuỳ chọn có thể áp dụng, chẳng hạn như định dạng quảng cáo hoặc tuỳ chọn nhắm mục tiêu.
Enum | |
---|---|
LINE_ITEM_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. Bạn không thể tạo hoặc cập nhật mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của chúng bằng API. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
Quảng cáo dạng hình ảnh, HTML5, gốc hoặc đa phương tiện. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Quảng cáo hiển thị giúp thúc đẩy lượt cài đặt ứng dụng. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
Quảng cáo dạng video được bán theo CPM cho nhiều môi trường. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
Quảng cáo dạng video giúp thúc đẩy lượt cài đặt ứng dụng. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
Quảng cáo hiển thị được phân phát trên khoảng không quảng cáo trên ứng dụng dành cho thiết bị di động. Bạn không thể tạo hoặc cập nhật mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của chúng bằng API. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
Quảng cáo dạng video được phân phát trên khoảng không quảng cáo trong ứng dụng dành cho thiết bị di động. Bạn không thể tạo hoặc cập nhật mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của chúng bằng API. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
Quảng cáo âm thanh RTB được bán cho nhiều môi trường. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
Quảng cáo trực tiếp có trong đơn đặt hàng quảng cáo trực tiếp qua Internet (OTT). Loại này chỉ áp dụng cho các mục hàng có đơn đặt hàng quảng cáo là insertionOrderType OVER_THE_TOP . |
LineItemFlight
Các chế độ cài đặt kiểm soát thời lượng hoạt động của một mục hàng.
Biểu diễn dưới dạng JSON |
---|
{ "flightDateType": enum ( |
Các trường | |
---|---|
flightDateType |
Bắt buộc. Loại thời biểu quảng cáo của mục hàng. |
dateRange |
Ngày bắt đầu và ngày kết thúc giai đoạn hiển thị của mục hàng. Các khung giờ này được phân giải tương ứng với múi giờ của nhà quảng cáo gốc.
|
triggerId |
Mã của điều kiện kích hoạt thủ công liên kết với mục hàng.
Cảnh báo: Các mục hàng sử dụng trình kích hoạt thủ công không còn phân phát trong Display & Video 360 nữa. Trường này sẽ ngừng hoạt động từ ngày 1 tháng 8 năm 2023. Hãy đọc thông báo về việc ngừng sử dụng tính năng của chúng tôi để biết thêm thông tin. |
LineItemFlightDateType
Các loại thời biểu quảng cáo có thể có của mục hàng.
Enum | |
---|---|
LINE_ITEM_FLIGHT_DATE_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. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
Thời biểu quảng cáo của mục hàng được kế thừa từ đơn đặt hàng quảng cáo gốc. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
Mục hàng sử dụng thời biểu quảng cáo tuỳ chỉnh riêng. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
Mục hàng sử dụng một điều kiện kích hoạt. Cảnh báo: Các mục hàng sử dụng trình kích hoạt thủ công không còn phân phát trong Display & Video 360 nữa. Giá trị này sẽ ngừng hoạt động từ ngày 1 tháng 8 năm 2023. Hãy đọc thông báo về việc ngừng sử dụng tính năng của chúng tôi để biết thêm thông tin. |
LineItemBudget
Chế độ cài đặt kiểm soát cách phân bổ ngân sách.
Biểu diễn dưới dạng JSON |
---|
{ "budgetAllocationType": enum ( |
Các trường | |
---|---|
budgetAllocationType |
Bắt buộc. Loại phân bổ ngân sách. Bạn chỉ dùng được |
budgetUnit |
Chỉ có đầu ra. Đơ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ị. Giá trị này được kế thừa từ đơn đặt hàng quảng cáo gốc. |
maxAmount |
Số tiền ngân sách tối đa mà mục hàng sẽ chi tiêu. Phải lớn hơn 0. Khi
|
LineItemBudgetAllocationType
Các loại mức phân bổ ngân sách có thể có.
Enum | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_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. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
Đã bật tính năng phân bổ ngân sách tự động cho mục hàng. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
Hệ thống sẽ phân bổ một số tiền ngân sách tối đa cố định cho mục hàng. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
Không có giới hạn ngân sách nào được áp dụng cho mục hàng. |
PartnerRevenueModel
Chế độ cài đặt kiểm soát cách tính doanh thu của đối tác.
Biểu diễn dưới dạng JSON |
---|
{
"markupType": enum ( |
Các trường | |
---|---|
markupType |
Bắt buộc. Loại đánh dấu của mô hình doanh thu của đối tác. |
markupAmount |
Bắt buộc. Số tiền đánh dấu của mô hình doanh thu của đối tác. Phải lớn hơn hoặc bằng 0.
|
PartnerRevenueModelMarkupType
Các loại mã đánh dấu có thể có của mô hình doanh thu của đối tác.
Enum | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_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. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
Tính toán doanh thu của đối tác dựa trên CPM cố định. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
Tính toán doanh thu của đối tác dựa trên tỷ lệ phần trăm phụ phí của chi phí truyền thông. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Tính doanh thu của đối tác dựa trên tỷ lệ phần trăm phụ phí của tổng chi phí truyền thông, bao gồm tất cả chi phí của đối tác và chi phí dữ liệu. |
ConversionCountingConfig
Chế độ cài đặt kiểm soát cách tính lượt chuyển đổi.
Tất cả các lượt chuyển đổi sau khi nhấp chuột sẽ được tính. Bạn có thể đặt giá trị phần trăm để tính lượt chuyển đổi sau khi xem.
Biểu diễn dưới dạng JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Các trường | |
---|---|
postViewCountPercentageMillis |
Tỷ lệ phần trăm lượt chuyển đổi sau khi xem cần tính, tính bằng mili giây (1/1000 của phần trăm). Phải nằm trong khoảng từ 0 đến 100.000. Ví dụ: để theo dõi 50% lượt chuyển đổi sau khi nhấp, hãy đặt giá trị là 50000. |
floodlightActivityConfigs[] |
Các cấu hình hoạt động Floodlight được dùng để theo dõi lượt chuyển đổi. Số lượt chuyển đổi được tính là tổng tất cả các lượt chuyển đổi được tính bởi tất cả các mã hoạt động Floodlight được chỉ định trong trường này. |
TrackingFloodlightActivityConfig
Các chế độ cài đặt kiểm soát hành vi của một cấu hình hoạt động Floodlight.
Biểu diễn dưới dạng JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Các trường | |
---|---|
floodlightActivityId |
Bắt buộc. Mã của hoạt động Floodlight. |
postClickLookbackWindowDays |
Bắt buộc. Số ngày mà một lượt chuyển đổi có thể được tính sau khi người dùng nhấp vào một quảng cáo. Phải nằm trong khoảng từ 0 đến 90. |
postViewLookbackWindowDays |
Bắt buộc. Số ngày mà một lượt chuyển đổi có thể được tính sau khi người dùng xem một quảng cáo. Phải nằm trong khoảng từ 0 đến 90. |
TargetingExpansionConfig
Các chế độ cài đặt kiểm soát chế độ cài đặt tối ưu hoá tiêu chí nhắm mục tiêu của mục hàng.
Biểu diễn dưới dạng JSON |
---|
{
"targetingExpansionLevel": enum ( |
Các trường | |
---|---|
targetingExpansionLevel |
Bắt buộc. Tính năng tối ưu hoá tiêu chí nhắm mục tiêu có được bật hay không. Trường này hỗ trợ các giá trị sau:
Nếu bạn đặt trường này thành bất kỳ giá trị nào khác, thì trường này sẽ tự động được đặt thành
|
excludeFirstPartyAudience |
Có loại trừ đối tượng của bên thứ nhất khỏi hoạt động mở rộng tiêu chí nhắm mục tiêu hay không. Trường này đã ngừng hoạt động khi tính năng tối ưu hoá tiêu chí nhắm mục tiêu ra mắt. Trường này sẽ được đặt thành |
TargetingExpansionLevel
Chế độ cài đặt Tối ưu hoá tiêu chí nhắm mục tiêu.
Enum | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Chế độ cài đặt cho tính năng tối ưu hoá tiêu chí nhắm mục tiêu chưa được chỉ định hoặc không xác định trong phiên bản này. |
NO_EXPANSION |
Tính năng tối ưu hoá tiêu chí nhắm mục tiêu đang tắt. |
LEAST_EXPANSION |
Tính năng tối ưu hoá tiêu chí nhắm mục tiêu đang bật. |
SOME_EXPANSION |
Nếu được sử dụng, sẽ tự động được đặt thành |
BALANCED_EXPANSION |
Nếu được sử dụng, sẽ tự động được đặt thành |
MORE_EXPANSION |
Nếu được sử dụng, sẽ tự động được đặt thành |
MOST_EXPANSION |
Nếu được sử dụng, sẽ tự động được đặt thành |
LineItemWarningMessage
Thông báo cảnh báo do một mục hàng tạo. Các loại cảnh báo này không chặn việc lưu mục hàng nhưng có thể chặn mục hàng chạy.
Enum | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Chưa được chỉ định hoặc không xác định. |
INVALID_FLIGHT_DATES |
Ngày thời gian hiển thị của mục hàng này không hợp lệ. Mục hàng sẽ không chạy. |
EXPIRED |
Ngày kết thúc của mục hàng này đã qua. |
PENDING_FLIGHT |
Mục hàng này sẽ bắt đầu chạy trong tương lai. |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
Tất cả những trao đổi đối tác đã bật đều nhắm mục tiêu phủ định. Mục hàng sẽ không chạy. |
INVALID_INVENTORY_SOURCE |
Không có nguồn khoảng không quảng cáo đang hoạt động nào được nhắm mục tiêu. Mục hàng sẽ không chạy. |
APP_INVENTORY_INVALID_SITE_TARGETING |
Tùy chọn nhắm mục tiêu theo Ứng dụng và URL của mục hàng này không bao gồm bất kỳ ứng dụng dành cho thiết bị di động nào. Loại mục hàng này yêu cầu bạn phải thêm ứng dụng di động vào tiêu chí nhắm mục tiêu kênh, danh sách trang web hoặc ứng dụng. Mục hàng sẽ không chạy. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Mục hàng này không nhắm mục tiêu bất kỳ người dùng thiết bị di động nào. Loại mục hàng này yêu cầu bạn phải nhắm mục tiêu danh sách người dùng có người dùng thiết bị di động. Mục hàng sẽ không chạy. |
NO_VALID_CREATIVE |
Mục hàng này không chứa bất kỳ mẫu quảng cáo hợp lệ nào. Mục hàng sẽ không chạy. |
PARENT_INSERTION_ORDER_PAUSED |
Thứ tự chèn của mục hàng này đã tạm dừng. Mục hàng sẽ không chạy. |
PARENT_INSERTION_ORDER_EXPIRED |
Ngày kết thúc của thứ tự chèn của mục hàng này đã được đặt trong quá khứ. Mục hàng sẽ không chạy. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Mục hàng này không nhắm mục tiêu đến bất kỳ danh sách đối tượng nào. Điều này có thể dẫn đến việc bạn chi tiêu ngân sách của mình quá nhanh. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Mục hàng lượt cài đặt ứng dụng này không có bất kỳ pixel chuyển đổi nào đã thiết lập. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Mục hàng này nhắm đến một hoặc nhiều danh sách người dùng không còn hoạt động nữa. Trong tương lai, hành động này sẽ ngăn mục hàng phân phát, vì vậy, hãy cân nhắc xoá những danh sách này khỏi tiêu chí nhắm mục tiêu của bạn. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Mục hàng lượt cài đặt ứng dụng này không có chiến lược đặt giá thầu tối ưu. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
Giao dịch mà mục hàng này nhắm mục tiêu có thể chấp nhận kích thước quảng cáo hiện không được sử dụng. Việc này có thể giới hạn quá trình phân phối hoặc hiệu quả hoạt động của mục hàng. |
NO_CREATIVE_FOR_TARGETED_DEALS |
Mục hàng này không chứa bất kỳ mẫu quảng cáo nào cho các giao dịch được nhắm mục tiêu. |
TARGETING_DEPRECATED_GEO_TARGET |
Mục hàng này nhắm đến một mục tiêu địa lý không còn dùng nữa. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Mục hàng này sử dụng chế độ cài đặt Hãy cập nhật chế độ tích hợp API để loại trừ trực tiếp mọi đối tượng của bên thứ nhất bằng tính năng nhắm mục tiêu theo đối tượng trước ngày 25 tháng 3 năm 2023 để tính đến việc trường |
MobileApp
Ứng dụng dành cho thiết bị di động được quảng bá bởi một mục hàng lượt cài đặt ứng dụng dành cho thiết bị di động.
Biểu diễn dưới dạng JSON |
---|
{
"appId": string,
"platform": enum ( |
Các trường | |
---|---|
appId |
Bắt buộc. Mã của ứng dụng do cửa hàng trên nền tảng cung cấp. Ứng dụng Android được xác định bằng mã nhận dạng gói mà Cửa hàng Play của Android sử dụng, chẳng hạn như Ứng dụng iOS được xác định bằng mã ứng dụng gồm 9 chữ số mà cửa hàng ứng dụng của Apple sử dụng (chẳng hạn như |
platform |
Chỉ có đầu ra. Nền tảng ứng dụng. |
displayName |
Chỉ có đầu ra. Tên ứng dụng. |
publisher |
Chỉ có đầu ra. Nhà xuất bản ứng dụng. |
Nền tảng
Các nền tảng ứng dụng di động có thể áp dụng.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Chưa chỉ định nền tảng. |
IOS |
iOS. |
ANDROID |
Nền tảng Android. |
Phương thức |
|
---|---|
|
Chỉnh sửa hàng loạt các tuỳ chọn nhắm mục tiêu trong một mục hàng. |
|
Liệt kê các tuỳ chọn nhắm mục tiêu được chỉ định của một mục hàng trên các loại tiêu chí nhắm mục tiêu. |
|
Tạo mục hàng mới. |
|
Xoá mục hàng. |
|
Tạo một mục hàng mới có chế độ cài đặt (bao gồm cả tiêu chí nhắm mục tiêu) kế thừa từ đơn đặt hàng quảng cáo và ENTITY_STATUS_DRAFT entity_status . |
|
Nhận một mục hàng. |
|
Liệt kê các mục hàng trong một nhà quảng cáo. |
|
Cập nhật mục hàng hiện có. |