REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Ressource: AssignedTargetOption

Une seule option de ciblage attribuée, 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,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "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)
  },
  "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)
  }
  // End of list of possible types for union field details.
}
Champs
name

string

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

assignedTargetingOptionId

string

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

targetingType

enum (TargetingType)

Uniquement en sortie. Indique le type de l'option de ciblage attribuée.

inheritance

enum (Inheritance)

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

Champ d'union details. Informations détaillées sur l'option de ciblage attribuée. Vous ne pouvez renseigner qu'un seul champ dans les détails, lequel doit correspondre à targeting_type. details ne peut être que l'un des éléments suivants:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Informations sur la chaîne. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Détails sur la catégorie de l'application. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Informations sur l'application. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Détails de l'URL. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Détails de la date et de l'heure. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Détails sur la tranche d'âge. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Détails de la liste d'emplacements régionaux. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Détails de la liste des zones géographiques de proximité. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Informations sur le sexe Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Informations sur la taille du lecteur vidéo. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Détails du contenu avec récompense pour l'utilisateur. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Informations concernant le statut parental. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Détails de la position InStream du contenu. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Détails de la position OutStream du contenu Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Détails sur le type d'appareil. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Informations sur le ciblage d'audience. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_AUDIENCE_GROUP. Vous ne pouvez cibler qu'une seule option de groupe d'audience par ressource.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Détails sur le navigateur. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Détails des revenus du foyer. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Informations sur la position à l'écran Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Informations sur l'opérateur et le FAI. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Informations sur les mots clés. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_KEYWORD.

Vous pouvez attribuer jusqu'à 5 000 mots clés à exclure directs à une ressource. Vous pouvez attribuer autant de mots clés à inclure que vous le souhaitez.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Informations sur les mots clés. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Détails du système d'exploitation Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Détails de la marque et du modèle de l'appareil. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Détails de l'environnement. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Détails de la source d'inventaire. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Détails sur la catégorie. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CATEGORY.

Le ciblage d'une catégorie ciblera également ses sous-catégories. Si une catégorie est exclue du ciblage et qu'une sous-catégorie est incluse, l'exclusion est prioritaire.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Informations détaillées sur la visibilité Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_VIEWABILITY.

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Informations sur l'état du vendeur autorisé. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

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

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Informations sur la langue. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Détails sur les régions géographiques. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Détails du groupe de sources d'inventaire. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Détails du libellé de contenu numérique Ce champ sera renseigné lorsque targetingType aura la valeur 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 définies, sont toujours appliquées lors de la diffusion (même si elles ne sont pas visibles dans les paramètres de ressource). Les paramètres de ressources permettent d'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 sur les catégories sensibles. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Détails de la place de marché. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Détails de la sous-place de marché. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Informations sur la validation tierce. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Détails du POI. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Détails de la chaîne d'établissements. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Détails sur la durée du contenu. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Détails sur la durée du contenu. Ce champ est renseigné lorsque le type de ciblage est défini sur TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Détails de la position du contenu natif. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Détails de l'inventaire activé pour Open Measurement. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Détails concernant le type de contenu audio Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Détails sur le genre de contenu. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_CONTENT_GENRE.

Héritage

Indique si l'option de ciblage attribuée est héritée d'une entité de niveau supérieur telle qu'un partenaire ou un annonceur. Les options de ciblage héritées ont la priorité. 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és actuel. Ils doivent être modifiés via le service d'entités dont ils sont hérités. 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 du 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 de l'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.

ChannelAssignedTargetingOptionDetails

Informations sur l'option de ciblage du canal attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 Chaîne détenue par un partenaire ou Chaîne détenue par l'annonceur ;

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion. Pour l'option de ciblage attribuée au niveau de l'annonceur, la valeur de ce champ doit être "true".

AppCategoryAssignedTargetingOptionDetails

Informations sur l'option de ciblage par catégorie d'applications attribuée. Ce champ est renseigné dans le champ appCategoryDetails d'une AssignedTargetOption si 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. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

AppAssignedTargetingOptionDetails

Informations sur l'option de ciblage par application attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 à neuf chiffres (par exemple, 422689480).

displayName

string

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

negative

boolean

Indique si cette option fait l'objet d'un ciblage 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 est considérée comme mobile Android ou iOS), et nous obtiendrons la plate-forme mobile appropriée à partir de l'ID de l'application.

AppPlatform

Options possibles de ciblage par plate-forme

