REST Resource: advertisers.lineItems

Tài nguyên: LineItem

Một mục hàng.

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)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
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 có 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 được mã hoá theo 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 cho khoảng không quảng cáo hay không.

  • Đối với phương thức lineItems.create, chỉ cho phép ENTITY_STATUS_DRAFT. Để 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.
  • Bạn không thể thay đổi trạng thái của 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 mẹ của mục hàng không hoạt động, thì mục hàng đó không thể chi tiêu ngân sách ngay cả khi trạng thái của 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.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
partnerCosts[]

object (PartnerCost)

Chi phí đối tác liên quan đến mục hàng.

Nếu không có hoặc trống trong phương thức lineItems.create, thì 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 của chuyến bay 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)

Không bắt buộc. Bắt buộc nếu loại mục hàng không phải là LINE_ITEM_TYPE_DEMAND_GEN. 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 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 đối tác cho mục hàng.
conversionCounting

object (ConversionCountingConfig)

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

string (int64 format)

Mã nhận dạng của các 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 chi tiết về việc tích hợp của 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 các mục hàng hiển thị, video hoặc âm thanh sử dụng chiến lược đặt giá thầu tự động và nhắm mục tiêu tích cực đến các 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 ra. 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 di động được quảng bá theo mục hàng.

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

Có loại trừ các sàn giao dịch mới khỏi việc tự động được nhắm mục tiêu theo mục hàng hay không. Trường này có giá trị mặc định là false.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Không bắt buộc. Chế độ cài đặt dành riêng cho mục hàng YouTube và đối tác.
demandGenSettings

object (DemandGenSettings)

Không bắt buộc. Chế độ cài đặt dành riêng cho mục hàng Tạo nhu cầu.

Chỉ áp dụng cho mục hàng Tạo nhu cầu.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Liệu mục hàng này có phân phát quảng cáo chính trị ở Liên minh Châu Âu hay không.

Nếu containsEuPoliticalAds được đặt thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING trong nhà quảng cáo gốc, thì trường này sẽ được chỉ định DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING nếu không được chỉ định khác. Sau đó, bạn có thể cập nhật trường này bằng giao diện người dùng, API hoặc Tệp dữ liệu có cấu trúc.

Bạn phải chỉ định trường này khi tạo mục hàng mới. Nếu không, yêu cầu advertisers.lineItems.create sẽ không thành công.
optimizeFixedBidding

boolean

Không bắt buộc. Có bật tính năng tối ưu hoá giá thầu của DV360 cho các mục hàng có giá thầu cố định hay không.

Theo mặc định, DV360 tối ưu hoá giá thầu cố định của bạn bằng cách tự động hạ giá thầu cho những lượt hiển thị ít có khả năng mang lại hiệu suất cao. Tính năng tối ưu hoá này được bật theo mặc định (giá trị là true).

Khi bạn đặt trường này thành false, tính năng tối ưu hoá này sẽ bị tắt và giá thầu sẽ không bị hạ vì bất kỳ lý do nào.

Chế độ cài đặt này chỉ áp dụng cho các mục hàng có biddingStrategy thuộc loại FIXED_BID.

LineItemType

Các loại mục hàng có thể có.

