REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Ressource : AssignedTargetingOption

Option de ciblage attribuée unique, qui définit l'état d'une option de ciblage pour une entité avec des paramètres de ciblage.

Représentation JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  },
  "lookalikeAudienceDetails": {
    object (LookalikeAudienceAssignedTargetingOptionDetails)
  },
  "googleAudienceDetails": {
    object (GoogleAudienceAssignedTargetingOptionDetails)
  },
  "customListDetails": {
    object (CustomListAssignedTargetingOptionDetails)
  },
  "combinedAudienceDetails": {
    object (CombinedAudienceAssignedTargetingOptionDetails)
  },
  "firstPartyAndPartnerAudienceDetails": {
    object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Champs
name

string

Uniquement en sortie. Nom de ressource de cette option de ciblage attribuée.

assignedTargetingOptionId

string

Uniquement en sortie. Identifiant unique de l'option de ciblage attribuée. L'ID n'est unique que pour une ressource et un type de ciblage donnés. Il peut être réutilisé dans d'autres contextes.

assignedTargetingOptionIdAlias

string

Uniquement en sortie. Alias de assignedTargetingOptionId. Cette valeur peut être utilisée à la place de assignedTargetingOptionId lors de la récupération ou de la suppression d'un ciblage existant.

Ce champ ne sera accepté que pour toutes les options de ciblage attribuées des types de ciblage suivants :

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Ce champ est également compatible avec les options de ciblage attribuées aux éléments de campagne des types de ciblage suivants :

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Uniquement en sortie. Identifie le type de cette option de ciblage attribuée.

inheritance

enum (Inheritance)

Uniquement en sortie. État d'héritage de l'option de ciblage attribuée.

Informations détaillées sur l'option de ciblage attribuée. Un seul champ de détails peut être renseigné, et il doit correspondre à targeting_type. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Informations sur la chaîne. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Informations sur la catégorie d'applications. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Informations sur l'application. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Détails de l'URL. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Détails du jour et de l'heure. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Détails de la tranche d'âge. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Détails de la liste de zones géographiques régionales. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Détails de la liste de lieux à proximité. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Informations sur le genre. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Informations sur la taille du lecteur vidéo. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Détails du contenu avec récompense pour l'utilisateur. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Informations sur le statut parental. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Détails de la position InStream du contenu. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Détails de la position outstream du contenu. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Détails du type d'appareil. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Détails du ciblage d'audience. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_AUDIENCE_GROUP. Vous ne pouvez cibler qu'une seule option de groupe d'audience par ressource.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Informations sur le navigateur. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Informations sur les revenus du foyer. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Détails de la position à l'écran. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Informations sur l'opérateur et le FAI. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Détails du mot clé. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_KEYWORD.

Vous pouvez attribuer jusqu'à 5 000 mots clés à exclure directs à une ressource. Aucune limite ne s'applique au nombre de mots clés à inclure pouvant être attribués.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Détails du mot clé. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Vous pouvez attribuer jusqu'à quatre listes de mots clés à exclure à une ressource.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Détails des systèmes d'exploitation. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Informations sur la marque et le modèle de l'appareil. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Détails de l'environnement. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Détails de la source d'inventaire. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_INVENTORY_SOURCE_DEAL.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Détails de la catégorie. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CATEGORY.

Si vous ciblez une catégorie, vous ciblez également ses sous-catégories. Si une catégorie est exclue du ciblage et qu'une sous-catégorie est incluse, l'exclusion prévaut.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Détails de la visibilité. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_VIEWABILITY.

Vous ne pouvez cibler qu'une seule option de visibilité par ressource.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Détails de l'état du vendeur autorisé. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Vous ne pouvez cibler qu'une seule option d'état de vendeur autorisé par ressource.

Si une ressource ne dispose pas d'une option d'état de vendeur autorisé, tous les vendeurs autorisés indiqués comme DIRECT ou RESELLER dans le fichier ads.txt sont ciblés par défaut.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Informations sur la langue. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Informations sur la région géographique. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Détails du groupe de sources d'inventaire. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Détails du libellé de contenu numérique. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Les libellés de contenu numérique sont des exclusions de ciblage. Les exclusions de libellés de contenu numérique au niveau de l'annonceur, si elles sont définies, sont toujours appliquées lors de la diffusion (même si elles ne sont pas visibles dans les paramètres de la ressource). Les paramètres de ressource peuvent exclure des libellés de contenu en plus des exclusions d'annonceurs, mais ne peuvent pas les remplacer. Un élément de campagne ne sera pas diffusé si tous les libellés de contenu numérique sont exclus.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Détails de la catégorie sensible. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Les catégories sensibles sont des exclusions de ciblage. Les exclusions de catégories sensibles au niveau de l'annonceur, si elles sont définies, sont toujours appliquées lors de la diffusion (même si elles ne sont pas visibles dans les paramètres de la ressource). Les paramètres de ressource peuvent exclure des catégories sensibles en plus des exclusions d'annonceurs, mais ne peuvent pas les remplacer.

contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

Détails du thème de contenu. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Les thèmes de contenu sont des exclusions de ciblage. Les exclusions de thèmes de contenu au niveau de l'annonceur, si elles sont définies, sont toujours appliquées lors de la diffusion (même si elles ne sont pas visibles dans les paramètres de la ressource). Les paramètres de ressource peuvent exclure un thème de contenu en plus des exclusions de l'annonceur.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Détails de l'échange. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Détails de la sous-place de marché. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Détails de la validation tierce. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Détails du POI. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Détails de la chaîne d'établissements. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Détails sur la durée du contenu. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Détails sur la durée du contenu. Ce champ est renseigné lorsque le TargetingType est TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Détails de la position du contenu natif. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Détails de l'inventaire compatible avec Open Measurement. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Détails du type de contenu audio. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Détails du genre de contenu. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_GENRE.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Informations sur la vidéo YouTube. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Informations sur la chaîne YouTube. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Détails de la position de la session. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_SESSION_POSITION.

lookalikeAudienceDetails

object (LookalikeAudienceAssignedTargetingOptionDetails)

Détails de l'audience similaire. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_LOOKALIKE_AUDIENCE.

googleAudienceDetails

object (GoogleAudienceAssignedTargetingOptionDetails)

Détails de l'audience Google. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_GOOGLE_AUDIENCE.

customListDetails

object (CustomListAssignedTargetingOptionDetails)

Détails de la liste personnalisée. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_CUSTOM_LIST.

combinedAudienceDetails

object (CombinedAudienceAssignedTargetingOptionDetails)

Informations sur l'audience combinée. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_COMBINED_AUDIENCE.

firstPartyAndPartnerAudienceDetails

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

Détails des audiences propriétaires et partenaires. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.

auctionPackageDetails

object (AuctionPackageAssignedTargetingOptionDetails)

Détails du package d'enchères. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_AUCTION_PACKAGE.

youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

Informations sur le pack de chaînes YouTube. Ce champ est renseigné lorsque targetingType est défini sur TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

Fin des champs mutuellement exclusifs.

ChannelAssignedTargetingOptionDetails

Détails de l'option de ciblage par canal attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_CHANNEL.

Représentation JSON
{
  "channelId": string,
  "negative": boolean
}
Champs
channelId

string (int64 format)

Obligatoire. ID de la chaîne. Doit faire référence au champ d'ID de la chaîne sur une ressource de chaîne appartenant au partenaire ou de chaîne appartenant à l'annonceur.

negative

boolean

Indique si cette option est ciblée par exclusion. Pour l'option de ciblage attribuée au niveau de l'annonceur, ce champ doit être défini sur "true".

AppCategoryAssignedTargetingOptionDetails

Détails de l'option de ciblage par catégorie d'application attribuée. Ce champ sera renseigné dans le champ appCategoryDetails d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_APP_CATEGORY.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Indique si cette option est ciblée par exclusion.

AppAssignedTargetingOptionDetails

Détails de l'option de ciblage d'application attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_APP.

Représentation JSON
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Champs
appId

string

Obligatoire. ID de l'application.

L'application Play Store d'Android utilise l'ID du bundle, par exemple com.google.android.gm. L'ID d'application de l'App Store d'Apple utilise une chaîne de neuf chiffres, par exemple 422689480.

displayName

string

Uniquement en sortie. Nom à afficher de l'application.

negative

boolean

Indique si cette option est ciblée par exclusion.

appPlatform

enum (AppPlatform)

Indique la plate-forme de l'application ciblée. Si ce champ n'est pas spécifié, la plate-forme de l'application est considérée comme mobile (c'est-à-dire, Android ou iOS), et nous déduirons la plate-forme mobile appropriée à partir de l'ID d'application.

AppPlatform

Options de ciblage possibles par plate-forme d'application.

