Dados estruturados – v7.1 – Campanha

Consulte a visão geral para uma explicação do 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 campanha, você pode usar um identificador personalizado para atribuir pedidos de inserção a ela. 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 pelo DBM, e os objetos são associados (por exemplo, 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 de anunciante válido
NomeSimstringSimO nome da entrada.
Carimbo de data/horaObrigatório ao editar entradas atuaisnú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 de 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 de meta da campanha aplicáveis:
  • 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 os KPIs de meta da campanha "% visível" e "CTR", insira o valor desse campo em porcentagem. Por exemplo, 80% seria inserido como "80". Para o KPI "Outro", este campo é uma breve descrição do objetivo.
Tipos de criativoSimstring, listSimLista 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 ponto flutuante para um valor monetário, já que será sempre um orçamento monetário. 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).
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 MM/DD/AAAA HH:mm
Frequência ativadaSimstringSimAtiva/desativa o limite de frequência com base em impressões na campanha.
  • TRUE
  • FALSO
Exposições de frequênciaObrigatório quando "Frequency Enabled" é "TRUE"número inteiroSimUm número inteiro positivo para a quantidade 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ênciaObrigatório quando "Frequency Enabled" é "TRUE"stringSimEspecifica a unidade de período para o limite de frequência.
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
Valor da frequênciaObrigatório quando "Frequency Enabled" é "TRUE"número inteiroSimUm número inteiro positivo para o período de tempo do tipo "Período de frequência", ou seja, o "y" em "Mostrar x impressões em um período de y".

Os períodos de tempo do limite de frequência precisam ser de 30 dias ou menos.
Segmentos de orçamento da campanhaNãostring, lista de listasSimO conjunto 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 de 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 ID e data de término não são fornecidos.
    Os valores aceitáveis estão na tabela a seguir:

    Nome da colunaObrigatórioDescrição
    IDNãoO ID exclusivo do segmento de orçamento da campanha. Isso precisa ser fornecido 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 de 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 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).
    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 em relação a 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 do 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 a esse orçamento (DSP, site etc.)
Segmentação demográfica por gêneroNãostring, listSimLista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis:
  • Feminino
  • Masculino
  • Desconhecido
Idade da segmentação demográficaNãostring, listSimSegmentar por faixa etária do usuário. Especifique um intervalo de "De/Até" selecionando uma idade inicial e uma idade final, além de incluir ou não idades desconhecidas (verdadeiro/falso). Confira a lista de idades "De/Até" aceitas.
Exemplo 1: para segmentar pessoas de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Até ; Incluir desconhecidas Verdadeiro/Falso} = 18;55;verdadeiro;
Exemplo 2: para segmentar apenas usuários com mais de 35 anos e excluir idades desconhecidas, especifique o seguinte = 35;+;falso;.
Valores aceitos 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, listSimSegmentar uma faixa de renda familiar. Especifique um intervalo de "de/até" selecionando um intervalo de renda "Top_of_Range" e um intervalo de renda "Bottom_of_Range", além de incluir ou não famílias com renda desconhecida (verdadeiro/falso). Confira a lista de intervalos aceitáveis de "Top_of_Range"/"Bottom_of_Range".
Exemplo 1: para segmentar os 10% a 50% mais ricos das famílias 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 das famílias 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 por status parentalSimstring, listSimLista de status parentais a serem segmentados. Selecione um ou mais dos valores aceitos.
  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação geográfica: incluirNãostring, listSim

Lista de regiões geográficas a serem incluídas na segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_GEO_REGION.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação geográfica - ExcluirNãostring, listSim

Lista de regiões geográficas a serem excluídas da segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_GEO_REGION.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por idioma: incluirNãostring, listSim

Lista de idiomas a serem incluídos na segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_LANGUAGE.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Segmentação por idioma - ExcluirNãostring, listSim

Lista de idiomas a serem excluídos da segmentação.

Essa coluna usa IDs de recursos TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_LANGUAGE.

Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente.

Classificações de conteúdo digital: excluirNãostring, listSimLista das classificações de conteúdo digital a serem excluídas. Formato da lista = (G;PG; etc.).
  • G
  • PG
  • T
  • MA
  • ?
Configuração de sensibilidade do brand safetyNãostringSimEscolha 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
  • Usar predefinição personalizada
Configurações personalizadas de brand safetyObrigatório quando a "Configuração personalizada de segurança da marca" é "Usar personalizada"string, listSimSe 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.).
  • 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
Etiquetas de verificação de terceirosNãostring, listSimSe "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 porcentagens de visibilidade previstas. 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: mostrar na telaNãostring, listSimSegmentação de posições de anúncios gráficos na tela. Selecione um ou mais dos valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posição: vídeo na telaNãostring, listSimSegmentação de posições de anúncios em vídeo 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údoNãostring, listSimPosições de conteúdo do anúncio de display a serem segmentadas. Selecione um ou mais dos valores aceitáveis:
  • No artigo
  • In-Feed
  • No banner
  • Intersticial
  • Desconhecido
Segmentação por posição: posição do vídeo no conteúdoNãostring, listSimPosições de conteúdo de anúncios em vídeo a serem segmentadas. Selecione um ou mais dos valores aceitáveis:
  • 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 desconhecido
Segmentação da origem de inventário: opções de vendedor autorizadoObrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio"stringSimDefinir a segmentação para vendedores diretos autorizados, vendedores diretos e revendedores autorizados ou vendedores autorizados + desconhecidos. "Direto autorizado" significa que apenas vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar os vendedores e revendedores autorizados. "Editor 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 - IncluirNãostring, listSim

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

Essa coluna usa IDs de recursos InventorySource da API Display & Video 360, IDs de troca publicados e IDs de recursos TargetingOption da API Display & Video 360 do tipo de segmentação TARGETING_TYPE_SUB_EXCHANGE.

Formato da lista = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

Segmentação da origem de inventário - ExcluirNãostring, listSim

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

Essa coluna usa IDs de recursos InventorySource da API Display & Video 360, IDs de troca publicados e IDs de recursos TargetingOption da API Display & Video 360 do tipo de segmentação TARGETING_TYPE_SUB_EXCHANGE.

Formato da lista = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

Segmentação da origem de inventário - Segmentar novas trocasNãostringSimConfiguração para segmentar novas trocas.
  • Verdadeiro
  • Falso
Segmentação de ambienteNãostring, listSimLista 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