REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

string (int64 format)

Obrigatório. ID do canal. Deve se referir ao campo "ID do canal" em um recurso de canal de propriedade do parceiro ou canal de propriedade do anunciante.

boolean

Indica se essa opção está sendo segmentada negativamente. Para a opção de segmentação atribuída no nível do anunciante, esse campo precisa ser "true".

string

Apenas saída. O nome de exibição da categoria do app.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_APP_CATEGORY.

boolean

Indica se essa opção está sendo segmentada negativamente.

string

Obrigatório. O ID do aplicativo.

O app Play Store do Android usa o ID do pacote, por exemplo, com.google.android.gm. O ID do app da App Store da Apple usa uma string de nove dígitos, por exemplo, 422689480.

string

Apenas saída. O nome de exibição do app.

boolean

Indica se essa opção está sendo segmentada negativamente.

enum (AppPlatform)

Indica a plataforma do app segmentado. Se esse campo não for especificado, a plataforma do app será considerada para dispositivos móveis (ou seja, Android ou iOS), e vamos derivar a plataforma móvel adequada do ID do app.

string

Obrigatório. O URL, por exemplo, example.com.

O DV360 é compatível com dois níveis de segmentação de subdiretório, por exemplo, www.example.com/one-subdirectory-level/second-level, e cinco níveis de segmentação de subdomínio, por exemplo, five.four.three.two.one.example.com.

boolean

Indica se essa opção está sendo segmentada negativamente.

enum (DayOfWeek)

Obrigatório. O dia da semana para essa configuração de segmentação por dia e hora.

integer

Obrigatório. A hora de início da segmentação por dia e horário. Precisa ser um número entre 0 (início do dia) e 23 (uma hora antes do fim do dia).

integer

Obrigatório. A hora de término da segmentação por dia e horário. Precisa ser entre 1 (uma hora após o início do dia) e 24 (fim do dia).

enum (TimeZoneResolution)

Obrigatório. O mecanismo usado para determinar qual fuso horário usar para essa configuração de segmentação por dia e horário.

enum (AgeRange)

Obrigatório. A faixa etária de um público-alvo. Só é possível segmentar um intervalo de idade contínuo de um público-alvo. Assim, a faixa etária representada nesse campo pode ser 1) segmentada apenas ou 2) parte de uma faixa etária contínua maior. O alcance de uma segmentação por faixa etária contínua pode ser ampliado ao segmentar também um público-alvo de idade desconhecida.

string (int64 format)

Obrigatório. ID da lista de locais na região. Precisa se referir ao campo locationListId de um recurso LocationList cujo tipo é TARGETING_LOCATION_TYPE_REGIONAL.

boolean

Indica se essa opção está sendo segmentada negativamente.

string (int64 format)

Obrigatório. ID da lista de locais de proximidade. Precisa se referir ao campo locationListId de um recurso LocationList cujo tipo é TARGETING_LOCATION_TYPE_PROXIMITY.

number

Obrigatório. Raio expresso nas unidades de distância definidas em proximityRadiusUnit. Isso representa o tamanho da área ao redor de um local escolhido que será segmentada. O raio precisa estar entre 1 e 500 milhas ou 800 quilômetros.

enum (ProximityRadiusUnit)

Obrigatório. Unidades de distância do raio.

enum (Gender)

Obrigatório. O gênero do público-alvo.

enum (VideoPlayerSize)

Obrigatório. O tamanho do player de vídeo.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_USER_REWARDED_CONTENT.

enum (UserRewardedContent)

Apenas saída. Status do conteúdo com prêmio para o usuário em anúncios em vídeo.

enum (ParentalStatus)

Obrigatório. O status parental do público-alvo.

enum (ContentInstreamPosition)

Obrigatório. A posição in-stream do conteúdo para anúncios em vídeo ou áudio.

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Essa opção só é aplicável à segmentação por pedido de inserção, e os novos itens de linha que oferecem suporte ao tipo de anúncio especificado a herdarão por padrão. Os valores possíveis são:

• AD_TYPE_VIDEO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_VIDEO_DEFAULT.
• AD_TYPE_AUDIO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_AUDIO_DEFAULT.

enum (ContentOutstreamPosition)