Enums
APP_PLATFORM_UNSPECIFIED Valeur par défaut lorsque la plate-forme de l'application n'est pas spécifiée dans cette version. Cet énumérateur est un espace réservé pour la valeur par défaut et ne représente pas une option de plate-forme réelle.
APP_PLATFORM_IOS La plate-forme de l'application est iOS.
APP_PLATFORM_ANDROID La plate-forme de l'application est Android.
APP_PLATFORM_ROKU La plate-forme de l'application est Roku.
APP_PLATFORM_AMAZON_FIRETV La plate-forme de l'application est Amazon FireTV.
APP_PLATFORM_PLAYSTATION La plate-forme de l'application est PlayStation.
APP_PLATFORM_APPLE_TV La plate-forme de l'application est Apple TV.
APP_PLATFORM_XBOX La plate-forme de l'application est Xbox.
APP_PLATFORM_SAMSUNG_TV La plate-forme de l'application est Samsung TV.
APP_PLATFORM_ANDROID_TV La plate-forme de l'application est Android TV.
APP_PLATFORM_GENERIC_CTV La plate-forme d'application est une plate-forme de TV connectée qui n'est pas explicitement listée ailleurs.
APP_PLATFORM_LG_TV La plate-forme de l'application est LG TV.
APP_PLATFORM_VIZIO_TV La plate-forme de l'application est VIZIO TV.
APP_PLATFORM_VIDAA La plate-forme de l'application est Vidaa.

UrlAssignedTargetingOptionDetails

Détails de l'option de ciblage par URL attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_URL.

Représentation JSON
{
  "url": string,
  "negative": boolean
}
Champs
url

string

Obligatoire. L'URL, par exemple example.com.

DV360 accepte deux niveaux de ciblage par sous-répertoire (par exemple, www.example.com/one-subdirectory-level/second-level) et cinq niveaux de ciblage par sous-domaine (par exemple, five.four.three.two.one.example.com).

negative

boolean

Indique si cette option est ciblée par exclusion.

DayAndTimeAssignedTargetingOptionDetails

Représentation d'un segment de temps défini pour un jour spécifique de la semaine, avec une heure de début et une heure de fin. L'heure représentée par startHour doit être antérieure à l'heure représentée par endHour.

Représentation JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Champs
dayOfWeek

enum (DayOfWeek)

Obligatoire. Jour de la semaine pour ce paramètre de ciblage par jour et heure.

startHour

integer

Obligatoire. Heure de début pour le ciblage par jour et par heure. Doit être compris entre 0 (début de la journée) et 23 (une heure avant la fin de la journée).

endHour

integer

Obligatoire. Heure de fin pour le ciblage par jour et heure. La valeur doit être comprise entre 1 (une heure après le début de la journée) et 24 (fin de la journée).

timeZoneResolution

enum (TimeZoneResolution)

Obligatoire. Mécanisme utilisé pour déterminer le fuseau horaire à utiliser pour ce paramètre de ciblage par jour et heure.

Pour les éléments de campagne Demand Gen, ce champ est toujours défini sur TIME_ZONE_RESOLUTION_ADVERTISER.

DayOfWeek

Représente un jour de la semaine.

Enums
DAY_OF_WEEK_UNSPECIFIED Le jour de la semaine n'est pas spécifié.
MONDAY Lundi
TUESDAY Mardi
WEDNESDAY Mercredi
THURSDAY Jeudi
FRIDAY Vendredi
SATURDAY Samedi
SUNDAY Dimanche

TimeZoneResolution

Approches possibles pour résoudre le problème de fuseau horaire.

Enums
TIME_ZONE_RESOLUTION_UNSPECIFIED La résolution du fuseau horaire n'est pas spécifiée ou est inconnue.
TIME_ZONE_RESOLUTION_END_USER Les heures sont indiquées dans le fuseau horaire de l'utilisateur qui a vu l'annonce.
TIME_ZONE_RESOLUTION_ADVERTISER Les heures sont indiquées dans le fuseau horaire de l'annonceur qui a diffusé l'annonce.

AgeRangeAssignedTargetingOptionDetails

Représente une tranche d'âge pouvant être ciblée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

Obligatoire. Tranche d'âge d'une audience. Vous ne pouvez cibler qu'une tranche d'âge continue d'une audience. Ainsi, la tranche d'âge représentée dans ce champ peut être 1) ciblée exclusivement ou 2) faire partie d'une tranche d'âge continue plus large. Vous pouvez élargir la couverture d'un ciblage par tranche d'âge continue en ciblant également une audience d'âge inconnu.

RegionalLocationListAssignedTargetingOptionDetails

Informations de ciblage pour la liste de zones géographiques régionales. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_REGIONAL_LOCATION_LIST.

Représentation JSON
{
  "regionalLocationListId": string,
  "negative": boolean
}
Champs
regionalLocationListId

string (int64 format)

Obligatoire. ID de la liste de zones géographiques régionales. Doit faire référence au champ locationListId d'une ressource LocationList dont le type est TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Indique si cette option est ciblée par exclusion.

ProximityLocationListAssignedTargetingOptionDetails

Informations de ciblage pour la liste de lieux à proximité. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

Représentation JSON
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Champs
proximityLocationListId

string (int64 format)

Obligatoire. ID de la liste de lieux à proximité. Doit faire référence au champ locationListId d'une ressource LocationList dont le type est TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadius

number

Obligatoire. Rayon exprimé dans les unités de distance définies dans proximityRadiusUnit. Il s'agit de la taille de la zone à cibler autour d'un lieu choisi. Le rayon doit être compris entre 1 et 500 miles ou 800 kilomètres.

proximityRadiusUnit

enum (ProximityRadiusUnit)

Obligatoire. Unités de distance du rayon.

ProximityRadiusUnit

Énumération des unités de distance pour ProximityRadius.

Enums
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Valeur par défaut lorsque les unités de distance ne sont pas spécifiées dans cette version. Cet énum est un espace réservé pour la valeur par défaut et ne représente pas une unité de distance réelle.
PROXIMITY_RADIUS_UNIT_MILES Unité de distance du rayon en miles.
PROXIMITY_RADIUS_UNIT_KILOMETERS Unité de distance du rayon en kilomètres

GenderAssignedTargetingOptionDetails

Détails de l'option de ciblage par genre attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_GENDER.

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

enum (Gender)

Obligatoire. Genre de l'audience.

VideoPlayerSizeAssignedTargetingOptionDetails

Détails de l'option de ciblage par taille du lecteur vidéo. Cette valeur sera renseignée dans le champ videoPlayerSizeDetails lorsque targetingType sera défini sur TARGETING_TYPE_VIDEO_PLAYER_SIZE. Le ciblage explicite de toutes les options n'est pas possible. Pour ce faire, supprimez toutes les options de ciblage par taille du lecteur vidéo.

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

enum (VideoPlayerSize)

Obligatoire. Taille du lecteur vidéo.

UserRewardedContentAssignedTargetingOptionDetails

Détails de l'option de ciblage de contenus avec récompense pour l'utilisateur. Cette valeur sera renseignée dans le champ userRewardedContentDetails lorsque targetingType sera défini sur TARGETING_TYPE_USER_REWARDED_CONTENT.

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

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_USER_REWARDED_CONTENT.

userRewardedContent

enum (UserRewardedContent)

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

ParentalStatusAssignedTargetingOptionDetails

Détails de l'option de ciblage par statut parental attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

Obligatoire. Statut parental de l'audience.

ContentInstreamPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage de la position InStream du contenu attribué. Cette valeur sera renseignée dans le champ contentInstreamPositionDetails lorsque targetingType sera défini sur TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

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

enum (ContentInstreamPosition)

Obligatoire. Position du contenu InStream pour les annonces vidéo ou audio.

adType

enum (AdType)

Uniquement en sortie. Type d'annonce à cibler. Cette option ne s'applique qu'au ciblage des ordres d'insertion. Les nouveaux éléments de campagne compatibles avec le type d'annonce spécifié hériteront de cette option de ciblage par défaut. Valeurs possibles :

  • AD_TYPE_VIDEO : le paramètre sera hérité par le nouvel élément de campagne lorsque lineItemType est défini sur LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO : le paramètre sera hérité par le nouvel élément de campagne lorsque lineItemType est défini sur LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Représente le type de création associé aux annonces.

Enums
AD_TYPE_UNSPECIFIED Le type d'annonce n'est pas spécifié ou est inconnu dans cette version.
AD_TYPE_DISPLAY Créations display (par exemple, image et HTML5)
AD_TYPE_VIDEO Créations vidéo, par exemple des annonces vidéo diffusées pendant la lecture de contenus en streaming dans des lecteurs vidéo.
AD_TYPE_AUDIO Créations audio, par exemple des annonces audio diffusées pendant un contenu audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage de la position outstream du contenu attribué. Cette valeur sera renseignée dans le champ contentOutstreamPositionDetails lorsque targetingType sera défini sur TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

enum (ContentOutstreamPosition)

Obligatoire. Position du contenu OutStream.

adType

enum (AdType)

