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 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 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 móvel (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 hora. 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 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.

Para itens de linha de Geração de demanda, esse campo é sempre TIME_ZONE_RESOLUTION_ADVERTISER.

enum (AgeRange)

Obrigatório. A faixa etária de um público-alvo. Só é possível segmentar uma faixa etária contínua 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 regionais. 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. 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 de segmentação só é aplicável à segmentação por pedido de inserção, e os novos itens de linha que aceitam o tipo de anúncio especificado a herdam 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 out-stream.

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Essa opção de segmentação só é aplicável à segmentação por pedido de inserção, e os novos itens de linha que aceitam o tipo de anúncio especificado a herdam 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. 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 de US $10,0 e o multiplicador for de 1,5 para tablet, o preço do lance resultante para tablet será de US $15,0.

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

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 das listas personalizadas do grupo incluído. Contém apenas IDs de lista personalizada.

object (CombinedAudienceGroup)

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

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 por 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 (FirstPartyAndPartnerAudienceGroup)

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

object (FirstPartyAndPartnerAudienceGroup)

Opcional. Os IDs e as atualidades dos públicos-alvo próprios e grupos de públicos-alvo de parceiros excluídos. 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 por público-alvo. Todos os itens são logicamente "OR" uns dos outros.

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 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. O ID é combinedAudienceId.

object (FirstPartyAndPartnerAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação de público-alvo próprio e de parceiro no grupo de público-alvo próprio e de parceiro. 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 parceiro da primeira configuração de segmentação de público-alvo próprio e de parceiro. O ID é firstPartyAndPartnerAudienceId.

enum (Recency)

Obrigatório. A atualização da configuração de segmentação por público-alvo próprio e de parceiro. 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.

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 de segmentação só é aplicável à segmentação por pedido de inserção, e os novos itens de linha que aceitam o tipo de anúncio especificado a herdam 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

Opcional. Os nomes das políticas que vão isentar a palavra-chave.

Ao tentar segmentar uma palavra-chave que viola uma política, o erro retornado vai incluir o nome da política relevante. Use esse nome neste campo para isentar a palavra-chave segmentada da política.

Esse campo só é aplicável a palavras-chave segmentadas positivamente atribuídas a recursos de Geração de demanda.

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 disponibilização.

string (int64 format)

Obrigatório. ID da origem de 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 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 ao 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 origem de 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 da classificação de conteúdo digital a ser EXCLUÍDO.

Esse campo só aceita o valor CONTENT_RATING_TIER_UNRATED.

enum (SensitiveCategory)

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

Esse campo só aceita os seguintes valores:

• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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 de terceiros: Scope3 (antes conhecido como Adloox).

object (DoubleVerify)

Verificador de marca de terceiros: DoubleVerify.

object (IntegralAdScience)

Verificador de marca de terceiros: Integral Ad Science.

enum (AdlooxCategory)

Categorias do 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 GARM de conteúdo sexual explícito e adulto a serem excluídos.

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 da GARM a serem excluídos.

enum (GarmRiskExclusion)

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

enum (GarmRiskExclusion)

Opcional. Intervalos de risco GARM para excluir conteúdo sobre questões sociais sensíveis em debate.

enum (GarmRiskExclusion)

Opcional. Intervalos de risco de GARM para excluir conteúdo sobre drogas ilícitas/bebidas alcoólicas.

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 spam ou conteúdo prejudicial.

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 indicativa.

object (AppStarRating)

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

object (DisplayViewability)

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

object (VideoViewability)

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

object (FraudInvalidTraffic)

Evite sites e apps com histórico de fraude e taxas de IVT.

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)

Segmente 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 IVT.

boolean

Estatísticas históricas de fraude e IVT 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: bebidas alcoólicas.

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 apenas a itens de linha de display).

enum (VideoViewability)

Seção de visibilidade de 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, inclusive.

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 ponto de interesse, 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 de 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 franquia, 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 por franquia 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 ativado para Open Measurement.

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

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 upload 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.

string (int64 format)

Obrigatório. O ID do pacote de canais do YouTube.

boolean

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