Loại mục hàng xác định chế độ cài đặt và lựa chọn nào có thể áp dụng, chẳng hạn như định dạng quảng cáo hoặc lựa 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 các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_DISPLAY_DEFAULT Quảng cáo dạng hình ảnh, HTML5, quảng cáo gốc hoặc quảng cáo đa truyền thông.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Quảng cáo hiển thị 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 mô hình CPM cho nhiều môi trường.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Quảng cáo dạng video 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 di động.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hà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 trên ứng ứng dụng di động.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_AUDIO_DEFAULT Quảng cáo dạng âm thanh RTB được bán cho nhiều môi trường.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Quảng cáo OTT có trong đơn đặt hàng quảng cáo 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.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Quảng cáo dạng video trên YouTube giúp tăng số lượt chuyển đổi.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Quảng cáo dạng video trên YouTube (tối đa 15 giây) mà người xem không thể bỏ qua.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Quảng cáo dạng video trên YouTube kể một câu chuyện theo một trình tự cụ thể bằng cách kết hợp nhiều định dạng.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Quảng cáo dạng âm thanh trên YouTube.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Quảng cáo dạng video trên YouTube giúp tối ưu hoá phạm vi tiếp cận thêm nhiều người dùng riêng biệt với chi phí thấp hơn. Có thể bao gồm quảng cáo đệm, quảng cáo trong luồng phát có thể bỏ qua hoặc kết hợp nhiều loại quảng cáo.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Quảng cáo dạng video mặc định trên YouTube.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Quảng cáo dạng video trên YouTube TV thông minh (tối đa 15 giây) không thể bỏ qua.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Quảng cáo dạng video trên YouTube dành cho TV thông minh giúp tối ưu hoá việc tiếp cận thêm nhiều người dùng riêng biệt với chi phí thấp hơn. Có thể bao gồm quảng cáo đệm, quảng cáo trong luồng phát có thể bỏ qua hoặc kết hợp nhiều loại quảng cáo.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Quảng cáo dạng video mặc định trên YouTube cho TV thông minh. Chỉ bao gồm định dạng quảng cáo trong luồng phát.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

Mục tiêu của loại mục hàng này là hiển thị quảng cáo trên YouTube theo số lần mục tiêu cho cùng một người trong một khoảng thời gian nhất định.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Quảng cáo dạng video trên YouTube nhằm tăng số lượt xem bằng nhiều định dạng quảng cáo.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Quảng cáo hiển thị được phân phát trên khoảng không quảng cáo kỹ thuật số ngoài trời.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Quảng cáo dạng video được phân phát trên khoảng không quảng cáo kỹ thuật số ngoài trời.

Bạn không thể tạo hoặc cập nhật các mục hàng thuộc loại này và tiêu chí nhắm mục tiêu của các mục hàng đó bằng API.
LINE_ITEM_TYPE_DEMAND_GEN Quảng cáo Tạo nhu cầu.

LineItemFlight

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)
  }
}
Trường
flightDateType

enum (LineItemFlightDateType)

Bắt buộc. Loại ngày của chuyến bay của mục hàng.
dateRange

object (DateRange)

Ngày bắt đầu và ngày kết thúc của mục hàng. Các giá trị này được phân giải theo múi giờ của nhà quảng cáo mẹ.

  • Bắt buộc khi flightDateType là LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Nếu không, chỉ có đầu ra.
  • Khi tạo chuyến bay mới, cả startDate và endDate đều phải là thời gian trong tương lai.
  • Một chuyến bay hiện có với 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 trước năm 2037.

LineItemFlightDateType

Các loại ngày hiển thị có thể có của một 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 Ngày hiển thị quảng cáo của mục hàng được kế thừa từ đơn đặt hàng quảng cáo mẹ.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM Mục hàng sử dụng ngày chạy tuỳ chỉnh của riêng mục hàng đó.

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
}
Trường
budgetAllocationType

enum (LineItemBudgetAllocationType)

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

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC chỉ áp dụng khi bạn bật tính năng phân bổ ngân sách tự động cho đơn đặt hàng quảng cáo chính.

Bạn phải đặt trường này thành LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED cho các mục hàng Tạo nhu cầu.
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)

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 là:

  • 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 đơn vị micro của đơn vị tiền tệ của nhà quảng cáo. Ví dụ: 1500000 tương ứng với 1, 5 đơn vị tiền tệ tiêu chuẩn.
    • BUDGET_UNIT_IMPRESSIONS, trường này thể hiện số lượt hiển thị tối đa cần phân phát.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, trường này không áp dụng và sẽ bị hệ thống bỏ qua.

LineItemBudgetAllocationType

Các loại 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 Tính năng phân bổ ngân sách tự động được bật cho mục hàng.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Một khoản ngân sách tối đa cố định được phân bổ cho mục hàng.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED Không áp dụng giới hạn ngân sách 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
}
Trường
markupType

