Dados estruturados – v4 – Campanha

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

CampoObrigatórioTipoGravávelDescrição
ID da campanhaObrigatório apenas ao editar campanhas atuaisnúmero inteiroNãoÉ o valor do ID numérico da campanha. Se deixado em branco, um novo ID de campanha será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar uma nova campanha, você pode usar um identificador personalizado para atribuir pedidos de inserção à nova campanha. O formato do identificador personalizado é "ext[custom identifier]", por exemplo: ext123. Quando o arquivo é enviado e processado, todos os identificadores personalizados são substituídos por IDs atribuídos pela DBM, e os objetos são associados (por exemplo, ordem de inserção à campanha) com base nos identificadores personalizados.
Código do anuncianteSimnúmero inteiroNãoÉ o valor do ID numérico do anunciante. Precisa ser um ID do anunciante válido
NomeSimstringSimO nome da entrada.
Carimbo de data/horaObrigatório ao editar entradas existentesnúmero inteiroNãoÉ 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.
StatusSimstringSimA configuração de status da entrada.
  • Ativo
  • Pausado
  • Arquivado
  • Excluído
Meta da campanhaSimstringSimSelecione uma das metas da campanha aplicáveis:
  • Aumentar o reconhecimento da minha marca ou do meu produto
  • Impulsionar ação on-line ou visitas
  • Impulsionar as vendas off-line ou na loja
  • Impulsionar instalações ou engajamentos do aplicativo
KPI da meta da campanhaSimstringSimSelecione um dos KPIs aplicáveis da meta da campanha:
  • CPM
  • Porcentagem visível
  • Custo por impressão audível e visível na conclusão (CPIAVC, na sigla em inglês)
  • CPA
  • CPC
  • CTR
  • Outro
Valor do KPI da meta da campanhaSimfloatSimUm número positivo para o KPI da meta da campanha. Para o KPI da meta da campanha "% de visualização" e "CTR", insira o valor desse campo em porcentagem. Por exemplo, 80% seria inserido como "80". Para o KPI "Outros", este campo é uma breve descrição do objetivo.
Tipos de criativoSimstring, listaSimLista de tipos de criativos que você espera usar.
  • Display
  • Vídeo
  • Áudio
Orçamento da campanhaNãofloatSimUm valor de orçamento positivo para a campanha. É sempre um número flutuante para um valor de moeda, já que sempre será um orçamento monetário. As moedas vão ser mostradas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de uma unidade monetária)
Data de início da campanhaSimstringSimA data de início da campanha no formato AAAA-MM-DD HH:mm
Data de término da campanhaNãostringSimA data de término da campanha no formato MM/DD/AAAA HH:mm
Frequência ativadaSimstringSimAtiva/desativa o limite de frequência com base nas impressões na campanha.
  • TRUE
  • FALSO
Exposições de frequênciaObrigatório quando "Frequency Enabled" for "TRUE"número inteiroSimUm valor 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 no período y".
Período de frequênciaObrigatório quando "Frequency Enabled" for "TRUE"stringSimEspecifica a unidade de tempo do limite de frequência.
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
  • Todo o período
Valor da frequênciaObrigatório quando "Frequency Enabled" for "TRUE"número inteiroSimUm valor inteiro positivo para a duração do tipo "Período de frequência", ou seja, o "y" em "Mostrar x impressões no período y".
Segmentação demográfica: gêneroNãostring, listaSimLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitos:
  • Feminino
  • Masculino
  • Desconhecido
Segmentação demográfica por idadeNãostring, listaSimSegmentar por faixa etária. Especifique um intervalo de "de/até" selecionando uma única idade de início e uma única idade de término e se deseja incluir idades desconhecidas (verdadeiro/falso). Consulte a lista de idades de início/término aceitáveis.
Exemplo 1: para segmentar pessoas de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Até ; Incluir idades desconhecidas Verdadeiro/Falso} = 18;55;true;
Exemplo 2: para segmentar apenas usuários com mais de 35 anos e excluir idades desconhecidas, especifique o seguinte = 35;+;false;.
Valores aceitáveis para "De":
  • 18
  • 25
  • 35
  • 45
  • 55
  • 65

Valores aceitáveis para "Para":
  • 25
  • 35
  • 45
  • 55
  • 65
  • +
