Dados estruturados – v5.5 – 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 da 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, o pedido 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ãoO 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
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. Ele é 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 MM/DD/AAAA HH:mm
Data de término da campanhaNãostringSimA data de término da campanha no formato DD/MM/AAAA HH:mm
Frequência ativadaSimstringSimAtiva/desativa o limite de frequência com base nas impressões na campanha.
  • VERDADEIRO
  • 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".
Segmentos de orçamento da campanhaNãostring, lista de listasSimConjunto de segmentos de orçamento da campanha. Formato da lista = (ID; Nome; Tipo; Valor; Data de início; Data de término; Origem do orçamento externo; ID do orçamento externo; ID do agrupamento de faturas; Código do cliente do Prisma; Código do produto do Prisma; Código da estimativa do Prisma; Tipo do Prisma; Fornecedor).

    Exemplo: '(; My Budget; IMPRESSIONS; 234; 01/01/2020 00:00; ; MEDIA_OCEAN; ExternalId; InvoiceId; Client; Product; Estimate; DISPLAY; MySupplier;)', em que o ID e a data de término não são fornecidos.
    Os valores aceitos são mostrados na tabela a seguir:

    Nome da colunaObrigatórioDescrição
    IDNãoO ID exclusivo do segmento do orçamento da campanha. É necessário fornecer esse valor ao editar um segmento de orçamento. Se deixado em branco, o segmento de orçamento será gravado como novo.
    NomeSimO nome de exibição do segmento do orçamento da campanha.
    TipoSimO tipo do valor do orçamento. Os valores aceitáveis são:
    • Valor
    • Impressões
    ValorSimUm valor de orçamento positivo para o tipo de orçamento. Pode ser um valor de impressão de número inteiro simples ou um número flutuante para um valor de moeda. 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ícioNãoUm carimbo de data/hora para a data de início do voo do segmento de orçamento no formato MM/DD/AAAA HH:mm. Uma data de início não definida é representada por um valor de campo em branco.
    Data de términoNãoUm carimbo de data/hora para a data de término do voo do segmento de orçamento no formato MM/DD/AAAA HH:mm. Uma data de término não definida é representada por um valor de campo em branco.
    Origem do orçamento externoSimA origem do segmento de orçamento. Os valores aceitáveis são:
    • Nenhum
    • Mediaocean
    ID do orçamento externoApenas para segmentos de orçamento da MediaoceanSe definido, todas as impressões veiculadas para esse segmento de orçamento vão incluir esse ID na fatura se o cliente tiver ativado o faturamento no nível do segmento de orçamento.
    ID do agrupamento de faturasNãoSe definido, todos os segmentos de orçamento com o mesmo ID de orçamento externo e ID de agrupamento de faturas serão agregados em uma única fatura se o cliente tiver ativado o faturamento no nível do segmento de orçamento.
    Código do cliente do PrismaApenas para segmentos de orçamento da MediaoceanSó pode ser definido para segmentos de orçamento da Mediaocean. A Central de pagamentos do Google permite pesquisar e filtrar esse campo.
    Código do produto do PrismaApenas para segmentos de orçamento da MediaoceanSó pode ser definido para segmentos de orçamento da Mediaocean. A Central de pagamentos do Google permite pesquisar e filtrar esse campo.
    Código da estimativa do PrismaApenas para segmentos de orçamento da MediaoceanSó pode ser definido para segmentos de orçamento da Mediaocean. A Central de pagamentos do Google permite pesquisar e filtrar esse campo.
    Tipo de prismaApenas para segmentos de orçamento da MediaoceanSó pode ser definido para segmentos de orçamento da Mediaocean. O tipo do Prisma do segmento. Os valores aceitáveis são:
    • Display
    • Pesquisar
    • Vídeo
    • Áudio
    • Social
    • Fee
    Fornecedor do PrismaApenas para segmentos de orçamento da MediaoceanSó pode ser definido para segmentos de orçamento da Mediaocean. A entidade alocada para esse orçamento (DSP, site etc.)
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 desconhecido 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 aceitos 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 geografias 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.).
Classificações de conteúdo digital: excluirNãostring, listaSimLista das classificações de conteúdo digital a serem excluídas. 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 em questão do conteúdo relacionado a ele.
  • Não bloquear
  • Usar a Verificação do Campaign Manager 360
  • 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, "Sexual;Álcool;Tabaco;etc.".
  • Conteúdo sexual
  • 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 compatíveis com o 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}
Segmentação por posição: mostrar na telaNãostring, listaSimSegmentação por posição do anúncio de display na tela. Selecione um ou mais dos valores aceitos:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posição: vídeo na telaNãostring, listaSimSegmentação por posição do anúncio em vídeo na tela. Selecione um ou mais dos valores aceitos:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posição: posição de exibição no conteúdoNãostring, listaSimMostrar posições de conteúdo de anúncios de display para segmentar. Selecione um ou mais dos valores aceitos:
  • No artigo
  • In-Feed
  • No banner
  • Intersticial
  • Desconhecido
Segmentação por posição: posição do vídeo no conteúdoNãostring, listaSimPosições de conteúdo de anúncios em vídeo para segmentação. Selecione um ou mais dos valores aceitos:
  • No artigo
  • In-Feed
  • No banner
  • Intersticial
  • Out-stream desconhecido
  • Início da exibição
  • Anúncio intermediário
  • Fim da exibição
  • In-stream desconhecida
Segmentação da origem de inventário: opções de vendedor autorizadoObrigatório quando "Type" for "Display", "Video" ou "Audio"stringSimA configuração para segmentar vendedores diretos autorizados, vendedores diretos autorizados e revendedores ou vendedores autorizados e desconhecidos. "Autorizado direto" significa que apenas os vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar os vendedores diretos e revendedores autorizados. "Editor autorizado e não participante" significa que o público-alvo será composto por 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: 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 ambienteNãostring, listaSimLista de ambientes a serem segmentados. Selecione um ou mais dos valores aceitáveis. Não é possível selecionar "Web não otimizada" sem selecionar "Web".
  • Web
  • Web não otimizada
  • App