enum (PartnerRevenueModelMarkupType)

Bắt buộc. Loại mức tăng giá của mô hình doanh thu đối tác.

Bạn phải đặt trường này thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP cho các mục hàng Tạo nhu cầu.
markupAmount

string (int64 format)

Bắt buộc. Mức tăng của mô hình doanh thu đối tác. Phải lớn hơn hoặc bằng 0.

  • Khi markupType được đặt thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, trường này thể hiện mức tăng CPM theo đơn vị micro của đơn vị tiền tệ của nhà quảng cáo. Ví dụ: 1500000 tương ứng với 1, 5 đơn vị tiền tệ tiêu chuẩn.
  • Khi markupType được đặt thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, trường này thể hiện phần trăm tăng chi phí truyền thông tính bằng phần nghìn. Ví dụ: 100 đại diện cho 0,1% (số thập phân 0,001).
  • Khi markupType được đặt thành PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, trường này thể hiện tỷ lệ phần trăm tăng tổng chi phí truyền thông tính theo phần nghìn. Ví dụ: 100 đại diện cho 0,1% (số thập phân 0,001).

PartnerRevenueModelMarkupType

Các loại mức tăng có thể có của mô hình doanh thu đố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 doanh thu của đối tác dựa trên CPM cố định.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_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 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ả lượt chuyển đổi sau lượt nhấp sẽ được tính. Bạn có thể đặt giá trị phần trăm cho việc tính số lượt chuyển đổi sau khi xem.

Biểu diễn dưới dạng JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ],
  "primaryAttributionModelId": string
}
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 (1/1000 của một phần trăm). Phải nằm trong khoảng từ 0 đến 100.000.

Ví dụ: để theo dõi 50% số lượt chuyển đổi sau lượt nhấp, hãy đặt giá trị là 50000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Cấu hình hoạt động Floodlight dùng để theo dõi lượt chuyển đổi.

Số lượt chuyển đổi được tính là tổng của tất cả lượt chuyển đổi được tính theo tất cả mã hoạt động Floodlight được chỉ định trong trường này.

Bạn không thể cập nhật trường này nếu thuật toán đặt giá thầu tuỳ chỉnh được chỉ định cho mục hàng. Nếu bạn đặt trường này và chỉ định một thuật toán đặt giá thầu tuỳ chỉnh trong cùng một yêu cầu, thì các hoạt động Floodlight phải khớp với các hoạt động mà thuật toán đặt giá thầu tuỳ chỉnh sử dụng.
primaryAttributionModelId

string (int64 format)

Không bắt buộc. Mô hình phân bổ dùng để đo lường lượt chuyển đổi. Mô hình phân bổ này sẽ xác định cách tính số lượt chuyển đổi. Bạn có thể đặt Mô hình chính cho một cấu hình hoặc nhóm Floodlight. Xem thêm thông tin tại đây.

Chỉ áp dụng cho mục hàng Tạo nhu cầu.

TrackingFloodlightActivityConfig

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
}
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 sau khi người dùng nhấp vào quảng cáo mà một lượt chuyển đổi có thể được tính. 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 quảng cáo. Phải nằm trong khoảng từ 0 đến 90.

LineItemWarningMessage

Thông báo cảnh báo do một mục hàng tạo ra. Những 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 Không đượ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 là ngày trong quá khứ.
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 đưa ứng dụng di động vào tiêu chí nhắm mục tiêu theo 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 đến người dùng thiết bị di động. Loại mục hàng này yêu cầu bạn 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 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 đơn đặt hàng quảng cáo cho mục hàng này được đặt trong quá khứ. Mục hàng sẽ không chạy.

MobileApp

Một ứng dụng di động được quảng bá bằng mục hàng cài đặt ứng dụng di động.

Biểu diễn dưới dạng JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Trường
appId

string

Bắt buộc. Mã nhận dạng của ứng dụng do cửa hàng 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à App Store 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ể sử dụng.