Enums
APP_PLATFORM_UNSPECIFIED Valeur par défaut lorsque la plate-forme de l'application n'est pas spécifiée dans cette version. Cette énumération est un espace réservé pour la valeur par défaut et ne représente pas une véritable option de plate-forme.
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 d'applications est Roku.
APP_PLATFORM_AMAZON_FIRETV La plate-forme de l'application est Amazon FireTV.
APP_PLATFORM_PLAYSTATION La plate-forme de l'appli est PlayStation.
APP_PLATFORM_APPLE_TV La plate-forme de l'appli est Apple TV.
APP_PLATFORM_XBOX La plate-forme de l'application est Xbox.
APP_PLATFORM_SAMSUNG_TV La plate-forme de l'appli est Samsung TV.
APP_PLATFORM_ANDROID_TV La plate-forme de l'application est Android TV.
APP_PLATFORM_GENERIC_CTV La plate-forme d'applications est une plate-forme de TV connectée qui n'est pas explicitement listée ailleurs.

UrlAssignedTargetingOptionDetails

Informations sur l'option de ciblage par URL attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_URL.

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

string

Obligatoire. 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 fait l'objet d'un ciblage par exclusion.

DayAndTimeAssignedTargetingOptionDetails

Représentation d'un segment de temps défini 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 correspondant à ce paramètre de ciblage par jour et heure.

startHour

integer

Obligatoire. Heure de début pour le ciblage par jour et heure. La valeur doit être comprise 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. Doit être compris entre 1 (une heure après le début de la journée) et 24 (fin de journée).

timeZoneResolution

enum (TimeZoneResolution)

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

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 fuseau horaire.

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

AgeRangeAssignedTargetingOptionDetails

Représente une tranche d'âge pouvant être ciblée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

Tranche d'âge d'une audience Vous ne pouvez cibler qu'une tranche d'âge continue de l'audience. Ainsi, la tranche d'âge représentée dans ce champ peut 1) être ciblée uniquement ou 2) faire partie d'une tranche d'âge continue plus importante. La couverture d'un ciblage continu de tranche d'âge peut être élargie en ciblant également une audience dont l'âge n'est pas connu.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_AGE_RANGE.

RegionalLocationListAssignedTargetingOptionDetails

Détails de ciblage pour la liste des zones géographiques régionales. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 de type TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

ProximityLocationListAssignedTargetingOptionDetails

Détails sur le ciblage pour la liste des zones géographiques de proximité. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

Représentation JSON
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
Champs
proximityLocationListId

string (int64 format)

Obligatoire. ID de la liste des zones de proximité. Doit faire référence au champ locationListId d'une ressource LocationList de type TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadiusRange

enum (ProximityRadiusRange)

Obligatoire. Plage de rayons pour la liste des zones géographiques de proximité. Il s'agit de la taille de la zone autour d'un emplacement choisi qui sera ciblé.

Le ciblage géographique de proximité All pour une seule ressource doit avoir la même valeur de plage de rayons. Définissez cette valeur de sorte qu'elle corresponde à tout ciblage existant. S'il est mis à jour, ce champ modifiera la plage de rayons de tous les ciblages de proximité associés à la ressource.

ProximityRadiusRange

Type d'une plage de rayons pour les options de proximité géographique attribuées à un type de données. La plage du rayon est liée à la densité de la population. Par exemple, PROXIMITY_RADIUS_RANGE_SMALL dans une zone rurale sera différent de PROXIMITY_RADIUS_RANGE_SMALL dans une ville très peuplée.

Enums
PROXIMITY_RADIUS_RANGE_UNSPECIFIED La plage de rayons ciblée n'est pas spécifiée ou est inconnue. Valeur par défaut lorsque la plage du rayon n'est pas spécifiée dans cette version. Cette énumération est un espace réservé pour la valeur par défaut et ne représente pas une option de plage de rayons réels.
PROXIMITY_RADIUS_RANGE_SMALL La plage de rayons de ciblage est petite.
PROXIMITY_RADIUS_RANGE_MEDIUM La plage de rayons ciblée est moyenne.
PROXIMITY_RADIUS_RANGE_LARGE La plage de rayons de ciblage est étendue.

GenderAssignedTargetingOptionDetails

Informations sur l'option de ciblage par genre attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_GENDER.

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

enum (Gender)

Genre de l'audience.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_GENDER.

VideoPlayerSizeAssignedTargetingOptionDetails

Détails de l'option de ciblage par taille du lecteur vidéo. Ce champ est renseigné dans le champ videoPlayerSizeDetails lorsque targetingType est défini sur TARGETING_TYPE_VIDEO_PLAYER_SIZE. Le ciblage explicite de toutes les options n'est pas accepté. Pour obtenir cet effet, supprimez toutes les options de ciblage par taille du lecteur vidéo.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_VIDEO_PLAYER_SIZE.

videoPlayerSize

enum (VideoPlayerSize)

Taille du lecteur vidéo.

Résultat uniquement dans v1. Obligatoire dans la version 2.

UserRewardedContentAssignedTargetingOptionDetails

Détails de l'option de ciblage par contenus avec récompense pour l'utilisateur. Ce champ est renseigné dans le champ userRewardedContentDetails lorsque targetingType est défini sur TARGETING_TYPE_USER_REWARDED_CONTENT.

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

