Use o upload parcial de arquivos de dados estruturados para simplificar o gerenciamento de SDFs, incluir mais recursos e reduzir o tempo de upload ao enviar SDFs de itens de linha. Confira nosso novo guia para começar hoje mesmo.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Dados estruturados - v11 - QA do item de linha

Consulte a visão geral para uma explicação do formato.

Este é um formato de arquivo de controle de qualidade. Os arquivos nesse formato são somente leitura e não podem ser enviados.

Campo Tipo Descrição

ID do item de linha número inteiro

ID de Io número inteiro

Nome do Io string Nome do pedido de inserção

Tipo

string

O tipo de entrada.

Só pode ser gravado ao criar, não ao editar.

Selecione um dos seguintes valores:

Display
Vídeo
TrueView
Áudio
Geração de demanda

Subtipo

string

Campo obrigatório para que os itens de linha distingam entre diferentes formatos.

Selecione um dos seguintes valores:

Simples
Não pulável
Alcance
Ver
Áudio
Over The Top
Instalação de apps para dispositivos móveis
Compra de apps para dispositivos móveis
Simple Over The Top
Non Skippable Over The Top
Alcançar o topo
Frequência desejada
Geração de demanda
Sequência de vídeo
Out of home

A "Sequência de vídeo" está disponível apenas para uma lista fechada de clientes do Display & Video 360.

Tipo de transação do item de linha

string

O tipo de transação do item de linha. Obrigatório e aplicável apenas a itens de linha de transação instantânea, que precisam ter o valor "TrueView" no campo "Tipo" e "Alcance" no campo "Subtipo".

Garantido

O suporte a SDF para itens de linha de transação instantânea está na versão Beta e disponível apenas para parceiros na lista de permissões. Os itens de linha de transação instantânea não serão incluídos nos arquivos baixados e precisam ser enviados pelo fluxo de trabalho de criação de transação instantânea do YouTube na interface do Display & Video 360.

Nome string O nome da entrada.

Carimbo de data/hora número inteiro O carimbo de data/hora da entrada. Ele é usado pelo sistema para verificar se a entrada não mudou entre o download e o upload.

Status

string

A configuração de status da entrada.

Ativo
Pausado
Arquivado
Excluído
Rascunho

Data de início string Um carimbo de data/hora para a data de início do voo da entrada no formato MM/DD/AAAA ou "Igual ao pedido de inserção" para usar a mesma data de início do pedido de inserção principal.

Data de término string Um carimbo de data/hora para a data de término do período de veiculação da entrada no formato MM/DD/AAAA ou "Igual ao pedido de inserção" para usar a mesma data de término do pedido de inserção principal.

Tipo de orçamento

string

Especifica se o orçamento é monetário ou com base em impressões. Se o pedido de inserção dessa entrada estiver ativado para alocação automática de orçamento, defina como "Automático" para permitir que o DBM faça o orçamento automaticamente para essa entrada.

Valor
Impressões
Ilimitado
Automático
Orçamento do TrueView

Valor do orçamento float Um valor positivo para o tipo de orçamento. Pode ser um valor inteiro simples de impressão ou um ponto flutuante para um valor de moeda. As moedas serão mostradas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de uma unidade monetária). Se a alocação de orçamento "Automática" estiver definida na entrada, você poderá especificar um valor mínimo a ser gasto (por exemplo, "gaste pelo menos" esse valor).

Ritmo

string

O período usado para gastar o valor do ritmo.

Diário
Mensal
Período de veiculação

Taxa de ritmo

string

A taxa de aceleração desta entrada.

Assim que possível
Uniforme
Adiante

Valor da aceleração float O valor a ser gasto por período definido pelo tipo de aceleração.

Frequência ativada string

Exposições de frequência número inteiro Um número inteiro positivo para o número de impressões em um determinado valor de frequência, ou seja, o x em "Mostrar x impressões em um período y".

Período de frequência

string

Minutos
Horas
Dias
Semanas
Meses
Ciclo de vida

Valor da frequência número inteiro

Frequência de visualização TrueView ativada

string

Ativa/desativa o limite de frequência com base em visualizações no item de linha do TrueView.

TRUE
FALSO

Exposições de frequência de visualização TrueView número inteiro Um número inteiro positivo para o número de visualizações TrueView, ou seja, o x em "Mostrar x visualizações durante o período"

Período de frequência de visualização TrueView

string

Especifica a unidade de período para o limite de frequência TrueView com base em visualizações.

Dias
Semanas
Meses

Modelo de receita do parceiro

string

Um modelo de receita do parceiro é um mecanismo que controla o cálculo da receita no Bid Manager. Use o modelo de receita do parceiro para acompanhar a margem de suas taxas de serviço. A coluna "Valor da receita do parceiro" precisa ser especificada quando a coluna "Modelo de receita do parceiro" é incluída.

TMCM: marcação do custo de mídia total
MCM: marcação do custo de mídia
CPM: custo por mil impressões

Valor da receita do parceiro float Um valor de ponto flutuante positivo correspondente ao modelo de receita do parceiro. Aplicável somente quando a coluna "Modelo de receita do parceiro" é especificada.

Tipo de contagem de conversões

string

Escolha os tipos de conversões que serão contabilizados.

Contar tudo
Contar pós-clique
Porcentagem da contagem

Porcentagem de contagem de conversões float Especifique a porcentagem para o tipo de contagem de conversões "Contagem %". Formate a porcentagem como um número de ponto flutuante (3,123% = 3,123), com precisão limitada aos milhares (três casas decimais).

IDs de atividade do Floodlight de conversão Qa

string, lista de listas

As atividades do Floodlight usadas para conversões e configurações relacionadas.

Essa coluna usa o nome de exibição e as medições do recurso FloodlightActivity da API Display & Video 360, em minutos, das janelas pós-visualização e pós-clique.

