REST Resource: targetingTypes.targetingOptions

Ressource: TargetingOption

Représente une seule option de ciblage, qui est un concept cible dans DV360.

Représentation JSON
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // Union field details can be only one of the following:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Champs
name

string

Uniquement en sortie. Nom de la ressource pour cette option de ciblage.

targetingOptionId

string

Uniquement en sortie. Identifiant unique de cette option de ciblage. Le tuple {targetingType, targetingOptionId} sera unique.

targetingType

enum (TargetingType)

Uniquement en sortie. Type de cette option de ciblage.

Champ d'union details. Informations détaillées sur les options de ciblage. Un seul champ des détails peut être renseigné, et il doit correspondre à targeting_type. details ne peut être qu'un des éléments suivants:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Informations sur les libellés de contenu numérique

sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

Informations sur la catégorie sensible.

appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Informations sur la catégorie d'applications

onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Détails de la position à l'écran.

contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Détails de la position du contenu dans le flux externe.

contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Détails de la position du contenu dans la vidéo

videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

Informations sur la taille du lecteur vidéo.

ageRangeDetails

object (AgeRangeTargetingOptionDetails)

Informations sur la tranche d'âge.

parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

Informations sur le statut parental.

userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

Informations sur le contenu avec récompense pour l'utilisateur.

householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

Informations détaillées sur les revenus du foyer

genderDetails

object (GenderTargetingOptionDetails)

Informations sur le genre

deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

Informations sur le type d'appareil.

browserDetails

object (BrowserTargetingOptionDetails)

Informations sur le navigateur.

carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

Informations sur l'opérateur et le FAI.

environmentDetails

object (EnvironmentTargetingOptionDetails)

Détails de l'environnement.

operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

Informations sur les ressources du système d'exploitation.

deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

Informations sur la ressource de la marque et du modèle de l'appareil.

viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Détails de la ressource de visibilité.

categoryDetails

object (CategoryTargetingOptionDetails)

Détails de la ressource de catégorie.

languageDetails

object (LanguageTargetingOptionDetails)

Informations sur les ressources linguistiques.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

Informations sur la ressource d'état du vendeur autorisé.

geoRegionDetails

object (GeoRegionTargetingOptionDetails)

Informations sur les ressources de la région géographique.

exchangeDetails

object (ExchangeTargetingOptionDetails)

Détails de la place de marché.

subExchangeDetails

object (SubExchangeTargetingOptionDetails)

Détails de la sous-place de marché.

poiDetails

object (PoiTargetingOptionDetails)

Détails de la ressource POI.

businessChainDetails

object (BusinessChainTargetingOptionDetails)

Détails de la ressource de la chaîne d'établissements.

contentDurationDetails

object (ContentDurationTargetingOptionDetails)

Détails de la ressource de durée du contenu.

contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

Détails de la ressource de type de flux de contenu.

nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

Informations sur la position du contenu natif.

omidDetails

object (OmidTargetingOptionDetails)

Détails de l'inventaire activé pour Open Measurement.

audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

Informations sur le type de contenu audio.

contentGenreDetails

object (ContentGenreTargetingOptionDetails)

Détails de la ressource de genre de contenu.

DigitalContentLabelTargetingOptionDetails

Représente un niveau de classification des libellés de contenu numérique pouvant être ciblé. Ce paramètre sera renseigné dans le champ digitalContentLabelDetails de TargetingOption lorsque targetingType est TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Représentation JSON
{
  "contentRatingTier": enum (ContentRatingTier)
}
Champs
contentRatingTier

enum (ContentRatingTier)

Uniquement en sortie. Enumération des niveaux de brand safety des libellés de contenu.

SensitiveCategoryTargetingOptionDetails

Représente une catégorie sensible ciblable. Ce paramètre sera renseigné dans le champ sensitiveCategoryDetails de TargetingOption lorsque targetingType est TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Représentation JSON
{
  "sensitiveCategory": enum (SensitiveCategory)
}
Champs
sensitiveCategory

enum (SensitiveCategory)

