- Tài nguyên: CuratedPackage
- Trạng thái
- AccessControlSettings
- PackageTargeting
- DeviceType
- Môi trường
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- Loại
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- Phương thức
Tài nguyên: CuratedPackage
Đại diện cho một gói khoảng không quảng cáo được tuyển chọn do Nhà tuyển chọn tạo và quản lý.
| Biểu diễn dưới dạng JSON |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| Trường | |
|---|---|
name |
Giá trị nhận dạng. Tên tài nguyên duy nhất cho gói được tuyển chọn. Định dạng |
displayName |
Bắt buộc. Tên hiển thị do người tuyển chọn chỉ định cho gói tuyển chọn. Có thể dùng để lọc phản hồi của phương thức |
description |
Không bắt buộc. Nội dung mô tả về gói được tuyển chọn, do người tuyển chọn cung cấp. |
createTime |
Chỉ có đầu ra. Dấu thời gian khi gói được tuyển chọn được tạo. Có thể dùng để lọc phản hồi của phương thức 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ụ: |
updateTime |
Chỉ có đầu ra. Dấu thời gian cho biết thời điểm gần đây nhất gói được tuyển chọn được cập nhật. Có thể dùng để lọc phản hồi của phương thức 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ụ: |
floorPriceCpm |
Không bắt buộc. Mức CPM tối thiểu mà người mua phải đặt giá thầu để tham gia phiên đấu giá cho khoảng không quảng cáo trong gói tuyển chọn này. Có thể dùng để lọc phản hồi của phương thức |
state |
Chỉ có đầu ra. Trạng thái của gói được tuyển chọn. Có thể dùng để lọc phản hồi của phương thức |
accessSettings |
Bắt buộc. Chế độ cài đặt để kiểm soát quyền truy cập vào gói được tuyển chọn. Chỉ những chuyên viên kế hoạch truyền thông có trong danh sách cho phép và nhà sáng tạo mới có thể sử dụng gói chọn lọc này. Người mua và bên đặt giá thầu không thể được đưa vào danh sách cho phép hoặc có quyền truy cập trực tiếp vào tài nguyên này. |
targeting |
Không bắt buộc. Tiêu chí nhắm mục tiêu cho gói được tuyển chọn. |
curationFeeVisibility |
Không bắt buộc. Không thể thay đổi. Chế độ hiển thị của phí gói tuyển chọn và phí phân khúc dữ liệu kết hợp (tổng phí tuyển chọn). |
| Phí được trả cho người tuyển chọn gói này. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi: | |
feeCpm |
Không bắt buộc. Phí CPM mà người tuyển chọn tính cho người mua sử dụng gói tuyển chọn này. Có thể dùng để lọc phản hồi của phương thức |
millipercentOfMediaFee |
Không bắt buộc. Phí sẽ được tính theo tỷ lệ phần trăm của chi phí cho mỗi lượt hiển thị, được biểu thị bằng phần nghìn phần trăm. Ví dụ: 1% được biểu thị là 1000. |
| Kết thúc các trường loại trừ lẫn nhau. | |
Tiểu bang
Trạng thái của gói được tuyển chọn.
| Enum | |
|---|---|
STATE_UNSPECIFIED |
Giá trị mặc định. |
ACTIVE |
Gói được tuyển chọn đang hoạt động. |
INACTIVE |
Gói được tuyển chọn không hoạt động. |
AccessControlSettings
Chế độ cài đặt để kiểm soát quyền truy cập vào một gói được tuyển chọn.
| Biểu diễn dưới dạng JSON |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| Trường | |
|---|---|
allowlistedMediaPlanners[] |
Bắt buộc. Không thể thay đổi. Danh sách các chuyên viên kế hoạch truyền thông được cấp quyền truy cập rõ ràng vào gói tuyển chọn. Bạn có thể tìm thấy các chuyên viên kế hoạch truyền thông đủ điều kiện trong phương thức Định dạng |
PackageTargeting
Tiêu chí nhắm mục tiêu cho gói được tuyển chọn và gói đấu giá.
| Biểu diễn dưới dạng JSON |
|---|
{ "includedDeviceTypes": [ enum ( |
| Trường | |
|---|---|
includedDeviceTypes[] |
Không bắt buộc. Danh sách các loại thiết bị được đưa vào để nhắm mục tiêu. Nếu bạn để trống, tất cả các loại thiết bị đều được nhắm mục tiêu. |
includedEnvironment |
Không bắt buộc. Môi trường cần nhắm đến. Nếu bạn không chỉ định, thì tất cả môi trường đều được nhắm mục tiêu. |
includedCreativeFormat |
Không bắt buộc. Định dạng mẫu quảng cáo cần nhắm mục tiêu. Nếu bạn không đặt, thì tất cả các loại mã đánh dấu mẫu quảng cáo đều được nhắm mục tiêu. |
includedAcceleratedMobilePageType |
Không bắt buộc. Loại trang AMP được nhắm mục tiêu. Nếu bạn không đặt, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể trạng thái AMP. |
includedAuthorizedSellerStatuses[] |
Không bắt buộc. Danh sách trạng thái người bán được uỷ quyền được nhắm mục tiêu. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể trạng thái của người bán. |
includedNativeInventoryTypes[] |
Không bắt buộc. Các loại khoảng không quảng cáo gốc được nhắm mục tiêu. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể loại khoảng không quảng cáo gốc. |
includedOpenMeasurementTypes[] |
Không bắt buộc. Danh sách các loại đo lường mở được nhắm mục tiêu. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể có hỗ trợ Đo lường mở hay không. |
includedRestrictedCategories[] |
Không bắt buộc. Danh sách các danh mục bị hạn chế được nhắm đến. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể danh mục bị hạn chế. |
includedRewardedType |
Không bắt buộc. Loại quảng cáo có tặng thưởng được nhắm mục tiêu. Nếu bạn không đặt, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể loại quảng cáo có tặng thưởng. |
videoTargeting |
Không bắt buộc. Tiêu chí nhắm mục tiêu cụ thể cho video. |
minimumPredictedViewabilityPercentage |
Không bắt buộc. Tỷ lệ phần trăm khả năng xem dự đoán tối thiểu được nhắm mục tiêu. Giá trị này phải là bội số của 10, từ 10 đến 90 (bao gồm cả 10 và 90). Ví dụ: 10 là hợp lệ, nhưng 0, 15 và 100 thì không. Giá trị 10 có nghĩa là cấu hình sẽ chỉ khớp với những vùng quảng cáo mà chúng tôi dự đoán có khả năng xem ít nhất là 10%. Giá trị chưa đặt cho biết khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể khả năng xem dự đoán. |
languageTargeting |
Không bắt buộc. Ngôn ngữ cần nhắm đến. Nếu bạn không đặt, thì khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể ngôn ngữ. Hãy xem https://developers.google.com/google-ads/api/data/codes-formats#languages để biết danh sách mã ngôn ngữ được hỗ trợ. |
includedAdSizes[] |
Không bắt buộc. Danh sách kích thước quảng cáo cần nhắm mục tiêu. Nếu bạn không đặt chính sách này, thì khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể kích thước quảng cáo. Gói được tuyển chọn hỗ trợ kích thước quảng cáo |
publisherTargeting |
Không bắt buộc. Nhà xuất bản được nhắm mục tiêu. Nếu bạn không đặt, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể nhà xuất bản. Nhà xuất bản được xác định bằng mã nhà xuất bản trong tệp ads.txt/app-ads.txt. Hãy xem https://iabtechlab.com/ads-txt/ và https://iabtechlab.com/app-ads-txt/ để biết thêm thông tin. |
minimumPredictedClickThroughRatePercentageMillis |
Không bắt buộc. Tỷ lệ nhấp chuột dự đoán tối thiểu được nhắm mục tiêu, nằm trong khoảng giá trị [10, 10000] (0,01% – 10%). Giá trị 50 có nghĩa là cấu hình sẽ chỉ khớp với những vùng quảng cáo mà chúng tôi dự đoán có tỷ lệ nhấp ít nhất là 0,05%. Giá trị chưa đặt cho biết khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể tỷ lệ nhấp dự đoán. |
verticalTargeting |
Không bắt buộc. Các ngành dọc được bao gồm hoặc loại trừ như được xác định trong https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Nếu bạn không đặt chính sách này, thì khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể ngành dọc. |
geoTargeting |
Không bắt buộc. Mã tiêu chí địa lý cần đưa vào hoặc loại trừ như được xác định trong https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Nếu bạn không đặt, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể vị trí địa lý. |
includedDataSegments[] |
Không bắt buộc. Phân khúc dữ liệu đang hoạt động cần nhắm đến. Nếu bạn không đặt chính sách này, thì khoảng không quảng cáo sẽ được nhắm đến bất kể phân khúc dữ liệu. Định dạng |
placementTargeting |
Không bắt buộc. Thông tin nhắm mục tiêu theo vị trí, ví dụ: URL, ứng dụng di động. |
publisherProvidedSignalsTargeting |
Không bắt buộc. Tín hiệu do nhà xuất bản cung cấp để nhắm mục tiêu. Nếu bạn không đặt, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể tín hiệu do nhà xuất bản cung cấp. |
DeviceType
Loại thiết bị chung cần nhắm đến.
| Enum | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
DEVICE_TYPE_PERSONAL_COMPUTER |
Nhắm đến máy tính để bàn hoặc máy tính xách tay. |
DEVICE_TYPE_CONNECTED_TV |
Nhắm đến TV kết nối Internet: những thiết bị phát trực tuyến nội dung truyền hình, bao gồm cả TV thông minh, máy chơi trò chơi và đầu thu phát trực tuyến/thiết bị phát trực tuyến. |
DEVICE_TYPE_PHONE |
Nhắm đến các thiết bị di động cao cấp. |
DEVICE_TYPE_TABLET |
Nhắm đến thiết bị máy tính bảng. |
Môi trường
Môi trường cần nhắm đến.
| Enum | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
ENVIRONMENT_SITE |
Nhắm đến khoảng không quảng cáo được hiển thị trong một trang web có chạy quảng cáo. |
ENVIRONMENT_APP |
Nhắm mục tiêu khoảng không quảng cáo trong một ứng dụng di động. |
CreativeFormat
Định dạng mẫu quảng cáo có thể được nhắm mục tiêu.
| Enum | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
CREATIVE_FORMAT_DISPLAY |
Nhắm đến các vị trí quảng cáo dành cho mẫu quảng cáo hiển thị HTML. |
CREATIVE_FORMAT_VIDEO |
Nhắm đến các vị trí quảng cáo dành cho mẫu quảng cáo dạng video. |
CREATIVE_FORMAT_AUDIO |
Nhắm đến các vị trí quảng cáo dành cho mẫu quảng cáo dạng âm thanh. |
AcceleratedMobilePageType
Loại triển khai Accelerated Mobile Pages (AMP) để nhắm mục tiêu.
| Enum | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
Nhắm đến khoảng không quảng cáo trên các trang web chuẩn không sử dụng khung AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
Nhắm đến khoảng không quảng cáo trên các trang được tạo bằng khung HTML AMP chính. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
Nhắm đến khoảng không quảng cáo trên các trang sử dụng định dạng Câu chuyện AMP (STAMP), được tối ưu hoá cho việc kể chuyện bằng hình ảnh (ví dụ: trải nghiệm toàn màn hình có thể nhấn vào). |
AuthorizedSellerStatus
Đại diện cho mối quan hệ giữa nhà xuất bản và người bán như được khai báo trong tệp ads.txt hoặc app-ads.txt.
| Enum | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
AUTHORIZED_SELLER_STATUS_DIRECT |
Nhắm đến khoảng không quảng cáo mà người bán được khai báo là "TRỰC TIẾP". Giá trị này cho biết nhà xuất bản (chủ sở hữu nội dung) trực tiếp kiểm soát tài khoản người bán và có hợp đồng kinh doanh trực tiếp với hệ thống quảng cáo cho tài khoản này. |
AUTHORIZED_SELLER_STATUS_RESELLER |
Nhắm đến khoảng không quảng cáo mà người bán được khai báo là "RESELLER" (ĐẠI LÝ). Giá trị này cho biết nhà xuất bản đã uỷ quyền cho một pháp nhân khác vận hành tài khoản người bán được liệt kê và bán lại không gian quảng cáo của họ. |
NativeInventoryType
Đại diện cho loại hiển thị mẫu quảng cáo mà một vị trí quảng cáo hỗ trợ, cụ thể là liên quan đến quảng cáo gốc.
| Enum | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
Nhắm đến những vị trí quảng cáo chỉ chấp nhận và hiển thị quảng cáo gốc. |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
Nhắm đến những vị trí quảng cáo chấp nhận và hiển thị quảng cáo gốc hoặc quảng cáo biểu ngữ. |
OpenMeasurementType
Loại Định nghĩa giao diện đo lường mở (OMID) cần nhắm đến.
| Enum | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
Nhắm đến khoảng không quảng cáo hỗ trợ Định nghĩa giao diện đo lường mở (OMID) phiên bản 1. |
RestrictedCategory
Đại diện cho các danh mục quảng cáo cụ thể bị hạn chế nhắm mục tiêu theo chính sách.
| Enum | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
RESTRICTED_CATEGORY_ALCOHOL |
Nhắm đến khoảng không quảng cáo mà nhà xuất bản cho phép quảng cáo đồ uống có cồn. |
RESTRICTED_CATEGORY_GAMBLING |
Nhắm đến khoảng không quảng cáo mà nhà xuất bản cho phép quảng cáo cờ bạc. |
RewardedType
Xác định tiêu chí nhắm mục tiêu dựa trên việc khoảng không quảng cáo có tặng thưởng cho người dùng khi xem quảng cáo hay không.
| Enum | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
REWARDED_TYPE_NON_REWARDED |
Nhắm đến khoảng không quảng cáo KHÔNG cung cấp phần thưởng rõ ràng cho người dùng khi họ xem hoặc tương tác với quảng cáo. |
REWARDED_TYPE_REWARDED |
Nhắm đến khoảng không quảng cáo cung cấp phần thưởng cho người dùng để đổi lấy việc xem hoặc tương tác với quảng cáo. |
PackageVideoTargeting
Tiêu chí nhắm mục tiêu cụ thể cho video.
| Biểu diễn dưới dạng JSON |
|---|
{ "includedMimeTypes": [ enum ( |
| Trường | |
|---|---|
includedMimeTypes[] |
Không bắt buộc. Danh sách các loại mime video được nhắm mục tiêu bằng cách sử dụng chuỗi loại MIME do IANA xuất bản (https://www.iana.org/assignments/media-types/media-types.xhtml). Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể loại mime video. |
includedMaximumAdDurationTargeting |
Không bắt buộc. Thời lượng quảng cáo dạng video tối đa được nhắm mục tiêu. Nếu bạn không đặt, thì khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể thời lượng tối đa của quảng cáo dạng video. |
includedPositionTypes[] |
Không bắt buộc. Các loại vị trí quảng cáo dạng video được nhắm mục tiêu. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể loại vị trí quảng cáo dạng video. |
includedContentDeliveryMethod |
Không bắt buộc. Phương thức phân phối video được nhắm mục tiêu. Nếu bạn không đặt, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể phương thức phân phối video. |
plcmtTargeting |
Không bắt buộc. Các loại vị trí video được nhắm mục tiêu. Nếu bạn không đặt chính sách này, thì khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể loại plcmt của video. |
includedPlaybackMethods[] |
Không bắt buộc. Danh sách các phương thức phát lại video được nhắm mục tiêu. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể phương thức phát video. |
minimumPredictedCompletionRatePercentage |
Không bắt buộc. Tỷ lệ phần trăm tỷ lệ hoàn thành dự đoán tối thiểu được nhắm mục tiêu. Giá trị này phải là bội số của 10, từ 10 đến 90 (bao gồm cả 10 và 90). Ví dụ: 10 là hợp lệ, nhưng 0, 15 và 100 thì không. Giá trị 10 có nghĩa là cấu hình sẽ chỉ khớp với những vùng quảng cáo mà chúng tôi dự đoán có tỷ lệ hoàn thành ít nhất là 10%. Giá trị chưa đặt cho biết khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể tỷ lệ hoàn thành dự đoán. |
includedPlayerSizeTargeting |
Không bắt buộc. Kích thước trình phát video được nhắm mục tiêu. Nếu bạn không đặt chính sách này, thì khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể kích thước trình phát video. |
VideoMimeType
Loại mime video cần nhắm đến.
| Enum | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
VIDEO_MIME_TYPE_THREEGPP |
Định dạng vùng chứa 3GPP dùng trên điện thoại 3G. |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
Vùng chứa MPEG-4 thường có bộ mã hoá và giải mã H.264. |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH. |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (dùng cho quảng cáo VPAID). |
VIDEO_MIME_TYPE_WEBM |
Vùng chứa WebM giả định bộ mã hoá và giải mã VP9. |
MaximumVideoAdDuration
Giới hạn trên về thời lượng của mẫu quảng cáo dạng video để nhắm mục tiêu. Các giá trị enum xác định các nhóm và việc chọn một giá trị có nghĩa là thời lượng của mẫu quảng cáo phải nhỏ hơn hoặc bằng thời gian đã chỉ định.
| Enum | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
Áp dụng cho quảng cáo dạng video có thời lượng tối đa 15 giây (0 < thời lượng <= 15 giây). |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
Áp dụng cho quảng cáo dạng video có thời lượng tối đa 20 giây (0 < thời lượng <= 20 giây). |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
Áp dụng cho quảng cáo dạng video có thời lượng tối đa 30 giây (0 < thời lượng <= 30 giây). |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
Áp dụng cho quảng cáo dạng video có thời lượng tối đa 60 giây (0 < thời lượng <= 60 giây). |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
Áp dụng cho quảng cáo dạng video có thời lượng tối đa 90 giây (0 < thời lượng <= 90 giây). |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
Áp dụng cho quảng cáo dạng video có thời lượng tối đa 120 giây (0 < thời lượng <= 120 giây). |
PositionType
Vị trí có thể nhắm mục tiêu của quảng cáo trong video.
| Enum | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
POSITION_TYPE_MIDROLL |
Quảng cáo được phát ở giữa nội dung video. |
POSITION_TYPE_POSTROLL |
Quảng cáo được phát sau nội dung video. |
POSITION_TYPE_PREROLL |
Quảng cáo được phát trước nội dung video. |
ContentDeliveryMethod
Tiêu chí nhắm mục tiêu dựa trên phương thức phân phối nội dung video.
| Enum | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
CONTENT_DELIVERY_METHOD_STREAMING |
Nhắm đến nội dung video đang được phát trực tiếp. |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
Nhắm đến nội dung video được chuyển dần theo yêu cầu phát của ứng dụng khách. |
VideoPlcmtTargeting
Xác định tiêu chí nhắm mục tiêu dựa trên loại vị trí đặt video, thường tương ứng với trường "plcmt" của IAB OpenRTB.
| Biểu diễn dưới dạng JSON |
|---|
{ "selectionType": enum ( |
| Trường | |
|---|---|
selectionType |
Bắt buộc. Loại lựa chọn cho danh sách vị trí video. |
videoPlcmtTypes[] |
Bắt buộc. Danh sách các loại vị trí đặt video được nhắm mục tiêu. Nếu để trống, khoảng không quảng cáo sẽ được nhắm mục tiêu bất kể loại vị trí video. |
SelectionType
Enum cho các loại lựa chọn có thể được sử dụng theo phương diện nhắm mục tiêu.
| Enum | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
Loại lựa chọn không xác định. Không nên sử dụng. |
SELECTION_TYPE_INCLUDE |
Các giá trị trong phương diện nhắm mục tiêu được đưa vào. |
SELECTION_TYPE_EXCLUDE |
Các giá trị trong phương diện nhắm mục tiêu sẽ bị loại trừ. |
VideoPlcmtType
Đại diện cho loại vị trí đặt video, phù hợp với các tiêu chuẩn OpenRTB.
| Enum | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
Giá trị mặc định. Không được dùng trong thông số kỹ thuật nhắm mục tiêu. |
INSTREAM |
Quảng cáo trước video, trong video và sau video được phát trước, trong hoặc sau nội dung video phát trực tuyến mà người tiêu dùng đã yêu cầu. Theo mặc định, video trong luồng phát phải được đặt ở chế độ "bật âm thanh" khi trình phát bắt đầu hoặc phải thể hiện rõ ý định của người dùng là muốn xem nội dung video. Mặc dù có thể có nội dung khác xung quanh trình phát, nhưng nội dung video phải là trọng tâm trong lượt truy cập của người dùng. Video này phải luôn là nội dung chính trên trang và là trình phát video duy nhất trong khung nhìn có thể phát âm thanh khi phát. Nếu trình phát chuyển đổi sang dạng nổi/gắn cố định, thì các lệnh gọi quảng cáo tiếp theo phải truyền tải chính xác kích thước trình phát đã cập nhật. |
ACCOMPANYING_CONTENT |
Quảng cáo trước video, trong video và sau video được phát trước, trong hoặc sau nội dung video phát trực tuyến. Trình phát video tải và phát trước, giữa hoặc sau các đoạn văn bản hoặc nội dung đồ hoạ, và chỉ bắt đầu phát khi xuất hiện trong khung nhìn. Nội dung đi kèm chỉ được bắt đầu phát khi xuất hiện trong khung nhìn. Trình phát này có thể chuyển đổi thành trình phát nổi/cố định khi người dùng cuộn ra khỏi trang. |
INTERSTITIAL |
Quảng cáo dạng video được phát mà không có nội dung video. Trong khi phát, quảng cáo phải là trọng tâm chính của trang và chiếm phần lớn khung nhìn, đồng thời không thể bị cuộn ra khỏi khung nhìn. Quảng cáo này có thể xuất hiện ở các vị trí như video trong ứng dụng hoặc bản trình chiếu. |
NO_CONTENT |
Quảng cáo dạng video được phát mà không có nội dung video phát trực tuyến. Quảng cáo này có thể xuất hiện ở các vị trí như bản trình chiếu, nguồn cấp dữ liệu gốc, trong nội dung hoặc quảng cáo cố định/quảng cáo nổi. |
PlaybackMethod
Phương thức phát để nhắm mục tiêu.
| Enum | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
Phương thức phát video chưa được chỉ định. Không nên sử dụng. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
Quá trình phát bắt đầu tự động khi trang/nội dung tải. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
Quá trình phát bắt đầu tự động khi trang/nội dung tải, nhưng không có âm thanh. |
PLAYBACK_METHOD_CLICK_TO_PLAY |
Quá trình phát được bắt đầu bằng một hành động của người dùng (ví dụ: nhấp vào nút phát). |
VideoPlayerSizeTargeting
Đại diện cho kích thước của trình phát video có thể được nhắm mục tiêu. Cả chiều rộng và chiều cao đều phải được đặt thành giá trị khác 0.
| Biểu diễn dưới dạng JSON |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| Trường | |
|---|---|
minimumWidth |
Bắt buộc. Chiều rộng tối thiểu của trình phát video, tính bằng pixel. |
minimumHeight |
Bắt buộc. Chiều cao tối thiểu của trình phát video, tính bằng pixel. |
StringTargetingDimension
Nhắm mục tiêu chung bằng giá trị chuỗi.
| Biểu diễn dưới dạng JSON |
|---|
{
"selectionType": enum ( |
| Trường | |
|---|---|
selectionType |
Bắt buộc. Cách nhắm mục tiêu các mục trong danh sách này. |
values[] |
Bắt buộc. Các giá trị được chỉ định. |
AdSize
Đại diện cho kích thước của một vị trí quảng cáo hoặc mẫu quảng cáo.
| Biểu diễn dưới dạng JSON |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| Trường | |
|---|---|
width |
Chiều rộng của vị trí quảng cáo tính bằng pixel. Trường này sẽ chỉ xuất hiện khi loại kích thước là |
height |
Chiều cao của vị trí quảng cáo tính bằng pixel. Trường này sẽ chỉ xuất hiện khi loại kích thước là |
type |
Loại kích thước vị trí quảng cáo. |
Loại
Đại diện cho các loại kích thước vị trí quảng cáo/mẫu quảng cáo khác nhau.
| Enum | |
|---|---|
TYPE_UNSPECIFIED |
Phần giữ chỗ cho loại kích thước không xác định. |
PIXEL |
Vị trí quảng cáo có kích thước được chỉ định theo chiều cao và chiều rộng tính bằng pixel. |
INTERSTITIAL |
Kích thước đặc biệt để mô tả vị trí quảng cáo xen kẽ. |
NATIVE |
Quảng cáo gốc (trên thiết bị di động) do nhà xuất bản hiển thị. |
FLUID |
Kích thước linh hoạt (kích thước thích ứng) có thể tự động đổi kích thước khi môi trường bên ngoài thay đổi. |
CriteriaTargeting
Tiêu chí nhắm mục tiêu chung được dùng để nhắm mục tiêu theo các phương diện chứa danh sách mã nhận dạng dạng số được thêm vào và loại trừ. Bạn không thể lọc thông tin này bằng cú pháp bộ lọc danh sách.
| Biểu diễn dưới dạng JSON |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| Trường | |
|---|---|
targetedCriteriaIds[] |
Danh sách mã nhận dạng dạng số cần đưa vào. |
excludedCriteriaIds[] |
Danh sách mã nhận dạng dạng số cần loại trừ. |
PackagePlacementTargeting
Đại diện cho tiêu chí nhắm mục tiêu về nơi quảng cáo có thể xuất hiện, ví dụ: một số trang web hoặc ứng dụng di động nhất định. Các loại tiêu chí nhắm mục tiêu theo vị trí khác nhau sẽ được kết hợp theo logic HOẶC.
| Biểu diễn dưới dạng JSON |
|---|
{ "uriTargeting": { object ( |
| Trường | |
|---|---|
uriTargeting |
Không bắt buộc. Danh sách URL được nhắm mục tiêu hoặc bị loại trừ. Các miền phải được loại bỏ http/https (ví dụ: google.com) và có thể chứa tối đa 5 đường dẫn cho mỗi URL. |
mobileAppTargeting |
Không bắt buộc. Danh sách mã ứng dụng di động được nhắm mục tiêu hoặc bị loại trừ mà nhà xuất bản sở hữu. Hiện tại, chúng tôi chỉ hỗ trợ ứng dụng Android và Apple. Bạn có thể tìm thấy Mã ứng dụng Android (ví dụ: com.google.android.apps.maps) trong URL của Cửa hàng Google Play. Bạn có thể tìm thấy Mã ứng dụng iOS (là một số) ở cuối URL của cửa hàng iTunes. Ứng dụng di động của bên thứ nhất được thêm hoặc loại trừ. |
includedMobileAppCategoryTargeting[] |
Không bắt buộc. Danh sách danh mục ứng dụng di động được nhắm mục tiêu. |
PackagePublisherProvidedSignalsTargeting
Đại diện cho tiêu chí nhắm mục tiêu về tín hiệu do nhà xuất bản cung cấp. Các loại tín hiệu do nhà xuất bản cung cấp khác nhau sẽ được kết hợp theo logic HOẶC.
| Biểu diễn dưới dạng JSON |
|---|
{ "audienceTargeting": { object ( |
| Trường | |
|---|---|
audienceTargeting |
Không bắt buộc. Danh sách mã nhận dạng đối tượng được nhắm mục tiêu hoặc bị loại trừ. Dựa trên Hệ thống phân loại đối tượng của IAB phiên bản 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) |
contentTargeting |
Không bắt buộc. Danh sách Content ID được nhắm mục tiêu hoặc bị loại trừ. Dựa trên Hệ thống phân loại nội dung theo IAB phiên bản 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) |
videoAndAudioSignalsTargeting |
Không bắt buộc. Danh sách mã nhận dạng tín hiệu video và âm thanh được nhắm mục tiêu và bị loại trừ. Đây là các tín hiệu bổ sung được hỗ trợ bởi tín hiệu do nhà xuất bản cung cấp. |
TaxonomyTargeting
Xác định tiêu chí nhắm mục tiêu để xử lý không gian Mã nhận dạng hệ thống phân loại nội dung và đối tượng của IAB.
| Biểu diễn dưới dạng JSON |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| Trường | |
|---|---|
targetedTaxonomyIds[] |
Không bắt buộc. Danh sách mã nhận dạng hệ thống phân loại nội dung được nhắm mục tiêu. |
excludedTaxonomyIds[] |
Không bắt buộc. Danh sách mã phân loại nội dung bị loại trừ. |
CurationFeeVisibility
Chế độ hiển thị của phí gói tuyển chọn và phí phân khúc dữ liệu kết hợp (tổng phí tuyển chọn). Người tạo gói luôn nhìn thấy phí.
| Enum | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
Không chỉ định chế độ hiển thị tổng phí tuyển chọn. |
DISCLOSED |
Tất cả người mua đều có thể nhìn thấy tổng phí tuyển chọn. Đây là giá trị mặc định nếu bạn không đặt. |
NON_DISCLOSED |
Không phải người mua nào cũng thấy tổng phí tuyển chọn. |
Phương thức |
|
|---|---|
|
Kích hoạt một gói được tuyển chọn hiện có. |
|
Tạo một gói được tuyển chọn mới. |
|
Huỷ kích hoạt một gói được tuyển chọn hiện có. |
|
Lấy một gói được tuyển chọn dựa trên tên tài nguyên của gói đó. |
|
Liệt kê các gói được tuyển chọn do người tuyển chọn được chỉ định sở hữu. |
|
Cập nhật một gói được tuyển chọn hiện có. |