REST Resource: curators.curatedPackages

Ressource : CuratedPackage

Représente un package d'inventaire sélectionné, créé et géré par un curateur.

Représentation 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.
}
Champs
name

string

Identifiant. Nom de ressource unique du package sélectionné. Format : curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Obligatoire. Nom à afficher attribué au package sélectionné par le curateur. Peut être utilisé pour filtrer la réponse de la méthode curatedPackages.list.

description

string

Facultatif. Description du package ayant fait l'objet d'une curation, fournie par le curateur.

createTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la création du package sélectionné. Peut être utilisé pour filtrer la réponse de la méthode curatedPackages.list.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière mise à jour du package sélectionné. Peut être utilisé pour filtrer la réponse de la méthode curatedPackages.list.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

Facultatif. CPM minimal qu'un acheteur doit proposer pour participer aux enchères sur l'inventaire de ce package organisé. Peut être utilisé pour filtrer la réponse de la méthode curatedPackages.list.

state

enum (State)

Uniquement en sortie. État du package sélectionné. Peut être utilisé pour filtrer la réponse de la méthode curatedPackages.list.

accessSettings

object (AccessControlSettings)

Obligatoire. Paramètres permettant de contrôler l'accès au package sélectionné.

L'accès à ce package sélectionné est limité aux média-planners autorisés et au créateur. Les acheteurs et les enchérisseurs ne peuvent pas être ajoutés à la liste d'autorisation ni avoir un accès direct à cette ressource.

targeting

object (PackageTargeting)

Facultatif. Critères de ciblage du package sélectionné.

curationFeeVisibility

enum (CurationFeeVisibility)

Facultatif. Immuable. La visibilité des frais combinés du package de curation et des frais du segment de données (frais de curation totaux).

Frais versés au curateur pour ce package. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
feeCpm

object (Money)

Facultatif. Frais de CPM facturés par le curateur aux acheteurs qui utilisent ce package organisé. Peut être utilisé pour filtrer la réponse de la méthode curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

Facultatif. Les frais seront facturés sous forme de pourcentage du coût de l'impression, exprimé en millièmes de pour cent. Par exemple, 1 % est représenté par 1 000.

Fin des champs mutuellement exclusifs.

État

État du package sélectionné.

Enums
STATE_UNSPECIFIED Valeur par défaut.
ACTIVE Le package sélectionné est actif.
INACTIVE Le package sélectionné est inactif.

AccessControlSettings

Paramètres permettant de contrôler l'accès à un package sélectionné.

Représentation JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Champs
allowlistedMediaPlanners[]

string

Obligatoire. Immuable. Liste des média-planners qui ont explicitement accès au package sélectionné. Les média-planners éligibles sont disponibles dans la méthode mediaPlanners.list. Pour le moment, un seul média-planner peut être ajouté à la liste d'autorisation.

Format : mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Critères de ciblage pour les packages préparés et d'enchères.

Représentation 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)
  }
}
Champs
includedDeviceTypes[]

enum (DeviceType)

Facultatif. Liste des types d'appareils inclus à cibler. Si ce champ est vide, tous les types d'appareils sont ciblés.

includedEnvironment

enum (Environment)

Facultatif. Environnement à cibler. Si aucune valeur n'est spécifiée, tous les environnements sont ciblés.

includedCreativeFormat

enum (CreativeFormat)

Facultatif. Format de création à cibler. Si ce paramètre n'est pas défini, tous les types de balisage de création sont ciblés.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

Facultatif. Type de page AMP (Accelerated Mobile Pages) ciblé. Si cette valeur n'est pas définie, l'inventaire sera ciblé quel que soit l'état AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

Facultatif. Liste incluse des états de vendeur autorisé ciblés. Si ce champ est vide, l'inventaire sera ciblé quel que soit l'état du vendeur.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

Facultatif. Types d'inventaires natifs ciblés. Si ce champ est vide, l'inventaire sera ciblé quel que soit le type d'inventaire natif.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

Facultatif. Liste des types de mesures Open Measurement ciblés. Si ce champ est vide, l'inventaire sera ciblé, qu'il soit compatible ou non avec Open Measurement.

includedRestrictedCategories[]

enum (RestrictedCategory)