Uniquement en sortie. Type d'annonce à cibler. Cette option ne s'applique qu'au ciblage des ordres d'insertion. Les nouveaux éléments de campagne compatibles avec le type d'annonce spécifié hériteront de cette option de ciblage par défaut. Valeurs possibles :

  • AD_TYPE_DISPLAY : le paramètre sera hérité par le nouvel élément de campagne lorsque lineItemType est défini sur LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO : le paramètre sera hérité par le nouvel élément de campagne lorsque lineItemType est défini sur LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Détails du ciblage par type d'appareil. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_TYPE.

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

enum (DeviceType)

Obligatoire. Nom à afficher du type d'appareil.

youtubeAndPartnersBidMultiplier

number

Uniquement en sortie. Le multiplicateur d'enchères vous permet de diffuser vos annonces plus ou moins fréquemment en fonction du type d'appareil. Il applique un multiplicateur au prix de l'enchère d'origine. Lorsque ce champ est défini sur 0, cela indique qu'il n'est pas applicable, au lieu de multiplier le prix de l'enchère d'origine par 0.

Par exemple, si le prix de l'enchère sans multiplicateur est de 10 € et que le multiplicateur est de 1,5 pour les tablettes, le prix de l'enchère pour les tablettes sera de 15 €.

S'applique uniquement aux éléments de campagne YouTube et partenaires.

AudienceGroupAssignedTargetingOptionDetails

Détails de l'option de ciblage par groupe d'audience attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_AUDIENCE_GROUP. La relation entre chaque groupe est UNION, à l'exception de excludedFirstAndThirdPartyAudienceGroup et excludedGoogleAudienceGroup, dont COMPLEMENT est utilisé comme INTERSECTION avec d'autres groupes.

Représentation JSON
{
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedFirstPartyAndPartnerAudienceGroups": [
    {
      object (FirstPartyAndPartnerAudienceGroup)
    }
  ],
  "excludedFirstPartyAndPartnerAudienceGroup": {
    object (FirstPartyAndPartnerAudienceGroup)
  }
}
Champs
includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Facultatif. ID d'audience Google du groupe d'audience Google inclus. Contient uniquement des ID d'audience Google.

includedCustomListGroup

object (CustomListGroup)

Facultatif. ID de liste personnalisée du groupe de listes personnalisées inclus. Contient uniquement des ID de listes personnalisées.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Facultatif. ID des audiences combinées du groupe d'audiences combinées inclus. Contient uniquement des ID d'audience combinée.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Facultatif. Identifiants des audiences Google du groupe d'audiences Google exclu. Utilisé pour le ciblage par exclusion. Le COMPLÉMENT de l'UNION de ce groupe et d'autres groupes d'audience exclus est utilisé comme INTERSECTION pour tout ciblage d'audience positif. Ne contient que les audiences Google de type "Affinité", "Sur le marché" et "Applis installées". Tous les éléments sont logiquement liés par l'opérateur "OU".

includedFirstPartyAndPartnerAudienceGroups[]

object (FirstPartyAndPartnerAudienceGroup)

Facultatif. ID et récence des audiences propriétaires et partenaires des groupes d'audience propriétaires et partenaires inclus. Chaque groupe d'audiences propriétaires et partenaires ne contient que des ID d'audiences propriétaires et partenaires. La relation entre chaque groupe d'audience propriétaire et partenaire est INTERSECTION, et le résultat est associé à d'autres groupes d'audience à l'aide de l'opérateur UNION. Les groupes répétés avec les mêmes paramètres seront ignorés.

excludedFirstPartyAndPartnerAudienceGroup

object (FirstPartyAndPartnerAudienceGroup)

Facultatif. ID et récence des audiences propriétaires et partenaires du groupe d'audiences propriétaires et partenaires exclu. Utilisé pour le ciblage par exclusion. Le COMPLÉMENT de l'UNION de ce groupe et d'autres groupes d'audience exclus est utilisé comme INTERSECTION pour tout ciblage d'audience positif. Tous les éléments sont logiquement liés par l'opérateur "OU".

GoogleAudienceGroup

Détails du groupe d'audience Google. Tous les paramètres de ciblage d'audience Google sont logiquement "OU" les uns des autres.

Représentation JSON
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Champs
settings[]

object (GoogleAudienceTargetingSetting)

Obligatoire. Tous les paramètres de ciblage d'audience Google dans le groupe d'audiences Google. Les paramètres répétés avec le même ID seront ignorés.

GoogleAudienceTargetingSetting

Détails du paramètre de ciblage d'audience Google.

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

string (int64 format)

Obligatoire. ID de l'audience Google du paramètre de ciblage d'audience Google. Cet ID est googleAudienceId.

CustomListGroup

Détails du groupe de listes de clients. Tous les paramètres de ciblage des listes personnalisées sont logiquement liés par l'opérateur "OU".

Représentation JSON
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Champs
settings[]

object (CustomListTargetingSetting)

Obligatoire. Tous les paramètres de ciblage par liste personnalisée dans le groupe de listes personnalisées. Les paramètres répétés avec le même ID seront ignorés.

CustomListTargetingSetting

Détails du paramètre de ciblage par liste personnalisée.

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

string (int64 format)

Obligatoire. ID personnalisé du paramètre de ciblage par liste personnalisée. Cet ID est customListId.

CombinedAudienceGroup

Détails du groupe d'audience combinée. Tous les paramètres de ciblage d'audience combinée sont logiquement liés par l'opérateur "OU".

Représentation JSON
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Champs
settings[]

object (CombinedAudienceTargetingSetting)

Obligatoire. Tous les paramètres de ciblage d'audience combinée dans le groupe d'audience combinée. Les paramètres répétés avec le même ID seront ignorés. Le nombre de paramètres d'audience combinée ne doit pas dépasser cinq. Sinon, une erreur sera générée.

CombinedAudienceTargetingSetting

Détails du paramètre de ciblage d'audience combinée.

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

string (int64 format)

Obligatoire. ID d'audience combinée du paramètre de ciblage d'audience combinée. Cet ID est combinedAudienceId.

FirstPartyAndPartnerAudienceGroup

Détails du groupe d'audiences propriétaires et partenaires. Tous les paramètres de ciblage d'audience propriétaires et partenaires sont logiquement associés par l'opérateur "OR".

Représentation JSON
{
  "settings": [
    {
      object (FirstPartyAndPartnerAudienceTargetingSetting)
    }
  ]
}
Champs
settings[]

object (FirstPartyAndPartnerAudienceTargetingSetting)

Obligatoire. Tous les paramètres de ciblage d'audience propriétaire et partenaire dans le groupe d'audience propriétaire et partenaire. Les paramètres répétés avec le même ID ne sont pas autorisés.

FirstPartyAndPartnerAudienceTargetingSetting

Détails du paramètre de ciblage d'audience propriétaire et partenaire.

Représentation JSON
{
  "firstPartyAndPartnerAudienceId": string,
  "recency": enum (Recency)
}
Champs
firstPartyAndPartnerAudienceId

string (int64 format)

Obligatoire. ID d'audience propriétaire et partenaire du paramètre de ciblage d'audience propriétaire et partenaire. Cet ID est firstPartyAndPartnerAudienceId.

recency

enum (Recency)

Obligatoire. Récence du paramètre de ciblage d'audience propriétaire et partenaire. S'applique uniquement aux audiences propriétaires. Sinon, cette option sera ignorée. Pour en savoir plus, consultez https://support.google.com/displayvideo/answer/2949947#recency. Si aucune valeur n'est spécifiée, aucune limite de récence ne sera utilisée.

Récence

Toutes les valeurs de récence d'audience propriétaires et partenaires acceptées.

Enums
RECENCY_NO_LIMIT Aucune limite de récence.
RECENCY_1_MINUTE La récence est d'une minute.
RECENCY_5_MINUTES La récence est de 5 minutes.
RECENCY_10_MINUTES La récence est de 10 minutes.
RECENCY_15_MINUTES La récence est de 15 minutes.
RECENCY_30_MINUTES La récence est de 30 minutes.
RECENCY_1_HOUR La récence est d'une heure.
RECENCY_2_HOURS La récence est de deux heures.
RECENCY_3_HOURS La récence est de trois heures.
RECENCY_6_HOURS La récence est de six heures.
RECENCY_12_HOURS La récence est de 12 heures.
RECENCY_1_DAY La récence est de 1 jour.
RECENCY_2_DAYS La récence est de deux jours.
RECENCY_3_DAYS La récence est de trois jours.
RECENCY_5_DAYS La récence est de cinq jours.
RECENCY_7_DAYS La récence est de sept jours.
RECENCY_10_DAYS La récence est de 10 jours.
RECENCY_14_DAYS La récence est de 14 jours.
RECENCY_15_DAYS La récence est de 15 jours.
RECENCY_21_DAYS La récence est de 21 jours.
RECENCY_28_DAYS La récence est de 28 jours.
RECENCY_30_DAYS La récence est de 30 jours.
RECENCY_40_DAYS La récence est de 40 jours.
RECENCY_45_DAYS La récence est de 45 jours.
RECENCY_60_DAYS La récence est de 60 jours.
RECENCY_90_DAYS La récence est de 90 jours.
RECENCY_120_DAYS La récence est de 120 jours.
RECENCY_180_DAYS La récence est de 180 jours.
RECENCY_270_DAYS La récence est de 270 jours.
RECENCY_365_DAYS La récence est de 365 jours.

