REST Resource: curators.curatedPackages

リソース: CuratedPackage

キュレーターによって作成、管理される、厳選された広告枠のパッケージを表します。

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.
}
フィールド
name

string

ID。キュレートされたパッケージの一意のリソース名。形式: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

必須。キュレーターによってキュレートされたパッケージに割り当てられた表示名。curatedPackages.list メソッドのレスポンスをフィルタするために使用できます。

description

string

省略可。キュレーターが提供する、キュレートされたパッケージの説明。

createTime

string (Timestamp format)

出力専用。キュレートされたパッケージが作成されたときのタイムスタンプ。curatedPackages.list メソッドのレスポンスをフィルタするために使用できます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

updateTime

string (Timestamp format)

出力専用。キュレートされたパッケージが最後に更新されたときのタイムスタンプ。curatedPackages.list メソッドのレスポンスをフィルタするために使用できます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

floorPriceCpm

object (Money)

省略可。このキュレーション パッケージの広告枠のオークションに参加するために、購入者が入札する必要がある最小インプレッション単価。curatedPackages.list メソッドのレスポンスをフィルタするために使用できます。

state

enum (State)

出力専用。キュレートされたパッケージの状態。curatedPackages.list メソッドのレスポンスをフィルタするために使用できます。

accessSettings

object (AccessControlSettings)

必須。キュレートされたパッケージへのアクセスを制御するための設定。

このキュレートされたパッケージにアクセスできるのは、許可リストに登録されているメディア プランナーとクリエイターのみです。購入者とビッダーは、このリソースの許可リストに登録することも、このリソースに直接アクセスすることもできません。

targeting

object (PackageTargeting)

省略可。キュレーションされたパッケージのターゲティング条件。

curationFeeVisibility

enum (CurationFeeVisibility)

省略可。変更不可。キュレーション パッケージ料金とデータ セグメント料金の合計(キュレーション料金の合計)の可視性。

このパッケージのキュレーターに支払われる料金。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
feeCpm

object (Money)

省略可。このキュレーションされたパッケージを使用する購入者に対して、キュレーターから請求される CPM 料金。curatedPackages.list メソッドのレスポンスをフィルタするために使用できます。

millipercentOfMediaFee

string (int64 format)

省略可。この料金は、インプレッション費用の割合として請求され、ミリパーセントで表されます。たとえば、1% は 1000 と表されます。

相互に排他的なフィールドの終了。

州

キュレートされたパッケージの状態。

列挙型
STATE_UNSPECIFIED デフォルト値。
ACTIVE キュレートされたパッケージが有効になっている。
INACTIVE キュレートされたパッケージは無効です。

AccessControlSettings

キュレートされたパッケージへのアクセスを制御するための設定。

JSON 表現
{
  "allowlistedMediaPlanners": [
    string
  ]
}
フィールド
allowlistedMediaPlanners[]

string

必須。変更不可。キュレートされたパッケージへのアクセス権が明示的に付与されているメディア プランナーのリスト。対象となるメディア プランナーは、mediaPlanners.list メソッドで確認できます。現時点で許可リストに登録できるメディア プランナーは 1 人のみです。

形式: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

キュレート パッケージとオークション パッケージのターゲティング条件。

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)
  }
}
フィールド
includedDeviceTypes[]

enum (DeviceType)

省略可。ターゲットに設定するデバイスタイプのリスト。空の場合、すべてのデバイスタイプがターゲットになります。

includedEnvironment

enum (Environment)

省略可。ターゲットとする環境。指定しない場合、すべての環境がターゲットになります。

includedCreativeFormat

enum (CreativeFormat)

省略可。ターゲットとするクリエイティブ フォーマット。設定しない場合、すべてのクリエイティブ マークアップ タイプがターゲットに設定されます。

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

省略可。ターゲットに設定された Accelerated Mobile Pages のタイプ。設定しない場合、AMP ステータスに関係なく広告枠がターゲットに設定されます。

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

省略可。ターゲットに設定されている認定販売者のステータスのリスト。空の場合、販売者のステータスに関係なく広告枠がターゲットに設定されます。

includedNativeInventoryTypes[]

enum (NativeInventoryType)