string

Obligatoire. 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

Informations sur l'option de ciblage par statut parental attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

Statut parental de l'audience.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_PARENTAL_STATUS.

ContentInstreamPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage par position InStream attribuée. Ce champ est renseigné dans le champ contentInstreamPositionDetails lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentInstreamPosition

enum (ContentInstreamPosition)

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

Résultat uniquement dans v1. Obligatoire dans la version 2.

adType

enum (AdType)

Uniquement en sortie. Type d'annonce à cibler. Cette option de ciblage ne s'appliquera par défaut 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. Les valeurs possibles sont :

  • AD_TYPE_VIDEO, ce paramètre sera hérité par le nouvel élément de campagne lorsque la valeur de "lineItemType" est "LINE_ITEM_TYPE_VIDEO_DEFAULT".
  • AD_TYPE_AUDIO, ce paramètre sera hérité par le nouvel élément de campagne lorsque la valeur de "lineItemType" est "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, des créations illustrées et HTML5).
AD_TYPE_VIDEO Créations vidéo, comme les annonces vidéo qui sont lues en streaming dans des lecteurs vidéo.
AD_TYPE_AUDIO Créations audio, par exemple les annonces audio diffusées pendant le contenu audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Détails de l'option de ciblage de la position OutStream du contenu attribué. Ce champ est renseigné dans le champ contentOutstreamPositionDetails lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

contentOutstreamPosition

enum (ContentOutstreamPosition)

Position OutStream du contenu

Résultat uniquement dans v1. Obligatoire dans la version 2.

adType

enum (AdType)

Uniquement en sortie. Type d'annonce à cibler. Cette option de ciblage ne s'appliquera par défaut 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. Les valeurs possibles sont :

  • AD_TYPE_DISPLAY, ce paramètre sera hérité par le nouvel élément de campagne lorsque la valeur de "lineItemType" est "LINE_ITEM_TYPE_DISPLAY_DEFAULT".
  • AD_TYPE_VIDEO, ce paramètre sera hérité par le nouvel élément de campagne lorsque la valeur de "lineItemType" est "LINE_ITEM_TYPE_VIDEO_DEFAULT".

DeviceTypeAssignedTargetingOptionDetails

Détails du ciblage en fonction du type d'appareil. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_TYPE.

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

string

Obligatoire. ID du type d'appareil.

deviceType

enum (DeviceType)

Nom à afficher pour le type d'appareil.

Résultat uniquement dans v1. Obligatoire dans la version 2.

AudienceGroupAssignedTargetingOptionDetails

Détails de l'option de ciblage du groupe d'audience attribué. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 une interférence avec d'autres groupes.

Représentation JSON
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
Champs
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

ID d'audience propriétaire et tiers, et récence des groupes d'audience propriétaires et tiers inclus. Chaque groupe d'audience propriétaire et tiers ne contient que des ID d'audience propriétaires et tiers. La relation entre chaque groupe d'audience propriétaire et tiers est la suivante : présentés. Le résultat est une combinaison "UNION" avec d'autres groupes d'audience. Les groupes répétés avec les mêmes paramètres sont ignorés.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Identifiants d'audience Google du groupe d'audience Google inclus. Ne contient que les ID d'audience Google.

includedCustomListGroup

object (CustomListGroup)

ID de liste personnalisée du groupe de listes personnalisées inclus. Ne contient que des ID de liste personnalisés.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

ID d'audience combinée du groupe d'audience combiné inclus. Ne contient que des ID d'audience combinés.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

ID d'audience propriétaire et tiers, et récences du groupe d'audience propriétaire et tiers exclu. Utilisé pour le ciblage par exclusion. Le COMPLÉMENT de l'UNION de ce groupe et des autres groupes d'audience exclus est utilisé comme constance pour tout ciblage d'audience positif. Tous les éléments sont logiquement "OU" les uns des autres.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

Détails des groupes d'audiences propriétaires et tiers. Tous les paramètres de ciblage d'audience propriétaire et tiers sont logiquement associés à l'opérateur "OU".

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

object (FirstAndThirdPartyAudienceTargetingSetting)

Obligatoire. Tous les paramètres de ciblage d'audience propriétaire et tiers des groupes d'audience propriétaires et tiers. L'utilisation d'un même identifiant dans plusieurs paramètres ne est pas autorisée.

FirstAndThirdPartyAudienceTargetingSetting

Détails des paramètres de ciblage d'audience propriétaire et tiers.

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

string (int64 format)

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

recency

enum (Recency)

Récence des paramètres de ciblage d'audience propriétaire et tiers. Elle ne s'applique qu'aux audiences propriétaires. Sinon, elle 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 n'est utilisée.

Récence

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

