REST Resource: advertisers.lineItems

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 (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}
Các trường
name

string

Chỉ có đầu ra. Tên tài nguyên của mục hàng.
advertiserId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

enum (LineItemType)

Bắt buộc. Không thể thay đổi. Loại mục hàng.
entityStatus

enum (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.

  • Đối với phương thức lineItems.create, chỉ ENTITY_STATUS_DRAFT được phép. Để kích hoạt một mục hàng, hãy sử dụng phương thức lineItems.patch và cập nhật trạng thái thành ENTITY_STATUS_ACTIVE sau khi tạo.
  • Không thể thay đổi mục hàng về trạng thái ENTITY_STATUS_DRAFT từ bất kỳ trạng thái nào khác.
  • Nếu đơn đặt hàng quảng cáo gốc của mục hàng không hoạt động, mục hàng không thể chi tiêu ngân sách ngay cả khi trạng thái của chính mục hàng là ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

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ụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

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 lineItems.create, mục hàng mới tạo sẽ kế thừa chi phí đối tác từ đơn đặt hàng quảng cáo gốc.
flight

object (LineItemFlight)

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

object (LineItemBudget)

Bắt buộc. Chế độ cài đặt phân bổ ngân sách của mục hàng.
pacing

object (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

object (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 maxImpressions trong đối tượng chế độ cài đặt này nếu chỉ định giới hạn.
partnerRevenueModel

object (PartnerRevenueModel)

Bắt buộc. Chế độ cài đặt mô hình doanh thu của mục hàng đối tác.
conversionCounting

object (ConversionCountingConfig)

Chế độ theo dõi lượt chuyển đổi của mục hàng.
creativeIds[]

string (int64 format)

Mã của mẫu quảng cáo liên kết với mục hàng.
bidStrategy

object (BiddingStrategy)

Bắt buộc. Chiến lược đặt giá thầu của mục hàng.
integrationDetails

object (IntegrationDetails)

Thông tin tích hợp chi tiết của mục hàng.
inventorySourceIds[]

string (int64 format)

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

object (TargetingExpansionConfig)

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[]

enum (LineItemWarningMessage)

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

object (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 lineItemType là LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL hoặc LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Chỉ có đầu ra. Loại đặt trước của mục hàng.
excludeNewExchanges

boolean

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 (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}
Các trường
flightDateType

enum (LineItemFlightDateType)

Bắt buộc. Loại thời biểu quảng cáo của mục hàng.
dateRange

object (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.

  • Bắt buộc khi flightDateType là LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Chỉ cho ra kết quả khác.
  • Khi tạo một chuyến bay mới, cả startDate và endDate đều phải ở trong tương lai.
  • Chuyến bay hiện tại có startDate trong quá khứ có endDate có thể thay đổi nhưng startDate không thể thay đổi.
  • endDate phải là startDate trở lên, cả hai đều phải trước năm 2037.
triggerId

string (int64 format)

Mã của điều kiện kích hoạt thủ công liên kết với mục hàng.

  • Bắt buộc khi flightDateType là LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER. Bạn không được đặt giá trị khác.
  • Khi bạn đặt chính sách này, thời biểu quảng cáo của mục hàng sẽ được kế thừa từ đơn đặt hàng quảng cáo gốc.
  • Mục hàng đang hoạt động sẽ chi tiêu khi điều kiện kích hoạt đã chọn được kích hoạt trong thời gian tiến hành của đơn đặt hàng quảng cáo gốc.

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 (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Các trường
budgetAllocationType

enum (LineItemBudgetAllocationType)

Bắt buộc. Loại phân bổ ngân sách.

Bạn chỉ dùng được LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC khi tính năng tự động phân bổ ngân sách được bật cho đơn đặt hàng quảng cáo gốc.
budgetUnit

enum (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

string (int64 format)

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 budgetAllocationType:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, trường này không thể thay đổi và do hệ thống đặt.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, nếu budgetUnit là:
    • BUDGET_UNIT_CURRENCY, trường này thể hiện số tiền ngân sách tối đa cần chi tiêu, tính bằng phần triệu đơn vị tiền tệ của nhà quảng cáo. Ví dụ: 1500000 đại diện cho 1, 5 đơn vị tiền tệ chuẩn.
    • BUDGET_UNIT_IMPRESSIONS, trường này thể hiện số lượt hiển thị tối đa sẽ phân phát.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, trường này không áp dụng được và sẽ bị hệ thống bỏ qua.

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 (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Các trường
markupType

enum (PartnerRevenueModelMarkupType)

Bắt buộc. Loại đánh dấu của mô hình doanh thu của đối tác.
markupAmount

string (int64 format)

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.

  • Khi bạn đặt markupType thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, trường này đại diện cho mã đánh dấu CPM theo phần triệu đơn vị tiền tệ của nhà quảng cáo. Ví dụ: 1500000 đại diện cho 1, 5 đơn vị tiền tệ chuẩn.
  • Khi bạn đặt markupType thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, trường này biểu thị mức tăng phần trăm chi phí truyền thông tính theo mili giây. Ví dụ: 100 đại diện cho 0,1% (thập phân 0,001).
  • Khi bạn đặt markupType thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, trường này sẽ biểu thị mức tăng tổng chi phí truyền thông tính theo mili giây. Ví dụ: 100 đại diện cho 0,1% (thập phân 0,001).

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 (TrackingFloodlightActivityConfig)
    }
  ]
}
Các trường
postViewCountPercentageMillis

string (int64 format)

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[]

object (TrackingFloodlightActivityConfig)

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

string (int64 format)

Bắt buộc. Mã của hoạt động Floodlight.
postClickLookbackWindowDays

integer

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

integer

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 (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}
Các trường
targetingExpansionLevel

enum (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:

  • NO_EXPANSION: tính năng tối ưu hoá tiêu chí nhắm mục tiêu đã tắt
  • LEAST_EXPANSION: tính năng tối ưu hoá tiêu chí nhắm mục tiêu đang bật

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 LEAST_EXPANSION.

NO_EXPANSION sẽ là giá trị mặc định cho trường này và sẽ tự động được gán nếu bạn không đặt trường này.
excludeFirstPartyAudience
(deprecated)

boolean

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 false. Nếu bạn đặt trường này thành true khi không dùng nữa, thì tất cả tiêu chí nhắm mục tiêu khẳng định theo đối tượng bên thứ nhất đã chỉ định cho mục hàng này sẽ được thay thế bằng tiêu chí nhắm mục tiêu phủ định cho chính các đối tượng bên thứ nhất để đảm bảo việc loại trừ tiếp tục các đối tượng đó.

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 LEAST_EXPANSION.
BALANCED_EXPANSION

Nếu được sử dụng, sẽ tự động được đặt thành LEAST_EXPANSION.
MORE_EXPANSION

Nếu được sử dụng, sẽ tự động được đặt thành LEAST_EXPANSION.
MOST_EXPANSION

Nếu được sử dụng, sẽ tự động được đặt thành LEAST_EXPANSION.

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 excludeFirstPartyAudience hiện không còn được dùng nữa và được lên lịch ngừng hoạt động sau ngày 25 tháng 3 năm 2023.

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 excludeFirstPartyAudience ngừng hoạt độ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 (Platform),
  "displayName": string,
  "publisher": string
}
Các trường
appId

string

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ư com.google.android.gm.

Ứ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ư 422689480).
platform

enum (Platform)

Chỉ có đầu ra. Nền tảng ứng dụng.
displayName

string

Chỉ có đầu ra. Tên ứng dụng.
publisher

string

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

bulkEditLineItemAssignedTargetingOptions

 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.

bulkListLineItemAssignedTargetingOptions

 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.

create

 Tạo mục hàng mới.

delete

 Xoá mục hàng.

generateDefault

 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.

get

 Nhận một mục hàng.

list

 Liệt kê các mục hàng trong một nhà quảng cáo.

patch

 Cập nhật mục hàng hiện có.