Enum
PLATFORM_UNSPECIFIED Nền tảng chưa được chỉ định.
IOS Nền tảng iOS.
ANDROID Nền tảng Android.

YoutubeAndPartnersSettings

Chế độ cài đặt cho mục hàng YouTube và đối tác.

Biểu diễn dưới dạng JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideos": [
    {
      object (RelatedVideo)
    }
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Trường
viewFrequencyCap

object (FrequencyCap)

Chế độ cài đặt giới hạn tần suất xem của mục hàng.

Bạn phải sử dụng trường maxViews trong đối tượng cài đặt này nếu chỉ định giới hạn.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Không bắt buộc. Cấu hình dịch vụ đo lường của bên thứ ba cho mục hàng.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Chế độ cài đặt kiểm soát khoảng không quảng cáo trên YouTube và Đối tác mà mục hàng sẽ nhắm đến.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Chỉ có đầu ra. Loại nội dung mà quảng cáo trên YouTube và Đối tác sẽ xuất hiện.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Chỉ có đầu ra. Danh mục nội dung có hiệu lực khi phân phát mục hàng. Khi danh mục nội dung được đặt trong cả mục hàng và nhà quảng cáo, danh mục nghiêm ngặt hơn sẽ có hiệu lực khi phân phát mục hàng.

Các mục hàng mới sẽ chỉ kế thừa chế độ cài đặt ở cấp nhà quảng cáo.
targetFrequency

object (TargetFrequency)

Không bắt buộc. Số lần trung bình mà bạn muốn quảng cáo của mục hàng này hiển thị cho cùng một người trong một khoảng thời gian nhất định.
linkedMerchantId

string (int64 format)

Không bắt buộc. Mã của tài khoản Merchant Center dùng để cung cấp nguồn cấp dữ liệu sản phẩm.

Tài khoản Merchant Center này phải được liên kết với nhà quảng cáo.
relatedVideos[]

object (RelatedVideo)

Không bắt buộc. Video có liên quan cho mục hàng. Những video này sẽ xuất hiện bên dưới quảng cáo dạng video chính khi phát trong ứng dụng YouTube trên thiết bị di động.
leadFormId

string (int64 format)

Không bắt buộc. Mã nhận dạng của biểu mẫu để tạo khách hàng tiềm năng.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Không bắt buộc. Chế độ cài đặt liên quan đến VideoAdSequence.
videoAdInventoryControl

object (VideoAdInventoryControl)

Không bắt buộc. Chế độ cài đặt để kiểm soát khoảng không quảng cáo được phép cho mục hàng này.

ThirdPartyMeasurementConfigs

Chế độ cài đặt kiểm soát những nhà cung cấp bên thứ ba đang đo lường các chỉ số cụ thể của mục hàng.

Biểu diễn dưới dạng JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Trường
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Không bắt buộc. Nhà cung cấp bên thứ ba đo lường khả năng xem.

Bạn có thể sử dụng các nhà cung cấp bên thứ ba sau đây:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Không bắt buộc. Nhà cung cấp bên thứ ba đo lường mức độ an toàn cho thương hiệu.

Bạn có thể sử dụng các nhà cung cấp bên thứ ba sau đây:

  • THIRD_PARTY_VENDOR_ZEFR
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Không bắt buộc. Nhà cung cấp bên thứ ba đo lường phạm vi tiếp cận.

Các nhà cung cấp bên thứ ba sau đây có thể áp dụng:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Không bắt buộc. Nhà cung cấp bên thứ ba đo lường mức tăng thương hiệu.

Các nhà cung cấp bên thứ ba sau đây được áp dụng:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Chế độ cài đặt kiểm soát cách định cấu hình dịch vụ đo lường của bên thứ ba.

Biểu diễn dưới dạng JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Trường
vendor

enum (ThirdPartyVendor)

Nhà cung cấp dịch vụ đo lường của bên thứ ba.
placementId

string