Enums
RECENCY_NO_LIMIT Aucune limite de récence.
RECENCY_1_MINUTE La récence est de 1 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 3 heures.
RECENCY_6_HOURS La récence est de 6 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 2 jours.
RECENCY_3_DAYS La récence est de trois jours.
RECENCY_5_DAYS La récence est de 5 jours.
RECENCY_7_DAYS La récence est de 7 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.

GoogleAudienceGroup

Détails du groupe d'audience Google. Tous les paramètres de ciblage d'audience Google sont logiquement associés à l'opérateur "OU".

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

object (GoogleAudienceTargetingSetting)

Obligatoire. Tous les paramètres de ciblage d'audience Google dans le groupe d'audience Google. Les paramètres répétés associés au même ID sont 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 d'audience Google du paramètre de ciblage d'audience Google. Cet ID est googleAudienceId.

CustomListGroup

Détails du groupe de listes personnalisées. Tous les paramètres de ciblage par liste personnalisée sont logiquement associés à 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 associés au même ID sont ignorés.

CustomListTargetingSetting

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

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é. Tous les paramètres de ciblage d'audience combiné sont logiquement associés à l'opérateur "OU".

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

object (CombinedAudienceTargetingSetting)

Obligatoire. Tous les paramètres de ciblage d'audience combiné dans le groupe d'audience combiné. Les paramètres répétés associés au même ID sont ignorés. Le nombre de paramètres d'audience combinée ne doit pas être supérieur à cinq. Dans le cas contraire, une erreur est générée.

CombinedAudienceTargetingSetting

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

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

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

Détails de l'option de ciblage par navigateur attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_BROWSER.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion. Toutes les options de ciblage par navigateur attribuées sur la même ressource doivent avoir la même valeur pour ce champ.

HouseholdIncomeAssignedTargetingOptionDetails

Détails de l'option de ciblage en fonction des revenus du foyer attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Revenus du foyer de l'audience.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_HOUSEHOLD_INCOME.

OnScreenPositionAssignedTargetingOptionDetails

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

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Uniquement en sortie. Position à l'écran

adType

enum (AdType)

Uniquement en sortie. Type d'annonce à cibler. Cette option de ciblage ne s'appliquera par défaut 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. Les valeurs possibles sont :

  • AD_TYPE_DISPLAY, ce paramètre sera hérité par le nouvel élément de campagne lorsque la valeur de "lineItemType" est "LINE_ITEM_TYPE_DISPLAY_DEFAULT".
  • AD_TYPE_VIDEO, ce paramètre sera hérité par le nouvel élément de campagne lorsque la valeur de "lineItemType" est "LINE_ITEM_TYPE_VIDEO_DEFAULT".

CarrierAndIspAssignedTargetingOptionDetails

Informations sur l'option de ciblage par opérateur et FAI attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion. Toutes les options de ciblage par opérateur et FAI attribuées sur la même ressource doivent avoir la même valeur pour ce champ.

KeywordAssignedTargetingOptionDetails

Informations sur l'option de ciblage par mots clés attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_KEYWORD.

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

string

Obligatoire. Mot clé (par exemple, car insurance).

Un mot clé à inclure ne doit pas être un terme choquant. L'encodage doit être effectué au format UTF-8, avec une taille maximale de 255 octets. Le nombre maximal de caractères est de 80. Le nombre de mots est limité à 10.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

NegativeKeywordListAssignedTargetingOptionDetails

Détails de ciblage de la liste de mots clés à exclure. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

string (int64 format)

Obligatoire. Identifiant 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é. Ce champ est renseigné dans le champ operatingSystemDetails lorsque targetingType est 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 fait l'objet d'un ciblage par exclusion.

DeviceMakeModelAssignedTargetingOptionDetails

Détails des options de ciblage par marque et modèle d'appareil attribués. Ce champ est renseigné dans le champ deviceMakeModelDetails lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_MAKE_MODEL.

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

string

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

targetingOptionId

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

EnvironmentAssignedTargetingOptionDetails

Détails de l'option de ciblage par environnement attribué. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

Environnement de diffusion.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. La targetingOptionId d'une TargetingOption de type TARGETING_TYPE_ENVIRONMENT (par exemple, "508010" pour cibler l'option ENVIRONMENT_WEB_OPTIMIZED).

InventorySourceAssignedTargetingOptionDetails

Détails sur le ciblage de la source d'inventaire. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_INVENTORY_SOURCE.

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. Ce champ est renseigné dans le champ categoryDetails lorsque targetingType est 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. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CATEGORY.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

ViewabilityAssignedTargetingOptionDetails

Détails de l'option de ciblage en fonction de la visibilité attribués. Ce champ est renseigné dans le champ viewabilityDetails d'une AssignedTargetOption si targetingType est défini sur TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

Pourcentage de visibilité prévu.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. La targetingOptionId d'une TargetingOption de type TARGETING_TYPE_VIEWABILITY (par exemple, "509010" pour cibler l'option VIEWABILITY_10_PERCENT_OR_MORE).

