REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Recurso: AssignedTargetingOption

Es una única opción de segmentación asignada, que define el estado de una opción de segmentación para una entidad con configuración de segmentación.

Representación 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.
}
Campos
name

string

Solo salida. Es el nombre del recurso de esta opción de segmentación asignada.
assignedTargetingOptionId

string

Solo salida. Es el ID único de la opción de segmentación asignada. El ID solo es único dentro de un recurso y un tipo de segmentación determinados. Se puede reutilizar en otros contextos.
assignedTargetingOptionIdAlias

string

Solo salida. Es un alias para assignedTargetingOptionId. Este valor se puede usar en lugar de assignedTargetingOptionId cuando se recupera o borra la segmentación existente.

Este campo solo se admitirá para todas las opciones de segmentación asignadas de los siguientes tipos de segmentación:

  • 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

Este campo también se admite para las opciones de segmentación asignadas a líneas de pedido de los siguientes tipos de segmentación:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Solo salida. Identifica el tipo de esta opción de segmentación asignada.
inheritance

enum (Inheritance)

Solo salida. Es el estado de herencia de la opción de segmentación asignada.
Campo de unión details. Información detallada sobre la opción de segmentación que se asigna. Solo se puede completar un campo en los detalles, y debe corresponder a targeting_type. details solo puede ser una de las siguientes opciones:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Detalles del canal Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_CHANNEL.
appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Detalles de la categoría de la app Este campo se propagará cuando targetingType sea TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Detalles de la app. Este campo se propagará cuando targetingType sea TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Detalles de la URL. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalles del día y la hora Este campo se propagará cuando targetingType sea TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Detalles del rango de edad Este campo se propagará cuando targetingType sea TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones regionales Este campo se propagará cuando targetingType sea TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones de proximidad Este campo se propagará cuando targetingType sea TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalles del género Este campo se propagará cuando targetingType sea TARGETING_TYPE_GENDER.
videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Detalles del tamaño del reproductor de video Este campo se propagará cuando targetingType sea TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalles del contenido recompensado del usuario Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Detalles del estado parental Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Detalles de la posición in-stream del contenido Este campo se propagará cuando targetingType sea TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Detalles de la posición del contenido fuera del flujo Este campo se propagará cuando targetingType sea TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Detalles del tipo de dispositivo Este campo se propagará cuando targetingType sea TARGETING_TYPE_DEVICE_TYPE.
audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Detalles de la segmentación por público Este campo se propagará cuando targetingType sea TARGETING_TYPE_AUDIENCE_GROUP. Solo puedes segmentar tus anuncios para una opción de grupo de público por recurso.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

Detalles del navegador Este campo se propagará cuando targetingType sea TARGETING_TYPE_BROWSER.
householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Detalles del ingreso familiar. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Detalles de la posición en pantalla Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_ON_SCREEN_POSITION.
carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalles del ISP y el proveedor. Este campo se propagará cuando targetingType sea TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalles de la palabra clave Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_KEYWORD.

Se puede asignar un máximo de 5,000 palabras clave negativas directas a un recurso. No hay límite para la cantidad de palabras clave positivas que se pueden asignar.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Detalles de la palabra clave Este campo se propagará cuando targetingType sea TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Se puede asignar un máximo de 4 listas de palabras clave negativas a un recurso.
operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Detalles del sistema operativo Este campo se propagará cuando targetingType sea TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Detalles de la marca y el modelo del dispositivo Este campo se propagará cuando targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.
environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Detalles del entorno. Este campo se propagará cuando targetingType sea TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Detalles de la fuente del inventario Este campo se propagará cuando targetingType sea TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Detalles de la categoría Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_CATEGORY.

Si segmentas una categoría, también se segmentarán sus subcategorías. Si se excluye una categoría de la segmentación y se incluye una subcategoría, la exclusión tendrá prioridad.
viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalles de visibilidad Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_VIEWABILITY.

Solo puedes segmentar una opción de visibilidad por recurso.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Detalles del estado de vendedor autorizado Este campo se propagará cuando targetingType sea TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Solo puedes segmentar una opción de estado de vendedor autorizado por recurso.

Si un recurso no tiene una opción de estado de vendedor autorizado, todos los vendedores autorizados que se indican como DIRECTO o DISTRIBUIDOR en el archivo ads.txt se segmentan de forma predeterminada.
languageDetails

object (LanguageAssignedTargetingOptionDetails)

Detalles del idioma. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_LANGUAGE.
geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Detalles de la región geográfica Este campo se propagará cuando targetingType sea TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalles del grupo de fuentes de inventario Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalles de la etiqueta de contenido digital Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Las etiquetas de contenido digital son exclusiones de segmentación. Si se establecen, las exclusiones de etiquetas de contenido digital a nivel del anunciante siempre se aplican en la publicación (aunque no sean visibles en la configuración de recursos). La configuración de recursos puede excluir etiquetas de contenido además de las exclusiones de anunciantes, pero no puede anularlas. Una línea de pedido no se publicará si se excluyen todas las etiquetas de contenido digital.
sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Detalles de categoría sensible. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Las categorías sensibles son exclusiones de segmentación. Si se establecen, las exclusiones de categorías sensibles a nivel del anunciante siempre se aplican en la publicación (aunque no sean visibles en la configuración de recursos). La configuración de recursos puede excluir categorías sensibles además de exclusiones de anunciantes, pero no puede anularlas.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalles del intercambio. Este campo se propagará cuando targetingType sea TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Detalles del intercambio secundario. Este campo se propagará cuando targetingType sea TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Detalles de verificación de terceros. Este campo se propagará cuando targetingType sea TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Detalles del lugar de interés Este campo se propagará cuando targetingType sea TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Detalles de la cadena empresarial Este campo se propagará cuando targetingType sea TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Detalles de la duración del contenido Este campo se propagará cuando targetingType sea TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Detalles de la duración del contenido. Este campo se propagará cuando el TargetingType sea TARGETING_TYPE_CONTENT_STREAM_TYPE.
nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Detalles de la posición del contenido nativo Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Detalles del inventario habilitado para Open Measurement Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Detalles del tipo de contenido de audio Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Detalles del género del contenido Este campo se propagará cuando targetingType sea TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Detalles del video de YouTube Este campo se propagará cuando targetingType sea TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Detalles del canal de YouTube. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Detalles de la posición de la sesión. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_SESSION_POSITION.

Métodos

create

 Asigna una opción de segmentación a un pedido de inserción.

delete

 Borra una opción de segmentación asignada de un pedido de inserción.

get

 Obtiene una sola opción de segmentación asignada a un pedido de inserción.

list

 Muestra una lista de las opciones de segmentación asignadas a un pedido de inserción.