BrowserAssignedTargetingOptionDetails

Détails de l'option de ciblage par navigateur attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_BROWSER.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

Uniquement en sortie. Nom à afficher du navigateur.

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_BROWSER.

negative

boolean

Indique si cette option est ciblée par exclusion. Toutes les options de ciblage par navigateur attribuées à la même ressource doivent avoir la même valeur pour ce champ.

HouseholdIncomeAssignedTargetingOptionDetails

Détails de l'option de ciblage par revenus du foyer attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Obligatoire. Revenus du foyer de l'audience.

OnScreenPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage par position à l'écran. Cette valeur sera renseignée dans le champ onScreenPositionDetails lorsque targetingType sera défini sur TARGETING_TYPE_ON_SCREEN_POSITION.

Représentation JSON
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
Champs
targetingOptionId

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Uniquement en sortie. La position à l'écran.

adType

enum (AdType)

Uniquement en sortie. Type d'annonce à cibler. Cette option ne s'applique qu'au ciblage des ordres d'insertion. Les nouveaux éléments de campagne compatibles avec le type d'annonce spécifié hériteront de cette option de ciblage par défaut. Valeurs possibles :

  • AD_TYPE_DISPLAY : le paramètre sera hérité par le nouvel élément de campagne lorsque lineItemType est défini sur LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO : le paramètre sera hérité par le nouvel élément de campagne lorsque lineItemType est défini sur LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Détails de l'option de ciblage par opérateur et FAI attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_CARRIER_AND_ISP.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Indique si cette option est ciblée par exclusion. Toutes les options de ciblage par opérateur et par FAI attribuées à la même ressource doivent avoir la même valeur pour ce champ.

KeywordAssignedTargetingOptionDetails

Détails de l'option de ciblage par mots clés attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_KEYWORD.

Représentation JSON
{
  "keyword": string,
  "negative": boolean,
  "exemptedPolicyNames": [
    string
  ]
}
Champs
keyword

string

Obligatoire. Le mot clé, par exemple car insurance.

Un mot clé à inclure ne peut pas être un mot choquant. Doit être encodé en UTF-8 et ne pas dépasser 255 octets. Le nombre maximal de caractères est de 80. Le nombre maximal de mots est de 10.

negative

boolean

Indique si cette option est ciblée par exclusion.

exemptedPolicyNames[]

string

Facultatif. Noms des règles dont le mot clé doit être exempté.

Si vous essayez de cibler un mot clé qui ne respecte pas une règle, l'erreur renvoyée inclura le nom de la règle concernée. Utilisez ce nom dans ce champ pour exempter le mot clé ciblé de la règle.

Ce champ ne s'applique qu'aux mots clés ciblés positivement attribués aux ressources Demand Gen.

NegativeKeywordListAssignedTargetingOptionDetails

Détails du ciblage pour la liste de mots clés à exclure. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

string (int64 format)

Obligatoire. ID de la liste de mots clés à exclure. Doit faire référence au champ negativeKeywordListId d'une ressource NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Détails de l'option de ciblage par système d'exploitation attribuée. Cette valeur sera renseignée dans le champ operatingSystemDetails lorsque targetingType sera défini sur TARGETING_TYPE_OPERATING_SYSTEM.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. ID de l'option de ciblage renseigné dans le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Indique si cette option est ciblée par exclusion.

DeviceMakeModelAssignedTargetingOptionDetails

Détails de l'option de ciblage par marque et modèle d'appareil attribuée. Cette valeur sera renseignée dans le champ deviceMakeModelDetails lorsque targetingType sera défini sur TARGETING_TYPE_DEVICE_MAKE_MODEL.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Indique si cette option est ciblée par exclusion.

EnvironmentAssignedTargetingOptionDetails

Détails de l'option de ciblage par environnement attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

Obligatoire. L'environnement de diffusion.

InventorySourceAssignedTargetingOptionDetails

Informations de ciblage pour la source d'inventaire. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_INVENTORY_SOURCE_DEAL.

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

string (int64 format)

Obligatoire. ID de la source d'inventaire. Doit faire référence au champ inventorySourceId d'une ressource InventorySource.

CategoryAssignedTargetingOptionDetails

Détails de l'option de ciblage par catégorie attribuée. Cette valeur sera renseignée dans le champ categoryDetails lorsque targetingType sera défini sur TARGETING_TYPE_CATEGORY.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CATEGORY.

negative

boolean

Indique si cette option est ciblée par exclusion.

ViewabilityAssignedTargetingOptionDetails

Détails de l'option de ciblage en fonction de la visibilité attribuée. Ce champ sera renseigné dans le champ viewabilityDetails d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

Obligatoire. Pourcentage de visibilité prévue.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Représente l'état d'un vendeur autorisé attribué. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Si aucune option de ciblage TARGETING_TYPE_AUTHORIZED_SELLER_STATUS n'est attribuée à une ressource, l'option "Vendeurs directs et revendeurs autorisés" est utilisée.

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

enum (AuthorizedSellerStatus)

Uniquement en sortie. État du vendeur autorisé à cibler.

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Détails de l'option de ciblage linguistique attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_LANGUAGE.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_LANGUAGE.

negative

boolean

Indique si cette option est ciblée par exclusion. Toutes les options de ciblage linguistique attribuées à la même ressource doivent avoir la même valeur pour ce champ.

GeoRegionAssignedTargetingOptionDetails

Détails de l'option de ciblage géographique attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_GEO_REGION.

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

string

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

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

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

negative

boolean

Indique si cette option est ciblée par exclusion.

InventorySourceGroupAssignedTargetingOptionDetails

Détails du ciblage pour le groupe de sources d'inventaire. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

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

string (int64 format)

Obligatoire. ID du groupe de sources d'inventaire. Doit faire référence au champ inventorySourceGroupId d'une ressource InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Détails du ciblage pour le libellé de contenu numérique. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

enum (ContentRatingTier)

Obligatoire. Nom à afficher du niveau de classification du libellé de contenu numérique à EXCLURE.

Ce champ n'accepte que la valeur CONTENT_RATING_TIER_UNRATED.

SensitiveCategoryAssignedTargetingOptionDetails

Détails du ciblage pour la catégorie sensible. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

enum (SensitiveCategory)

Obligatoire. Énumération pour le contenu de la catégorie sensible Display & Video 360 classé comme EXCLU.

Ce champ n'accepte que les valeurs suivantes :

  • SENSITIVE_CATEGORY_EMBEDDED_VIDEO
  • SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

ContentThemeAssignedTargetingOptionDetails

Détails du ciblage par thème de contenu. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Représentation JSON
{
  "excludedTargetingOptionId": string,
  "contentTheme": enum (ContentTheme),
  "excludedContentTheme": enum (ContentTheme)
}
Champs
excludedTargetingOptionId

string

Obligatoire. ID du thème de contenu à EXCLURE.

contentTheme

enum (ContentTheme)

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

excludedContentTheme

enum (ContentTheme)

Obligatoire. Énumération du thème de contenu DV360 classé comme EXCLU.

ExchangeAssignedTargetingOptionDetails

Détails de l'option de ciblage d'échange attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_EXCHANGE.

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

enum (Exchange)

Obligatoire. Valeur d'énumération de l'échange.

SubExchangeAssignedTargetingOptionDetails

Détails de l'option de ciblage de sous-place de marché attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_SUB_EXCHANGE.

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

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Détails de l'option de ciblage par vérificateur tiers attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Représentation JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  },
  "peer39": {
    object (Peer39)
  }
  // End of mutually exclusive fields.
}
Champs
Vous pouvez cibler une organisation de validation tierce pour appliquer des seuils de brand safety aux impressions. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
doubleVerify

object (DoubleVerify)

Vérificateur de marque tiers : DoubleVerify.

integralAdScience

object (IntegralAdScience)

Vérificateur de marque tiers : Integral Ad Science.

peer39

object (Peer39)

Vérificateur de marque tiers : Peer39.

Fin des champs mutuellement exclusifs.

DoubleVerify

Détails des paramètres DoubleVerify.

Représentation JSON
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Champs
brandSafetyCategories

object (BrandSafetyCategories)

Contrôles de brand safety DV.

avoidedAgeRatings[]

enum (AgeRating)

Évitez d'enchérir sur des applications en fonction de leur classification par âge.

appStarRating

object (AppStarRating)

Évitez d'enchérir sur des applications en fonction de leur note.

displayViewability

object (DisplayViewability)

Paramètres de visibilité display (applicables uniquement aux éléments de campagne display).