List of list format = ((FloodlightActivity.displayName; view_window_days; click_window_days;);(FloodlightActivity.displayName; view_window_days; click_window_days;).

Essa lista é gerada em ordem alfabética crescente.

Primary Attribution Model Id Qa string O nome do modelo de atribuição do item de linha associado.

Taxas

string, lista de listas

Todas as taxas desta entrada. Formato da lista = (categoria da taxa; valor da taxa; tipo de taxa; faturado;).

Categoria da taxa
- CPM
- Mídia
Valor da taxa
- Ponto flutuante
- Pct como ponto flutuante
Tipo de taxa
- (string, consulte a tabela de taxas)
Com fatura
- Verdadeiro
- Falso
- em branco

Exemplo: '(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'
. Os valores aceitáveis são fornecidos na tabela a seguir:

Categoria de taxa	Tipo de taxa	Opção faturada
CPM/mídia	Padrão	Não permitido (deixe em branco)
CPM/mídia	Servidor de anúncios de terceiros	Não permitido (deixe em branco)
CPM/mídia	DoubleVerify	Permitido (verdadeiro/falso)
CPM/mídia	Adsafe	Não permitido (deixe em branco)
CPM/mídia	Adxpose	Não permitido (deixe em branco)
CPM/mídia	Vizu	Não permitido (deixe em branco)
CPM/mídia	Aggregate Knowledge	Não permitido (deixe em branco)
CPM/mídia	Teracent	Não permitido (deixe em branco)
CPM/mídia	Evidon	Não permitido (deixe em branco)
CPM/mídia	Taxa das agências negociadoras	Não permitido (deixe em branco)
CPM/mídia	Adloox	Permitido (verdadeiro/falso)
CPM	ShopLocal	Obrigatório (True)
CPM	TrustMetrics	Não permitido (deixe em branco)
CPM	Vídeo da Integral Ad Science	Permitido (verdadeiro/falso)
CPM	Vídeo da MOAT	Não permitido (deixe em branco)
Mídia	Taxa do Display & Video 360	Obrigatório (True)
Mídia	Dados de custo de mídia	Não permitido (deixe em branco)
Mídia	Taxa da Scibids	Obrigatório (True)

Código de integração string Um código opcional para fins de rastreamento.

Detalhes string Detalhes da entrada em formato de string.

Tipo de estratégia de lances

string

Selecione uma das estratégias de lances aplicáveis:

Minimizar: ao gastar todo o orçamento, minimize o CPA/CPC
Maximizar: ao gastar todo o orçamento, maximize o valor de impressão ou a impressão de qualidade
Superar: atingir ou superar uma meta de X CPA/CPC
Otimizar o vCPM: otimizar para lance de vCPM visível de X
Corrigido: especifique um lance fixo de X

Valor de estratégia de lances float Para os tipos de estratégia "Superar", "Otimizar VCPM" e "Fixa", escolha um valor para o lance de meta.
Nenhum valor de estratégia de lances é necessário para os tipos "Minimizar" ou "Maximizar".

Unidade de estratégia de lances

string

Para os tipos de estratégia "Superar", "Minimizar" ou "Maximizar", selecione a unidade correspondente:

CPA
CPC
valor/custo de impr. personalizado
CIVA
IVO_TEN
AV_VIEWED
REACH

Estratégia de lances "Não exceder" float Defina um valor de CPM "não exceder". Se for 0, a opção "não exceder" não estará ativada. Isso só está disponível se a estratégia de lances for "Minimizar", "Maximizar" ou "Superar".

Aplicar preço mínimo às transações string Se as transações devem ser priorizadas em vez do inventário de leilão aberto

ID do algoritmo

número inteiro

Esse ID de algoritmo correspondente precisa ser usado quando a unidade de estratégia de lances é definida como valor/custo de impressão personalizado.

Todas as atividades do Floodlight usadas no algoritmo atribuído a essa coluna precisam ser incluídas na coluna "IDs de atividade do Floodlight de conversão". As tentativas de atribuir um algoritmo sem atualizar corretamente a coluna "IDs de atividade do Floodlight de conversão" vão resultar em um erro.

Creative Assignments Qa string, lista Lista de criativos atribuídos à entrada. Formato da lista = (Nome do criativo; Nome do criativo; etc.). Essa lista é gerada em ordem alfabética.

Contém anúncios políticos na UE

string

Se este item de linha veicula anúncios políticos na União Europeia.

Se você declarou que esse anunciante não veicula anúncios políticos da UE, os novos itens de linha vão receber o valor "Não" se a coluna não estiver definida.

Esse valor pode ser atualizado para itens de linha atuais usando a interface, o SDF ou a API.

Sim
Não
Não definido

Status principal

string

O status principal da entrada.

Os status possíveis são:

Qualificado
Não qualificado
Pausado
Removido
Finalizada
Limitado
Pendente
Configuração incorreta

Motivo do status principal

string

A causa do status principal atual.

Grupo de campanhas pausado
Todos os orçamentos do grupo de campanhas foram encerrados
Campanha finalizada
Campanha pausada
Campanha pendente
Campanha removida
Nenhum grupo de anúncios
Tem anúncios reprovados
Tem anúncios limitados pela política
Nenhum anúncio no grupo de anúncios
A maioria dos anúncios está em análise
Não há critérios de grupos de anúncios de aplicativos para dispositivos móveis
Aprendizado da estratégia de lances
Segmentação por local ausente

Nível de segmentação geográfica e por idioma da Geração de demanda

string

O nível em que a segmentação por local e idioma é definida para campanhas Geração de demanda. Essa coluna não deve ser definida para itens de linha que não são de Geração de demanda. Essa coluna é imutável após a criação.

Item de linha
Grupo de anúncios

Segmentação geográfica: incluir Qa string, lista Lista de regiões geográficas a serem incluídas na segmentação. Formato da lista = (Nome da região geográfica; Nome da região geográfica; etc.). Essa lista é gerada em ordem alfabética.

Segmentação geográfica: exclusão de QA string, lista Lista de regiões geográficas a serem excluídas da segmentação. Formato da lista = (Nome da região geográfica; Nome da região geográfica; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por lista de locais regionais geográficos: incluir QA string, lista Lista de nomes de listas de locais regionais a serem incluídos na segmentação. Uma entidade só pode segmentar duas listas de locais, incluindo as de proximidade. Formato da lista = (Nome da lista de locais; Nome da lista de locais;).

Segmentação por lista de locais regionais geográficos: excluir Qa string, lista Lista de nomes de listas de locais regionais a serem excluídos na segmentação. Uma entidade só pode segmentar duas listas de locais, incluindo as de proximidade. Formato da lista = (Nome da lista de locais; Nome da lista de locais;).

Segmentação por proximidade

string, lista de listas

Lista de segmentações por proximidade, cada uma no formato "(Latitude; Longitude; Raio; Unidade; Endereço completo);". A latitude está entre -90 e 90 graus (inclusive); a longitude está entre -180 e 180 graus (inclusive); o raio é uma distância entre 1 e 500 (inclusive) em Unidade; a unidade pode ser "mi" ou "km"; o endereço completo é opcional. Por exemplo: "(38.907192; -77.03687; 1.0; mi; Washington D.C., DC, USA;); (40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;);".

Se a coluna "Tipo" estiver definida como "Geração de demanda", ela só vai estar disponível se o item de linha tiver um nível de segmentação geográfica e por idioma definido como item de linha na interface.

Segmentação por lista de locais de proximidade Qa string, lista de listas Lista de listas de locais por proximidade a serem incluídas na segmentação de pedidos de inserção ou itens de linha não TrueView, cada uma no formato "(Nome da lista de proximidade; Raio; Unidade;);". O raio é uma distância entre 1 e 500 (inclusive) em unidade, que pode ser "mi" ou "km". Uma entidade só pode segmentar duas listas de locais, incluindo as regionais. Por exemplo: "(Proximity list 1; 20.0; mi;); (Proximity list 2; 20.5; km;);". Essa lista é gerada em ordem alfabética.

Segmentação por proximidade de franquias: QA

string, lista de listas

Lista de franquias segmentando nomes para itens de linha, cada um no formato "(Nome da franquia; Nome da região geográfica; Raio; Unidade; );".

O raio é uma distância entre 1 e 500 (inclusive) em "Unit", que pode ser "mi" ou "km".

Por exemplo: "(Chain Store 1; United States; 20.0; mi;); (Chain Store 2; Australia; 15.0; km;);".

Segmentação por idioma: incluir QA string, lista Lista de idiomas a serem incluídos na segmentação. Formato da lista = (Nome do idioma; Nome do idioma; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por idioma: excluir QA string, lista Lista de idiomas a serem excluídos da segmentação. Formato da lista = (Nome do idioma; Nome do idioma; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por dispositivo: incluir Qa string, lista Lista de dispositivos a serem incluídos na segmentação. Formato da lista = (Nome do dispositivo; Nome do dispositivo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por dispositivo: excluir QA string, lista Lista de dispositivos a serem excluídos da segmentação. Formato da lista = (Nome do dispositivo; Nome do dispositivo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por navegador: incluir Qa string, lista Lista de navegadores a serem incluídos na segmentação. Formato da lista = (Nome do navegador; Nome do navegador; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por navegador: excluir Qa string, lista Lista de navegadores a serem excluídos da segmentação. Formato da lista = (Nome do navegador; Nome do navegador; etc.). Essa lista é gerada em ordem alfabética.

Classificações de conteúdo digital: excluir

string, lista

Lista das classificações de conteúdo digital a serem excluídas. Formato da lista = (G;PG; etc.).

Configuração de sensibilidade de brand safety

string

Escolha a configuração de sensibilidade para bloquear o inventário com base no assunto do conteúdo relacionado a ele.

Não bloquear
Usar a verificação do Campaign Manager 360

Configurações personalizadas de brand safety

string, lista

Se a configuração de sensibilidade de brand safety for "Usar personalizada", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Sexual;Alcohol;Tobacco;etc.).

Essa coluna não é mais compatível e será preenchida com um valor vazio no download.

Serviços de verificação de terceiros

string

Provedor de serviços de verificação terceirizada.

Nenhum
Integral Ad Science
DoubleVerify
Adloox

Etiquetas de verificação de terceiros string, lista Se os serviços de verificação de terceiros não forem "Nenhum", especifique uma lista de rótulos compatíveis com o provedor selecionado.

Segmentação por canal: incluir Qa string, lista Lista de canais a serem incluídos na segmentação. Formato da lista = (Nome do canal; Nome do canal; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por canal: excluir Qa string, lista Lista de canais a serem excluídos da segmentação. Formato da lista = (Nome do canal; Nome do canal; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por site: incluir QA

string, lista

Lista de sites a serem incluídos na segmentação. A lista é de strings de URLs.

Formato da lista = (algumsite.com; algumsite2.com; etc.). Essa lista é gerada em ordem alfabética.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, os URLs individuais serão truncados conforme necessário. Os URLs truncados não terão menos de 10 caracteres.

Segmentação por site: excluir Qa

string, lista

Lista de sites a serem excluídos da segmentação. A lista é de strings de URLs.

Formato da lista = (algumsite.com; algumsite2.com; etc.). Essa lista é gerada em ordem alfabética.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, os URLs individuais serão truncados conforme necessário. Os URLs truncados não terão menos de 10 caracteres.

Segmentação por app: incluir QA

string, lista

Lista de apps a serem incluídos na segmentação. A lista é uma concatenação de strings da plataforma e do ID da plataforma do app.

Os seguintes valores são usados para definir a plataforma do app:

APP (isso abrange as plataformas da Play Store do Android e da App Store da Apple)
ROKU_APP
AMAZON_FIRETV_APP
XBOX_APP
PLAYSTATION_APP
APPLE_TV_APP
SAMSUNG_TV_APP
ANDROID_TV_APP
GENERIC_CTV_APP
LG_TV_APP
VIZIO_TV_APP
VIDAA_APP

O ID é fornecido pela plataforma relevante, como um ID de pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID de app da App Store da Apple (exemplo: 422689480).

A string concatenada da plataforma e do ID do app é separada por dois pontos, por exemplo: APP:com.google.android.gm.

Formato da lista = (APP:com.google.android.gm; APP:422689480; etc.). Essa lista é gerada em ordem alfabética crescente.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, as entradas individuais serão truncadas conforme necessário. As entradas truncadas não terão menos de 10 caracteres.

Segmentação de apps: excluir QA

string, lista

Lista de apps a serem excluídos da segmentação. A lista é uma concatenação de strings da plataforma e do ID da plataforma do app.

Os seguintes valores são usados para definir a plataforma do app:

APP (isso abrange as plataformas da Play Store do Android e da App Store da Apple)
ROKU_APP
AMAZON_FIRETV_APP
XBOX_APP
PLAYSTATION_APP
APPLE_TV_APP
SAMSUNG_TV_APP
ANDROID_TV_APP
GENERIC_CTV_APP
LG_TV_APP
VIZIO_TV_APP
VIDAA_APP

O ID é fornecido pela plataforma relevante, como um ID de pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID de app da App Store da Apple (exemplo: 422689480).

A string concatenada da plataforma e do ID do app é separada por dois pontos, por exemplo: APP:com.google.android.gm.

Formato da lista = (APP:com.google.android.gm; APP:422689480; etc.). Essa lista é gerada em ordem alfabética crescente.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, as entradas individuais serão truncadas conforme necessário. As entradas truncadas não terão menos de 10 caracteres.

Segmentação por coleção de apps: incluir QA string, lista Lista de coleções de apps a serem incluídas na segmentação. Formato da lista = (nome da coleção de apps; nome da coleção de apps; etc.). Essa lista é gerada em ordem alfabética.

Segmentação de coleção de apps: excluir QA string, lista Lista de coleções de apps a serem excluídas da segmentação. Formato da lista = (nome da coleção de apps; nome da coleção de apps; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por categoria: incluir controle de qualidade string, lista Lista de categorias a serem incluídas na segmentação. Formato da lista = (nome da categoria; nome da categoria; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por categoria: excluir Qa string, lista Lista de categorias a serem excluídas da segmentação. Formato da lista = (nome da categoria; nome da categoria; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por gênero de conteúdo: incluir Qa string, lista Lista de gêneros de conteúdo a serem incluídos na segmentação. Formato de lista = (Nome do gênero de conteúdo; Nome do gênero de conteúdo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por gênero de conteúdo: excluir Qa string, lista Lista de gêneros de conteúdo a serem excluídos da segmentação. Formato de lista = (Nome do gênero de conteúdo; Nome do gênero de conteúdo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por palavras-chave: incluir QA

string, lista

Lista de strings de palavras-chave a serem incluídas na segmentação. Essa lista é gerada em ordem alfabética.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, as entradas individuais serão truncadas conforme necessário. As entradas truncadas não terão menos de 10 caracteres.

Segmentação por palavras-chave: excluir Qa

string, lista

Lista de strings de palavras-chave a serem excluídas na segmentação. Essa lista é gerada em ordem alfabética.

Se o comprimento total de caracteres da lista exceder 32.700 caracteres, as entradas individuais serão truncadas conforme necessário. As entradas truncadas não terão menos de 10 caracteres.

Segmentação por lista de palavras-chave: excluir Qa

string, lista

Lista de listas de palavras-chave negativas a serem excluídas na segmentação. Formato da lista = (nome da lista de palavras-chave negativas; nome da lista de palavras-chave negativas; etc.). Essa lista é gerada em ordem alfabética.

Otimizar lances fixos

string

Permite que seu item de linha faça um lance menor do que o lance fixo.

Essa coluna precisa ser deixada sem definição ou definida como "TRUE", a menos que o "Tipo de estratégia de lances" seja "Fixa".

Segmentação otimizada

string

Ative a segmentação otimizada.

TRUE
FALSO

A segmentação otimizada não é compatível com todas as estratégias de lances. Essa coluna precisa ser "FALSE" se:

"Tipo de estratégia de lances" é "Fixa"
"Tipo de estratégia de lances" é "vCPM otimizado"
"Tipo de estratégia de lances" é "Máximo" e "Unidade de estratégia de lances" é "CIVA", "IVO_TEN" ou "AV_VIEWED"

Essa restrição também se aplica se o item de linha herdar uma das estratégias de lances acima da ordem de inserção mãe. As estratégias de lances definidas no nível do pedido de inserção serão herdadas pelos itens de linha se a coluna "Otimização do pedido de inserção" estiver definida como "TRUE".

Segmentação por público-alvo: incluir QA

string, lista de listas de pares

Lista de públicos-alvo próprios e de terceiros a serem incluídos na segmentação.

Para listas de público-alvo próprias, cada público-alvo é listado como um par de nome de exibição e configuração de atualização. Um par é (Nome do público-alvo;1d;), em que 1d é uma amostra de atualização que representa um dia de atualização. O tempo para retorno não está disponível para públicos-alvo de terceiros. Portanto, o formato da lista é (Nome do público-alvo;);(Nome do público-alvo;);. Para combinar grupos de público-alvo com "AND" e "OR", siga este exemplo: para combinar pares com e sem tempo para retorno: '((audience 1 name;1d;);(audience 2 name;365d;));((audience 3 name;);(audience 4 name;5m;);(audience 5 name;all;));'. Isso significa (lista 1 com 1 dia de tempo para retorno OU lista 2 com 365 dias de tempo para retorno) E (lista 3 sem um tempo para retorno especificado OU lista 4 com 5 minutos de tempo para retorno OU lista 5 com todos os usuários).

Os valores de recência válidos são:

todas
1min
5min
10min
15min
30min
1h
2h
3h
6h
12h
1 d
2d
3 dias
5 d
7d
10d
14d
15d
21d
28d
30d
45d
60d
90d
120d
180d
270d
365d

Segmentação por público-alvo - Excluir Qa

string, lista de listas de pares

Lista de públicos-alvo próprios e de terceiros a serem excluídos na segmentação.

Os valores de recência válidos são:

todas
1min
5min
10min
15min
30min
1h
2h
3h
6h
12h
1 d
2d
3 dias
5 d
7d
10d
14d
15d
21d
28d
30d
45d
60d
90d
120d
180d
270d
365d

Segmentação por afinidade e no mercado: incluir QA string, lista Lista de públicos-alvo de afinidade e/ou no mercado a serem incluídos. Formato da lista = (Nome do público-alvo; Nome do público-alvo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por afinidade e no mercado: excluir QA string, lista

Segmentação por eventos importantes: incluir QA

string, lista

Uma lista de nomes de públicos-alvo de eventos da vida para incluir na segmentação.

Formato da lista: Nome do evento importante; Nome do evento importante;

Segmentação por eventos importantes: exclusão de QA

string, lista

Uma lista de nomes de públicos-alvo de eventos da vida a serem excluídos na segmentação.

Formato da lista: Nome do evento importante; Nome do evento importante;

Segmentação por informações demográficas detalhadas: incluir QA

string, lista

Uma lista de nomes de públicos-alvo demográficos detalhados para incluir na segmentação.

Formato da lista: Nome da demonstração detalhada; Nome da demonstração detalhada;

Segmentação demográfica detalhada - Excluir Qa

string, lista

Uma lista de nomes de públicos-alvo de demonstração detalhados a serem excluídos da segmentação.

Formato da lista: Nome da demonstração detalhada; Nome da demonstração detalhada;

QA da segmentação por público-alvo combinado string, lista Lista de públicos-alvo combinados a serem segmentados. Formato da lista = (Nome do público-alvo; Nome do público-alvo; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por lista personalizada Qa string, lista Lista de listas personalizadas para segmentação. Formato da lista = (Nome da lista personalizada; Nome da lista personalizada; etc.). Essa lista é gerada em ordem alfabética.

Segmentação da origem de inventário: opções de vendedor autorizado

string

Definir como segmentação de vendedores diretos autorizados, vendedores diretos e revendedores autorizados ou vendedor autorizado + desconhecido. "Direto autorizado" significa que apenas vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar os vendedores e revendedores autorizados. "Publisher autorizado e não participante" significa que ele vai segmentar vendedores autorizados, revendedores e vendedores desconhecidos.

Vendedores diretos autorizados
Vendedores diretos e revendedores autorizados
Editor autorizado e não participante

Segmentação da origem de inventário: incluir QA

string, lista

Lista de origens de inventário, exchanges e subexchanges a serem incluídas na segmentação.

Formato da lista = (nome da origem de inventário/bolsa/subbolsa; nome da origem de inventário/bolsa/subbolsa; etc.)

Segmentação da origem de inventário: excluir QA

string, lista

Lista de origens de inventário, mercados e submercados a serem excluídos na segmentação.

Formato da lista = (nome da origem de inventário/bolsa/subbolsa; nome da origem de inventário/bolsa/subbolsa; etc.)

Segmentação da origem de inventário: segmentar novas trocas

string

Configuração para segmentar novas trocas.

Verdadeiro
Falso

Private Deal Group Targeting Include Qa

string, lista

Lista de grupos de transações a serem incluídos na segmentação.

Formato da lista = (Nome da oferta agrupada; Nome da oferta agrupada; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por período do dia Qa

string, lista

Lista de períodos do dia a serem segmentados. Cada período do dia é construído no formato "dia_da_semana horário_de_início horário_de_término":

"day_of_the_week" é segunda-feira, terça-feira, quarta-feira, quinta-feira, sexta-feira, sábado ou domingo
"start_time" e "end_time" são representados como HH:MM no formato de 24 horas.

Exemplo de lista: (segunda-feira 01:20 13:20; terça-feira 09:00 10:00;)

Essa lista é gerada em ordem crescente de tempo, começando pela segunda-feira.

Fuso horário da segmentação por período do dia string Fuso horário a ser usado para a segmentação por período do dia.

Segmentação por ambiente

string, lista

Lista de ambientes a serem segmentados. Selecione um ou mais dos valores aceitáveis. Não é possível selecionar "Web não otimizado" sem selecionar "Web".

Web
Web não otimizada
App

Segmentação por visibilidade e OMID ativada

string

Permite segmentar apenas impressões mensuráveis pelo padrão de medição aberto. Se a entidade não for compatível com a segmentação OMID, deixe essa coluna em branco.

TRUE
FALSO

Se a segmentação por OMID estiver ativada no nível do anunciante e for compatível com a entidade, essa coluna não poderá ser definida como "FALSE". Se essa coluna não for definida na criação de um recurso para uma entidade compatível, ela vai usar a configuração no nível do anunciante por padrão.

Segmentação por visibilidade do Active View string Segmentar porcentagens de visibilidade prevista. As porcentagens são representadas como números de ponto flutuante. Um de {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}

Segmentação por posição: na tela

string, lista

Segmentação por posições de anúncios na tela. Selecione um ou mais dos valores aceitáveis:

Acima da dobra
Abaixo da dobra
Desconhecido

Segmentação por posição: posição de exibição no conteúdo

string, lista

Posições de conteúdo do anúncio de display a serem segmentadas. Selecione um ou mais dos valores aceitáveis:

In-article
In-feed
No banner
Intersticial
Desconhecido

Segmentação por posição: posição do vídeo no conteúdo

string, lista

Posições de conteúdo do anúncio em vídeo a serem segmentadas. Selecione um ou mais dos valores aceitáveis:

In-article
In-feed
No banner
Intersticial
Out-stream desconhecido
Início da exibição
Anúncio intermediário
Fim da exibição
In-stream desconhecido

Segmentação por posição: posição de áudio no conteúdo

string, lista

Posições de conteúdo do anúncio em áudio para segmentar. Selecione um ou mais dos valores aceitáveis:

Início da exibição
Anúncio intermediário
Fim da exibição
Desconhecido

Segmentação por tamanho do player de vídeo

string, lista

Lista de tamanhos do player de anúncios em vídeo para segmentação. Selecione um ou mais dos valores aceitáveis:

desconhecido
pequeno
grande
HD

Segmentação por duração do conteúdo

string, lista

Lista de durações de conteúdo a serem segmentadas. O valor da unidade é em minutos. Selecione um ou mais dos valores aceitáveis:

0-1
1-5
5-15
15-30
30-60
Mais de 60
desconhecido

Segmentação por tipo de transmissão de conteúdo

string, lista

Lista de tipos de transmissão de conteúdo a serem segmentados. Selecione um ou mais dos valores aceitáveis:

transmissão ao vivo
Sob demanda

Segmentação por tipo de conteúdo de áudio

string, lista

Lista de tipos de conteúdo de áudio a serem segmentados. Selecione um ou mais dos valores aceitáveis:

desconhecido
serviço de streaming de música
transmissão FM/AM ao vivo
podcasts
rádio sob demanda
rádio na Web
videogame
conversão de texto em voz

Demographic Targeting Gender Qa

string, lista

Lista completa de gêneros segmentados.

Formato da lista = (Feminino; Masculino; Desconhecido;)

Feminino
Masculino
Desconhecido

Demographic Targeting Age Qa

string, lista

Lista completa das idades segmentadas.

Formato da lista = (25-34; 35-44; Desconhecido;)

18-24
25 a 34
35 a 44
45 a 54
55-64
65+
Desconhecido

Controle de qualidade da segmentação demográfica por renda familiar

string, lista

Lista completa das rendas familiares segmentadas.

Formato da lista = (10% principais; 11 a 20%; 21 a 30%)

10% com maior renda
11-20%
De 21% a 30%
De 31% a 40%
De 41% a 50%
50% com menor renda
Desconhecido

Segmentação demográfica: status parental (QA)

string, lista

Lista completa de status parentais segmentados.

Formato da lista = (Parent;)

Com filhos
Sem filhos
Desconhecido

Segmentação por velocidade de conexão

string

Segmentar uma velocidade de conexão específica. Selecione um dos valores aceitáveis:

Todos
2G
3G
DSL
4G

Segmentação por operadora: incluir Qa string, lista Lista de ISPs ou operadoras a serem incluídas na segmentação. Formato da lista = (nome da operadora/ISP; nome da operadora/ISP; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por operadora: excluir QA string, lista Lista de ISPs ou operadoras a serem excluídas na segmentação. Formato da lista = (nome da operadora/ISP; nome da operadora/ISP; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por canal do YouTube: excluir Qa string, lista Lista de canais do YouTube a serem excluídos. Formato da lista = (nome do canal do YouTube; nome do canal do YouTube; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por posição: vídeos do YouTube - excluir Qa string, lista Lista de vídeos do YouTube a serem excluídos. Formato da lista = (nome do vídeo do YouTube; nome do vídeo do YouTube; etc.). Essa lista é gerada em ordem alfabética.

Segmentação por canal: conteúdo em alta (excluir)

string, lista

Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google para exclusão. Cada agrupamento de conteúdo individual deve ter o 'video_content::ID do agrupamento de conteúdo' estruturado.

Formato da lista = (video_content::ID do agrupamento de conteúdo; video_content::ID do agrupamento de conteúdo; etc.).

Essa coluna só está disponível se o "Subtipo" for "Sequência de vídeo".

Formatos de anúncios em vídeo TrueView

string

O formato do anúncio em vídeo do item de linha.

Os anúncios em vídeo puláveis / in-feed são tipos de anúncio em vídeo TrueView vendidos com base no CPV. Os anúncios em vídeo não puláveis são anúncios in-stream de 6 a 15 segundos vendidos com base no CPM. Os anúncios em vídeo puláveis, bumper e não puláveis são tipos de anúncio em vídeo TrueView aceitáveis para itens de linha com um subtipo "Frequência desejada" ou "Sequência de vídeo" vendidos com base no CPM. Os anúncios responsivos em vídeo são tipos de anúncios veiculados em vários formatos.

Pulável
Vídeo pulável / in-feed
Não pulável
Pulável / Bumper / Não pulável
Responsivo

Formato de anúncio de oferta instantânea TrueView

string

O formato do anúncio do item de linha. Aplicável somente a itens de linha de transação instantânea.

In-stream pulável
Bumper
In-stream não pulável de 15s
In-stream não pulável de 30s
In-stream não pulável de 60 segundos
Shorts
Pausar

Restrições da política de transações instantâneas do TrueView

string, lista

Restrições de política para o item de linha. Aplicável somente a itens de linha de transação instantânea.

Jogos de azar
Bebidas alcoólicas
Política

Ativação do estudo de Lift de transação instantânea do TrueView

string

Indica se o estudo de Lift está ativado para o item de linha. Aplicável somente a itens de linha de transação instantânea.

TRUE
FALSO

Tipo de estratégia de lances TrueView

string

A estratégia de lances usada por um item de linha TrueView ou de Geração de demanda.

Selecione um dos seguintes valores:

CPV manual: lances manuais baseados em visualizações em que você paga por visualização.
CPM manual: lance manual baseado em impressões em que você paga por mil impressões. Esse valor não é compatível com novos itens de linha TrueView ou Geração de Demanda.
CPM desejado: estratégia de lances automática que otimiza os lances para gerar o máximo de impressões possível usando um valor desejado para quanto você quer pagar a cada mil vezes que seu anúncio é mostrado.
Maximizar conversões: estratégia de lances automáticos que otimiza os lances para gerar o máximo de conversões possível.
CPA desejado: estratégia de lances automáticos que otimiza os lances para gerar o maior número possível de conversões usando um valor desejado para quanto você quer pagar por conversão.
Maximizar o Valor de Conversão: estratégia de lances com base no valor automática que otimiza as conversões de maior valor.
ROAS desejado: uma estratégia de lances com base no valor que otimiza para um valor mais alto de uma conversão.
CPV desejado: estratégia de lances automática que permite ao sistema dar lances mais altos em formatos selecionados quando necessário (por exemplo, in-stream), reduzindo a média em outros (por exemplo, in-feed) para atingir o requisito geral da meta.
CPC desejado: estratégia de lances automáticos que define lances para segmentar o CPC médio especificado pelo anunciante.
Maximizar cliques: estratégia de lances automáticos que otimiza os lances para maximizar os cliques com base no orçamento.
CPM fixo: tipo de estratégia de lances para transações instantâneas do YouTube.

Valor da estratégia de lances TrueView

float

Para o tipo de estratégia de lances de CPA desejado ou ROAS desejado, escolha um valor para o lance desejado.

Para os outros valores de "Tipo de estratégia de lances TrueView" ou outros tipos de item de linha, essa coluna precisa ser 0 ao fazer o upload.

Se a estratégia de lances de CPM fixo for usada para itens de linha de transação instantânea do YouTube, essa coluna deverá ser 0.

Para o ROAS desejado, essa coluna deve ser a porcentagem como uma fração. Por exemplo, se você quiser que o ROAS desejado seja de 150%, coloque 1,5 nessa coluna.

Opção de ajuste de lance para dispositivos móveis do TrueView

string

A direção em que os lances serão ajustados para exibição em dispositivos móveis.

Aumentar
Diminuir

Porcentagem de ajuste de lance para dispositivos móveis TrueView

número inteiro

Ajuste de lance para aumentar as chances de veicular anúncios em dispositivos móveis. Os ajustes aceitáveis são para a opção "Aumentar": [0;900%]; e para "Diminuir": [0;90%] ou 100%.

Quando o "Tipo de estratégia de lances TrueView" é "CPA desejado" ou "Maximizar conversões", ou quando o "Subtipo" é "Geração de demanda" ou "Sequência de vídeo", os ajustes aceitáveis são para a opção "Aumentar": 0; e para "Diminuir": 100%.

Opção de ajuste de lance para computadores TrueView

string

A direção em que os lances para exibição em computadores serão ajustados.

Aumentar
Diminuir

Porcentagem de ajuste de lance para computadores TrueView

número inteiro

Ajuste de lance para aumentar as chances de veicular anúncios em computadores. Os ajustes aceitáveis são para a opção "Aumentar": [0;900%]; e para "Diminuir": [0;90%] ou 100%.

Opção de ajuste de lance para tablets do TrueView

string

A direção em que os lances para exibição em tablets devem ser ajustados.

Aumentar
Diminuir

Porcentagem de ajuste de lance para tablets do TrueView

número inteiro

Ajuste de lance para aumentar as chances de veicular anúncios em tablets. Os ajustes aceitáveis são para a opção "Aumentar": [0;900%]; e para "Diminuir": [0;90%] ou 100%.

Opção de ajuste de lance para smart TV TrueView

string

A direção em que ajustar os lances para exibição em smart TVs.

Aumentar
Diminuir

Porcentagem de ajuste de lance para smart TV TrueView

número inteiro

Ajuste de lance para aumentar as chances de veicular anúncios em smart TVs. Os ajustes aceitáveis são para a opção "Aumentar": [0;900%]; e para "Diminuir": [0;90%] ou 100%.

Segmentação por exclusões de categoria do TrueView

string, lista

Lista de categorias a serem excluídas. Formato da lista = Vídeos incorporados, Famílias etc.

Vídeos incorporados
Transmissões ao vivo
Jogos
Famílias

Modo de inventário

string

Filtro de conteúdo TrueView ou Geração de demanda.

Selecione um dos seguintes valores:

Limitado
Moderado
Máximo

Segmentação da origem de inventário do TrueView

string, lista

Listas de origens de inventário do TrueView a serem incluídas

YouTube
Google TV
Parceiros de vídeo

"Parceiros de vídeo" precisa ser incluído nos itens de linha de Geração de demanda.

Fornecedor de visibilidade de terceiros do TrueView

string, lista de listas

Fornecedor terceirizado que mede a visibilidade dos itens de linha TrueView e Geração de Demanda. Se esse campo ficar em branco durante a criação do item de linha TrueView ou Geração de demanda e houver um fornecedor de visibilidade padrão ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.

Essa coluna sempre precisa usar o formato de vários fornecedores com o nome e o ID de relatório ou ficar em branco (por exemplo, (Vendor Name; Reporting ID;);.

Selecione um dos seguintes valores:

Nenhum
Moat
DoubleVerify
Integral Ad Science
ZEFR

Fornecedor de brand safety de terceiros para TrueView

string, lista de listas

Fornecedor terceirizado que mede o brand safety para itens de linha TrueView e Geração de Demanda. Se esse campo ficar em branco durante a criação do item de linha TrueView ou Geração de demanda e houver um fornecedor padrão de brand safety ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.

Essa coluna sempre precisa usar o formato de vários fornecedores com o nome do fornecedor e o ID do relatório ou ficar em branco (por exemplo, (Vendor Name; Reporting ID;);.

Selecione um dos seguintes valores:

Nenhum
DoubleVerify
Integral Ad Science
ZEFR

Fornecedor de alcance terceirizado do TrueView

string, lista de listas

Fornecedor terceirizado que mede o alcance dos itens de linha TrueView e Geração de Demanda. Se esse campo ficar em branco durante a criação de um item de linha TrueView ou Geração de demanda e houver um fornecedor de alcance padrão ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.

Essa coluna sempre precisa usar o formato de vários fornecedores, contendo o nome do fornecedor e o ID de relatório, ou ficar em branco (por exemplo, (Vendor Name; Reporting ID;);.

Selecione um dos seguintes valores:

Nenhum
Nielsen
Comscore
Kantar
Gemius
Video Research
Media Scope
AudienceProject
iSpot TV
VideoAmp
Aquila

Fornecedor terceirizado de Brand Lift do TrueView

string, lista de listas

Fornecedor terceirizado que mede o Brand Lift para itens de linha TrueView e Geração de demanda. Se esse campo ficar vazio durante a criação de um item de linha TrueView ou Geração de Demanda e houver um fornecedor padrão de Brand Lift ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.

Essa coluna sempre precisa usar o formato de vários fornecedores com o nome do fornecedor e o ID de relatório ou ficar vazia (por exemplo, (Vendor Name; Reporting ID;);.

Selecione um dos seguintes valores:

Nenhum
Kantar
Dynata
Intage
Macromill

Contagem de frequência desejada do TrueView número inteiro A contagem de frequência desejada definida para um item de linha do YouTube do tipo "Frequência desejada". Esse campo só pode ser definido com um conjunto diferente de valores com base no período. Para itens de linha do YouTube que não são do tipo "Frequência desejada", esse campo precisa estar vazio.

Janela de tempo da frequência desejada do TrueView

string

O período da frequência desejada para um item de linha do YouTube do tipo "Frequência desejada". Por enquanto, esse campo pode ser definido como "Semanal" ou "Mensal". Para itens de linha do YouTube que não são do tipo "Frequência desejada", esse campo precisa estar vazio.

Semanal
Mensal

Controle de inventário de anúncios em vídeo TrueView

string, lista

O controle de inventário de anúncios em vídeo para itens de linha de alcance ou visualização.

Selecione um ou mais dos valores aceitáveis de formato de anúncio:

In-stream
In-feed
Shorts

ID da conta do Merchant Center

número inteiro

ID da conta do Merchant Center. Imutável depois de definido.

Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda".

Vídeos relacionados

string, lista

Lista de IDs de vídeos relacionados do YouTube. Se definido, a lista precisa conter de dois a cinco IDs de vídeos do YouTube.

Cada ID de vídeo do YouTube também pode ser pareado com um valor de status de atestado de conteúdo sintético que especifica se um rótulo deve ser adicionado ao vídeo como criado ou editado com IA quando veiculado em regiões com regulamentações locais de rotulagem de IA:

"ON" atesta que o vídeo foi criado ou editado com IA
"OFF" atesta que o vídeo não foi criado nem editado com IA
Deixar esse valor em branco não fornece uma atestação. Se uma declaração já tiver sido fornecida para esse ID de vídeo do YouTube no anunciante, o valor da declaração atual será aplicado automaticamente.

Se o valor "ON" ou "OFF" for fornecido para um ID de vídeo do YouTube, essa declaração será aplicada a todos os usos atuais desse ID de vídeo do YouTube no anunciante. Leia mais sobre isso em Rotulagem de IA em anúncios usando SDF.

Formato da lista = (ID do vídeo do YouTube; status da declaração de conteúdo sintético); (ID do vídeo do YouTube; status da declaração de conteúdo sintético); etc.)

Por exemplo: "(abdefg; ON);(hijlk; OFF);(mnopq;)"

Essa coluna está disponível apenas para itens de linha "TrueView".

Etapas da sequência de vídeo

string, lista de listas

Uma lista de valores que representam a sequência de etapas que constituem um item de linha de sequência de vídeo. Cada item na lista representa uma "etapa" na sequência.

Cada etapa, formatada como "(step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;)", usa os seguintes campos:

step_id: o ID exclusivo da etapa. Se for uma etapa nova, use um número negativo como ID temporário, como -1, -2 etc. Depois de salvar, o sistema vai atribuir um novo ID a essa etapa.
previous_step_id: o ID da etapa anterior na sequência. As etapas conectadas por interações "Pular" e "Visualização paga" podem ter a mesma etapa anterior, criando uma sequência ramificada.
interaction_type: o tipo de interação que conecta a etapa anterior a esta. Os valores aceitos são "Impressão", "Pular" e "Visualização paga".
ad_group_type: o tipo de grupo de anúncios da etapa. Os valores aceitos são "In-stream", "Bumper" e "Não pulável".
video_asset_id: o código do recurso do vídeo do anúncio da etapa.

As sequências precisam seguir estas regras:

A primeira etapa de uma sequência precisa ter valores vazios em "previous_step_id" e "interaction_type".
A etapa anterior precisa estar na frente da próxima na lista.
Se você deixar a coluna em branco, a sequência de vídeo do item de linha será removida no upload.

Formato da lista = ((step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;);(step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;);)

Essa coluna só está disponível se o "Subtipo" for "Sequência de vídeo".

Duração mínima da sequência de vídeo

string

O tempo mínimo necessário para um usuário repetir uma sequência de anúncios.

Semana
Mês

Disponível apenas para itens de linha de "Sequência de vídeo".

Segmentação de pacotes selecionados de smart TV: incluir

string

Inclua pacotes selecionados de smart TV na segmentação.

TRUE
FALSO

Dados estruturados - v11 - QA do item de linha Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Dados estruturados - v11 - QA do item de linha