Uniquement en sortie. Énumération pour le classificateur de contenu de la catégorie "Contenu sensible" DV360.

AppCategoryTargetingOptionDetails

Représente une collection d'applications ciblables. Une collection vous permet de cibler des groupes dynamiques d'applications associées gérées par la plate-forme, par exemple All Apps/Google Play/Games. Ce champ est renseigné dans le champ appCategoryDetails lorsque targetingType est TARGETING_TYPE_APP_CATEGORY.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom de la collection d'applications.

OnScreenPositionTargetingOptionDetails

Représente une position cible à l'écran, qui peut être utilisée par les annonces display et vidéo. Ce champ est renseigné dans le champ onScreenPositionDetails lorsque targetingType est TARGETING_TYPE_ON_SCREEN_POSITION.

Représentation JSON
{
  "onScreenPosition": enum (OnScreenPosition)
}
Champs
onScreenPosition

enum (OnScreenPosition)

Uniquement en sortie. Position à l'écran.

ContentOutstreamPositionTargetingOptionDetails

Représente une position de contenu OutStream ciblable, qui peut être utilisée par les annonces display et vidéo. Ce champ est renseigné dans le champ contentOutstreamPositionDetails lorsque targetingType est TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Représentation JSON
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
Champs
contentOutstreamPosition

enum (ContentOutstreamPosition)

Uniquement en sortie. Position du contenu dans le flux externe.

ContentInstreamPositionTargetingOptionDetails

Représente une position InStream de contenu ciblable, qui peut être utilisée par les annonces vidéo et audio. Ce champ est renseigné dans le champ contentInstreamPositionDetails lorsque targetingType est TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Représentation JSON
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
Champs
contentInstreamPosition

enum (ContentInstreamPosition)

Uniquement en sortie. Position du contenu dans le flux.

VideoPlayerSizeTargetingOptionDetails

Représente une taille de lecteur vidéo cible. Ce champ est renseigné dans le champ videoPlayerSizeDetails lorsque targetingType est TARGETING_TYPE_VIDEO_PLAYER_SIZE.

Représentation JSON
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Champs
videoPlayerSize

enum (VideoPlayerSize)

Uniquement en sortie. Taille du lecteur vidéo.

AgeRangeTargetingOptionDetails

Représente une tranche d'âge ciblable. Ce champ est renseigné dans le champ ageRangeDetails lorsque targetingType est TARGETING_TYPE_AGE_RANGE.

Représentation JSON
{
  "ageRange": enum (AgeRange)
}
Champs
ageRange

enum (AgeRange)

Uniquement en sortie. Tranche d'âge d'une audience.

ParentalStatusTargetingOptionDetails

Représente un statut parental pouvant être ciblé. Ce paramètre sera renseigné dans le champ parentalStatusDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_PARENTAL_STATUS.

Représentation JSON
{
  "parentalStatus": enum (ParentalStatus)
}
Champs
parentalStatus

enum (ParentalStatus)

Uniquement en sortie. Statut parental d'une audience.

UserRewardedContentTargetingOptionDetails

Représente l'état du contenu avec récompense utilisateur ciblable pour les annonces vidéo uniquement. Ce champ est renseigné dans le champ userRewardedContentDetails lorsque targetingType est TARGETING_TYPE_USER_REWARDED_CONTENT.

Représentation JSON
{
  "userRewardedContent": enum (UserRewardedContent)
}
Champs
userRewardedContent

enum (UserRewardedContent)

Uniquement en sortie. État du contenu avec récompense pour l'utilisateur pour les annonces vidéo.

HouseholdIncomeTargetingOptionDetails

Représente un revenu du foyer pouvant être ciblé. Ce paramètre sera renseigné dans le champ householdIncomeDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_HOUSEHOLD_INCOME.

Représentation JSON
{
  "householdIncome": enum (HouseholdIncome)
}
Champs
householdIncome

enum (HouseholdIncome)

Uniquement en sortie. Revenus du foyer d'une audience.

GenderTargetingOptionDetails

Représente un genre cible. Ce paramètre sera renseigné dans le champ genderDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_GENDER.