Facultatif. Liste des catégories restreintes ciblées. Si ce champ est vide, l'inventaire sera ciblé, quelles que soient les catégories restreintes.

includedRewardedType

enum (RewardedType)

Facultatif. Type de récompense ciblé. Si cette option n'est pas définie, l'inventaire sera ciblé quel que soit le type de récompense.

videoTargeting

object (PackageVideoTargeting)

Facultatif. Critères de ciblage spécifiques aux vidéos.

minimumPredictedViewabilityPercentage

string (int64 format)

Facultatif. Pourcentage de visibilité minimale prévue ciblé.

Cette valeur doit être un multiple de 10 compris entre 10 et 90 (inclus). Par exemple, 10 est valide, mais pas 0, 15 et 100. Une valeur de 10 signifie que la configuration ne correspondra qu'aux espaces publicitaires pour lesquels nous prévoyons une visibilité d'au moins 10 %.

Une valeur non définie indique que l'inventaire sera ciblé, quelle que soit la visibilité prévue.

languageTargeting

object (StringTargetingDimension)

Facultatif. Langues à cibler. Si ce paramètre n'est pas défini, l'inventaire sera ciblé quelle que soit la langue. Pour obtenir la liste des codes de langue acceptés, consultez https://developers.google.com/google-ads/api/data/codes-formats#languages.

includedAdSizes[]

object (AdSize)

Facultatif. Liste des tailles d'annonces à cibler. Si cette valeur n'est pas définie, l'inventaire sera ciblé quelle que soit la taille de l'annonce.

Les packages sélectionnés sont compatibles avec les tailles d'annonces PIXEL et INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

Facultatif. Les éditeurs ciblés. Si cette valeur n'est pas définie, l'inventaire sera ciblé quel que soit l'éditeur. Les éditeurs sont identifiés par leur référence éditeur dans le fichier ads.txt/app-ads.txt. Pour en savoir plus, consultez https://iabtechlab.com/ads-txt/ et https://iabtechlab.com/app-ads-txt/.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

Facultatif. Taux de clics minimal prévu ciblé, compris entre 10 et 10 000 (0, 01 % à 10 %). Une valeur de 50 signifie que la configuration ne correspondra qu'aux espaces publicitaires pour lesquels nous prévoyons un taux de clics d'au moins 0,05 %.

Une valeur non définie indique que l'inventaire sera ciblé quel que soit le taux de clics prédit.

verticalTargeting

object (CriteriaTargeting)

Facultatif. Secteurs d'activité inclus ou exclus, tels que définis sur la page https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Si ce paramètre n'est pas défini, l'inventaire sera ciblé quel que soit le secteur d'activité.

geoTargeting

object (CriteriaTargeting)

Facultatif. ID des critères géographiques à inclure ou à exclure, tels que définis sur https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Si ce paramètre n'est pas défini, l'inventaire sera ciblé quelle que soit la zone géographique.

includedDataSegments[]

string

Facultatif. Segments de données actifs à cibler. Si cette option n'est pas définie, l'inventaire sera ciblé indépendamment des segments de données. Format : curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Facultatif. Informations sur le ciblage par emplacements (par exemple, URL, applications mobiles)

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

Facultatif. Signaux fournis par l'éditeur à cibler. Si cette option n'est pas définie, l'inventaire sera ciblé quels que soient les signaux fournis par l'éditeur.

DeviceType

Type général d'appareil à cibler.

Enums
DEVICE_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
DEVICE_TYPE_PERSONAL_COMPUTER Cible les ordinateurs de bureau ou portables.
DEVICE_TYPE_CONNECTED_TV Cible les TV connectées : appareils qui diffusent du contenu télévisé en streaming, y compris les smart TV, les consoles de jeu et les boîtiers/clés de streaming.
DEVICE_TYPE_PHONE Cible les téléphones multimédias.
DEVICE_TYPE_TABLET Cible les tablettes.

Environnement

Environnement à cibler.

Enums
ENVIRONMENT_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
ENVIRONMENT_SITE Cible l'inventaire affiché sur un site Web avec publicité.
ENVIRONMENT_APP Cible l'inventaire dans une application mobile.

CreativeFormat

