- Tài nguyên: Mục hàng
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- LineItemWarningMessage
- MobileApp
- Nền tảng
- YoutubeAndPartnersSettings
- ThirdPartyMeasurementConfigs
- ThirdPartyVendorConfig
- ThirdPartyVendor
- YoutubeAndPartnersInventorySourceConfig
- YoutubeAndPartnersContentCategory
- TargetFrequency
- VideoAdSequenceSettings
- VideoAdSequenceMinimumDuration
- VideoAdSequenceStep
- InteractionType
- Phương thức
Tài nguyên: Mục hàng
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 ( |
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 được mã hoá 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 đối tác của mục hàng. |
conversionCounting |
Chế độ cài đặt theo dõi lượt chuyển đổi của mục hàng. |
creativeIds[] |
Mã của mẫu quảng cáo được 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 chi tiết về quy trình tích hợp của 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 các 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à có danh sách đối tượng đủ điều kiện nhắm mục tiêu tích cực. |
warningMessages[] |
Chỉ có đầu ra. Thông báo cảnh báo do mục hàng tạo. Các 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 quảng cáo bởi mục hàng. Điều này chỉ có thể á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 nền tảng 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 sai theo mặc định. |
youtubeAndPartnersSettings |
Chỉ có đầu ra. Chế độ cài đặt dành riêng cho các mục hàng YouTube và Đối tác. |
LineItemType
Các loại mục hàng có thể có.
Loại mục hàng xác định những chế độ cài đặt và tuỳ chọn nào có thể áp dụng, chẳng hạn như định dạng của 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 hình ảnh, quảng cáo HTML5, quảng cáo gốc hoặc quảng cáo đa phương tiện. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Hiển thị quảng cáo 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 trên cơ sở 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 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 của ứng dụng 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 xuất hiện trong đơn đặt hàng quảng cáo OTT (trực tiếp qua Internet). Loại này chỉ áp dụng cho các mục hàng có đơn đặt hàng quảng cáo insertionOrderType OVER_THE_TOP . |
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION |
Quảng cáo dạng video trên YouTube quảng bá lượt chuyển đổi. 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_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE |
Quảng cáo dạng video trên YouTube (dài tối đa 15 giây) không thể bỏ qua. 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_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE |
Quảng cáo dạng video trên YouTube hiển thị một câu chuyện theo một trình tự cụ thể bằng cách sử dụng kết hợp nhiều định dạ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_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 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_YOUTUBE_AND_PARTNERS_REACH |
Quảng cáo dạng video trên YouTube giúp tối ưu hoá việc tiếp cận nhiều người dùng riêng biệt hơn 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 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_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 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_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP |
Quảng cáo dạng video trên YouTube qua TV thông minh (dài tối đa 15 giây) không thể bỏ qua. 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_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP |
Quảng cáo dạng video trên TV thông minh trên YouTube, 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 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_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP |
Quảng cáo dạng video trên YouTube mặc định trên TV thông minh. Chỉ bao gồm định dạng quảng cáo trong luồ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_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY |
Mục tiêu của loại mục hàng này là hiển thị số lần mục tiêu quảng cáo trên YouTube nhắm đến 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 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_YOUTUBE_AND_PARTNERS_VIEW |
Quảng cáo dạng video trên YouTube nhằm giúp bạn nhận được nhiều lượt xem hơn bằng nhiều định dạng quảng cáo. 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_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 nhà. 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_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 nhà. 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. |
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 ( |
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 thời biểu của mục hàng. 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.
|
LineItemFlightDateType
Các loại có thể có về thời biểu quảng cáo 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 |
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 này sử dụng thời biểu quảng cáo tuỳ chỉnh riê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 ( |
Trường | |
---|---|
budgetAllocationType |
Bắt buộc. Loại phân bổ ngân sách. Bạn chỉ có thể sử dụng |
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 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 tự động phân bổ ngân sách đang bật cho mục hàng. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
Số tiề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 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 ( |
Trường | |
---|---|
markupType |
Bắt buộc. Loại đánh dấu trong mô hình doanh thu của đối tác. |
markupAmount |
Bắt buộc. Số tiền đánh dấu trong 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 đánh dấu 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 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 toán doanh thu của đối tác dựa trên phụ phí theo tỷ lệ phần trăm của tổng chi phí truyền thông, bao gồm tất cả chi phí và chi phí dữ liệu của đối tác. |
ConversionCountingConfig
Chế độ cài đặt kiểm soát cách tính lượt chuyển đổi.
Tất cả chuyển đổi sau 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 ( |
Trường | |
---|---|
postViewCountPercentageMillis |
Tỷ lệ phần trăm 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ả lượt chuyển đổi được tính theo 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 } |
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 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 một quảng cáo đã được xem. 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. 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 không cho 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 này 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 này 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 này 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 bao gồm ứng dụng dành cho thiết bị di động trong 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 này sẽ không chạy. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Mục hàng này không nhắm đến 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 là người dùng thiết bị di động. Mục hàng này 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 này 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 này 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 của mục hàng này đã được đặt trong quá khứ. Mục hàng này sẽ không chạy. |
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 di động.
Biểu diễn dưới dạng JSON |
---|
{
"appId": string,
"platform": enum ( |
Trường | |
---|---|
appId |
Bắt buộc. Mã nhận dạng 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ư Ứ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ư |
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
Nền tảng ứng dụng di động có thể có.
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 ( |
Trường | |
---|---|
viewFrequencyCap |
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 |
thirdPartyMeasurementConfigs |
Không bắt buộc. Các cấu hình đo lường của bên thứ ba của mục hàng. |
inventorySourceSettings |
Chế độ cài đặt kiểm soát những khoảng không quảng cáo của YouTube và Đối tác mà mục hàng sẽ nhắm đến. |
contentCategory |
Loại nội dung mà quảng cáo của YouTube và Đối tác sẽ hiển thị. |
effectiveContentCategory |
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ối mục hàng. |
targetFrequency |
Số lần trung bình bạn muốn quảng cáo từ 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 |
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. |
relatedVideoIds[] |
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. |
leadFormId |
Mã của biểu mẫu để tạo khách hàng tiềm năng. |
videoAdSequenceSettings |
Chế độ cài đặt liên quan đến VideoAdSequence. |
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 ( |
Trường | |
---|---|
viewabilityVendorConfigs[] |
Không bắt buộc. Nhà cung cấp bên thứ ba đo lường khả năng xem. Có thể áp dụng các nhà cung cấp bên thứ ba sau đây:
|
brandSafetyVendorConfigs[] |
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. Có thể áp dụng các nhà cung cấp bên thứ ba sau đây:
|
reachVendorConfigs[] |
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ó thể áp dụng các nhà cung cấp bên thứ ba sau đây:
|
brandLiftVendorConfigs[] |
Không bắt buộc. Nhà cung cấp bên thứ ba đo lường hiệu quả nâng cao thương hiệu. Có thể áp dụng các nhà cung cấp bên thứ ba sau đây:
|
ThirdPartyVendorConfig
Chế độ cài đặt kiểm soát cách định cấu hình nhà cung cấp dịch vụ đo lường bên thứ ba.
Biểu diễn dưới dạng JSON |
---|
{
"vendor": enum ( |
Trường | |
---|---|
vendor |
Nhà cung cấp dịch vụ đo lường bên thứ ba. |
placementId |
Mã đượ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. |
ThirdPartyVendor
Những 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 |
Hào. |
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. |
YoutubeAndPartnersInventorySourceConfig
Chế độ cài đặt kiểm soát những khoảng không quảng cáo có liên quan trê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 |
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. Dữ liệu này bao gồm cả lượt tìm kiếm, kênh và video. |
includeGoogleTv |
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. |
includeYoutubeVideoPartners |
Liệu bạn có nhắm đến khoảng không quảng cáo trên một nhóm các trang web và ứng dụng của đối tác tuân thủ các tiêu chuẩn an toàn thương hiệu giống 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 chưa đượ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 nội dung phù hợp với hầu hết các thương hiệu. Nội dung đó tuân thủ 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 |
Một 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 phạm vi nội dung được giảm bớt nhằm đáp ứng các yêu cầu nâng cao, đặ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 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 ( |
Trường | |
---|---|
targetCount |
Số lần mục tiêu, trung bình, quảng cáo sẽ được hiển thị cho cùng một người trong khoảng thời gian do |
timeUnit |
Đơn vị thời gian mà tần suất mục tiêu sẽ được áp dụng. Có thể áp dụng đơn vị thời gian sau đây:
|
timeUnitCount |
Số Các hạn chế sau đây áp dụng dựa trên giá trị của
|
VideoAdSequenceSettings
Chế độ cài đặt liên quan đến VideoAdSequence.
Biểu diễn dưới dạng JSON |
---|
{ "minimumDuration": enum ( |
Trường | |
---|---|
minimumDuration |
Khoảng thời gian tối thiểu trước khi cùng một người dùng thấy lại trình tự này. |
steps[] |
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 qua. |
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 ( |
Trường | |
---|---|
stepId |
Mã của bước. |
adGroupId |
Mã của nhóm quảng cáo tương ứng ở bước này. |
previousStepId |
Mã của bước trước đó. Bước đầu tiên không có bước trước. |
interactionType |
Hành độ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. |
InteractionType
Các loại tương tác trên một bước.
Enum | |
---|---|
INTERACTION_TYPE_UNSPECIFIED |
Chưa xác định hoặc không xác định |
INTERACTION_TYPE_PAID_VIEW |
Lượt xem có trả phí. |
INTERACTION_TYPE_SKIP |
Bị người xem bỏ qua. |
INTERACTION_TYPE_IMPRESSION |
Lượt hiển thị quảng cáo (đã xem). |
INTERACTION_TYPE_ENGAGED_IMPRESSION |
Lượt hiển thị quảng cáo không bị người xem bỏ qua ngay lập tức nhưng cũng không đạt đến sự kiện có thể lập hoá đơn. |
Phương thức |
|
---|---|
|
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. |
|
Liệt kê các lựa chọn 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. |
|
Cập nhật nhiều mục hàng. |
|
Tạo mục hàng mới. |
|
Xoá một mục hàng. |
|
Sao chép một 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 được 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ó. |