AuthorizedSellerStatusAssignedTargetingOptionDetails

Représente un état de vendeur autorisé attribué. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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, celle-ci utilise l'option "Vendeurs directs et revendeurs autorisés".

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

enum (AuthorizedSellerStatus)

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

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Informations sur l'option de ciblage linguistique attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 pour la langue (par exemple, « Français »).

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_LANGUAGE.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion. Toutes les options de ciblage linguistique attribuées sur la même ressource doivent avoir la même valeur pour ce champ.

GeoRegionAssignedTargetingOptionDetails

Informations sur l'option de ciblage par zone géographique attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 zone géographique (par exemple, "Ontario, Canada").

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

Uniquement en sortie. Type de ciblage par zone géographique.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

InventorySourceGroupAssignedTargetingOptionDetails

Détails sur le ciblage du groupe de sources d'inventaire. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 de ciblage du libellé de contenu numérique. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

string

Obligatoire. Identifiant du libellé de contenu numérique à EXCLURE.

contentRatingTier

enum (ContentRatingTier)

Uniquement en sortie. Nom à afficher pour la classification du libellé de contenu numérique.

SensitiveCategoryAssignedTargetingOptionDetails

Détails du ciblage pour la catégorie sensible. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

string

Obligatoire. Identifiant de la catégorie sensible à EXCLURE.

sensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

Détails de l'option de ciblage de la place de marché attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_EXCHANGE.

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

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_EXCHANGE.

SubExchangeAssignedTargetingOptionDetails

Informations sur l'option de ciblage des sous-places de marché attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_SUB_EXCHANGE.

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

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Détails de l'option de ciblage de l'outil de vérification tiers attribué. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Représentation JSON
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Champs
Champ d'union verifier. Possibilité de cibler l'un des vérificateurs tiers afin d'appliquer des seuils de brand safety pour les impressions. verifier ne peut être qu'un des éléments suivants :
adloox

object (Adloox)

Outil de vérification de la marque tierce : Adloox.

doubleVerify

object (DoubleVerify)

Outil de vérification de la marque tierce : DoubleVerify

integralAdScience

object (IntegralAdScience)

Outil de vérification de la marque tierce : Integral Ad Science

Adloox

Détails des paramètres Adloox.

Représentation JSON
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
Champs
excludedAdlooxCategories[]

enum (AdlooxCategory)

Paramètres de brand safety d'Adloox.

AdlooxCategory

Options Adloox possibles

Enums
ADLOOX_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option Adloox.
ADULT_CONTENT_HARD Contenu réservé aux adultes (difficile)
ADULT_CONTENT_SOFT Contenu réservé aux adultes (non contenu)
ILLEGAL_CONTENT Contenu illégal
BORDERLINE_CONTENT Contenus à la limite d'une infraction
DISCRIMINATORY_CONTENT Contenus discriminatoires
VIOLENT_CONTENT_WEAPONS Contenu violent et armes
LOW_VIEWABILITY_DOMAINS Domaines à faible visibilité.
FRAUD Fraude.

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 associées à la classification par âge.

appStarRating

object (AppStarRating)

Évitez d'enchérir sur les applications ayant reçu des notes.

displayViewability

object (DisplayViewability)

Paramètres de visibilité des annonces 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)

Évitez les sites et les applications présentant des taux historiques de fraude et d'IVT.

customSegmentId

string (int64 format)

ID de segment personnalisé fourni par DoubleVerify. L'ID doit commencer par "51" et comporter huit chiffres. Impossible de spécifier l'ID de segment personnalisé avec les 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 impossible à évaluer.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Catégories d'évitement de gravité élevée pour la brand safety.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Catégories d'évitement de gravité moyenne pour la brand safety.

HighSeverityCategory

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

Enums
HIGHER_SEVERITY_UNSPECIFIED Cette énumération 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 réservés aux adultes et nudité
COPYRIGHT_INFRINGEMENT Atteinte aux droits d'auteur.
SUBSTANCE_ABUSE Drogues/Alcools/Substances illicites: abus de substances.
GRAPHIC_VIOLENCE_WEAPONS Violence extrême/Violence explicite/Armes
HATE_PROFANITY Haine/Grossièretés.
CRIMINAL_SKILLS Activités illégales: compétences criminelles
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incitation/Logiciel malveillant/Encombrement.

MediumSeverityCategory

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

Enums
MEDIUM_SEVERITY_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune catégorie de gravité moyenne.
AD_SERVERS Serveurs publicitaires.
ADULT_CONTENT_SWIMSUIT Contenu réservé aux adultes: Maillot de bain
ALTERNATIVE_LIFESTYLES Sujets controversés: styles 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 illicites: alcool
SMOKING Drogues/Alcools/Substances illicites: tabac
NEGATIVE_NEWS_FINANCIAL Mauvaises nouvelles: finance.
NON_ENGLISH Contenu non standard: langue autre que l'anglais.
PARKING_PAGE Contenu non standard: page de stationnement.
UNMODERATED_UGC Contenus non modérés générés par les utilisateurs: forums, images et vidéos.
INFLAMMATORY_POLITICS_AND_NEWS Sujets controversés: actualités et politiques provocantes
NEGATIVE_NEWS_PHARMACEUTICAL Actualités à exclure: produits pharmaceutiques.