Format de création pouvant être ciblé.

Enums
CREATIVE_FORMAT_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
CREATIVE_FORMAT_DISPLAY Cible les espaces publicitaires destinés aux créations display HTML.
CREATIVE_FORMAT_VIDEO Cible les espaces publicitaires destinés aux créations vidéo.
CREATIVE_FORMAT_AUDIO Cible les espaces publicitaires destinés aux créations audio.

AcceleratedMobilePageType

Type d'implémentation Accelerated Mobile Page (AMP) à cibler.

Enums
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP Cible l'inventaire sur les pages Web standards n'utilisant pas de framework AMP.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Cible l'inventaire sur les pages créées à l'aide du framework AMP HTML de base.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Cible l'inventaire sur les pages utilisant le format AMP Story (STAMP), qui est optimisé pour le storytelling visuel (par exemple, les expériences plein écran interactives).

AuthorizedSellerStatus

Représente la relation entre l'éditeur et le vendeur, telle qu'elle est déclarée dans un fichier ads.txt ou app-ads.txt.

Enums
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
AUTHORIZED_SELLER_STATUS_DIRECT Cible l'inventaire pour lequel le vendeur est déclaré comme "DIRECT". Cela indique que l'éditeur (propriétaire de contenu) contrôle directement le compte vendeur et qu'il existe un contrat commercial direct entre l'éditeur et le système publicitaire pour ce compte.
AUTHORIZED_SELLER_STATUS_RESELLER Cible l'inventaire pour lequel le vendeur est déclaré comme "RESELLER". Cela indique que l'éditeur a autorisé une autre entité à exploiter le compte vendeur listé et à revendre son espace publicitaire.

NativeInventoryType

Représente le type de rendu de création accepté par un espace publicitaire, en particulier pour les annonces natives.

Enums
NATIVE_INVENTORY_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Cible les espaces publicitaires qui acceptent et affichent uniquement des annonces natives.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Cible les espaces publicitaires qui acceptent et affichent des annonces natives ou des bannières.

OpenMeasurementType

Type d'Open Measurement Interface Definition (OMID) à cibler.

Enums
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
OPEN_MEASUREMENT_TYPE_OMID_V1 Cible l'inventaire compatible avec la version 1 de l'Open Measurement Interface Definition (OMID).

RestrictedCategory

Représente les catégories spécifiques d'annonces dont le ciblage est limité par les règles.

Enums
RESTRICTED_CATEGORY_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
RESTRICTED_CATEGORY_ALCOHOL Cible l'inventaire où l'éditeur autorise les annonces pour de l'alcool.
RESTRICTED_CATEGORY_GAMBLING Cible l'inventaire où les annonces pour des jeux d'argent et de hasard sont autorisées par l'éditeur.

RewardedType

Définit des critères de ciblage selon que l'inventaire publicitaire offre ou non une récompense à l'utilisateur pour avoir visionné une annonce.

Enums
REWARDED_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
REWARDED_TYPE_NON_REWARDED Cible l'inventaire qui n'offre PAS de récompense explicite à l'utilisateur pour avoir regardé l'annonce ou interagi avec elle.
REWARDED_TYPE_REWARDED Cible l'inventaire qui offre une récompense à l'utilisateur en échange du visionnage de l'annonce ou de l'interaction avec celle-ci.

PackageVideoTargeting

Critères de ciblage spécifiques aux vidéos.

Représentation JSON
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Champs
includedMimeTypes[]

enum (VideoMimeType)