省略可。ターゲットに設定されているネイティブ広告枠タイプ。空の場合、ネイティブ広告枠タイプに関係なく広告枠がターゲットに設定されます。

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

省略可。対象となる Open Measurement タイプのリスト。空の場合、Open Measurement のサポートに関係なく、広告枠がターゲットに設定されます。

includedRestrictedCategories[]

enum (RestrictedCategory)

省略可。ターゲットに設定されている制限付きカテゴリのリスト。空の場合、制限付きカテゴリに関係なく広告枠がターゲットに設定されます。

includedRewardedType

enum (RewardedType)

省略可。対象となるリワード広告のタイプ。設定しない場合、リワードタイプに関係なく広告枠がターゲットに設定されます。

videoTargeting

object (PackageVideoTargeting)

省略可。動画固有のターゲティング条件。

minimumPredictedViewabilityPercentage

string (int64 format)

省略可。ターゲットとする視認性の下限(予測値)の割合。

この値は 10 ~ 90 の 10 の倍数(両端の値を含む)で指定する必要があります。たとえば、10 は有効ですが、0、15、100 は無効です。値が 10 の場合、視認性が 10% 以上と予測される広告スロットのみが構成と一致します。

値が設定されていない場合、予測視認性に関係なく広告枠がターゲットに設定されます。

languageTargeting

object (StringTargetingDimension)

省略可。ターゲットとする言語。設定しない場合、言語に関係なく広告枠がターゲットに設定されます。サポートされている言語コードの一覧については、https://developers.google.com/google-ads/api/data/codes-formats#languages をご覧ください。

includedAdSizes[]

object (AdSize)

省略可。ターゲットに設定する広告サイズのリスト。設定しない場合、広告サイズに関係なく広告枠がターゲットに設定されます。

厳選パッケージは、PIXEL と INTERSTITIAL の広告サイズをサポートしています。

publisherTargeting

object (StringTargetingDimension)

省略可。ターゲットに設定されたパブリッシャー。設定しない場合、パブリッシャーに関係なく広告枠がターゲットに設定されます。パブリッシャーは、ads.txt / app-ads.txt のパブリッシャー ID で識別されます。詳しくは、https://iabtechlab.com/ads-txt/ と https://iabtechlab.com/app-ads-txt/ をご覧ください。

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

省略可。クリック率の下限(予測値)の目標値。値の範囲は [10, 10000](0.01%~ 10%)です。値が 50 の場合、クリック率が 0.05% 以上と予測される広告スロットのみが構成に一致します。

値を設定しない場合、予測クリック率に関係なく広告枠がターゲットに設定されます。

verticalTargeting

object (CriteriaTargeting)

省略可。https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals で定義されている、含めるまたは除外するカテゴリ。設定しない場合、業種に関係なく広告枠がターゲットに設定されます。

geoTargeting

object (CriteriaTargeting)

省略可。https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv で定義されている、含めるまたは除外する地域条件 ID。設定しない場合、地域に関係なく広告枠がターゲットに設定されます。

includedDataSegments[]

string

省略可。ターゲットに設定するアクティブなデータ セグメント。設定しない場合、データ セグメントに関係なく広告枠がターゲットに設定されます。形式: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

省略可。プレースメント ターゲティング情報(URL、モバイルアプリなど)。

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

省略可。ターゲティングするパブリッシャー提供のシグナル。設定しない場合、パブリッシャー提供のシグナルに関係なく広告枠がターゲットに設定されます。

DeviceType

ターゲットとするデバイスの一般的なタイプ。

列挙型
DEVICE_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
DEVICE_TYPE_PERSONAL_COMPUTER デスクトップ パソコンまたはノートパソコンをターゲットに設定します。
DEVICE_TYPE_CONNECTED_TV コネクテッド テレビ(スマートテレビ、ゲーム機、ストリーミング ボックス / スティックなど、テレビのコンテンツをストリーミングするデバイス)をターゲットに設定します。
DEVICE_TYPE_PHONE ハイエンド モバイル デバイスをターゲットに設定します。
DEVICE_TYPE_TABLET タブレット デバイスをターゲットに設定します。

環境

ターゲットとする環境。