Représentation JSON
{
  "gender": enum (Gender)
}
Champs
gender

enum (Gender)

Uniquement en sortie. Genre d'une audience.

DeviceTypeTargetingOptionDetails

Représente un type d'appareil cible. Ce paramètre sera renseigné dans le champ deviceTypeDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_DEVICE_TYPE.

Représentation JSON
{
  "deviceType": enum (DeviceType)
}
Champs
deviceType

enum (DeviceType)

Uniquement en sortie. Type d'appareil ciblé.

BrowserTargetingOptionDetails

Représente un navigateur pouvant être ciblé. Ce champ est renseigné dans le champ browserDetails lorsque targetingType est TARGETING_TYPE_BROWSER.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher du navigateur.

CarrierAndIspTargetingOptionDetails

Représente un opérateur ou un FAI pouvant être ciblé. Ce paramètre sera renseigné dans le champ carrierAndIspDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_CARRIER_AND_ISP.

Représentation JSON
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher du transporteur ou de l'ISP.

type

enum (CarrierAndIspType)

Uniquement en sortie. Type indiquant s'il s'agit d'un opérateur ou d'un FAI.

CarrierAndIspType

Type de CarrierAndIspTargetingOption.

Enums
CARRIER_AND_ISP_TYPE_UNSPECIFIED Valeur par défaut lorsque le type n'est pas spécifié ou est inconnu dans cette version.
CARRIER_AND_ISP_TYPE_ISP Indique que cette ressource de ciblage fait référence à un FAI.
CARRIER_AND_ISP_TYPE_CARRIER Indique que cette ressource de ciblage fait référence à un opérateur mobile.

EnvironmentTargetingOptionDetails

Représente un environnement cible. Ce paramètre sera renseigné dans le champ environmentDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_ENVIRONMENT.

Représentation JSON
{
  "environment": enum (Environment)
}
Champs
environment

enum (Environment)

Uniquement en sortie. Environnement de diffusion.

OperatingSystemTargetingOptionDetails

Représente un système d'exploitation ciblable. Ce paramètre sera renseigné dans le champ operatingSystemDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_OPERATING_SYSTEM.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher du système d'exploitation.

DeviceMakeModelTargetingOptionDetails

Représente une marque et un modèle d'appareil pouvant être ciblés. Ce paramètre sera renseigné dans le champ deviceMakeModelDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_DEVICE_MAKE_MODEL.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher de la marque et du modèle de l'appareil.

ViewabilityTargetingOptionDetails

Représente une visibilité ciblable. Ce paramètre sera renseigné dans le champ viewabilityDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_VIEWABILITY.

Représentation JSON
{
  "viewability": enum (Viewability)
}
Champs
viewability

enum (Viewability)

Uniquement en sortie. Pourcentage de visibilité prévu.

CategoryTargetingOptionDetails

Représente une catégorie cible. Ce paramètre sera renseigné dans le champ categoryDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_CATEGORY.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher de la catégorie.

LanguageTargetingOptionDetails

Représente une langue pouvant être ciblée. Ce champ est renseigné dans le champ languageDetails lorsque targetingType est TARGETING_TYPE_LANGUAGE.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher de la langue (par exemple, "français").

AuthorizedSellerStatusTargetingOptionDetails

Représente l'état d'un vendeur autorisé pouvant être ciblé. Ce champ est renseigné dans le champ authorizedSellerStatusDetails lorsque targetingType est TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Représentation JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
Champs
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Uniquement en sortie. État du vendeur autorisé.

GeoRegionTargetingOptionDetails

Représente une région géographique pouvant être ciblée. Ce champ est renseigné dans le champ geoRegionDetails lorsque targetingType est TARGETING_TYPE_GEO_REGION.

Représentation JSON
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher de la région géographique (par exemple, "Ontario, Canada").

geoRegionType

enum (GeoRegionType)

Uniquement en sortie. Type de ciblage par région géographique.

ExchangeTargetingOptionDetails

Représente une place de marché ciblable. Ce paramètre sera renseigné dans le champ exchangeDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_EXCHANGE.

Représentation JSON
{
  "exchange": enum (Exchange)
}
Champs
exchange