AgeRating

Options possibles pour la classification par âge.

Enums
AGE_RATING_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de classification par âge.
APP_AGE_RATE_UNKNOWN Applications dont la classification par âge est inconnue.
APP_AGE_RATE_4_PLUS Applications adaptées à tous les publics (4 ans et plus).
APP_AGE_RATE_9_PLUS Applications adaptées à tous les 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 de note DoubleVerify.

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

enum (StarRating)

Évitez d'enchérir sur les applications ayant reçu des notes.

avoidInsufficientStarRating

boolean

Évitez d'enchérir sur des applications dont le nombre d'étoiles est insuffisant.

StarRating

Options possibles pour les notes.

Enums
APP_STAR_RATE_UNSPECIFIED Cette énumération 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é des annonces display DoubleVerify.

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

enum (IAB)

Ciblez l'inventaire Web et d'applications pour maximiser le taux de visibilité IAB.

viewableDuring

enum (ViewableDuring)

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

IAB

Options possibles pour le taux de visibilité IAB.

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

ViewableDuring

Options possibles pour la durée de visibilité

Enums
AVERAGE_VIEW_DURATION_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de durée moyenne de visionnage.
AVERAGE_VIEW_DURATION_5_SEC Ciblez l'inventaire Web et d'applications pour maximiser la durée de visionnage à 100% pendant au moins cinq secondes.
AVERAGE_VIEW_DURATION_10_SEC Ciblez l'inventaire Web et d'application pour maximiser la visibilité à 100% pendant au moins 10 secondes.
AVERAGE_VIEW_DURATION_15_SEC Ciblez l'inventaire Web et d'application pour maximiser la durée de visibilité à 100% pendant 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)

Ciblez l'inventaire Web pour maximiser le taux de visibilité IAB.

videoViewableRate

enum (VideoViewableRate)

Ciblez l'inventaire Web pour maximiser le taux de visibilité entièrement visible.

playerImpressionRate

enum (PlayerImpressionRate)

Ciblez l'inventaire pour maximiser les impressions avec une taille de lecteur d'au moins 400 x 300.

VideoIAB

Options possibles pour le taux de visibilité IAB.

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

VideoViewableRate

Options possibles pour le tarif entièrement visible.

Enums
VIDEO_VIEWABLE_RATE_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de taux de visibilité de la vidéo.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visibilité complète de 40% ou plus.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visibilité complète de 35% ou plus.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visibilité complète de 30% ou plus.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visibilité complète à 25% ou plus.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visibilité complète de 20% ou plus.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Ciblez l'inventaire Web pour maximiser le taux de visibilité complète de 10% ou plus.

PlayerImpressionRate

Options possibles pour les impressions.

Enums
PLAYER_SIZE_400X300_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option d'impression.
PLAYER_SIZE_400X300_95 Sites enregistrant au moins 95%d'impressions
PLAYER_SIZE_400X300_70 Sites enregistrant 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 concernant le trafic frauduleux et incorrect.

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

enum (FraudOption)

Évitez les sites et les applications qui présentent un historique de fraude et d'IVT.

avoidInsufficientOption

boolean

Historique insuffisant pour les statistiques liées à la fraude et à l'IVT.

FraudOption

Options possibles pour l'historique du taux de fraude et d'IVT.

Enums
FRAUD_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de fraude et de trafic incorrect.
AD_IMPRESSION_FRAUD_100 100% de fraude et d'IVT.
AD_IMPRESSION_FRAUD_50 50% ou plus (trafic frauduleux et incorrect)
AD_IMPRESSION_FRAUD_25 25% ou plus (trafic frauduleux et incorrect)
AD_IMPRESSION_FRAUD_10 10% ou plus (trafic frauduleux et incorrect)
AD_IMPRESSION_FRAUD_8 8% ou plus (trafic frauduleux et incorrect)
AD_IMPRESSION_FRAUD_6 6% ou plus (trafic frauduleux et incorrect)
AD_IMPRESSION_FRAUD_4 4% ou plus (trafic frauduleux et incorrect)
AD_IMPRESSION_FRAUD_2 2% ou plus (trafic frauduleux et incorrect)

IntegralAdScience

Détails des paramètres 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
  ]
}
Champs
traqScoreOption

enum (TRAQScore)

Qualité réelle de la publicité (applicable uniquement aux éléments de campagne display)

excludeUnrateable

boolean

Brand safety – Impossible à évaluer.