Mã nhận dạng mà nền tảng của nhà cung cấp bên thứ ba sử dụng để xác định mục hàng.

ThirdPartyVendor

Nhà cung cấp thực hiện dịch vụ đo lường của bên thứ ba.

Enum
THIRD_PARTY_VENDOR_UNSPECIFIED Nhà cung cấp bên thứ ba không xác định.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Dữ liệu đo từ xa.
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR.
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.
THIRD_PARTY_VENDOR_TRANSUNION Transunion.
THIRD_PARTY_VENDOR_ORIGIN Nguồn gốc từ bạn.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project.
THIRD_PARTY_VENDOR_VIDEO_AMP Video Amp.
THIRD_PARTY_VENDOR_ISPOT_TV Ispot.tv.
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

Chế độ cài đặt kiểm soát khoảng không quảng cáo liên quan đến YouTube mà mục hàng YouTube và đối tác sẽ nhắm đến.

Biểu diễn dưới dạng JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Trường
includeYoutube

boolean

Không bắt buộc. Có nhắm đến khoảng không quảng cáo trên YouTube hay không. Điều này bao gồm cả nội dung tìm kiếm, kênh và video.
includeGoogleTv

boolean

Không bắt buộc. Có nhắm đến khoảng không quảng cáo trong các ứng dụng video có trên Google TV hay không.
includeYoutubeVideoPartners

boolean

Có nhắm đến khoảng không quảng cáo trên một tập hợp các trang web và ứng dụng đối tác tuân thủ cùng tiêu chuẩn an toàn thương hiệu như YouTube hay không.

YoutubeAndPartnersContentCategory

Danh mục an toàn thương hiệu cho nội dung trên YouTube và Đối tác.

Enum
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED Danh mục nội dung không được chỉ định hoặc không xác định trong phiên bản này.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Một danh mục bao gồm nhiều loại nội dung phù hợp với hầu hết các thương hiệu. Nội dung này dựa trên nguyên tắc về nội dung phù hợp với nhà quảng cáo của YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Danh mục bao gồm tất cả nội dung trên YouTube và đối tác video đáp ứng các tiêu chuẩn kiếm tiền.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Danh mục bao gồm một phạm vi nội dung hẹp hơn, đáp ứng những yêu cầu khắt khe hơn, đặc biệt là về ngôn từ không phù hợp và nội dung khêu gợi tình dục.

TargetFrequency

Chế độ cài đặt kiểm soát số lần trung bình mà quảng cáo sẽ hiển thị cho cùng một người trong một khoảng thời gian nhất định.

Biểu diễn dưới dạng JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Trường
targetCount

string (int64 format)

Số lần trung bình (mục tiêu) mà quảng cáo sẽ hiển thị cho cùng một người trong khoảng thời gian do timeUnit và timeUnitCount quy định.
timeUnit

enum (TimeUnit)

Đơn vị thời gian áp dụng tần suất mục tiêu.

Bạn có thể áp dụng đơn vị thời gian sau:

  • TIME_UNIT_WEEKS
  • TIME_UNIT_MONTHS
timeUnitCount

integer

Số timeUnit mà tần suất mục tiêu sẽ kéo dài.

Các quy định hạn chế sau đây sẽ áp dụng dựa trên giá trị của timeUnit:

  • TIME_UNIT_WEEKS – phải là 1
  • TIME_UNIT_MONTHS – phải là 1

RelatedVideo

Đại diện cho một mục video có liên quan.

Biểu diễn dưới dạng JSON 
{
  "videoId": string,
  "videoAssetId": string
}
Trường
videoId

string

Chỉ có đầu ra. Mã video trên YouTube của video có liên quan.
videoAssetId

string (int64 format)

Bắt buộc. adAssetId của tài nguyên AdAsset cho video trên YouTube.

VideoAdSequenceSettings

Chế độ cài đặt liên quan đến VideoAdSequence.

Biểu diễn dưới dạng JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Trường
minimumDuration

enum (VideoAdSequenceMinimumDuration)