enum (Exchange)

Uniquement en sortie. Type d'échange.

SubExchangeTargetingOptionDetails

Représente une sous-place de marché ciblable. Ce paramètre sera renseigné dans le champ subExchangeDetails d'une TargetingOption lorsque targetingType est TARGETING_TYPE_SUB_EXCHANGE.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher de la place de marché secondaire.

PoiTargetingOptionDetails

Représente un point d'intérêt(POI) pouvant être ciblé. Ce champ est renseigné dans le champ poiDetails lorsque targetingType est TARGETING_TYPE_POI.

Représentation JSON
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
Champs
latitude

number

Uniquement en sortie. Latitude du POI arrondie à la 6e décimale.

longitude

number

Uniquement en sortie. Longitude du POI arrondie à la 6e décimale.

displayName

string

Uniquement en sortie. Nom à afficher d'un POI(par exemple, "Times Square", "Space Needle"), suivi de son adresse complète, le cas échéant.

BusinessChainTargetingOptionDetails

Représente une chaîne d'établissements ciblable dans une région géographique. Ce champ est renseigné dans le champ businessChainDetails lorsque targetingType est TARGETING_TYPE_BUSINESS_CHAIN.

Représentation JSON
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
Champs
businessChain

string

Uniquement en sortie. Nom à afficher de la chaîne d'établissements, par exemple "KFC" ou "Chase Bank".

geoRegion

string

Uniquement en sortie. Nom à afficher de la région géographique (par exemple, "Ontario, Canada").

geoRegionType

enum (GeoRegionType)

Uniquement en sortie. Type de région géographique.

ContentDurationTargetingOptionDetails

Représente la durée d'un contenu ciblable. Ce champ est renseigné dans le champ contentDurationDetails lorsque targetingType est TARGETING_TYPE_CONTENT_DURATION.

Représentation JSON
{
  "contentDuration": enum (ContentDuration)
}
Champs
contentDuration

enum (ContentDuration)

Uniquement en sortie. Durée du contenu.

ContentStreamTypeTargetingOptionDetails

Représente un type de flux de contenu ciblable. Ce champ est renseigné dans le champ contentStreamTypeDetails lorsque targetingType est TARGETING_TYPE_CONTENT_STREAM_TYPE.

Représentation JSON
{
  "contentStreamType": enum (ContentStreamType)
}
Champs
contentStreamType

enum (ContentStreamType)

Uniquement en sortie. Type de flux de contenu.

NativeContentPositionTargetingOptionDetails

Représente une position de contenu natif ciblable. Ce champ est renseigné dans le champ nativeContentPositionDetails lorsque targetingType est TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Représentation JSON
{
  "contentPosition": enum (NativeContentPosition)
}
Champs
contentPosition

enum (NativeContentPosition)

Uniquement en sortie. Position du contenu.

OmidTargetingOptionDetails

Représente un type d'inventaire Open Measurement activé pour le ciblage. Ce champ est renseigné dans le champ omidDetails lorsque targetingType est TARGETING_TYPE_OMID.

Représentation JSON
{
  "omid": enum (Omid)
}
Champs
omid

enum (Omid)

Uniquement en sortie. Type d'inventaire activé pour Open Measurement.

AudioContentTypeTargetingOptionDetails

Représente un type de contenu audio pouvant être ciblé. Ce champ est renseigné dans le champ audioContentTypeDetails lorsque targetingType est TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Représentation JSON
{
  "audioContentType": enum (AudioContentType)
}
Champs
audioContentType

enum (AudioContentType)

Uniquement en sortie. Type de contenu audio.

ContentGenreTargetingOptionDetails

Représente un genre de contenu ciblable. Ce champ est renseigné dans le champ contentGenreDetails lorsque targetingType est TARGETING_TYPE_CONTENT_GENRE.

Représentation JSON
{
  "displayName": string
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher du genre de contenu

Méthodes

get

Récupère une seule option de ciblage.

list

Liste les options de ciblage d'un type donné.
Recherche des options de ciblage d'un type donné en fonction des termes de recherche donnés.