REST Resource: partners.targetingTypes.assignedTargetingOptions

Recurso: AssignedTargetingOption

Uma única opção de segmentação atribuída, que define o estado de uma opção de segmentação para uma entidade com configurações de segmentação.

Representação 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.
}
Campos
name

string

Apenas saída. O nome do recurso para esta opção de segmentação atribuída.

assignedTargetingOptionId

string

Apenas saída. O ID exclusivo da opção de segmentação atribuída. O ID é exclusivo apenas em um determinado recurso e tipo de segmentação. Eles poderão ser reutilizados em outros contextos.

targetingType

enum (TargetingType)

Apenas saída. Identifica o tipo dessa opção de segmentação atribuída.

inheritance

enum (Inheritance)

Apenas saída. O status de herança da opção de segmentação atribuída.

Campo de união details. Informações detalhadas sobre a opção de segmentação atribuída. Só é possível preencher um campo detalhado, que deve corresponder a targeting_type. O valor details só pode ser de uma das seguintes opções:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Detalhes do canal. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Detalhes da categoria do app. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Detalhes do app Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Detalhes do URL. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalhes de dia e hora. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Detalhes da faixa etária. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalhes da lista de locais regionais. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalhes da lista de locais próximos. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalhes do sexo. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Detalhes do tamanho do player de vídeo. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalhes do conteúdo premiado para o usuário Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Detalhes do status parental Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Detalhes da posição in-stream do conteúdo Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Detalhes da posição out-stream do conteúdo Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Detalhes do tipo de dispositivo Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Detalhes da segmentação por público-alvo Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_AUDIENCE_GROUP. Só é possível segmentar uma opção de grupo de compartilhamento por recurso.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Detalhes do navegador. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Detalhes da renda familiar. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Detalhes de posição na tela. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalhes da operadora e do ISP Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalhes da palavra-chave Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_KEYWORD.

É possível atribuir até 5.000 palavras-chave negativas diretas a um recurso. Não há limite para o número de palavras-chave positivas que podem ser atribuídas.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Detalhes da palavra-chave Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

É possível atribuir até quatro listas de palavras-chave negativas a um recurso.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Detalhes do sistema operacional. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Detalhes da marca e do modelo do dispositivo. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Detalhes do ambiente. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Detalhes da origem de inventário Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Detalhes da categoria. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CATEGORY.

Segmentar uma categoria também segmenta as subcategorias dela. Se uma categoria for excluída da segmentação e uma subcategoria for incluída, a exclusão vai prevalecer.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalhes de visibilidade. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_VIEWABILITY.

Só é possível segmentar uma opção de visibilidade por recurso.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Detalhes do status do vendedor autorizado. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Só é possível segmentar uma opção de status de vendedor autorizado por recurso.

Se um recurso não tiver uma opção de status de vendedor autorizado, todos os vendedores autorizados indicados como DIRECT ou RESELLER no arquivo ads.txt serão segmentados por padrão.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Detalhes do idioma. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Detalhes da região geográfica. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalhes do grupo de origem de inventário. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalhes da classificação de conteúdo digital Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

As classificações de conteúdo digital são exclusões de segmentação. As exclusões de classificação de conteúdo digital no nível do anunciante, quando definidas, são sempre aplicadas na veiculação, mesmo que não estejam visíveis nas configurações do recurso. As configurações do recurso podem excluir classificações de conteúdo e de anunciantes, mas não podem substituí-las. Um item de linha não será veiculado se todas as classificações de conteúdo digital forem excluídas.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Detalhes da categoria sensível. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

As categorias sensíveis são exclusões de segmentação. As exclusões de categoria sensível no nível do anunciante, quando definidas, são sempre aplicadas na veiculação, mesmo que não estejam visíveis nas configurações do recurso. As configurações de recursos podem excluir categorias sensíveis, além de exclusões de anunciantes, mas não podem substituí-las.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalhes da troca. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Detalhes da subtroca. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Detalhes da verificação de terceiros Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Detalhes do PDI. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Detalhes da rede de negócios. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Detalhes da duração do conteúdo Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Detalhes da duração do conteúdo Este campo será preenchido quando o SegmentType for TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Detalhes da posição do conteúdo nativo Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Detalhes do inventário com o Open Measurement ativado Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Detalhes do tipo de conteúdo de áudio Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Detalhes do gênero do conteúdo. Esse campo vai ser preenchido quando targetingType for TARGETING_TYPE_CONTENT_GENRE.

Métodos

create

Atribui uma opção de segmentação a um parceiro.

delete

Exclui uma opção de segmentação atribuída de um parceiro.

get

Recebe uma única opção de segmentação atribuída a um parceiro.

list

Lista as opções de segmentação atribuídas a um parceiro.