videoViewability

object (VideoViewability)

Paramètres de visibilité des vidéos (applicables uniquement aux éléments de campagne vidéo).

fraudInvalidTraffic

object (FraudInvalidTraffic)

Éviter les sites et les applications dont le taux historique de trafic frauduleux et incorrect est de :

customSegmentId

string (int64 format)

ID de segment personnalisé fourni par DoubleVerify. L'ID doit commencer par "51" et comporter huit chiffres. L'ID de segment personnalisé ne peut pas être spécifié avec l'un des champs suivants :

BrandSafetyCategories

Paramètres des contrôles de brand safety.

Représentation JSON
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Champs
avoidUnknownBrandSafetyCategory

boolean

Inconnu ou non évaluable.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Catégories de brand safety à éviter (gravité élevée).

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Catégories de blocage de niveau de gravité moyen pour la brand safety.

HighSeverityCategory

Options possibles pour les catégories de gravité élevée.

Enums
HIGHER_SEVERITY_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune catégorie de gravité élevée.
ADULT_CONTENT_PORNOGRAPHY Contenu réservé aux adultes : pornographie, sujets pour adultes et nudité.
COPYRIGHT_INFRINGEMENT Atteinte aux droits d'auteur.
SUBSTANCE_ABUSE Drogues/Alcools/Substances réglementées : abus de substances.
GRAPHIC_VIOLENCE_WEAPONS Violence extrême/Violence explicite/Armes.
HATE_PROFANITY Incitation à la haine/Langage grossier.
CRIMINAL_SKILLS Activités illégales : criminalité.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Trafic incité/Logiciels malveillants/Encombrement publicitaire.

MediumSeverityCategory

Options possibles pour les catégories de gravité moyenne.

Enums
MEDIUM_SEVERITY_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune catégorie de gravité moyenne.
AD_SERVERS Ad servers.
ADULT_CONTENT_SWIMSUIT Contenu réservé aux adultes : maillots de bain.
ALTERNATIVE_LIFESTYLES Sujets controversés : modes de vie alternatifs.
CELEBRITY_GOSSIP Sujets controversés : actualités people.
GAMBLING Sujets controversés : jeux d'argent et de hasard.
OCCULT Sujets controversés : sciences occultes.
SEX_EDUCATION Sujets controversés : éducation sexuelle.
DISASTER_AVIATION Catastrophe : aviation.
DISASTER_MAN_MADE Catastrophe : d'origine humaine.
DISASTER_NATURAL Catastrophe : naturelle.
DISASTER_TERRORIST_EVENTS Catastrophe : événements terroristes.
DISASTER_VEHICLE Catastrophe : véhicule.
ALCOHOL Drogues/Alcools/Substances réglementées : alcool.
SMOKING Drogues/Alcools/Substances réglementées : tabac.
NEGATIVE_NEWS_FINANCIAL Mauvaises nouvelles : finance.
NON_ENGLISH Contenu non standard : non rédigé en anglais.
PARKING_PAGE Contenu non standard : page parking.
UNMODERATED_UGC Contenu non modéré généré par les utilisateurs : forums, images et vidéos.
INFLAMMATORY_POLITICS_AND_NEWS Sujets controversés : sujets d'actualité et politiques sulfureux.
NEGATIVE_NEWS_PHARMACEUTICAL Mauvaises nouvelles : industrie pharmaceutique.

AgeRating

Options possibles pour les classifications par âge.

Enums
AGE_RATING_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de classification par âge.
APP_AGE_RATE_UNKNOWN Applications avec classification par âge inconnue.
APP_AGE_RATE_4_PLUS Applications tous publics (4 ans et plus).
APP_AGE_RATE_9_PLUS Applications tous publics (9 ans et plus).
APP_AGE_RATE_12_PLUS Applications pour adolescents (12 ans et plus).
APP_AGE_RATE_17_PLUS Applications réservées à un public averti (17 ans et plus).
APP_AGE_RATE_18_PLUS Applications réservées aux adultes (18 ans et plus).

AppStarRating

Détails des paramètres des avis DoubleVerify.

Représentation JSON
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Champs
avoidedStarRating

enum (StarRating)

Évitez d'enchérir sur des applications en fonction de leur note.

avoidInsufficientStarRating

boolean

Évitez d'enchérir sur des applications dont la note est insuffisante.

StarRating

Options possibles pour les notes.

Enums
APP_STAR_RATE_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de note d'application.
APP_STAR_RATE_1_POINT_5_LESS Applications officielles dont la note est inférieure ou égale à 1,5 étoile.
APP_STAR_RATE_2_LESS Applications officielles dont la note est inférieure ou égale à 2 étoiles.
APP_STAR_RATE_2_POINT_5_LESS Applications officielles dont la note est inférieure ou égale à 2,5 étoiles.
APP_STAR_RATE_3_LESS Applications officielles dont la note est inférieure ou égale à 3 étoiles.
APP_STAR_RATE_3_POINT_5_LESS Applications officielles dont la note est inférieure ou égale à 3,5 étoiles.
APP_STAR_RATE_4_LESS Applications officielles dont la note est inférieure ou égale à 4 étoiles.
APP_STAR_RATE_4_POINT_5_LESS Applications officielles dont la note est inférieure ou égale à 4,5 étoiles.

DisplayViewability

Détails des paramètres de visibilité DoubleVerify pour le Réseau Display.

Représentation JSON
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Champs
iab

enum (IAB)

Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB.

viewableDuring

enum (ViewableDuring)

Cibler l'inventaire Web et d'application pour maximiser la durée de visionnage à 100 %.

IAB

Options possibles pour le taux visible IAB.

Enums
IAB_VIEWED_RATE_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de taux de visibilité IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Ciblez l'inventaire Web et d'application pour maximiser le taux visible IAB (80% ou plus).
IAB_VIEWED_RATE_75_PERCENT_HIGHER Ciblez l'inventaire Web et d'application pour maximiser le taux visible IAB (75% ou plus).
IAB_VIEWED_RATE_70_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (70% ou plus).
IAB_VIEWED_RATE_65_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (65% ou plus).
IAB_VIEWED_RATE_60_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (60% ou plus).
IAB_VIEWED_RATE_55_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (55% ou plus).
IAB_VIEWED_RATE_50_PERCENT_HIGHER Ciblez l'inventaire Web et d'application pour maximiser le taux visible IAB de 50% ou plus.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (40% ou plus).
IAB_VIEWED_RATE_30_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (30% ou plus).

ViewableDuring

Options possibles pour la durée de visibilité.

Enums
AVERAGE_VIEW_DURATION_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de durée moyenne de visionnage.
AVERAGE_VIEW_DURATION_5_SEC Cibler l'inventaire Web et d'application pour maximiser la durée de visionnage à 100% pendant au moins cinq secondes.
AVERAGE_VIEW_DURATION_10_SEC Cibler l'inventaire Web et d'application pour maximiser la durée de visionnage à 100% pendant 10 secondes ou plus.
AVERAGE_VIEW_DURATION_15_SEC Cibler l'inventaire Web et d'application pour maximiser la durée de visionnage à 100 % (15 secondes ou plus).

VideoViewability

Détails des paramètres de visibilité des vidéos DoubleVerify.

Représentation JSON
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Champs
videoIab

enum (VideoIAB)

Cibler l'inventaire Web pour maximiser le taux visible IAB.

videoViewableRate

enum (VideoViewableRate)

Cibler l'inventaire Web pour maximiser le taux de visionnage complet.

playerImpressionRate

enum (PlayerImpressionRate)

Ciblez l'inventaire pour maximiser les impressions avec une taille de lecteur de 400 x 300 ou plus.

VideoIAB

Options possibles pour le taux visible IAB.

Enums
VIDEO_IAB_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de taux visible IAB pour les vidéos.
IAB_VIEWABILITY_80_PERCENT_HIGHER Ciblez l'inventaire Web et d'application pour maximiser le taux visible IAB (80% ou plus).
IAB_VIEWABILITY_75_PERCENT_HIGHER Ciblez l'inventaire Web et d'application pour maximiser le taux visible IAB (75% ou plus).
IAB_VIEWABILITY_70_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (70% ou plus).
IAB_VIEWABILITY_65_PERCENT_HIHGER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (65% ou plus).
IAB_VIEWABILITY_60_PERCENT_HIGHER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (60% ou plus).
IAB_VIEWABILITY_55_PERCENT_HIHGER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (55% ou plus).
IAB_VIEWABILITY_50_PERCENT_HIGHER Ciblez l'inventaire Web et d'application pour maximiser le taux visible IAB de 50% ou plus.
IAB_VIEWABILITY_40_PERCENT_HIHGER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (40% ou plus).
IAB_VIEWABILITY_30_PERCENT_HIHGER Cibler l'inventaire Web et d'application pour maximiser le taux visible IAB (30% ou plus).

VideoViewableRate

Options possibles pour le taux de visibilité complète.

