REST Resource: partners.targetingTypes.assignedTargetingOptions

Ressource : AssignedTargetingOption

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

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

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

string

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

assignedTargetingOptionId

string

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

assignedTargetingOptionIdAlias

string

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

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

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

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

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

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

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

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

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

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

genderDetails

object (GenderAssignedTargetingOptionDetails)

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

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

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

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

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

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

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

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

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

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

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

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

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

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

contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

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

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

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

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

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

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

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

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

lookalikeAudienceDetails

object (LookalikeAudienceAssignedTargetingOptionDetails)

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

googleAudienceDetails

object (GoogleAudienceAssignedTargetingOptionDetails)

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

customListDetails

object (CustomListAssignedTargetingOptionDetails)

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

combinedAudienceDetails

object (CombinedAudienceAssignedTargetingOptionDetails)

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

firstPartyAndPartnerAudienceDetails

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

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

auctionPackageDetails

object (AuctionPackageAssignedTargetingOptionDetails)

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

youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

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

Fin des champs mutuellement exclusifs.

Méthodes

create

Attribue une option de ciblage à un partenaire.

delete

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

get

Récupère une seule option de ciblage attribuée à un partenaire.

list

Répertorie les options de ciblage attribuées à un partenaire.