REST Resource: advertisers.insertionOrders.targetingTypes.assignedTargetingOptions

Recurso: AssignedTargetingOption

Es una sola 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)
  },
  "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)
  }
  // End of list of possible types for union field details.
}
Campos
name

string

Solo salida. Es el nombre del recurso para 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 es compatible con las opciones de segmentación asignadas a la línea 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. Es 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 uno de los siguientes:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

object (AppCategoryAssignedTargetingOptionDetails)

Son los detalles de la categoría de la app. Este campo se completará cuando targetingType sea TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

Son los detalles de la app. Este campo se completará cuando targetingType sea TARGETING_TYPE_APP.
urlDetails

object (UrlAssignedTargetingOptionDetails)

Son los detalles de la URL. Este campo se completará cuando targetingType sea TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalles de la fecha y la hora Este campo se completará cuando targetingType sea TARGETING_TYPE_DAY_AND_TIME.
ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Son los detalles del rango de edad. Este campo se completará cuando targetingType sea TARGETING_TYPE_AGE_RANGE.
regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Son los detalles de la lista de ubicaciones regionales. Este campo se completará cuando targetingType sea TARGETING_TYPE_REGIONAL_LOCATION_LIST.
proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Son los detalles de la lista de ubicaciones cercanas. Este campo se completará cuando targetingType sea TARGETING_TYPE_PROXIMITY_LOCATION_LIST.
genderDetails

object (GenderAssignedTargetingOptionDetails)

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

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Son los detalles del tamaño del reproductor de video. Este campo se completará cuando targetingType sea TARGETING_TYPE_VIDEO_PLAYER_SIZE.
userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Son los detalles del contenido recompensado del usuario. Este campo se completará cuando targetingType sea TARGETING_TYPE_USER_REWARDED_CONTENT.
parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Son los detalles del estado parental. Este campo se completará cuando targetingType sea TARGETING_TYPE_PARENTAL_STATUS.
contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Son los detalles de la posición del contenido instream. Este campo se completará cuando targetingType sea TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Son los detalles de la posición del contenido out-stream. Este campo se completará cuando targetingType sea TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.
deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

object (AudienceGroupAssignedTargetingOptionDetails)

Son los detalles de la segmentación por público. Este campo se completará cuando targetingType sea TARGETING_TYPE_AUDIENCE_GROUP. Solo puedes segmentar cada recurso para una opción de grupo de público.
browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

object (HouseholdIncomeAssignedTargetingOptionDetails)

Son los detalles del ingreso familiar. Este campo se completará cuando targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.
onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalles del operador y el ISP Este campo se completará cuando targetingType sea TARGETING_TYPE_CARRIER_AND_ISP.
keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Son los detalles de la palabra clave. Este campo se completará cuando 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 en la cantidad de palabras clave positivas que se pueden asignar.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Son los detalles de la palabra clave. Este campo se completará 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 completará cuando targetingType sea TARGETING_TYPE_OPERATING_SYSTEM.
deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

object (EnvironmentAssignedTargetingOptionDetails)

Son los detalles del entorno. Este campo se completará cuando targetingType sea TARGETING_TYPE_ENVIRONMENT.
inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Son los detalles de la fuente de inventario. Este campo se completará cuando targetingType sea TARGETING_TYPE_INVENTORY_SOURCE.
categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Son los detalles de la categoría. Este campo se completará cuando targetingType sea TARGETING_TYPE_CATEGORY.

Si segmentas para una categoría, también se segmentará para sus subcategorías. Si una categoría se excluye 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 targetingType sea TARGETING_TYPE_VIEWABILITY.

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Son los detalles del estado de vendedor autorizado. Este campo se completará cuando targetingType sea TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

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

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

Son los detalles de la región geográfica. Este campo se completará cuando targetingType sea TARGETING_TYPE_GEO_REGION.
inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Son los detalles del grupo de fuentes del inventario. Este campo se completará cuando targetingType sea TARGETING_TYPE_INVENTORY_SOURCE_GROUP.
digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Son los detalles de la etiqueta de contenido digital. Este campo se completará cuando targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Las etiquetas de contenido digital son exclusiones de segmentación. Si se configuran exclusiones de etiquetas de contenido digital a nivel del anunciante, estas siempre se aplican en la publicación (aunque no se vean 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)

Son los detalles de la categoría sensible. Este campo se completará cuando targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

object (ContentThemeAssignedTargetingOptionDetails)

Son los detalles del tema del contenido. Este campo se completará cuando targetingType sea TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Los temas de contenido son exclusiones de segmentación. Si se configuran, las exclusiones de temas de contenido a nivel del anunciante siempre se aplican en la publicación (aunque no se vean en la configuración de recursos). La configuración del recurso puede excluir temas de contenido, además de las exclusiones del anunciante.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Son los detalles del intercambio. Este campo se completará cuando targetingType sea TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Son los detalles del subintercambio. Este campo se completará cuando targetingType sea TARGETING_TYPE_SUB_EXCHANGE.
thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Son los detalles de la verificación de terceros. Este campo se completará cuando targetingType sea TARGETING_TYPE_THIRD_PARTY_VERIFIER.
poiDetails

object (PoiAssignedTargetingOptionDetails)

Son los detalles del PDI. Este campo se completará cuando targetingType sea TARGETING_TYPE_POI.
businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Son los detalles de la cadena empresarial. Este campo se completará cuando targetingType sea TARGETING_TYPE_BUSINESS_CHAIN.
contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Son los detalles de la duración del contenido. Este campo se completará cuando targetingType sea TARGETING_TYPE_CONTENT_DURATION.
contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

Son los detalles de la posición del contenido nativo. Este campo se completará cuando targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION.
omidDetails

object (OmidAssignedTargetingOptionDetails)

Son los detalles del inventario habilitado para Open Measurement. Este campo se completará cuando targetingType sea TARGETING_TYPE_OMID.
audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Son los detalles del tipo de contenido de audio. Este campo se completará cuando targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE.
contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Son los detalles del género del contenido. Este campo se completará cuando targetingType sea TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Son los detalles del video de YouTube. Este campo se completará cuando targetingType sea TARGETING_TYPE_YOUTUBE_VIDEO.
youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Son los detalles del canal de YouTube. Este campo se completará cuando targetingType sea TARGETING_TYPE_YOUTUBE_CHANNEL.
sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Son los detalles de la posición de la sesión. Este campo se completará cuando targetingType sea TARGETING_TYPE_SESSION_POSITION.

Métodos

create

 Asigna una opción de segmentación a una orden de inserción.

delete

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

get

 Obtiene un solo objeto TargetingOption asignado a un pedido de inserción.

list

 Enumera las opciones de segmentación asignadas a una orden de inserción.