Facultatif. Liste des types MIME vidéo ciblés à l'aide des chaînes de types MIME publiées par l'IANA (https://www.iana.org/assignments/media-types/media-types.xhtml). Si ce champ est vide, l'inventaire sera ciblé quel que soit le type MIME de la vidéo.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

Facultatif. Durée maximale ciblée de l'annonce vidéo. Si ce paramètre n'est pas défini, l'inventaire sera ciblé quelle que soit la durée maximale de l'annonce vidéo.

includedPositionTypes[]

enum (PositionType)

Facultatif. Types de positions d'annonces vidéo ciblés. Si ce champ est vide, l'inventaire sera ciblé quel que soit le type de position de l'annonce vidéo.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

Facultatif. Mode de diffusion de la vidéo ciblée. Si cette option n'est pas définie, l'inventaire sera ciblé quelle que soit la méthode de diffusion de la vidéo.

plcmtTargeting

object (VideoPlcmtTargeting)

Facultatif. Types d'emplacements vidéo ciblés. Si cette option n'est pas définie, l'inventaire sera ciblé quel que soit le type de plcmt vidéo.

includedPlaybackMethods[]

enum (PlaybackMethod)

Facultatif. Liste des méthodes de lecture vidéo ciblées. Si ce champ est vide, l'inventaire sera ciblé quelle que soit la méthode de lecture de la vidéo.

minimumPredictedCompletionRatePercentage

string (int64 format)

Facultatif. Pourcentage du taux minimal prévu de lecture complète ciblé.

Cette valeur doit être un multiple de 10 compris entre 10 et 90 (inclus). Par exemple, 10 est valide, mais pas 0, 15 et 100. Une valeur de 10 signifie que la configuration ne correspondra qu'aux espaces publicitaires pour lesquels nous prévoyons un taux de lecture complète d'au moins 10 %.

Une valeur non définie indique que l'inventaire sera ciblé quel que soit le taux de lecture complète prévu.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

Facultatif. Taille du lecteur vidéo ciblé. Si cette valeur n'est pas définie, l'inventaire sera ciblé quelle que soit la taille du lecteur vidéo.

VideoMimeType

Types MIME de vidéo à cibler.

Enums
VIDEO_MIME_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
VIDEO_MIME_TYPE_THREEGPP Format de conteneur 3GPP utilisé sur les téléphones 3G.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 Conteneur MPEG-4, généralement avec le codec H.264.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (utilisé pour les annonces VPAID).
VIDEO_MIME_TYPE_WEBM Conteneur WebM supposant le codec VP9.

MaximumVideoAdDuration

Limite supérieure de la durée de la création d'annonce vidéo à cibler. Les valeurs d'énumération définissent des buckets. Sélectionner une valeur signifie que la durée de la création doit être inférieure ou égale à la durée spécifiée.

Enums
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS S'applique aux annonces vidéo d'une durée maximale de 15 secondes (0 < durée <= 15 s).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS S'applique aux annonces vidéo d'une durée maximale de 20 secondes (0 < durée <= 20 s).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS S'applique aux annonces vidéo d'une durée maximale de 30 secondes (0 < durée <= 30 s).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS S'applique aux annonces vidéo d'une durée maximale de 60 secondes (0 < durée <= 60 s).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS S'applique aux annonces vidéo d'une durée maximale de 90 secondes (0 < durée <= 90 s).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS S'applique aux annonces vidéo d'une durée maximale de 120 secondes (0 < durée <= 120 s).

PositionType

Position de l'annonce dans une vidéo, qui peut être ciblée.

Enums
POSITION_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
POSITION_TYPE_MIDROLL L'annonce est diffusée au milieu du contenu vidéo.
POSITION_TYPE_POSTROLL L'annonce est diffusée après le contenu vidéo.
POSITION_TYPE_PREROLL L'annonce est diffusée avant le contenu vidéo.

ContentDeliveryMethod

Critères de ciblage basés sur la méthode de diffusion du contenu vidéo.

Enums
CONTENT_DELIVERY_METHOD_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
CONTENT_DELIVERY_METHOD_STREAMING Cible les contenus vidéo diffusés en direct.
CONTENT_DELIVERY_METHOD_PROGRESSIVE Cible le contenu vidéo transféré de manière incrémentielle en fonction des besoins de lecture du client.

VideoPlcmtTargeting

Définit des critères de ciblage en fonction du type d'emplacement vidéo, correspondant souvent au champ "plcmt" d'OpenRTB de l'IAB.

Représentation JSON
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Champs
selectionType

enum (SelectionType)

Obligatoire. Type de sélection pour la liste des emplacements vidéo.

videoPlcmtTypes[]

enum (VideoPlcmtType)

Obligatoire. Liste des types d'emplacements vidéo ciblés. Si ce champ est vide, l'inventaire sera ciblé quel que soit le type de plcmt vidéo.

SelectionType

Énumération des types de sélection possibles utilisés par les dimensions de ciblage.

Enums
SELECTION_TYPE_UNSPECIFIED Type de sélection non spécifié. Ne doit pas être utilisée.
SELECTION_TYPE_INCLUDE Les valeurs de la dimension de ciblage sont incluses.
SELECTION_TYPE_EXCLUDE Les valeurs de la dimension de ciblage sont exclues.

VideoPlcmtType

Représente le type d'emplacement vidéo, conformément aux normes OpenRTB.

Enums
VIDEO_PLCMT_TYPE_UNSPECIFIED Valeur par défaut. Ne doit pas être utilisé dans les spécifications de ciblage.
INSTREAM Annonces pré-roll, mid-roll et post-roll diffusées avant, pendant ou après le contenu vidéo en streaming demandé par l'utilisateur. Le son des vidéos InStream doit être activé par défaut au démarrage du lecteur, ou l'utilisateur doit avoir explicitement indiqué son intention de regarder le contenu vidéo. Même si d'autres contenus peuvent entourer le lecteur, le contenu vidéo doit être l'objectif principal de la visite de l'utilisateur. Il doit rester le contenu principal de la page et le seul lecteur vidéo visible capable de diffuser du son pendant la lecture. Si le lecteur devient flottant/fixe, les appels d'annonce suivants doivent refléter précisément la nouvelle taille du lecteur.
ACCOMPANYING_CONTENT Annonces pré-roll, mid-roll et post-roll diffusées avant, pendant ou après un contenu vidéo en streaming. Le lecteur vidéo se charge et lit l'annonce avant, entre ou après des paragraphes de texte ou de contenu graphique, et ne commence à la lire que lorsqu'elle entre dans la fenêtre d'affichage. La lecture du contenu associé ne doit commencer que lorsqu'il entre dans la fenêtre d'affichage. Il peut se transformer en lecteur flottant/fixe lorsqu'il défile hors de la page.
INTERSTITIAL Annonces vidéo diffusées sans contenu vidéo. Pendant la lecture, elle doit constituer l'objet principal de la page, occuper la majeure partie de la fenêtre d'affichage et ne pas pouvoir être masquée par défilement. Il peut s'agir d'emplacements tels que des vidéos ou des diaporamas dans l'application.
NO_CONTENT Annonces vidéo diffusées sans contenu vidéo en streaming. Il peut s'agir d'emplacements tels que des diaporamas, des flux natifs, des annonces intégrées au contenu ou des annonces fixes/flottantes.

PlaybackMethod

Méthode de lecture à cibler.

Enums
PLAYBACK_METHOD_UNSPECIFIED Mode de lecture de la vidéo non spécifié. Ne doit pas être utilisée.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON La lecture démarre automatiquement lorsque la page ou le contenu se charge.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF La lecture démarre automatiquement lorsque la page ou le contenu se charge, mais sans le son.
PLAYBACK_METHOD_CLICK_TO_PLAY La lecture est lancée par une action de l'utilisateur (par exemple, un clic sur un bouton de lecture).

VideoPlayerSizeTargeting

Représente la taille du lecteur vidéo pouvant être ciblé. La largeur et la hauteur doivent être définies sur des valeurs non nulles.

Représentation JSON
{
  "minimumWidth": string,
  "minimumHeight": string
}
Champs
minimumWidth

string (int64 format)

Obligatoire. Largeur minimale du lecteur vidéo en pixels.

minimumHeight

string (int64 format)

Obligatoire. Hauteur minimale du lecteur vidéo en pixels.

StringTargetingDimension

Ciblage générique avec des valeurs de chaîne.

Représentation JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Champs
selectionType

enum (SelectionType)

Obligatoire. Mode de ciblage des éléments de cette liste.

values[]

string

Obligatoire. Les valeurs spécifiées.

AdSize

Représente la taille d'un seul espace publicitaire ou d'une création.

Représentation JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Champs
width

string (int64 format)

Largeur de l'espace publicitaire en pixels. Ce champ n'est présent que lorsque le type de taille est PIXEL.

height

string (int64 format)

Hauteur de l'espace publicitaire en pixels. Ce champ n'est présent que lorsque le type de taille est PIXEL.

type

enum (Type)

Type de taille de l'espace publicitaire.

Type

Représente différents types de dimensionnement d'espace publicitaire/de création.

Enums
TYPE_UNSPECIFIED Espace réservé pour un type de taille non défini.
PIXEL Espace publicitaire dont la taille est spécifiée par la hauteur et la largeur en pixels.
INTERSTITIAL Taille spéciale pour décrire un espace d'annonce interstitielle.
NATIVE Annonces natives (mobiles) affichées par l'éditeur.
FLUID La taille fluide (taille responsive) peut être redimensionnée automatiquement en fonction de l'environnement extérieur.

CriteriaTargeting

Ciblage générique utilisé pour cibler des dimensions contenant une liste d'ID numériques inclus et exclus. Il ne peut pas être filtré à l'aide de la syntaxe de filtre de liste.

Représentation JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Champs
targetedCriteriaIds[]

string (int64 format)

Liste des ID numériques à inclure.

excludedCriteriaIds[]

string (int64 format)

Liste d'ID numériques à exclure.

PackagePlacementTargeting

Représente le ciblage des emplacements où les annonces peuvent être diffusées, par exemple sur certains sites ou dans certaines applications mobiles. Les différents types de ciblage par emplacements seront combinés à l'aide de l'opérateur logique OU.

Représentation JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Champs
uriTargeting

object (StringTargetingDimension)

Facultatif. Liste des URL ciblées ou exclues. Les domaines ne doivent pas inclure http/https (par exemple, google.com) et peuvent contenir un maximum de cinq chemins d'accès par URL.

mobileAppTargeting

object (StringTargetingDimension)

Facultatif. Liste des ID d'applications mobiles ciblés ou exclus appartenant aux éditeurs. Actuellement, seules les applications Android et Apple sont compatibles.

L'ID d'application Android (par exemple, com.google.android.apps.maps) se trouve dans l'URL du Google Play Store. L'ID d'application iOS (qui est un nombre) se trouve à la fin de l'URL de l'iTunes Store. Les applications mobiles propriétaires sont incluses ou exclues.

includedMobileAppCategoryTargeting[]

string (int64 format)

Facultatif. Liste des catégories d'applications mobiles ciblées.

PackagePublisherProvidedSignalsTargeting

Représente le ciblage des signaux fournis par l'éditeur. Les différents types de signaux fournis par l'éditeur seront combinés à l'aide de l'opérateur logique OU.

Représentation JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Champs
audienceTargeting

object (TaxonomyTargeting)

Facultatif. Liste des ID d'audience ciblés ou exclus. Basé sur la version 1.1 de la taxonomie d'audience de l'IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

Facultatif. Liste des ID Content ID ciblés ou exclus. Basé sur la version 2.2 de la taxonomie de contenu de l'IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

Facultatif. Liste des ID de signaux vidéo et audio ciblés et exclus. Il s'agit de signaux supplémentaires compatibles avec les signaux fournis par l'éditeur.

TaxonomyTargeting

Définit les critères de ciblage pour gérer l'espace d'ID de taxonomie d'audience et de contenu de l'IAB.

Représentation JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Champs
targetedTaxonomyIds[]

string

Facultatif. Liste des ID de taxonomie de contenu ciblés.

excludedTaxonomyIds[]

string

Facultatif. Liste des ID de taxonomie de contenu exclus.

CurationFeeVisibility

La visibilité des frais combinés du package de curation et des frais du segment de données (frais de curation totaux). Les frais sont toujours visibles par le créateur du package.

Enums
CURATION_FEE_VISIBILITY_UNSPECIFIED La visibilité des frais de curation totaux n'est pas spécifiée.
DISCLOSED Le montant total des frais de curation est visible par tous les acheteurs. Il s'agit de la valeur par défaut si aucune valeur n'est définie.
NON_DISCLOSED Les frais de curation totaux ne sont pas visibles par tous les acheteurs.

Méthodes

activate

Active un package sélectionné existant.

create

Crée un package sélectionné.

deactivate

Désactive un package organisé existant.

get

Récupère un package organisé en fonction de son nom de ressource.

list

Répertorie les packages sélectionnés appartenant au curateur spécifié.

patch

Met à jour un package organisé existant.