Khoảng thời gian tối thiểu trước khi người dùng nhìn thấy lại trình tự này.
steps[]

object (VideoAdSequenceStep)

Các bước trong trình tự.

VideoAdSequenceMinimumDuration

Enum cho khoảng thời gian tối thiểu có thể có trước khi cùng một người dùng nhìn thấy lại VideoAdSequence.

Enum
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED Chưa xác định hoặc không xác định.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 ngày.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 ngày.

VideoAdSequenceStep

Thông tin chi tiết về một bước trong VideoAdSequence.

Biểu diễn dưới dạng JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Trường
stepId

string (int64 format)

Mã của bước.
adGroupId

string (int64 format)

Mã của nhóm quảng cáo tương ứng của bước.
previousStepId

string (int64 format)

Mã nhận dạng của bước trước. Bước đầu tiên không có bước trước đó.
interactionType

enum (InteractionType)

Tương tác ở bước trước sẽ dẫn người xem đến bước này. Bước đầu tiên không có interactionType.

InteractionType

Loại tương tác trong một bước.

Enum
INTERACTION_TYPE_UNSPECIFIED Không xác định hoặc không rõ
INTERACTION_TYPE_PAID_VIEW Lượt xem có trả phí.
INTERACTION_TYPE_SKIP Người xem đã bỏ qua.
INTERACTION_TYPE_IMPRESSION Lượt hiển thị quảng cáo (đã xem).
INTERACTION_TYPE_ENGAGED_IMPRESSION Một lượt hiển thị quảng cáo mà người xem không bỏ qua ngay lập tức, nhưng cũng không đạt đến sự kiện có thể tính phí.

VideoAdInventoryControl

Chế độ kiểm soát khoảng không quảng cáo dạng video được dùng trong một số loại mục hàng nhất định trên YouTube.

Biểu diễn dưới dạng JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
Trường
allowInStream

boolean

Không bắt buộc. Liệu quảng cáo có thể phân phát ở định dạng trong luồng phát hay không.
allowInFeed

boolean

Không bắt buộc. Liệu quảng cáo có thể phân phát ở định dạng trong nguồn cấp dữ liệu hay không.
allowShorts

boolean

Không bắt buộc. Liệu quảng cáo có thể phân phát ở định dạng Shorts hay không.
allowNonSkippableInStream

boolean

Không bắt buộc. Cho biết liệu quảng cáo có thể phân phát dưới dạng định dạng trong luồng phát không thể bỏ qua hay không.

DemandGenSettings

Chế độ cài đặt cho mục hàng Tạo nhu cầu.

Biểu diễn dưới dạng JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Trường
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Không bắt buộc. Chế độ cài đặt dịch vụ đo lường của bên thứ ba cho mục hàng Tạo nhu cầu.
linkedMerchantId

string (int64 format)

Không bắt buộc. Mã của tài khoản Merchant Center dùng để cung cấp nguồn cấp dữ liệu sản phẩm.

Tài khoản Merchant Center này phải được liên kết với nhà quảng cáo.
geoLanguageTargetingEnabled

boolean

Không bắt buộc. Không thể thay đổi. Liệu có thể đặt tiêu chí nhắm mục tiêu theo vị trí và nhắm mục tiêu theo ngôn ngữ ở cấp mục hàng hay không. Nếu không, bạn phải chỉ định trực tiếp các loại tiêu chí nhắm mục tiêu có liên quan cho nhóm quảng cáo.

Phương thức

bulkEditAssignedTargetingOptions

 Chỉnh sửa hàng loạt các lựa chọn nhắm mục tiêu trong nhiều mục hàng.

bulkListAssignedTargetingOptions

 Liệt kê các tiêu chí nhắm mục tiêu được chỉ định cho nhiều mục hàng trên các loại tiêu chí nhắm mục tiêu.

bulkUpdate

 Cập nhật nhiều mục hàng.

create

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

delete

 Xoá một mục hàng.

duplicate

 Sao chép một mục hàng.

get

 Lấy 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ột mục hàng hiện có.