Obrigatório. A posição do conteúdo outstream.

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Essa opção só é aplicável à segmentação por pedido de inserção, e os novos itens de linha que oferecem suporte ao tipo de anúncio especificado a herdarão por padrão. Os valores possíveis são:

• AD_TYPE_DISPLAY, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_DISPLAY_DEFAULT.
• AD_TYPE_VIDEO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_VIDEO_DEFAULT.

enum (DeviceType)

Obrigatório. O nome de exibição do tipo de dispositivo.

number

Apenas saída. Com o multiplicador de lances, você pode veicular seus anúncios com maior ou menor frequência de acordo com o tipo de dispositivo. Ele vai aplicar um multiplicador ao preço do lance original. Quando esse campo é 0, ele indica que o campo não é aplicável, em vez de multiplicar 0 no preço do lance original.

Por exemplo, se o preço do lance sem multiplicador for US $10,0 e o multiplicador for 1,5 para tablet, o preço do lance resultante para tablet será US $15,0.

Aplicável apenas a itens de linha do YouTube e parceiros.

object (FirstAndThirdPartyAudienceGroup)

Opcional. Os IDs e as recências de público-alvo próprios e de terceiros dos grupos de público-alvo próprios e de terceiros incluídos. Cada grupo de público-alvo próprio e de terceiros contém apenas IDs de público-alvo próprios e de terceiros. A relação entre cada grupo de público-alvo próprio e de terceiros é INTERSECTION, e o resultado é UNION com outros grupos de público-alvo. Grupos repetidos com as mesmas configurações serão ignorados.

object (GoogleAudienceGroup)

Opcional. Os IDs de público-alvo do Google do grupo de público-alvo do Google incluído. Contém apenas IDs de público-alvo do Google.

object (CustomListGroup)

Opcional. Os IDs da lista personalizada do grupo de listas personalizadas incluído. Contém apenas IDs de listas personalizadas.

object (CombinedAudienceGroup)

Opcional. Os IDs do público-alvo combinado do grupo incluído. Contém apenas IDs de público-alvo combinado.

object (FirstAndThirdPartyAudienceGroup)

Opcional. Os IDs e as recências de público-alvo próprios e de terceiros do grupo excluído. Usado para segmentação negativa. O COMPLEMENTO da UNIÃO deste grupo e de outros grupos de público-alvo excluídos é usado como uma INTERSEÇÃO para qualquer segmentação positiva de público-alvo. Todos os itens são logicamente "OR" uns dos outros.

object (GoogleAudienceGroup)

Opcional. Os IDs de público-alvo do Google do grupo de público-alvo excluído. Usado para segmentação negativa. O COMPLEMENTO da UNIÃO deste grupo e de outros grupos de público-alvo excluídos é usado como uma INTERSEÇÃO para qualquer segmentação positiva de público-alvo. Contém apenas públicos-alvo do Google de afinidade, no mercado e de apps instalados. Todos os itens são logicamente "OR" uns dos outros.

