REST Resource: targetingTypes.targetingOptions

L'

Ressource : TargetingOption

Représente une option de ciblage unique, qui est un concept ciblable 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)
  },
  "contentThemeDetails": {
    object (ContentThemeTargetingOptionDetails)
  },
  "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 ressource de 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 de détails peut être renseigné, et il doit correspondre à targeting_type. details ne peut correspondre qu'à l'un des éléments suivants :
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Détails des libellés de contenu numérique.

sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

Détails sur les catégories sensibles.

contentThemeDetails

object (ContentThemeTargetingOptionDetails)

Détails sur les thèmes de contenu.

appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Informations sur la catégorie d'application.

onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Détails sur la position outstream du contenu.

contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Détails sur la position du contenu dans le flux.

videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

Informations sur la taille du lecteur vidéo.

ageRangeDetails

object (AgeRangeTargetingOptionDetails)

Détails de la tranche d'âge.

parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

Informations sur le statut parental.

userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

Détails du contenu avec récompense pour l'utilisateur.

householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

Informations sur les revenus du foyer.

genderDetails

object (GenderTargetingOptionDetails)

Informations sur le genre.

deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

Détails 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)

Détails des ressources du système d'exploitation.

deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

Détails de la ressource sur la marque et le modèle de l'appareil.

viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Détails des ressources de visibilité.

categoryDetails

object (CategoryTargetingOptionDetails)

Détails de la ressource de catégorie.

languageDetails

object (LanguageTargetingOptionDetails)

Détails de la ressource linguistique.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

Détails sur la ressource de statut de vendeur autorisé.

geoRegionDetails

object (GeoRegionTargetingOptionDetails)

Détails sur la ressource de région géographique.

exchangeDetails

object (ExchangeTargetingOptionDetails)

Détails de l'échange.

subExchangeDetails

object (SubExchangeTargetingOptionDetails)

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

poiDetails

object (PoiTargetingOptionDetails)

Détails de la ressource de point d'intérêt.

businessChainDetails

object (BusinessChainTargetingOptionDetails)

Détails de la ressource de 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)

Détails 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 de libellé de contenu numérique pouvant être ciblé. Ce champ sera renseigné dans le champ digitalContentLabelDetails de TargetingOption lorsque targetingType est défini sur TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

enum (ContentRatingTier)

Uniquement en sortie. Énumération pour les niveaux de brand safety des libellés de contenu.

SensitiveCategoryTargetingOptionDetails

Représente une catégorie sensible ciblable. Ce champ sera renseigné dans le champ sensitiveCategoryDetails de TargetingOption lorsque targetingType est défini sur 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 catégorie sensible DV360.

ContentThemeTargetingOptionDetails

Représente un thème de contenu ciblable. Ce champ sera renseigné dans le champ contentThemeDetails de TargetingOption lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Représentation JSON
{
  "contentTheme": enum (ContentTheme)
}
Champs
contentTheme

enum (ContentTheme)

Uniquement en sortie. Énumération pour le classificateur de contenu de thème de contenu DV360.

AppCategoryTargetingOptionDetails

Représente une collection d'applications ciblables. Une collection vous permet de cibler des groupes dynamiques d'applications associées gérés par la plate-forme, par exemple All Apps/Google Play/Games. Ce champ sera renseigné dans le champ appCategoryDetails lorsque targetingType est défini sur 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 à l'écran pouvant être ciblée, qui peut être utilisée par les annonces display et vidéo. Ce champ sera renseigné dans le champ onScreenPositionDetails lorsque targetingType est défini sur 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 OutStream de contenu ciblable, qui peut être utilisée par les annonces display et vidéo. Ce champ sera renseigné dans le champ contentOutstreamPositionDetails lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

enum (ContentOutstreamPosition)

Uniquement en sortie. Position du contenu outstream.

ContentInstreamPositionTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

Uniquement en sortie. Position du contenu instream.

VideoPlayerSizeTargetingOptionDetails

