REST Resource: advertisers.insertionOrders.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,
  "assignedTargetingOptionIdAlias": 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)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // 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.
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 du ciblage existant.

Ce champ ne sera compatible qu'avec 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 types de ciblage suivants pour les éléments de campagne:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
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.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Détails de la vidéo YouTube Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

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

object (SessionPositionAssignedTargetingOptionDetails)

Détails de la position de la session. Ce champ sera renseigné lorsque targetingType aura la valeur TARGETING_TYPE_SESSION_POSITION.

Méthodes

create

 Attribue une option de ciblage à un ordre d'insertion.

delete

 Supprime une option de ciblage attribuée d'un ordre d'insertion.

get

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

list

 Liste les options de ciblage attribuées à un ordre d'insertion.