object (FirstAndThirdPartyAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação por público-alvo próprio e de terceiros no grupo de público-alvo próprio e de terceiros. Não são permitidas configurações repetidas com o mesmo ID.

string (int64 format)

Obrigatório. ID de público-alvo próprio e de terceiros da configuração de segmentação de público-alvo próprio e de terceiros. O ID é firstAndThirdPartyAudienceId.

enum (Recency)

Opcional. A atualização da configuração de segmentação por público-alvo próprio e de terceiros. Aplicável apenas a públicos-alvo próprios. Caso contrário, será ignorado. Para mais informações, consulte https://support.google.com/displayvideo/answer/2949947#recency. Quando não especificado, nenhum limite de frequência é usado.

object (GoogleAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação por público-alvo do Google no grupo de público-alvo do Google. Configurações repetidas com o mesmo ID serão ignoradas.

string (int64 format)

Obrigatório. ID do público-alvo do Google da configuração de segmentação por público-alvo do Google. O ID é googleAudienceId.

object (CustomListTargetingSetting)

Obrigatório. Todas as configurações de segmentação por lista personalizada no grupo de listas personalizadas. Configurações repetidas com o mesmo ID serão ignoradas.

string (int64 format)

Obrigatório. ID personalizado da configuração de segmentação por lista personalizada. O ID é customListId.

object (CombinedAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação por público-alvo combinado no grupo de público-alvo combinado. Configurações repetidas com o mesmo ID serão ignoradas. O número de configurações de público-alvo combinadas não pode ser maior que cinco. Caso contrário, um erro será gerado.

string (int64 format)

Obrigatório. ID do público-alvo combinado da configuração de segmentação por público-alvo combinado. O ID é combinedAudienceId.

string

Apenas saída. O nome de exibição do navegador.

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_BROWSER.

boolean

Indica se essa opção está sendo segmentada negativamente. Todas as opções de segmentação por navegador atribuídas ao mesmo recurso precisam ter o mesmo valor para esse campo.

enum (HouseholdIncome)

Obrigatório. A renda familiar do público-alvo.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_ON_SCREEN_POSITION.

enum (OnScreenPosition)

Apenas saída. A posição na tela.

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Essa opção só é aplicável à segmentação por pedido de inserção, e os novos itens de linha que oferecem suporte ao tipo de anúncio especificado a herdarão por padrão. Os valores possíveis são:

• AD_TYPE_DISPLAY, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_DISPLAY_DEFAULT.
• AD_TYPE_VIDEO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_VIDEO_DEFAULT.

string

Apenas saída. O nome de exibição da operadora ou do ISP.

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_CARRIER_AND_ISP.

boolean

Indica se essa opção está sendo segmentada negativamente. Todas as opções de segmentação por operadora e ISP atribuídas no mesmo recurso precisam ter o mesmo valor para esse campo.

string

Obrigatório. A palavra-chave, por exemplo, car insurance.

A palavra-chave positiva não pode ser ofensiva. Precisa ser codificado em UTF-8 com um tamanho máximo de 255 bytes. O número máximo de caracteres é 80. O número máximo de palavras é 10.

boolean

Indica se essa opção está sendo segmentada negativamente.

string (int64 format)

Obrigatório. ID da lista de palavras-chave negativas. Deve se referir ao campo negativeKeywordListId de um recurso NegativeKeywordList.

string

Apenas saída. O nome de exibição do sistema operacional.

string

Obrigatório. O ID da opção de segmentação preenchido no campo targetingOptionId quando targetingType é TARGETING_TYPE_OPERATING_SYSTEM.

boolean

Indica se essa opção está sendo segmentada negativamente.

string

Apenas saída. O nome de exibição da marca e do modelo do dispositivo.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_DEVICE_MAKE_MODEL.

boolean

Indica se essa opção está sendo segmentada negativamente.

enum (Environment)

Obrigatório. O ambiente de veiculação.

string (int64 format)

Obrigatório. ID da origem de inventário. Precisa se referir ao campo inventorySourceId de um recurso InventorySource.

string

Apenas saída. O nome de exibição da categoria.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CATEGORY.

boolean

Indica se essa opção está sendo segmentada negativamente.

enum (Viewability)

Obrigatório. A porcentagem de visibilidade prevista.

enum (AuthorizedSellerStatus)

Apenas saída. O status de vendedor autorizado a ser segmentado.

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

string

Apenas saída. O nome de exibição do idioma (por exemplo, "Francês").

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_LANGUAGE.

boolean

Indica se essa opção está sendo segmentada negativamente. Todas as opções de segmentação por idioma atribuídas no mesmo recurso precisam ter o mesmo valor para esse campo.

string

Apenas saída. O nome de exibição da região geográfica (por exemplo, "Ontário, Canadá").

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_GEO_REGION.

enum (GeoRegionType)

Apenas saída. O tipo de segmentação por região geográfica.

boolean

Indica se essa opção está sendo segmentada negativamente.

string (int64 format)

Obrigatório. ID do grupo de origens de inventário. Precisa se referir ao campo inventorySourceGroupId de um recurso InventorySourceGroup.

enum (ContentRatingTier)

Obrigatório. O nome de exibição do nível de classificação da classificação de conteúdo digital a ser EXCLUÍDO.

enum (SensitiveCategory)

Obrigatório. Uma enumeração para o conteúdo da categoria sensível do DV360 classificado como EXCLUÍDO.

string

Obrigatório. ID do tema de conteúdo a ser EXCLUÍDO.

enum (ContentTheme)

Apenas saída. Uma enumeração para o classificador de tema de conteúdo do DV360.

enum (ContentTheme)

Obrigatório. Uma enumeração para o tema de conteúdo do DV360 classificado como EXCLUÍDO.

enum (Exchange)

Obrigatório. O valor de enumeração da troca.

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_SUB_EXCHANGE.

object (Adloox)

Verificador de marca terceirizado: Scope3 (antes conhecido como Adloox).

object (DoubleVerify)

Verificador de marca de terceiros: DoubleVerify.

object (IntegralAdScience)

Verificador de marca terceirizado: Integral Ad Science.

enum (AdlooxCategory)

Categorias da Scope3 a serem excluídas.

enum (FraudIvtMfaCategory)

Opcional. Categorias de MFA de IVT de fraude da Scope3 a serem excluídas.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco do GARM para excluir conteúdo sexual explícito e adulto.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco GARM para excluir conteúdo sobre crimes e atos nocivos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de conteúdo sobre armas e munições GARM a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de GARM a serem excluídos para conteúdo sobre morte, ferimentos ou conflito militar.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco GARM de conteúdo sobre questões sociais sensíveis em debate a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco GARM de conteúdo sobre drogas ilícitas/bebidas alcoólicas a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de conteúdo sobre pirataria on-line GARM a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco do GARM para excluir conteúdo sobre discurso de ódio e atos de agressão.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de obscenidade e linguagem obscena GARM a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de GARM para excluir conteúdo nocivo ou spam.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de conteúdo terrorista GARM a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de conteúdo de desinformação GARM a serem excluídos.

enum (DisplayIabViewability)

Opcional. Limite de visibilidade do IAB para anúncios de display.

enum (VideoIabViewability)

Opcional. Limite de visibilidade do IAB para anúncios em vídeo.

object (BrandSafetyCategories)

Controles de brand safety da DV.

enum (AgeRating)

Evite dar lances em apps com a classificação etária.

object (AppStarRating)

Evite dar lances em apps com as classificações por estrelas.

object (DisplayViewability)

Configurações de visibilidade de display (aplicáveis somente a itens de linha de display).

object (VideoViewability)

Configurações de visibilidade de vídeo (aplicáveis somente a itens de linha de vídeo).

object (FraudInvalidTraffic)

Evite sites e apps com histórico de fraude e taxas de tráfego inválido.

string (int64 format)

O ID do segmento personalizado fornecido pela DoubleVerify. O ID precisa começar com "51" e ter oito dígitos. O ID do segmento personalizado não pode ser especificado com nenhum dos seguintes campos:

• brandSafetyCategories
• avoidedAgeRatings
• appStarRating
• fraudInvalidTraffic

boolean

Desconhecido ou não classificável.

enum (HighSeverityCategory)

Categorias de rejeição de alta gravidade de brand safety.

enum (MediumSeverityCategory)

Categorias de rejeição de gravidade média de brand safety.

enum (StarRating)

Evite dar lances em apps com as classificações por estrelas.

boolean

Evite dar lances em apps com classificações por estrelas insuficientes.

enum (IAB)

Segmentar o inventário da Web e do app para aumentar a taxa visível do IAB.

enum (ViewableDuring)

Segmentar o inventário da Web e do app para aumentar 100% de duração da visualização.

enum (VideoIAB)

Segmentar o inventário da Web para aumentar a taxa visível do IAB.

enum (VideoViewableRate)

Segmentar o inventário da Web para aumentar a taxa visível total.

enum (PlayerImpressionRate)

Segmentar o inventário para maximizar as impressões com players de 400 x 300 ou maiores.

enum (FraudOption)

Evite sites e apps com histórico de fraude e tráfego inválido.

boolean

Estatísticas históricas de fraude e tráfego inválido insuficientes.

enum (TRAQScore)

Qualidade verdadeira da publicidade (aplicável somente a itens de linha de display).

boolean

Brand safety: Não classificável.

enum (Adult)

Brand safety: conteúdo adulto.

enum (Alcohol)

Brand safety: álcool.

enum (IllegalDownloads)

Brand safety: Downloads ilegais.

enum (Drugs)

Brand safety: drogas.

enum (HateSpeech)

Brand safety: discurso de ódio.

enum (OffensiveLanguage)

Brand safety: Linguagem ofensiva.

enum (Violence)

Brand safety: violência.

enum (Gambling)

Brand safety: jogos de azar.

enum (AdFraudPrevention)

Configurações contra fraude de anúncios.

enum (DisplayViewability)

Seção "Visibilidade da exibição" (aplicável somente a itens de linha de display).

enum (VideoViewability)

Seção de visibilidade de vídeo (aplicável somente a itens de linha de vídeo).

string (int64 format)

O ID do segmento personalizado fornecido pela Integral Ad Science. O ID precisa estar entre 1000001 e 1999999 ou 3000001 e 3999999, incluindo esses valores.

string (int64 format)

Opcional. O ID do segmento personalizado de sincronização de qualidade fornecido pela Integral Ad Science. O ID precisa estar entre 3000000 e 4999999, incluindo esses dois valores.

string

Apenas saída. O nome de exibição de um PDI, por exemplo, "Times Square", "Space Needle", seguido do endereço completo, se disponível.

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_POI.

Os IDs das opções de segmentação por PDI aceitas podem ser recuperados usando targetingTypes.targetingOptions.search.

Se você estiver segmentando uma coordenada de latitude/longitude específica removida de um endereço ou nome de PDI, gere o ID da opção de segmentação necessária arredondando os valores de coordenada desejados para a 6ª casa decimal, removendo os decimais e concatenando os valores de string separados por um ponto e vírgula. Por exemplo, você pode segmentar o par latitude/longitude 40.7414691, -74.003387 usando o ID da opção de segmentação "40741469;-74003387". Após a criação, o valor desse campo será atualizado para anexar um ponto e vírgula e um valor de hash alfanumérico se apenas coordenadas de latitude/longitude forem fornecidas.

number

Apenas saída. Latitude do PDI arredondada para a sexta casa decimal.

number

Apenas saída. Longitude do PDI arredondada para a sexta casa decimal.

number

Obrigatório. O raio da área ao redor do PDI que será segmentada. As unidades do raio são especificadas por proximityRadiusUnit. Precisa ser de 1 a 800 se a unidade for DISTANCE_UNIT_KILOMETERS e de 1 a 500 se a unidade for DISTANCE_UNIT_MILES.

enum (DistanceUnit)

Obrigatório. A unidade de distância em que o raio de segmentação é medido.

string

Apenas saída. O nome de exibição de uma rede de empresas, por exemplo, "KFC", "Chase Bank".

string

Obrigatório. O targetingOptionId de um TargetingOption do tipo TARGETING_TYPE_BUSINESS_CHAIN.

Os IDs das opções de segmentação de redes de negócios aceitas podem ser recuperados usando SearchTargetingOptions.

number

Obrigatório. O raio da área ao redor da franquia que será segmentada. As unidades do raio são especificadas por proximityRadiusUnit. Precisa ser de 1 a 800 se a unidade for DISTANCE_UNIT_KILOMETERS e de 1 a 500 se a unidade for DISTANCE_UNIT_MILES. O incremento mínimo para os dois casos é 0,1. As entradas serão arredondadas para o valor aceitável mais próximo se forem muito granulares. Por exemplo, 15,57 se torna 15,6.

enum (DistanceUnit)

Obrigatório. A unidade de distância em que o raio de segmentação é medido.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CONTENT_DURATION.

enum (ContentDuration)

Apenas saída. A duração do conteúdo.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CONTENT_STREAM_TYPE.

enum (ContentStreamType)

Apenas saída. O tipo de transmissão de conteúdo.

enum (NativeContentPosition)

Obrigatório. A posição do conteúdo.

enum (Omid)

Obrigatório. O tipo de inventário com Open Measurement ativado.

enum (AudioContentType)

Obrigatório. O tipo de conteúdo de áudio.

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CONTENT_GENRE.

string

Apenas saída. O nome de exibição do gênero de conteúdo.

boolean

Indica se essa opção está sendo segmentada negativamente.

string

O ID do vídeo do YouTube como aparece na página de exibição do YouTube.

boolean

Indica se essa opção está sendo segmentada negativamente.

string

O ID do canal do usuário que fez o envio ou o código de um canal do YouTube.

boolean

Indica se essa opção está sendo segmentada negativamente.

enum (SessionPosition)

A posição em que o anúncio vai aparecer em uma sessão.