Enums
VIDEO_VIEWABLE_RATE_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de taux visible des vidéos.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visionnage complet (40% ou plus).
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Cibler l'inventaire Web pour maximiser le taux de visionnage complet (35% ou plus).
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Cibler l'inventaire Web pour maximiser le taux de visionnage complet (30% ou plus).
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Cibler l'inventaire Web pour maximiser le taux de visionnage complet (25% ou plus).
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Cibler l'inventaire Web pour maximiser le taux de visionnage complet (20% ou plus).
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Cibler l'inventaire Web pour maximiser le taux de visionnage complet (10% ou plus).

PlayerImpressionRate

Options possibles pour les impressions.

Enums
PLAYER_SIZE_400X300_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option d'impression.
PLAYER_SIZE_400X300_95 Sites avec au moins 95%d'impressions.
PLAYER_SIZE_400X300_70 Sites avec plus de 70%d'impressions.
PLAYER_SIZE_400X300_25 Sites avec au moins 25%d'impressions.
PLAYER_SIZE_400X300_5 Sites avec au moins 5%d'impressions.

FraudInvalidTraffic

Paramètres DoubleVerify pour la fraude et le trafic non valide.

Représentation JSON
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Champs
avoidedFraudOption

enum (FraudOption)

Éviter les sites et les applications dont le taux historique de trafic frauduleux et incorrect est de :

avoidInsufficientOption

boolean

Statistiques insuffisantes sur l'historique du trafic frauduleux et IVT.

FraudOption

Options possibles pour le taux historique de trafic frauduleux et incorrect.

Enums
FRAUD_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de fraude ni de trafic non valide.
AD_IMPRESSION_FRAUD_100 100% de trafic frauduleux et IVT.
AD_IMPRESSION_FRAUD_75 75% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_50 50% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_25 25% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_10 10% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_8 8% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_6 6% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_4 4% ou plus de fraude et trafic incorrect.
AD_IMPRESSION_FRAUD_2 2% ou plus de fraude et trafic incorrect.

IntegralAdScience

Détails des paramètres d'Integral Ad Science.

Représentation JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ],
  "qualitySyncCustomSegmentId": [
    string
  ]
}
Champs
traqScoreOption

enum (TRAQScore)

Véritable qualité publicitaire (applicable aux éléments de campagne display uniquement).

excludeUnrateable

boolean

Brand safety : Non évaluable.

excludedAdultRisk

enum (Adult)

Brand safety : Contenu réservé aux adultes.

excludedAlcoholRisk

enum (Alcohol)

Brand safety : Alcool.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Brand safety - Téléchargements illégaux.

excludedDrugsRisk

enum (Drugs)

Brand safety – Drogues.

excludedHateSpeechRisk

enum (HateSpeech)

Brand safety - Incitation à la haine.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Brand safety – Termes choquants.

excludedViolenceRisk

enum (Violence)

Brand safety - Violence.

excludedGamblingRisk

enum (Gambling)

Brand safety - Jeux d'argent et de hasard.

excludedAdFraudRisk

enum (AdFraudPrevention)

Paramètres de fraude publicitaire.

displayViewability

enum (DisplayViewability)

Section "Visibilité display" (applicable uniquement aux éléments de campagne display).

videoViewability

enum (VideoViewability)

Section "Visibilité des vidéos" (applicable uniquement aux éléments de campagne vidéo).

customSegmentId[]

string (int64 format)

ID de segment personnalisé fourni par Integral Ad Science. L'ID doit être compris entre 1000001 et 1999999 ou entre 3000001 et 3999999 (inclus).

qualitySyncCustomSegmentId[]

string (int64 format)

Facultatif. ID du segment personnalisé de synchronisation de la qualité fourni par Integral Ad Science. L'ID doit être compris entre 3000000 et 4999999, inclus.

TRAQScore

Plages de scores TRAQ (true advertising quality) possibles d'Integral Ad Science.

Enums
TRAQ_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucun niveau de qualité réel de l'annonce.
TRAQ_250 Score TRAQ de 250 à 1 000.
TRAQ_500 Score TRAQ de 500 à 1 000.
TRAQ_600 Score TRAQ de 600 à 1 000.
TRAQ_700 Score TRAQ de 700 à 1 000.
TRAQ_750 Score TRAQ de 750 à 1 000.
TRAQ_875 Score TRAQ de 875 à 1 000.
TRAQ_1000 Score TRAQ de 1 000.

Adulte

Options Integral Ad Science possibles pour les contenus réservés aux adultes.

Enums
ADULT_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option pour les adultes.
ADULT_HR Adultes : exclure les éléments à risque élevé.
ADULT_HMR Adultes : exclure les éléments à risque élevé et modéré.

Alcools

Options Integral Ad Science possibles pour l'alcool.

Enums
ALCOHOL_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option d'alcool.
ALCOHOL_HR Alcools : exclure les éléments à risque élevé.
ALCOHOL_HMR Alcools : exclure les éléments à risque élevé et modéré.

IllegalDownloads

Options possibles pour les téléchargements illégaux Integral Ad Science.

Enums
ILLEGAL_DOWNLOADS_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de téléchargement illégal.
ILLEGAL_DOWNLOADS_HR Téléchargements illégaux : exclure les éléments à risque élevé.
ILLEGAL_DOWNLOADS_HMR Téléchargements illégaux : exclure les éléments à risque élevé et modéré.

Drogues

Options possibles pour Integral Ad Science : Drogues.

Enums
DRUGS_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de médicament.
DRUGS_HR Drogues : exclure les éléments à risque élevé.
DRUGS_HMR Drogues : exclure les éléments à risque élevé et modéré.

HateSpeech

Options possibles pour la catégorie "Incitation à la haine" d'Integral Ad Science.

Enums
HATE_SPEECH_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option d'incitation à la haine.
HATE_SPEECH_HR Incitation à la haine : exclure les éléments à risque élevé.
HATE_SPEECH_HMR Incitation à la haine : exclure les éléments à risque élevé et modéré.

OffensiveLanguage

Options possibles pour les termes choquants Integral Ad Science.

Enums
OFFENSIVE_LANGUAGE_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de langue.
OFFENSIVE_LANGUAGE_HR Termes choquants : exclure les éléments à risque élevé.
OFFENSIVE_LANGUAGE_HMR Termes choquants : exclure les éléments à risque élevé et modéré.

Violence

Options possibles pour Integral Ad Science Violence.

Enums
VIOLENCE_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de violence.
VIOLENCE_HR Violence : exclure les éléments à risque élevé.
VIOLENCE_HMR Violence : exclure les éléments à risque élevé et modéré.

Jeux d'argent et de hasard

Options possibles pour les jeux d'argent et de hasard Integral Ad Science.

Enums
GAMBLING_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de jeux d'argent et de hasard.
GAMBLING_HR Jeux d'argent et de hasard : exclure les éléments à risque élevé.
GAMBLING_HMR Jeux d'argent et de hasard : exclure les éléments à risque élevé et modéré.

AdFraudPrevention

Options possibles de prévention de la fraude publicitaire Integral Ad Science.

Enums
SUSPICIOUS_ACTIVITY_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de prévention de la fraude publicitaire.
SUSPICIOUS_ACTIVITY_HR Fraude publicitaire : exclure les éléments à risque élevé.
SUSPICIOUS_ACTIVITY_HMR Fraude publicitaire : exclure les éléments à risque élevé et modéré.
SUSPICIOUS_ACTIVITY_FD Fraude publicitaire : exclure les appareils frauduleux.

DisplayViewability

Options de visibilité Integral Ad Science possibles pour le display.

Enums
PERFORMANCE_VIEWABILITY_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option de visibilité de l'affichage.
PERFORMANCE_VIEWABILITY_40 Ciblez une visibilité de 40% ou plus.
PERFORMANCE_VIEWABILITY_50 Ciblez une visibilité de 50% ou plus.
PERFORMANCE_VIEWABILITY_60 Ciblez une visibilité de 60% ou plus.
PERFORMANCE_VIEWABILITY_70 Ciblez une visibilité de 70% ou plus.

VideoViewability

Options de visibilité possibles pour les vidéos Integral Ad Science.

