REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

string (int64 format)

Obrigatório. ID do canal. Precisam se referir ao campo de ID em um recurso de canal de propriedade do parceiro ou de canal de propriedade 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 Play Store para Android usa um 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 aplicativo 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 para dispositivos móveis 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 horário.

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 (1 hora antes do fim do dia).

integer

Obrigatório. O horário de término para a segmentação por dia e horário. Precisa estar 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 o fuso horário a ser usado na configuração de segmentação de dia e hora.

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 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. 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 por 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á segmentado. O raio deve 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.

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 premiado pelo usuário para 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ó é 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 out-stream do conteúdo.

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 somente a itens de linha do YouTube e de parceiros.

object (FirstAndThirdPartyAudienceGroup)

Os IDs de público-alvo primário e de terceiros e as recências dos grupos de público-alvo primários 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 primário e de terceiros é INTERNA, e o resultado é UNION com outros grupos de público-alvo. Grupos repetidos com as mesmas configurações serão ignorados.

object (GoogleAudienceGroup)

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

object (CustomListGroup)

Os IDs de listas personalizadas do grupo de listas personalizadas incluído. Contém apenas IDs de listas personalizadas.

object (CombinedAudienceGroup)

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 (FirstAndThirdPartyAudienceGroup)

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 por público-alvo positiva. Todos os itens são logicamente "OU" entre si.

object (GoogleAudienceGroup)

Os IDs de público-alvo do Google do grupo de públicos-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 por público-alvo positiva. Contém somente públicos-alvo do Google dos tipos afinidade, no mercado e aplicativos 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. Configurações repetidas com o mesmo ID não são permitidas.

string (int64 format)

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

enum (Recency)

O tempo para retorno da configuração de segmentação por público-alvo primária 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. Este 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. 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. Configurações repetidas com o mesmo ID serão ignoradas. O número de configurações de público-alvo combinado não deve ser maior do que cinco. Caso contrário, ocorrerá um erro.

string (int64 format)

Obrigatório. ID do público-alvo combinado da configuração de segmentação por público-alvo combinado. Este 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 neste 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 devem ter o mesmo valor neste 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 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. Precisa 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 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 área 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. Precisa se referir ao campo inventorySourceGroupId de um recurso InventorySourceGroup.

enum (ContentRatingTier)

Obrigatório. O nome de exibição da camada de classificação de conteúdo digital a ser EXCLUÍDA.

enum (SensitiveCategory)

Obrigatório. Uma enumeração para o conteúdo da categoria sensível 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 de terceiros: Adloox.

object (DoubleVerify)

Verificador de marca de terceiros: DoubleVerify.

object (IntegralAdScience)

Verificador de marca de terceiros: Integral Ad Science.

enum (AdlooxCategory)

Configurações de brand safety da Adloox.

object (BrandSafetyCategories)

Controles de brand safety da DV.

enum (AgeRating)

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

object (AppStarRating)

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

object (DisplayViewability)

Configurações de visibilidade de exibição (aplicáveis somente 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 sem classificação.

enum (HighSeverityCategory)

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

enum (MediumSeverityCategory)

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

enum (StarRating)

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

boolean

Evite dar lances em apps com notas insuficientes.

enum (IAB)

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

enum (ViewableDuring)

Segmente inventários da Web e de apps para maximizar a duração visível de 100%.

enum (VideoIAB)

Segmente o inventário da Web para maximizar a taxa visível do IAB.

enum (VideoViewableRate)

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

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: Sem classificação.

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 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 de 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, incluindo esses dois valores.

string

Apenas saída. O nome de exibição de um PDI, por exemplo, "Times Square", "Space Needle", seguido pelo seu 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 de 40,7414691, -74,003387 usando o código de 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 por 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 granulares, por exemplo, 15.57 passará a ser 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 stream 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 do YouTube 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 será exibido em uma sessão.