REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

string (int64 format)

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

boolean

Indica se essa opção está sendo segmentada negativamente. Para a opção de segmentação atribuída ao anunciante, este campo precisa ser verdadeiro.

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 da 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 9 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 de destino. Se esse campo não for especificado, a plataforma do app será considerada como móvel (ou seja, Android ou iOS), e vamos derivar a plataforma móvel apropriada 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 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 hora. 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 público-alvo com um intervalo de idade contínuo. Assim, a faixa etária representada neste campo pode ser 1) segmentada exclusivamente 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 um público-alvo de idade desconhecida.

string (int64 format)

Obrigatório. ID da lista de locais regionais. Deve 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. Deve 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. Representa o tamanho da área ao redor de um local escolhido que será segmentado. 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. Posição do conteúdo in-stream 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ó é válida para a segmentação de pedidos de inserção, e os novos itens de linha que oferecem suporte ao tipo de anúncio especificado vão herdar essa opção de segmentaçã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ó é válida para a segmentação de pedidos de inserção, e os novos itens de linha que oferecem suporte ao tipo de anúncio especificado vão herdar essa opção de segmentaçã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 com base no tipo de dispositivo. Um multiplicador será aplicado ao preço do lance original. Quando esse campo é 0, ele indica que 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,00 e o multiplicador for 1,5 para "Tablet", o preço do lance resultante para "Tablet" será US $15,00.

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

object (FirstAndThirdPartyAudienceGroup)

Opcional. Os IDs e as moedas dos públicos-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 é UNIDO a outros grupos de público-alvo. Grupos repetidos com as mesmas configurações serão ignorados.

object (GoogleAudienceGroup)

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

object (CustomListGroup)

Opcional. Os IDs de 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 combinados.

object (FirstAndThirdPartyAudienceGroup)

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

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 desse grupo e de outros grupos de público-alvo excluídos é usado como uma INTERSEÇÃO para qualquer segmentação de público-alvo positiva. Contém apenas públicos-alvo do Google de afinidade, no mercado e de apps instalados. Todos os itens são logicamente "OR" entre si.

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 do público-alvo próprio e de terceiros da configuração de segmentação de público-alvo próprio e de terceiros. Esse ID é firstAndThirdPartyAudienceId.

enum (Recency)

Opcional. A recência 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. Se não for especificado, nenhum limite de recência será 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. As 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. Esse ID é googleAudienceId.

object (CustomListTargetingSetting)

Obrigatório. Todas as configurações de segmentação por lista personalizada no grupo de listas personalizadas. As 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. Esse ID é customListId.

object (CombinedAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação de público-alvo combinado no grupo de público-alvo combinado. As configurações repetidas com o mesmo ID serão ignoradas. O número de configurações de público-alvo combinado 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. Esse 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 no mesmo recurso precisam ter o mesmo valor para este 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ó é válida para a segmentação de pedidos de inserção, e os novos itens de linha que oferecem suporte ao tipo de anúncio especificado vão herdar essa opção de segmentaçã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 este 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 do inventário. Deve 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 do 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 este campo.

string

Apenas saída. O nome de exibição da região geográfica (por exemplo, "Ontario, 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 origem do inventário. Deve se referir ao campo inventorySourceGroupId de um recurso InventorySourceGroup.

enum (ContentRatingTier)

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

enum (SensitiveCategory)

Obrigatório. Um tipo enumerado 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 temas de conteúdo do DV360.

enum (ContentTheme)

Obrigatório. Um tipo enumerado para o tema de conteúdo do DV360 classificado como EXCLUÍDO.

enum (Exchange)

Obrigatório. O valor do tipo enumerado para a troca.

string

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

object (Adloox)

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

object (DoubleVerify)

Verificador de marca de terceiros: DoubleVerify.

object (IntegralAdScience)

Verificador de marca terceirizado: Integral Ad Science.

enum (AdlooxCategory)

Categorias do escopo 3 a serem excluídas.

enum (FraudIvtMfaCategory)

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

enum (GarmRiskExclusion)

Opcional. GARM (mínimo, máximo e risco) para conteúdo adulto e sexualmente explícito a ser excluído.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de Conteúdo sobre crimes e atos nocivos GARM a serem excluídos.

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Opcional. GARM (morte, ferimentos ou conflito militar) intervalos de risco para excluir.

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Opcional. GARM (Risco de drogas ilícitas/conteúdo sobre bebidas alcoólicas) para excluir.

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de GARM (conteúdo sobre discurso de ódio e atos de agressão) a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de conteúdo obsceno e linguagem obscena da GARM a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de GARM (conteúdo nocivo ou spam) a serem excluídos.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de conteúdo terrorista da 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 do DV.

enum (AgeRating)

Evite dar lances em apps com a classificação indicativa.

object (AppStarRating)

Evite dar lances em apps com avaliações com estrelas.

object (DisplayViewability)

Configurações de visibilidade de exibição (aplicável apenas a itens de linha de display).

object (VideoViewability)

Configurações de visibilidade de vídeo (aplicável apenas 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 de 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 evitação de brand safety de gravidade média.

enum (StarRating)

Evite dar lances em apps com avaliações com estrelas.

boolean

Evite dar lances em apps com notas mínimas com estrelas.

enum (IAB)

Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB.

enum (ViewableDuring)

Segmente o inventário da Web e do app para maximizar a duração da visualização de 100%.

enum (VideoIAB)

Segmente o inventário da Web para maximizar a taxa de visibilidade do IAB.

enum (VideoViewableRate)

Segmente o inventário da Web para maximizar a taxa de visualização completa.

enum (PlayerImpressionRate)

Segmente o inventário para maximizar as impressões com um tamanho de player de 400 x 300 ou maior.

enum (FraudOption)

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

boolean

Histórico insuficiente de fraude e estatísticas de tráfego inválido.

enum (TRAQScore)

Qualidade verdadeira da publicidade (aplicável apenas 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 de fraude de anúncios.

enum (DisplayViewability)

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

enum (VideoViewability)

Seção "Visibilidade do vídeo" (aplicável apenas 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 dois 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 de opções de segmentação de PDI aceitas podem ser recuperados usando targetingTypes.targetingOptions.search.

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

number

Apenas saída. Latitude do ponto de interesse arredondado para a sexta casa decimal.

number

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

number

Obrigatório. O raio da área ao redor do PDI que será segmentado. 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 pela qual 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 de opções de segmentação de rede de negócios aceitos podem ser recuperados usando SearchTargetingOptions.

number

Obrigatório. O raio da área ao redor da rede de franquias 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 detalhadas. Por exemplo, 15,57 vai se tornar 15,6.

enum (DistanceUnit)

Obrigatório. A unidade de distância pela qual 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 o 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 do conteúdo.

boolean

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

string

ID do vídeo do YouTube conforme 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.