Enums
VIDEO_VIEWABILITY_UNSPECIFIED Cet enum n'est qu'un espace réservé et ne spécifie aucune option de visibilité des vidéos.
VIDEO_VIEWABILITY_40 40%ou plus de visibilité (norme de visibilité des vidéos de l'IAB).
VIDEO_VIEWABILITY_50 50%ou plus de l'annonce est visible (norme de visibilité des vidéos de l'IAB).
VIDEO_VIEWABILITY_60 60%ou plus de visibilité (norme de visibilité des vidéos de l'IAB).
VIDEO_VIEWABILITY_70 70%ou plus de visibilité (norme de visibilité des vidéos de l'IAB).

Peer39

Détails des paramètres de brand safety de Peer39.

Représentation JSON
{
  "excludedFraudIvtMfaCategories": [
    enum (FraudIvtMfaCategory)
  ],
  "adultExplicitSexualContent": enum (GarmRiskExclusion),
  "crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent": enum (GarmRiskExclusion),
  "armsAmmunitionContent": enum (GarmRiskExclusion),
  "deathInjuryMilitaryConflictContent": enum (GarmRiskExclusion),
  "debatedSensitiveSocialIssueContent": enum (GarmRiskExclusion),
  "illegalDrugsTobaccoEcigarettesVapingAlcoholContent": enum (GarmRiskExclusion),
  "onlinePiracyContent": enum (GarmRiskExclusion),
  "hateSpeechActsAggressionContent": enum (GarmRiskExclusion),
  "obscenityProfanityContent": enum (GarmRiskExclusion),
  "spamHarmfulContent": enum (GarmRiskExclusion),
  "terrorismContent": enum (GarmRiskExclusion),
  "misinformationContent": enum (GarmRiskExclusion),
  "displayIabViewability": enum (DisplayIabViewability),
  "videoIabViewability": enum (VideoIabViewability)
}
Champs
excludedFraudIvtMfaCategories[]

enum (FraudIvtMfaCategory)

Facultatif. Catégories de fraude, d'IVT et de MFA de Peer39 à exclure.

adultExplicitSexualContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM pour le contenu à caractère sexuel explicite et réservé aux adultes à exclure.

crimeHarmfulActsIndividualsSocietyHumanRightsViolationsContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM à exclure pour les contenus liés à des actes criminels et dangereux.

armsAmmunitionContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM pour le contenu lié aux armes et munitions à exclure.

deathInjuryMilitaryConflictContent

enum (GarmRiskExclusion)

Facultatif. Niveaux de risque GARM à exclure pour les contenus liés à la mort, aux blessures ou aux conflits militaires.

debatedSensitiveSocialIssueContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM à exclure pour le contenu lié à des sujets sociaux sensibles faisant l'objet de débats.

illegalDrugsTobaccoEcigarettesVapingAlcoholContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM à exclure pour le contenu lié à des drogues illégales/l'alcool.

onlinePiracyContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM à exclure pour le contenu lié au piratage en ligne.

hateSpeechActsAggressionContent

enum (GarmRiskExclusion)

Facultatif. Niveaux de risque GARM à exclure pour les contenus liés à l'incitation à la haine et aux actes d'agression.

obscenityProfanityContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM pour le contenu obscène et grossier à exclure.

spamHarmfulContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM pour le spam ou le contenu nuisible à exclure.

terrorismContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM pour le contenu à caractère terroriste à exclure.

misinformationContent

enum (GarmRiskExclusion)

Facultatif. Plages de risque GARM pour les contenus liés à des informations incorrectes à exclure.

displayIabViewability

enum (DisplayIabViewability)

Facultatif. Seuil de visibilité de l'IAB pour les annonces display.

videoIabViewability

enum (VideoIabViewability)

Facultatif. Seuil de visibilité de l'IAB pour les annonces vidéo.

FraudIvtMfaCategory

Catégories Peer39 disponibles : fraude, trafic incorrect, MFA.

Enums
FRAUD_IVT_MFA_CATEGORY_UNSPECIFIED Valeur par défaut lorsqu'une catégorie Peer39 de fraude, d'IVT ou de MFA n'est pas spécifiée ou est inconnue dans cette version.
FRAUD_IVT_MFA FRAUD, IVT, MFA.

GarmRiskExclusion

Options d'exclusion de niveau de risque GARM disponibles.

Enums
GARM_RISK_EXCLUSION_UNSPECIFIED Cet énum n'est qu'un espace réservé et ne spécifie aucune option d'exclusion des risques GARM.
GARM_RISK_EXCLUSION_FLOOR Exclure le risque maximal.
GARM_RISK_EXCLUSION_HIGH Exclure les risques élevés et maximaux.
GARM_RISK_EXCLUSION_MEDIUM Exclure les risques moyens, élevés et maximaux.
GARM_RISK_EXCLUSION_LOW Exclure tous les niveaux de risque (faible, moyen, élevé et maximal)

DisplayIabViewability

Seuils de visibilité display IAB Peer39 disponibles.

Enums
DISPLAY_IAB_VIEWABILITY_UNSPECIFIED Valeur par défaut lorsqu'elle n'est pas spécifiée ou qu'elle est inconnue dans cette version.
DISPLAY_IAB_VIEWABILITY_10 10%ou plus de l'annonce sont visibles (norme de visibilité de l'IAB pour le display).
DISPLAY_IAB_VIEWABILITY_20 20%ou plus de visibilité (norme de visibilité display de l'IAB).
DISPLAY_IAB_VIEWABILITY_35 35%ou plus de visibilité (norme de visibilité de l'IAB pour le display).
DISPLAY_IAB_VIEWABILITY_50 Au moins 50%de l'annonce est visible (norme de visibilité display de l'IAB).
DISPLAY_IAB_VIEWABILITY_75 75%ou plus de visibilité (norme de visibilité de l'IAB pour les annonces display).

VideoIabViewability

Seuils de visibilité des vidéos IAB Peer39 disponibles.

Enums
VIDEO_IAB_VIEWABILITY_UNSPECIFIED Valeur par défaut lorsqu'elle n'est pas spécifiée ou qu'elle est inconnue dans cette version.
VIDEO_IAB_VIEWABILITY_10 10%ou plus de visibilité (norme de visibilité vidéo de l'IAB).
VIDEO_IAB_VIEWABILITY_20 20%ou plus de visibilité (norme de visibilité des vidéos de l'IAB).
VIDEO_IAB_VIEWABILITY_35 35%ou plus de visibilité (norme de visibilité des vidéos de l'IAB).
VIDEO_IAB_VIEWABILITY_50 50%ou plus de l'annonce est visible (norme de visibilité des vidéos de l'IAB).
VIDEO_IAB_VIEWABILITY_75 75%ou plus de visibilité (norme de visibilité des vidéos de l'IAB).

PoiAssignedTargetingOptionDetails

Détails de l'option de ciblage par POI attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_POI.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Champs
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.

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_POI.

Vous pouvez récupérer les ID des options de ciblage par POI acceptées à l'aide de targetingTypes.targetingOptions.search.

Si vous ciblez des coordonnées de latitude/longitude spécifiques qui ne sont pas associées à une adresse ou à un nom de point d'intérêt, vous pouvez générer l'ID d'option de ciblage nécessaire en arrondissant les valeurs de coordonnées souhaitées à la sixième décimale, en supprimant les décimales et en concaténant les valeurs de chaîne séparées par un point-virgule. Par exemple, vous pouvez cibler la paire de latitude/longitude 40.7414691, -74.003387 à l'aide de l'ID d'option de ciblage "40741469;-74003387". Lors de la création , la valeur de ce champ sera mise à jour pour ajouter un point-virgule et une valeur de hachage alphanumérique si seules les coordonnées de latitude/longitude sont fournies.

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.

proximityRadiusAmount

number

Obligatoire. Rayon de la zone autour du POI qui sera ciblé. Les unités du rayon sont spécifiées par proximityRadiusUnit. Doit être compris entre 1 et 800 si l'unité est DISTANCE_UNIT_KILOMETERS, et entre 1 et 500 si l'unité est DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

Obligatoire. Unité de distance utilisée pour mesurer le rayon de ciblage.

DistanceUnit

Options d'unités de distance possibles.

Enums
DISTANCE_UNIT_UNSPECIFIED La valeur du type n'est pas spécifiée ou est inconnue dans cette version.
DISTANCE_UNIT_MILES Miles.
DISTANCE_UNIT_KILOMETERS Kilomètres.

BusinessChainAssignedTargetingOptionDetails

Détails de l'option de ciblage par chaîne d'établissements attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_BUSINESS_CHAIN.

Représentation JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Champs
displayName

string

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

targetingOptionId

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_BUSINESS_CHAIN.

Vous pouvez récupérer les ID des options de ciblage de chaînes d'établissements acceptées à l'aide de SearchTargetingOptions.

proximityRadiusAmount

number

Obligatoire. Rayon de la zone autour de la chaîne d'établissements qui sera ciblée. Les unités du rayon sont spécifiées par proximityRadiusUnit. Doit être compris entre 1 et 800 si l'unité est DISTANCE_UNIT_KILOMETERS, et entre 1 et 500 si l'unité est DISTANCE_UNIT_MILES. L'incrément minimal pour les deux cas est de 0,1. Les entrées seront arrondies à la valeur acceptable la plus proche si elles sont trop précises (par exemple, 15,57 deviendra 15,6).

proximityRadiusUnit

enum (DistanceUnit)

Obligatoire. Unité de distance utilisée pour mesurer le rayon de ciblage.

ContentDurationAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée pour la durée du contenu. Cette valeur sera renseignée dans le champ contentDurationDetails lorsque targetingType sera défini sur TARGETING_TYPE_CONTENT_DURATION. Le ciblage explicite de toutes les options n'est pas possible. Pour cela, supprimez toutes les options de ciblage de la durée du contenu.

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

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_DURATION.

contentDuration

enum (ContentDuration)

Uniquement en sortie. Durée du contenu.

ContentStreamTypeAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée au type de flux de contenu. Cette valeur sera renseignée dans le champ contentStreamTypeDetails lorsque targetingType sera défini sur TARGETING_TYPE_CONTENT_STREAM_TYPE. Le ciblage explicite de toutes les options n'est pas possible. Pour ce faire, supprimez toutes les options de ciblage par type de flux de contenu.

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

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_STREAM_TYPE.

contentStreamType

enum (ContentStreamType)

Uniquement en sortie. Type de flux de contenu.

NativeContentPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée pour la position de contenu natif. Cette valeur sera renseignée dans le champ nativeContentPositionDetails lorsque targetingType sera défini sur TARGETING_TYPE_NATIVE_CONTENT_POSITION. Le ciblage explicite de toutes les options n'est pas possible. Pour ce faire, supprimez toutes les options de ciblage de la position du contenu natif.

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

enum (NativeContentPosition)

Obligatoire. Position du contenu.

OmidAssignedTargetingOptionDetails

Représente un type d'inventaire compatible avec Open Measurement et pouvant être ciblé. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_OMID.

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

enum (Omid)

Obligatoire. Type d'inventaire compatible avec Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée pour le type de contenu audio. Cette valeur sera renseignée dans le champ audioContentTypeDetails lorsque targetingType sera défini sur TARGETING_TYPE_AUDIO_CONTENT_TYPE. Le ciblage explicite de toutes les options n'est pas possible. Pour ce faire, supprimez toutes les options de ciblage par type de contenu audio.

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

enum (AudioContentType)

Obligatoire. Type de contenu audio.

ContentGenreAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée par genre de contenu. Cette valeur sera renseignée dans le champ contentGenreDetails lorsque targetingType sera défini sur TARGETING_TYPE_CONTENT_GENRE. Le ciblage explicite de toutes les options n'est pas possible. Pour ce faire, supprimez toutes les options de ciblage par genre de contenu.

Représentation JSON
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Champs
targetingOptionId

string

Obligatoire. Le champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_GENRE.

displayName

string

Uniquement en sortie. Nom à afficher du genre de contenu.

negative

boolean

Indique si cette option est ciblée par exclusion.

YoutubeVideoAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée à la vidéo YouTube. Cette valeur sera renseignée dans le champ youtubeVideoDetails lorsque targetingType sera défini sur TARGETING_TYPE_YOUTUBE_VIDEO.

Représentation JSON
{
  "videoId": string,
  "negative": boolean
}
Champs
videoId

string

ID vidéo YouTube tel qu'il apparaît sur la page de lecture YouTube.

negative

boolean

Indique si cette option est ciblée par exclusion.

YoutubeChannelAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée à la chaîne YouTube. Cette valeur sera renseignée dans le champ youtubeChannelDetails lorsque targetingType sera défini sur TARGETING_TYPE_YOUTUBE_CHANNEL.

Représentation JSON
{
  "channelId": string,
  "negative": boolean
}
Champs
channelId

string

ID de la chaîne de l'utilisateur ayant mis en ligne la vidéo sur YouTube ou code d'une chaîne YouTube.

negative

boolean

Indique si cette option est ciblée par exclusion.

SessionPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée pour la position de la session. Cette valeur sera renseignée dans le champ sessionPositionDetails lorsque targetingType sera défini sur TARGETING_TYPE_SESSION_POSITION.

Représentation JSON
{
  "sessionPosition": enum (SessionPosition)
}
Champs
sessionPosition

enum (SessionPosition)

Position à laquelle l'annonce sera diffusée au cours d'une session.

SessionPosition

Positions possibles dans une session.

Enums
SESSION_POSITION_UNSPECIFIED Il s'agit d'un espace réservé qui n'indique aucune position.
SESSION_POSITION_FIRST_IMPRESSION Première impression de la session.

LookalikeAudienceAssignedTargetingOptionDetails

Détails de l'option de ciblage par audience similaire. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_LOOKALIKE_AUDIENCE.

Représentation JSON
{
  "lookalikeAudienceId": string,
  "negative": boolean
}
Champs
lookalikeAudienceId

string (int64 format)

Obligatoire. ID de l'audience similaire.

negative

boolean

Facultatif. Indique si cette option est ciblée par exclusion.

GoogleAudienceAssignedTargetingOptionDetails

Détails de l'option de ciblage d'audience Google. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_GOOGLE_AUDIENCE.

Représentation JSON
{
  "googleAudienceId": string,
  "googleAudienceType": enum (GoogleAudienceType),
  "negative": boolean
}
Champs
googleAudienceId

string (int64 format)

Obligatoire. ID de l'audience Google.

googleAudienceType

enum (GoogleAudienceType)

Obligatoire. Type de l'audience Google.

negative

boolean

Facultatif. Indique si cette option est ciblée par exclusion.

CustomListAssignedTargetingOptionDetails

Détails de l'option de ciblage par liste personnalisée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_CUSTOM_LIST.

Représentation JSON
{
  "customListId": string,
  "customListType": enum (CustomListType)
}
Champs
customListId

string (int64 format)

Obligatoire. ID de la liste personnalisée.

customListType

enum (CustomListType)

Obligatoire. Type de la liste personnalisée.

CustomListType

Types possibles de la liste personnalisée.

Enums
CUSTOM_LIST_TYPE_UNSPECIFIED Valeur par défaut lorsque le type n'est pas spécifié ou est inconnu.
CUSTOM_LIST_TYPE_CUSTOM_AFFINITY Liste de clients de type "audience d'affinité personnalisée".
CUSTOM_LIST_TYPE_CUSTOM_INTENT Liste personnalisée de type "Intention personnalisée".

CombinedAudienceAssignedTargetingOptionDetails

Détails de l'option de ciblage d'audience combinée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_COMBINED_AUDIENCE.

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

string (int64 format)

Obligatoire. ID de l'audience combinée.

FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails

Détails de l'option de ciblage d'audience propriétaire et partenaire. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.

Représentation JSON
{
  "firstPartyAndPartnerAudienceId": string,
  "negative": boolean
}
Champs
firstPartyAndPartnerAudienceId

string (int64 format)

Obligatoire. ID de l'audience propriétaire ou partenaire.

negative

boolean

Facultatif. Indique si cette option est ciblée par exclusion.

AuctionPackageAssignedTargetingOptionDetails

Détails de l'option de ciblage de package d'enchères attribuée. Ce champ sera renseigné dans le champ "details" d'un AssignedTargetingOption lorsque targetingType est défini sur TARGETING_TYPE_AUCTION_PACKAGE.

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

string

Obligatoire. targetingOptionId d'un TargetingOption de type TARGETING_TYPE_AUCTION_PACKAGE.

displayName

string

Uniquement en sortie. Nom à afficher du package d'enchères.

YoutubeChannelPackAssignedTargetingOptionDetails

Détails de l'option de ciblage attribuée au pack de chaînes YouTube. Cette valeur sera renseignée dans le champ youtubeChannelPackDetails lorsque targetingType sera défini sur TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.

Représentation JSON
{
  "channelPackId": string,
  "negative": boolean
}
Champs
channelPackId

string (int64 format)

Obligatoire. ID du pack de chaînes YouTube.

negative

boolean

Facultatif. Indique si cette option est ciblée par exclusion.

Héritage

Indique si l'option de ciblage attribuée est héritée d'une entité de niveau supérieur, comme un partenaire ou un annonceur. Les options de ciblage attribuées héritées sont prioritaires. Elles sont toujours appliquées lors de la diffusion par rapport au ciblage attribué au niveau actuel et ne peuvent pas être modifiées via le service d'entité actuel. Elles doivent être modifiées via le service d'entité dont elles sont héritées. L'héritage ne s'applique qu'aux chaînes ciblées par exclusion, aux exclusions de catégories sensibles et aux exclusions de libellés de contenu numérique si elles sont configurées au niveau parent.

Enums
INHERITANCE_UNSPECIFIED L'héritage n'est pas spécifié ou est inconnu.
NOT_INHERITED L'option de ciblage attribuée n'est pas héritée d'une entité de niveau supérieur.
INHERITED_FROM_PARTNER L'option de ciblage attribuée est héritée des paramètres de ciblage du partenaire.
INHERITED_FROM_ADVERTISER L'option de ciblage attribuée est héritée des paramètres de ciblage de l'annonceur.

Méthodes

create

Attribue une option de ciblage à un groupe d'annonces.

delete

Supprime une option de ciblage attribuée d'un groupe d'annonces.

get

Récupère une seule option de ciblage attribuée à un groupe d'annonces.

list

Répertorie les options de ciblage attribuées à un groupe d'annonces.