Segmentação demográfica: renda familiarNãostring, listaSimSegmentar uma faixa de renda familiar. Especifique um intervalo de "de/até" selecionando um único intervalo de renda "Top_of_Range" e um único intervalo de renda "Bottom_of_Range" e se é necessário incluir domicílios com renda desconhecida (verdadeiro/falso). Consulte a lista de intervalos aceitáveis de Top_of_Range/Bottom_of_Range.
Exemplo 1: para segmentar os 10% a 50% mais ricos e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true;
Exemplo 2: para segmentar apenas os 50% mais pobres e excluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true;
Valores aceitáveis para Top_of_Range/Bottom_of_Range:
  • Os 10% com maior renda
  • De 11% a 20%
  • De 21% a 30%
  • De 31% a 40%
  • De 41% a 50%
  • Os 50% com menor renda

Segmentação demográfica: status parentalSimstring, listaSimLista de status parentais a serem segmentados. Selecione um ou mais dos valores aceitáveis.
  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação geográfica: incluirNãostring, listaSimLista de geografias a serem incluídas na segmentação. Formato da lista = (GeoLocation.id; GeoLocation.id; etc.).
Segmentação geográfica: excluirNãostring, listaSimLista de localizações a serem excluídas da segmentação. Formato da lista = (GeoLocation.id;GeoLocation.id; etc.).
Segmentação por idioma: incluirNãostring, listaSimLista de idiomas para incluir na segmentação. Formato da lista = (Language.id;Language.id;etc.).
Segmentação por idioma: excluirNãostring, listaSimLista de idiomas a serem excluídos da segmentação. Formato da lista = (Language.id;Language.id;etc.).
Rótulos de brand safetyNãostring, listaSimLista das classificações de conteúdo digital a serem segmentadas. Formato da lista = (G; PG; etc.).
  • G
  • PG
  • T
  • MA
  • ?
Configurações de sensibilidade de brand safetyNãostringSimEscolha a configuração de sensibilidade para bloquear o inventário com base no objeto do conteúdo relacionado.
  • Não bloquear
  • Usar a Verificação da DoubleClick
  • Usar personalizado
Configurações personalizadas de brand safetyObrigatório quando a configuração personalizada de proteção de marca é "Usar personalizado"string, listaSimSe a configuração de sensibilidade à proteção de marca for "Usar personalizado", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Adulto;Álcool;Tabaco;etc.).
  • Adulto
  • Depreciativo
  • Downloads e compartilhamento
  • Armas
  • Jogos de azar
  • Violência
  • Sugestivo
  • Linguagem obscena
  • Bebidas alcoólicas
  • Drogas
  • Tabaco
  • Política
  • Religião
  • Tragédia
  • Acidentes de transporte
  • Problemas sociais sensíveis
  • Chocante
Serviços de verificação de terceirosNãostringSimprovedor de serviços de verificação de terceiros.
  • Nenhum
  • Integral Ad Science
  • DoubleVerify
  • Adloox
Rótulos de verificação de terceirosNãostring, listaSimSe a opção "Serviços de verificação de terceiros" não for "Nenhum", especifique uma lista de rótulos aceitos pelo provedor selecionado.
Segmentação de visibilidade do Active ViewNãostringSimSegmentar por porcentagens de visibilidade previstas. As porcentagens são representadas como números de ponto flutuante. Um dos valores {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Posição do anúncio da segmentação de visibilidade: incluirNãostringSimSegmentar posições de anúncios. Selecione um ou nenhum dos valores aceitáveis:
  • Todos
  • ATF
  • BTF
  • Desconhecido
Segmentação por visibilidade da posição do anúncio: excluirNãostringSimExcluir posições de anúncios na segmentação. Selecione um ou nenhum dos valores aceitáveis:
  • ATF
  • BTF
  • Desconhecido
Segmentação da origem de inventário: incluirNãostring, listaSimLista de inventário a ser incluído na segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário: excluirNãostring, listaSimLista de inventário a ser excluído da segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).
Segmentação da origem de inventário: segmentar novas trocasNãostringSimA configuração para segmentar novas trocas.
  • Verdadeiro
  • Falso
Segmentação de ambienteObrigatório quando "Type" é "Display", "Video" ou "Audio"string, listaSimLista de ambientes a serem segmentados. Formato da lista = (Web para computador, app para dispositivos móveis etc.).
Para o ambiente de exibição:
  • Web para computadores
  • Web para dispositivos móveis
  • App para dispositivos móveis
  • Intersticial de app para dispositivos móveis
  • Web para computadores em dispositivos móveis
Para vídeos:
  • Vídeo da Web para computadores
  • Jogo da Web para computadores
  • In-Read para Web para computadores
  • Web para computadores no feed
  • Vídeo da Web para dispositivos móveis
  • Vídeo do app para dispositivos móveis
  • Intersticial em vídeo de app para dispositivos móveis
Para áudio:
  • Áudio da Web para computadores
  • Áudio da Web para dispositivos móveis
  • Áudio do app para dispositivos móveis