REST Resource: advertisers.lineItems

{
  "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)
  }
}

string

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

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.

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.

string (int64 format)

Bắt buộc. Bất biến. Mã nhận dạng duy nhất của đơn đặt hàng quảng cáo chứa mục hàng.

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.

string

Bắt buộc. Tên hiển thị của mục hàng.

Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.

enum (LineItemType)

Bắt buộc. Bất biến. Loại mục hàng.

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ỉ 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, thì mục hàng đó không thể chi tiêu ngân sách ngay cả khi trạng thái riêng là ENTITY_STATUS_ACTIVE.

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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

object (PartnerCost)

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

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.

object (LineItemFlight)

Bắt buộc. Thời gian bắt đầu và kết thúc trong tiến trình của mục hàng.

object (LineItemBudget)

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

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.

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 cài đặt này nếu gán giới hạn giới hạn.

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

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

string (int64 format)

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

object (BiddingStrategy)

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

object (IntegrationDetails)

Thông tin chi tiết về quá trình tích hợp của mục hàng.

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 những 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 cho danh sách đối tượng đủ điều kiện.

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 việc chạy mục hàng.

object (MobileApp)

Ứng dụng dành cho thiết bị di động được quảng cáo bởi mục hàng.

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

enum (ReservationType)

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

boolean

Liệu có loại trừ các sàn giao dịch mới khỏi bị mục hàng tự động nhắm mục tiêu hay không. Theo mặc định, trường này là false.

object (YoutubeAndPartnersSettings)

Chỉ có đầu ra. Chế độ cài đặt dành riêng cho các mục hàng YouTube và Partners.

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}

enum (LineItemFlightDateType)

Bắt buộc. Loại thời gian hiển thị của mục hàng.

object (DateRange)

Ngày bắt đầu và ngày kết thúc của giai đoạn hiển thị của mục hàng. Các khoảng thời gian 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. Chỉ có thể xuất nếu không.
• Khi tạo chuyến bay mới, cả startDate và endDate đều phải ở trong tương lai.
• Một chuyến bay hiện tại 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.

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

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 tính năng phân bổ ngân sách tự động được bật cho đơn đặt hàng quảng cáo gốc.

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.

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 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 để chi tiêu, tính bằng đơ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 để 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.

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum (PartnerRevenueModelMarkupType)

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

string (int64 format)

Bắt buộc. Số tiền tăng giá trong 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 thể hiện mức đánh dấu CPM tính theo đơ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 thể hiện mức tăng phần trăm chi phí truyền thông tính bằng mili giây. Ví dụ: 100 biểu thị 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 thể hiện tỷ lệ phần trăm tăng chi phí truyền thông tính bằng mili giây. Ví dụ: 100 biểu thị 0,1% (thập phân 0,001).

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

Tỷ lệ phần trăm số lượt chuyển đổi sau khi xem cần được tính, tính bằng mili giây (1/1000 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 chuột, hãy đặt giá trị là 50.000.

object (TrackingFloodlightActivityConfig)

Các cấu hình của 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 của tất cả lượt chuyển đổi được tính trong tất cả mã hoạt động Floodlight được chỉ định trong trường này.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

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

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.

integer

Bắt buộc. Số ngày 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.

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

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.

Các ứ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.

Các ứ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.

enum (Platform)

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

string

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

string

Chỉ có đầu ra. Nhà xuất bản ứng dụng.

{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}

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 gán giới hạn giới hạn.

object (ThirdPartyMeasurementConfigs)

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

object (YoutubeAndPartnersInventorySourceConfig)

Các chế độ cài đặt kiểm soát những khoảng không quảng cáo mà YouTube và Đối tác sẽ nhắm mục tiêu.

enum (YoutubeAndPartnersContentCategory)

Loại nội dung sẽ hiển thị quảng cáo YouTube và Đối tác.

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 thiết lập 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.

object (TargetFrequency)

Số lần trung bình 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.

string (int64 format)

Mã của người bán được liên kết với mục hàng cho nguồn cấp dữ liệu sản phẩm.

string

Mã của các video xuất hiện bên dưới quảng cáo chính dạng video khi quảng cáo đang phát trong ứng dụng YouTube trên thiết bị di động.

string (int64 format)

Mã của biểu mẫu để tạo khách hàng tiềm năng.

object (VideoAdSequenceSettings)

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

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

object (ThirdPartyVendorConfig)

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

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

• 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

object (ThirdPartyVendorConfig)

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

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

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

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.

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

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.

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

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum (ThirdPartyVendor)

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

string

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

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

Không bắt buộc. Liệu có nhắm mục tiêu khoảng không quảng cáo trên YouTube hay không. Mục này bao gồm cả tìm kiếm, kênh và video.

boolean

Không bắt buộc. Liệu 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.

boolean

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

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string (int64 format)

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

enum (TimeUnit)

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

Bạn có thể sử dụng đơn vị thời gian sau đây:

• TIME_UNIT_WEEKS

integer

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

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

• TIME_UNIT_WEEKS – phải là 1

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum (VideoAdSequenceMinimumDuration)

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

object (VideoAdSequenceStep)

Các bước tạo thành trình tự.

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string (int64 format)

Mã của bước.

string (int64 format)

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

string (int64 format)

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

enum (InteractionType)

Hoạt động tương tác ở bước trước đó sẽ đưa người xem đến bước này. Bước đầu tiên không có engagementType.