列挙型
ENVIRONMENT_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
ENVIRONMENT_SITE 広告が掲載されているウェブサイト内に表示される広告枠をターゲットに設定します。
ENVIRONMENT_APP モバイルアプリ内の広告枠をターゲットに設定します。

CreativeFormat

ターゲティング可能なクリエイティブ フォーマット。

列挙型
CREATIVE_FORMAT_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
CREATIVE_FORMAT_DISPLAY HTML ディスプレイ クリエイティブ用の広告スロットをターゲットに設定します。
CREATIVE_FORMAT_VIDEO 動画クリエイティブ用の広告スロットをターゲットに設定します。
CREATIVE_FORMAT_AUDIO オーディオ クリエイティブ用の広告スロットをターゲットに設定します。

AcceleratedMobilePageType

ターゲットとする Accelerated Mobile Pages(AMP)の実装タイプ。

列挙型
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP AMP フレームワークを使用していない標準のウェブページの広告枠をターゲットに設定します。
ACCELERATED_MOBILE_PAGE_TYPE_AMP コア AMP HTML フレームワークを使用して作成されたページの広告枠をターゲットに設定します。
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY AMP ストーリー(STAMP)形式を使用するページの広告枠をターゲットに設定します。この形式は、視覚的なストーリーテリング(タップ可能な全画面表示など)に最適化されています。

AuthorizedSellerStatus

ads.txt または app-ads.txt ファイルで宣言されている、パブリッシャーと販売者の関係を表します。

列挙型
AUTHORIZED_SELLER_STATUS_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
AUTHORIZED_SELLER_STATUS_DIRECT 販売者が「DIRECT」として宣言されている広告枠をターゲットに設定します。これは、パブリッシャー(コンテンツ所有者)が販売アカウントを直接管理し、このアカウントについて広告システムと直接のビジネス契約を結んでいることを示します。
AUTHORIZED_SELLER_STATUS_RESELLER 販売者が「RESELLER」として宣言されている広告枠をターゲットに設定します。これは、パブリッシャーが、記載されている販売アカウントを運営し、広告スペースを再販することを別のエンティティに許可していることを示します。

NativeInventoryType

広告スロットでサポートされているクリエイティブ レンダリングのタイプを表します(特にネイティブ広告に関連)。

列挙型
NATIVE_INVENTORY_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
NATIVE_INVENTORY_TYPE_NATIVE_ONLY ネイティブ広告のみを受け入れてレンダリングする広告スロットをターゲットに設定します。
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER ネイティブ広告またはバナー広告を受け入れてレンダリングする広告スロットをターゲットに設定します。

OpenMeasurementType

ターゲットとする Open Measurement Interface Definition(OMID)のタイプ。

列挙型
OPEN_MEASUREMENT_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
OPEN_MEASUREMENT_TYPE_OMID_V1 v1 Open Measurement Interface Definition(OMID)をサポートする広告枠をターゲットに設定します。

RestrictedCategory

ポリシーによってターゲティングが制限されている広告の特定のカテゴリを表します。

列挙型
RESTRICTED_CATEGORY_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
RESTRICTED_CATEGORY_ALCOHOL パブリッシャーがアルコール広告を許可している広告枠をターゲットに設定します。
RESTRICTED_CATEGORY_GAMBLING パブリッシャーがギャンブル広告を許可している広告枠をターゲットに設定します。

RewardedType

広告インベントリで広告を視聴したユーザーに報酬を提供するかどうかに基づいて、ターゲティング条件を定義します。

列挙型
REWARDED_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
REWARDED_TYPE_NON_REWARDED 広告の視聴や操作に対してユーザーに明示的な報酬を提供しない広告枠をターゲットに設定します。
REWARDED_TYPE_REWARDED 広告の視聴や操作と引き換えにユーザーに特典を提供する広告枠をターゲットに設定します。

PackageVideoTargeting

動画固有のターゲティング条件。

JSON 表現
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
フィールド
includedMimeTypes[]

enum (VideoMimeType)