excludedAdultRisk

enum (Adult)

Brand safety – Contenu réservé aux adultes

excludedAlcoholRisk

enum (Alcohol)

Brand safety – Alcools

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 lutte contre la fraude publicitaire.

displayViewability

enum (DisplayViewability)

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

videoViewability

enum (VideoViewability)

Section "Visibilité de la vidéo" (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 inclus.

TRAQScore

Plages possibles pour le score Integral Ad Science TRAQ (vraie qualité publicitaire).

Enums
TRAQ_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucun véritable niveau de qualité publicitaire.
TRAQ_250 Score TRAQ compris entre 250 et 1 000.
TRAQ_500 Score TRAQ 500-1000.
TRAQ_600 Score TRAQ 600-1000.
TRAQ_700 Score TRAQ 700-1000.
TRAQ_750 Score TRAQ 750-1000.
TRAQ_875 Score TRAQ 875-1000.
TRAQ_1000 Score TRAQ de 1 000.

Adulte

Options disponibles pour les adultes Integral Ad Science.

Enums
ADULT_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option pour adultes.
ADULT_HR Adulte : Exclure les éléments à risque élevé.
ADULT_HMR Adulte : exclut les risques élevés et modérés.

Alcool

Options possibles d'Integral Ad Science concernant les alcools.

Enums
ALCOHOL_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option liée à l'alcool.
ALCOHOL_HR Alcools – Exclure les éléments à risque élevé
ALCOHOL_HMR Alcools - Excluez les risques élevé et modéré.

IllegalDownloads

Options possibles de téléchargement Integral Ad Science illégales.

Enums
ILLEGAL_DOWNLOADS_UNSPECIFIED Cette énumération 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 : excluez les risques élevé et modéré.

Drogues

Options possibles pour les médicaments Integral Ad Science.

Enums
DRUGS_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option médicamenteuse.
DRUGS_HR Drogues – Exclure les éléments à risque élevé
DRUGS_HMR Drogues – Exclure les risques élevé et modéré

HateSpeech

Options possibles d'Integral Ad Science concernant l'incitation à la haine.

Enums
HATE_SPEECH_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option concernant l'incitation à la haine.
HATE_SPEECH_HR Incitation à la haine – Exclure les éléments à risque élevé
HATE_SPEECH_HMR Incitation à la haine – Excluez les éléments à risque élevé et modéré.

OffensiveLanguage

Options de langage choquantes proposées par Integral Ad Science.

Enums
OFFENSIVE_LANGUAGE_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de langue.
OFFENSIVE_LANGUAGE_HR Termes choquants – Exclure les éléments à haut risque.
OFFENSIVE_LANGUAGE_HMR Termes choquants – Excluez les éléments à risque élevé et modéré.

Violence

Options possibles concernant la violence Integral Ad Science.

Enums
VIOLENCE_UNSPECIFIED Cette énumération 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 – Excluez les éléments à risque élevé et modéré.

Jeux d'argent et de hasard

Options de jeux d'argent et de hasard Integral Ad Science disponibles.

Enums
GAMBLING_UNSPECIFIED Cette énumération 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 : excluez les risques élevé et modéré.

AdFraudPrevention

Options de prévention des fraudes publicitaires proposées par Integral Ad Science

Enums
SUSPICIOUS_ACTIVITY_UNSPECIFIED Cette énumération 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 : excluez les éléments à risque élevé.
SUSPICIOUS_ACTIVITY_HMR Fraude publicitaire : excluez les risques élevés et modérés.

DisplayViewability

Options de visibilité des annonces display Integral Ad Science.

Enums
PERFORMANCE_VIEWABILITY_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de visibilité de l'affichage.
PERFORMANCE_VIEWABILITY_40 Cibler au minimum 40% de visibilité.
PERFORMANCE_VIEWABILITY_50 Cibler au minimum 50% de visibilité.
PERFORMANCE_VIEWABILITY_60 Cibler au minimum 60% de visibilité.
PERFORMANCE_VIEWABILITY_70 Cibler au minimum 70% de visibilité.

VideoViewability

Options de visibilité possibles des vidéos Integral Ad Science.

Enums
VIDEO_VIEWABILITY_UNSPECIFIED Cette énumération n'est qu'un espace réservé et ne spécifie aucune option de visibilité des vidéos.
VIDEO_VIEWABILITY_40 Plus de 40%visibles (norme de visibilité vidéo de l'IAB).
VIDEO_VIEWABILITY_50 Plus de 50%visibles (norme de visibilité vidéo de l'IAB).
VIDEO_VIEWABILITY_60 Plus de 60%visibles (norme de visibilité vidéo de l'IAB).
VIDEO_VIEWABILITY_70 Plus de 70%visibles (norme de visibilité vidéo de l'IAB).

PoiAssignedTargetingOptionDetails

Détails de l'option de ciblage par POI attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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 POI (par exemple, "Times Square", "Space Needle"), suivi de son adresse complète, le cas échéant.

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_POI.

Les ID d'option de ciblage de POI acceptés peuvent être récupérés à l'aide de SearchTargetingOptions.

Si vous ciblez des coordonnées de latitude/longitude spécifiques supprimées du nom d'une adresse ou d'un POI, vous pouvez générer l'ID d'option de ciblage nécessaire en arrondissant les coordonnées souhaitées à la sixième décimale, en supprimant les décimales et en concaténant les valeurs de la chaîne séparées par un point-virgule. Par exemple, vous pouvez cibler la paire latitude/longitude 40.7414691, -74.003387 à l'aide de l'ID d'option de ciblage "40741469;-74003387".

latitude

number

Uniquement en sortie. Latitude du POI arrondie à la sixième décimale.

longitude

number

Uniquement en sortie. Longitude du POI 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 par laquelle le rayon de ciblage est mesuré.

DistanceUnit

Options d'unité de distance possibles

Enums
DISTANCE_UNIT_UNSPECIFIED La valeur de 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 de la chaîne d'établissements attribuée. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption 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. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_BUSINESS_CHAIN.

Les ID acceptés d'option de ciblage par chaîne d'établissements peuvent être récupérés à 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 dans les deux cas est de 0,1. Les données saisies 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 par laquelle le rayon de ciblage est mesuré.

ContentDurationAssignedTargetingOptionDetails

Informations sur l'option de ciblage attribuée à la durée du contenu. Ce champ est renseigné dans le champ contentDurationDetails lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_DURATION. Le ciblage explicite de toutes les options n'est pas accepté. Pour obtenir cet effet, supprimez toutes les options de ciblage par durée du contenu.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_DURATION.

contentDuration

enum (ContentDuration)

Uniquement en sortie. Durée du contenu.

ContentStreamTypeAssignedTargetingOptionDetails

Informations sur l'option de ciblage attribuée au type de flux de contenu. Ce champ est renseigné dans le champ contentStreamTypeDetails lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_STREAM_TYPE. Le ciblage explicite de toutes les options n'est pas accepté. Pour obtenir ce résultat, supprimez toutes les options de ciblage par type de flux de contenu.

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

string

Obligatoire. 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

Informations sur l'option de ciblage attribuée à la position du contenu natif. Ce champ est renseigné dans le champ nativeContentPositionDetails lorsque targetingType est défini sur TARGETING_TYPE_NATIVE_CONTENT_POSITION. Le ciblage explicite de toutes les options n'est pas accepté. Pour obtenir cet effet, supprimez toutes les options de ciblage par position du contenu natif.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_NATIVE_CONTENT_POSITION.

contentPosition

enum (NativeContentPosition)

Position du contenu.

Résultat uniquement dans v1. Obligatoire dans la version 2.

OmidAssignedTargetingOptionDetails

Représente un type d'inventaire disponible pour le ciblage Open Measurement. Cette valeur est renseignée dans le champ de détails d'une AssignedTargetOption lorsque targetingType est défini sur TARGETING_TYPE_OMID.

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

enum (Omid)

Type d'inventaire activé pour Open Measurement.

Résultat uniquement dans v1. Obligatoire dans la version 2.

targetingOptionId

string

Obligatoire. Le targetingOptionId d'un TargetingOption de type TARGETING_TYPE_OMID.

AudioContentTypeAssignedTargetingOptionDetails

Informations sur l'option de ciblage attribuée au type de contenu audio. Ce champ est renseigné dans le champ audioContentTypeDetails lorsque targetingType est défini sur TARGETING_TYPE_AUDIO_CONTENT_TYPE. Le ciblage explicite de toutes les options n'est pas accepté. Pour obtenir cet effet, supprimez toutes les options de ciblage par type de contenu audio.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_AUDIO_CONTENT_TYPE.

audioContentType

enum (AudioContentType)

Type de contenu audio.

Résultat uniquement dans v1. Obligatoire dans la version 2.

ContentGenreAssignedTargetingOptionDetails

Informations sur l'option de ciblage attribuée au genre de contenu. Ce champ est renseigné dans le champ contentGenreDetails lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_GENRE. Le ciblage explicite de toutes les options n'est pas accepté. Pour obtenir cet effet, supprimez toutes les options de ciblage par genre de contenu.

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

string

Obligatoire. Champ targetingOptionId lorsque targetingType est défini sur TARGETING_TYPE_CONTENT_GENRE.

displayName

string

Uniquement en sortie. Nom à afficher pour le genre de contenu.

negative

boolean

Indique si cette option fait l'objet d'un ciblage par exclusion.

Méthodes

get

Permet d'obtenir une seule option de ciblage attribuée à une campagne.

list

Liste les options de ciblage attribuées à une campagne pour un type de ciblage spécifié.