REST Resource: curators.curatedPackages

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 (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Trường
name

string

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 curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

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 curatedPackages.list.

description

string

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

string (Timestamp format)

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 curatedPackages.list.

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

updateTime

string (Timestamp format)

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 curatedPackages.list.

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

floorPriceCpm

object (Money)

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 curatedPackages.list.

state

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

accessSettings

object (AccessControlSettings)

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

object (PackageTargeting)

Không bắt buộc. Tiêu chí nhắm mục tiêu cho gói được tuyển chọn.

curationFeeVisibility

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

object (Money)

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 curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

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

string

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 mediaPlanners.list. Hiện tại, bạn chỉ có thể đưa một chuyên viên kế hoạch truyền thông vào danh sách cho phép.

Định dạng mediaPlanners/{mediaPlannerAccountId}

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 (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Trường
includedDeviceTypes[]

enum (DeviceType)

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

enum (Environment)

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

enum (CreativeFormat)

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

enum (AcceleratedMobilePageType)

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

enum (AuthorizedSellerStatus)

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

enum (NativeInventoryType)

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

enum (OpenMeasurementType)

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

enum (RestrictedCategory)

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

enum (RewardedType)

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

object (PackageVideoTargeting)

Không bắt buộc. Tiêu chí nhắm mục tiêu cụ thể cho video.

minimumPredictedViewabilityPercentage

string (int64 format)

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

object (StringTargetingDimension)

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

object (AdSize)

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 PIXEL và INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

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

string (int64 format)

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

object (CriteriaTargeting)

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

object (CriteriaTargeting)

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

string

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 curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

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

object (PackagePublisherProvidedSignalsTargeting)

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 (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Trường
includedMimeTypes[]

enum (VideoMimeType)

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

enum (MaximumVideoAdDuration)

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

enum (PositionType)

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

enum (ContentDeliveryMethod)

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

object (VideoPlcmtTargeting)

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

enum (PlaybackMethod)

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

string (int64 format)

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

object (VideoPlayerSizeTargeting)

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 (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Trường
selectionType

enum (SelectionType)

Bắt buộc. Loại lựa chọn cho danh sách vị trí video.

videoPlcmtTypes[]

enum (VideoPlcmtType)

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

string (int64 format)

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

string (int64 format)

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 (SelectionType),
  "values": [
    string
  ]
}
Trường
selectionType

enum (SelectionType)

Bắt buộc. Cách nhắm mục tiêu các mục trong danh sách này.

values[]

string

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 (Type)
}
Trường
width

string (int64 format)

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à PIXEL.

height

string (int64 format)

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à PIXEL.

type

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

string (int64 format)

Danh sách mã nhận dạng dạng số cần đưa vào.

excludedCriteriaIds[]

string (int64 format)

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 (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Trường
uriTargeting

object (StringTargetingDimension)

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

object (StringTargetingDimension)

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

string (int64 format)

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 (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Trường
audienceTargeting

object (TaxonomyTargeting)

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

object (TaxonomyTargeting)

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

object (StringTargetingDimension)

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

string

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

string

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

activate

Kích hoạt một gói được tuyển chọn hiện có.

create

Tạo một gói được tuyển chọn mới.

deactivate

Huỷ kích hoạt một gói được tuyển chọn hiện có.

get

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 đó.

list

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.

patch

Cập nhật một gói được tuyển chọn hiện có.