省略可。IANA が公開している MIME タイプ文字列(https://www.iana.org/assignments/media-types/media-types.xhtml))を使用した、ターゲットとする動画の MIME タイプのリスト。空の場合、動画の MIME タイプに関係なく広告枠がターゲットに設定されます。

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

省略可。ターゲットに設定された動画広告の最大再生時間。設定しない場合、動画広告の最大再生時間に関係なく、広告枠がターゲットに設定されます。

includedPositionTypes[]

enum (PositionType)

省略可。ターゲットに設定されている動画広告の掲載順位のタイプ。空の場合、動画広告の掲載順位タイプに関係なく、広告枠がターゲットに設定されます。

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

省略可。ターゲットに設定された動画配信方法。設定しない場合、動画配信方法に関係なく広告枠がターゲットに設定されます。

plcmtTargeting

object (VideoPlcmtTargeting)

省略可。ターゲットに設定された動画 plcmt タイプ。未設定の場合、動画のプレースメント タイプに関係なく広告枠がターゲットに設定されます。

includedPlaybackMethods[]

enum (PlaybackMethod)

省略可。ターゲットに設定された動画の再生方法のリスト。空の場合、動画の再生方法に関係なく広告枠がターゲットに設定されます。

minimumPredictedCompletionRatePercentage

string (int64 format)

省略可。完全再生率の下限(予測値)の目標値(%)。

この値は 10 ~ 90 の 10 の倍数(両端の値を含む)で指定する必要があります。たとえば、10 は有効ですが、0、15、100 は無効です。値が 10 の場合、完全再生率が 10% 以上と予測される広告スロットのみが構成に一致します。

値を設定しない場合、予測される完全再生率に関係なく広告枠がターゲットに設定されます。

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

省略可。ターゲットに設定されている動画プレーヤーのサイズ。設定しない場合、動画プレーヤーのサイズに関係なく広告枠がターゲティングされます。

VideoMimeType

ターゲットとする動画の MIME タイプ。

列挙型
VIDEO_MIME_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
VIDEO_MIME_TYPE_THREEGPP 3G スマートフォンで使用される 3GPP コンテナ形式。
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 通常は H.264 コーデックを使用する MPEG-4 コンテナ。
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH。
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript(VPAID 広告に使用)。
VIDEO_MIME_TYPE_WEBM VP9 コーデックを想定した WebM コンテナ。

MaximumVideoAdDuration

ターゲットとする動画広告クリエイティブの再生時間の上限。列挙値はバケットを定義します。値を選択すると、クリエイティブの再生時間が指定された時間以下である必要があることを意味します。

列挙型
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS 長さが 15 秒以下の動画広告(0 < 長さ <= 15 秒)に適用されます。
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS 再生時間が 20 秒以下の動画広告に適用されます(0 < 再生時間 <= 20 秒)。
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS 再生時間が 30 秒以下の動画広告(0 < 再生時間 <= 30 秒)に適用されます。
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS 再生時間が 60 秒以下の動画広告に適用されます(0 < 再生時間 <= 60 秒)。
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS 再生時間が 90 秒以下の動画広告に適用されます(0 < 再生時間 <= 90 秒)。
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS 再生時間が 120 秒以下の動画広告に適用されます(0 < 再生時間 <= 120 秒)。

PositionType

動画内でターゲティング可能な広告の位置。

列挙型
POSITION_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
POSITION_TYPE_MIDROLL 動画コンテンツの途中で再生される広告。
POSITION_TYPE_POSTROLL 広告は動画コンテンツの後に再生されます。
POSITION_TYPE_PREROLL 動画コンテンツの前に再生される広告。

ContentDeliveryMethod

動画コンテンツの配信方法に基づくターゲティング条件。

列挙型
CONTENT_DELIVERY_METHOD_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
CONTENT_DELIVERY_METHOD_STREAMING ライブ配信されている動画コンテンツをターゲットに設定します。
CONTENT_DELIVERY_METHOD_PROGRESSIVE クライアントの再生に必要な分だけ段階的に転送される動画コンテンツをターゲットに設定します。

VideoPlcmtTargeting

動画プレースメント タイプに基づいてターゲティング条件を定義します。多くの場合、IAB OpenRTB の「plcmt」フィールドに対応します。

JSON 表現
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
フィールド
selectionType

enum (SelectionType)

必須。動画プレースメントのリストの選択タイプ。

videoPlcmtTypes[]

enum (VideoPlcmtType)

必須。対象となる動画プレースメント タイプのリスト。空の場合、動画の plcmt タイプに関係なく広告枠がターゲットに設定されます。

SelectionType

ターゲティング ディメンションで使用できる選択タイプの列挙型。

列挙型
SELECTION_TYPE_UNSPECIFIED 選択タイプが指定されていません。これは使用しないでください。
SELECTION_TYPE_INCLUDE ターゲティング ディメンションの値が含まれます。
SELECTION_TYPE_EXCLUDE ターゲティング ディメンションの値は除外されます。

VideoPlcmtType

OpenRTB 規格に準拠した動画プレースメント タイプを表します。

列挙型
VIDEO_PLCMT_TYPE_UNSPECIFIED デフォルト値。ターゲティング仕様では使用しないでください。
INSTREAM ユーザーがリクエストしたストリーミング動画コンテンツの再生前、再生中、再生後に再生されるプレロール広告、ミッドロール広告、ポストロール広告。インストリーム動画は、プレーヤーの起動時にデフォルトで「音声あり」に設定されているか、動画コンテンツを視聴するユーザーの意図が明確に示されている必要があります。プレーヤーの周囲に他のコンテンツが表示される場合もありますが、動画コンテンツはユーザーがアクセスした目的のものである必要があります。動画はページのメイン コンテンツであり、再生時に音声が聞こえる唯一の動画プレーヤーである必要があります。プレーヤーがフローティング / スティッキーに変換された場合、それ以降の広告呼び出しでは、更新されたプレーヤー サイズが正確に伝えられる必要があります。
ACCOMPANYING_CONTENT プレロール広告、ミッドロール広告、ポストロール広告は、ストリーミング動画コンテンツの再生前、再生中、再生後に再生される広告です。動画プレーヤーは、テキストまたはグラフィック コンテンツの段落の前、間、または後に読み込まれて再生され、ビューポートに入ったときにのみ再生が開始されます。付随するコンテンツは、ビューポートに入ったときにのみ再生を開始する必要があります。ページをスクロールすると、フローティング プレーヤーまたは追尾型プレーヤーに変換される場合があります。
INTERSTITIAL 動画コンテンツなしで再生される動画広告。再生中は、ページのメイン要素となり、ビューポートの大部分を占め、スクロールしても表示から外れないようにする必要があります。これには、アプリ内動画やスライドショーなどのプレースメントが含まれます。
NO_CONTENT ストリーミング動画コンテンツなしで再生される動画広告。スライドショー、ネイティブ フィード、コンテンツ内、固定 / フローティングなどのプレースメントに表示できます。

PlaybackMethod

ターゲティングする再生方法。

列挙型
PLAYBACK_METHOD_UNSPECIFIED 動画の再生方法が指定されていません。これは使用しないでください。
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON ページまたはコンテンツが読み込まれると、再生が自動的に開始されます。
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF ページやコンテンツが読み込まれると、再生が自動的に開始されますが、音声はオフになっています。
PLAYBACK_METHOD_CLICK_TO_PLAY ユーザーのアクション(再生ボタンのクリックなど)によって再生が開始される。

VideoPlayerSizeTargeting

ターゲットに設定できる動画プレーヤーのサイズを表します。幅と高さの両方にゼロ以外の値を設定する必要があります。

JSON 表現
{
  "minimumWidth": string,
  "minimumHeight": string
}
フィールド
minimumWidth

string (int64 format)

必須。動画プレーヤーの最小幅(ピクセル単位)。

minimumHeight

string (int64 format)

必須。動画プレーヤーの最小の高さ(ピクセル単位)。

StringTargetingDimension

文字列値を使用した一般的なターゲティング。

JSON 表現
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
フィールド
selectionType

enum (SelectionType)

必須。このリストのアイテムをターゲティングする方法。

values[]

string

必須。指定された値。

AdSize

1 つの広告スロットまたはクリエイティブのサイズを表します。

JSON 表現
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
フィールド
width

string (int64 format)

広告スロットの幅(ピクセル単位)。このフィールドは、サイズタイプが PIXEL の場合にのみ表示されます。

height

string (int64 format)

広告スロットの高さ(ピクセル単位)。このフィールドは、サイズタイプが PIXEL の場合にのみ表示されます。

type

enum (Type)

広告スロットのサイズのタイプ。

タイプ

さまざまなタイプの広告スロット / クリエイティブ サイズを表します。

列挙型
TYPE_UNSPECIFIED 未定義のサイズタイプのプレースホルダ。
PIXEL 高さと幅をピクセル単位で指定した広告スロット。
INTERSTITIAL インタースティシャル広告スロットを記述する特別なサイズ。
NATIVE パブリッシャー側でレンダリングされるネイティブ(モバイル)広告。
FLUID 流動的なサイズ(レスポンシブ サイズ)は、外部環境の変化に応じて自動的にサイズ変更できます。

CriteriaTargeting

含める数値 ID と除外する数値 ID のリストを含むターゲティング ディメンションに使用される一般的なターゲティング。これは、リストフィルタ構文を使用してフィルタリングできません。

JSON 表現
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
フィールド
targetedCriteriaIds[]

string (int64 format)

含める数値 ID のリスト。

excludedCriteriaIds[]

string (int64 format)

除外する数値 ID のリスト。

PackagePlacementTargeting

広告を表示できる場所(特定のサイトやモバイルアプリなど)に関するターゲティングを表します。異なるプレースメント ターゲティング タイプは論理和(OR)で結合されます。

JSON 表現
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
フィールド
uriTargeting

object (StringTargetingDimension)

省略可。ターゲットに設定または除外する URL のリスト。ドメインから http/https を削除する必要があります(例: google.com)。URL ごとに最大 5 つのパスを含めることができます。

mobileAppTargeting

object (StringTargetingDimension)

省略可。パブリッシャーが所有する、ターゲットに設定または除外されたモバイル アプリケーション ID のリスト。現在、Android アプリと Apple アプリのみがサポートされています。

Android アプリ ID(例: com.google.android.apps.maps)は、Google Play ストアの URL で確認できます。iOS アプリ ID(数字)は、iTunes ストアの URL の末尾で確認できます。ファーストパーティのモバイルアプリが含まれているか、除外されている。

includedMobileAppCategoryTargeting[]

string (int64 format)

省略可。ターゲティング対象のモバイルアプリのカテゴリのリスト。

PackagePublisherProvidedSignalsTargeting

パブリッシャー提供のシグナルに関するターゲティングを表します。異なるタイプのパブリッシャー提供のシグナルは、論理和(OR)で結合されます。

JSON 表現
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
フィールド
audienceTargeting

object (TaxonomyTargeting)

省略可。ターゲットに設定または除外されたオーディエンス ID のリスト。IAB オーディエンスの分類バージョン 1.1(https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)に基づく

contentTargeting

object (TaxonomyTargeting)

省略可。ターゲットに設定または除外された Content ID のリスト。IAB コンテンツの分類バージョン 2.2(https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)に基づく

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

省略可。ターゲティング対象および除外対象の動画と音声のシグナル ID のリスト。これらは、パブリッシャー提供のシグナルでサポートされている追加のシグナルです。

TaxonomyTargeting

IAB オーディエンスとコンテンツの分類 ID スペースを処理するためのターゲティング条件を定義します。

JSON 表現
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
フィールド
targetedTaxonomyIds[]

string

省略可。ターゲットに設定されたコンテンツ分類 ID のリスト。

excludedTaxonomyIds[]

string

省略可。除外されたコンテンツ分類 ID のリスト。

CurationFeeVisibility

キュレーション パッケージ料金とデータ セグメント料金の合計(キュレーション料金の合計)の可視性。料金は常にパッケージの作成者に表示されます。

列挙型
CURATION_FEE_VISIBILITY_UNSPECIFIED キュレーション料金の合計の表示設定が指定されていません。
DISCLOSED キュレーション料金の合計は、すべての購入者に表示されます。設定しない場合、これがデフォルト値になります。
NON_DISCLOSED キュレーション料金の合計は、すべての購入者に表示されるわけではありません。

メソッド

activate

既存のキュレートされたパッケージを有効にします。

create

新しいキュレートされたパッケージを作成します。

deactivate

既存のキュレートされたパッケージを無効にします。

get

リソース名を指定して、キュレートされたパッケージを取得します。

list

指定されたキュレーターが所有するキュレートされたパッケージを一覧表示します。

patch

既存のキュレートされたパッケージを更新します。