Représente une taille de lecteur vidéo ciblable. Ce champ sera renseigné dans le champ videoPlayerSizeDetails lorsque targetingType est défini sur 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 sera renseigné dans le champ ageRangeDetails lorsque targetingType est défini sur 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 champ sera renseigné dans le champ parentalStatusDetails d'un TargetingOption lorsque targetingType est défini sur 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 un état de contenu avec récompense pour les utilisateurs pouvant être ciblés, uniquement pour les annonces vidéo. Ce champ sera renseigné dans le champ userRewardedContentDetails lorsque targetingType est défini sur 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 ciblable. Ce champ sera renseigné dans le champ householdIncomeDetails d'un TargetingOption lorsque targetingType est défini sur 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 pouvant être ciblé. Ce champ sera renseigné dans le champ genderDetails d'un TargetingOption lorsque targetingType est défini sur 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 pouvant être ciblé. Ce champ sera renseigné dans le champ deviceTypeDetails d'un TargetingOption lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_TYPE.

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

enum (DeviceType)

Uniquement en sortie. Type d'appareil à cibler.

BrowserTargetingOptionDetails

Représente un navigateur pouvant être ciblé. Ce champ sera renseigné dans le champ browserDetails lorsque targetingType est défini sur 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 ciblable. Ce champ sera renseigné dans le champ carrierAndIspDetails d'un TargetingOption lorsque targetingType est défini sur TARGETING_TYPE_CARRIER_AND_ISP.

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

string

Uniquement en sortie. Nom à afficher de l'opérateur ou du FAI.

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 ciblable. Ce champ sera renseigné dans le champ environmentDetails d'un TargetingOption lorsque targetingType est défini sur 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 champ sera renseigné dans le champ operatingSystemDetails d'un TargetingOption lorsque targetingType est défini sur 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 ciblables. Ce champ sera renseigné dans le champ deviceMakeModelDetails d'un TargetingOption lorsque targetingType est défini sur 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 champ sera renseigné dans le champ viewabilityDetails d'un TargetingOption lorsque targetingType est défini sur TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

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

CategoryTargetingOptionDetails

Représente une catégorie ciblable. Ce champ sera renseigné dans le champ categoryDetails d'un TargetingOption lorsque targetingType est défini sur 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 sera renseigné dans le champ languageDetails lorsque targetingType est défini sur 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 un état de vendeur autorisé pouvant être ciblé. Ce champ sera renseigné dans le champ authorizedSellerStatusDetails lorsque targetingType est défini sur 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 ciblable. Ce champ sera renseigné dans le champ geoRegionDetails lorsque targetingType est défini sur 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 de région géographique.

ExchangeTargetingOptionDetails

Représente une place de marché ciblable. Ce champ sera renseigné dans le champ exchangeDetails d'un TargetingOption lorsque targetingType est défini sur 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 d'échange pouvant être ciblée. Ce champ sera renseigné dans le champ subExchangeDetails d'un TargetingOption lorsque targetingType est défini sur TARGETING_TYPE_SUB_EXCHANGE.

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

string

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

PoiTargetingOptionDetails

Représente un point d'intérêt(POI) ciblable. Ce champ sera renseigné dans le champ poiDetails lorsque targetingType est défini sur TARGETING_TYPE_POI.

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

number

Uniquement en sortie. Latitude du point d'intérêt, arrondie à la sixième décimale.

longitude

number

Uniquement en sortie. Longitude du point d'intérêt, arrondie à la sixième décimale.

displayName

string

Uniquement en sortie. Nom à afficher d'un point d'intérêt(par exemple, "Times Square", "Space Needle"), suivi de son adresse complète si elle est disponible.

BusinessChainTargetingOptionDetails

Représente une chaîne d'établissements ciblable dans une région géographique. Ce champ sera renseigné dans le champ businessChainDetails lorsque targetingType est défini sur 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 une durée de contenu ciblable. Ce champ sera renseigné dans le champ contentDurationDetails lorsque targetingType est défini sur 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 sera renseigné dans le champ contentStreamTypeDetails lorsque targetingType est défini sur 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 sera renseigné dans le champ nativeContentPositionDetails lorsque targetingType est défini sur 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 activé pour Open Measurement et pouvant être ciblé. Ce champ sera renseigné dans le champ omidDetails lorsque targetingType est défini sur 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 ciblable. Ce champ sera renseigné dans le champ audioContentTypeDetails lorsque targetingType est défini sur 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 sera renseigné dans le champ contentGenreDetails lorsque targetingType est défini sur 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 fournis.