Dados estruturados – v7 – Campanha

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

CampoObrigatórioTipoGravávelDescrição
ID da campanhaObrigatório somente 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. Como opção, ao criar uma nova campanha, é possível usar um identificador personalizado para atribuir pedidos de inserção a ela. O formato de um identificador personalizado é "ext[identificador personalizado]", 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 da 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.
NomeSimstringSimNome 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.
  • Ativas
  • 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
  • Aumentar instalações ou engajamentos do aplicativo
KPI da meta da campanhaSimstringSimSelecione um dos KPIs de meta da campanha aplicáveis:
  • CPM
  • % de impressões visíveis
  • Custo por impressão audível e visível na conclusão (CPIAVC, na sigla em inglês)
  • CPA
  • CPC
  • CTR
  • Outros
Valor do KPI da meta da campanhaSimfloatSimUm número positivo para o KPI da meta da campanha. Para o KPI "Porcentagem visível" e "CTR" da meta da campanha, insira o valor desse campo em porcentagem. Por exemplo, 80% seria inserido como "80". Para o KPI "Outros", esse campo é uma breve descrição do objetivo.
Tipos de criativoSimstring, listaSimLista dos tipos de criativos que você espera usar.
  • Tela
  • Video
  • Áudio
Orçamento da campanhaNãofloatSimUm valor de orçamento positivo para a campanha. Isso é sempre uma flutuação para um valor monetário, pois 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
  • FALSE
Exposições de frequênciaObrigatório quando a "Frequência ativada" 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 "Exibir x impressões em y período".
Período de frequênciaObrigatório quando a "Frequência ativada" for "TRUE"stringSimEspecifica a unidade do período para o limite de frequência.
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
  • Ciclo de vida
Valor de frequênciaObrigatório quando a "Frequência ativada" for "TRUE"número inteiroSimUm valor inteiro positivo para a duração do tipo "Período de frequência", ou seja, o y em "Exibir x impressões em y período".
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 do agrupamento de faturas; Código do cliente Prisma; Código do produto 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; MyVendor;)' Onde ID e data de término não são informados.
    Os valores aceitáveis são mostrados 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á escrito como novo.
    NomeSimNome de exibição do segmento do orçamento da campanha.
    TipoSimTipo de 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 número inteiro simples de impressão ou uma flutuação para um valor 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ícioNãoUm carimbo de data/hora da data de início do período de veiculação 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 da data de término do período de veiculação 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 externoSomente para segmentos de orçamento do 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 segmento do 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 vão ser agregados em uma única fatura se o cliente tiver ativado o faturamento no nível do segmento de orçamento.
    Código do cliente PrismaSomente para segmentos de orçamento do MediaoceanEssa opção só pode ser definida para segmentos de orçamento do Mediaocean. A central de pagamentos do Google oferece suporte à pesquisa e filtragem nesse campo.
    Código do produto PrismaSomente para segmentos de orçamento do MediaoceanEssa opção só pode ser definida para segmentos de orçamento do Mediaocean. A central de pagamentos do Google oferece suporte à pesquisa e filtragem nesse campo.
    Código da estimativa do PrismaSomente para segmentos de orçamento do MediaoceanEssa opção só pode ser definida para segmentos de orçamento do Mediaocean. A central de pagamentos do Google oferece suporte à pesquisa e filtragem nesse campo.
    Tipo de PrismaSomente para segmentos de orçamento do MediaoceanEssa opção só pode ser definida para segmentos de orçamento do Mediaocean. O tipo Prisma do segmento. Os valores aceitáveis são:
    • Tela
    • Pesquisar
    • Video
    • Áudio
    • Mídias sociais
    • Fee
    Fornecedor de PrismaSomente para segmentos de orçamento do MediaoceanEssa opção só pode ser definida para segmentos de orçamento do Mediaocean. A entidade alocada a este orçamento (DSP, site etc.)
Sexo de segmentação demográficaNãostring, listaSimLista de sexos a serem segmentados. Selecione um ou mais valores aceitáveis:
  • Feminino
  • Masculino
  • Desconhecido
Idade da segmentação demográficaNãostring, listaSimsegmentar uma faixa etária do usuário; Especifique um intervalo de/para selecionando uma única idade "De" e uma única idade "Para" e se quer incluir idades desconhecidas como verdadeiro/falso. Veja a lista de idades "De/Até" aceitáveis.
Exemplo 1: para segmentar 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Para ; Inclua desconhecido Verdadeiro/Falso} = 18;55;true;
Exemplo 2: para segmentar apenas usuários maiores 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, listaSimSegmente uma faixa de renda familiar. Especifique um intervalo de/para selecionando uma única faixa de renda Top_of_Range e uma única faixa de renda Bottom_of_Range, e se você quer incluir famílias com renda desconhecida (verdadeiro/falso). Veja a lista de intervalos Top_of_Range/Bottom_of_Range aceitáveis.
Exemplo 1: para segmentar os 10% a 50% das famílias mais altas e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; inclua desconhecido Verdadeiro/Falso} = Top 10%;41-50%;true;
Exemplo 2: para segmentar apenas o formato familiar_inferior_inferior e que inclui o formato_inferior_inferior com renda desconhecida,
  • 10% com maior renda
  • De 11% a 20%
  • De 21% a 30%
  • De 31% a 40%
  • De 41% a 50%
  • 50% com menor renda

Segmentação demográfica: status parentalSimstring, listaSimLista de status parentais a serem segmentados. Selecione um ou mais valores aceitáveis.
  • Com filhos
  • Sem filhos
  • Desconhecido
Segmentação geográfica - IncluirNãostring, listaSim

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

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

Formato da lista = (SegmentaçãoOption.targetingOptionId; SegmentaçãoOption.targetingOptionId etc.). Esta lista é gerada em ordem numérica crescente.

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

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

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

Formato da lista = (SegmentaçãoOption.targetingOptionId; SegmentaçãoOption.targetingOptionId etc.). Esta lista é gerada em ordem numérica crescente.

Idioma de destino - incluirNãostring, listaSim

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

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

Formato da lista = (SegmentaçãoOption.targetingOptionId; SegmentaçãoOption.targetingOptionId etc.). Esta lista é gerada em ordem numérica crescente.

Idioma de destino - excluirNãostring, listaSim

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

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

Formato da lista = (SegmentaçãoOption.targetingOptionId; SegmentaçãoOption.targetingOptionId etc.). Esta lista é gerada em ordem numérica crescente.

Classificação 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ção de sensibilidade de brand safetyNãostringSimEscolha a configuração de confidencialidade para bloquear inventário com base no assunto do conteúdo ao redor.
  • 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 brand safety" for "Usar personalizado"string, listaSimSe a configuração de sensibilidade de brand safety for "Usar personalizado", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Conteúdo 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
  • Conflitante
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 "Serviços de verificação de terceiros" não for "Nenhum", especifique uma lista de rótulos aceitos pelo provedor selecionado.
Active View de segmentação de visibilidadeNãostringSimPorcentagem desejada de visibilidade prevista. As porcentagens são representadas como flutuações. Um destes: {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Segmentação por posicionamento – Display na telaNãostring, listaSimSegmentação por posições de anúncios de display na tela. Selecione um ou mais valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posicionamento - Vídeo na telaNãostring, listaSimSegmentação por posições de anúncios em vídeo na tela. Selecione um ou mais valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posicionamento - posição de exibição no conteúdoNãostring, listaSimPosições do conteúdo do anúncio de display a serem segmentadas. Selecione um ou mais valores aceitáveis:
  • No artigo
  • In-Feed
  • No banner
  • Intersticial
  • Desconhecido
Segmentação por posicionamento - posição do vídeo no conteúdoNãostring, listaSimPosições do conteúdo do anúncio em vídeo a serem segmentadas. Selecione um ou mais 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 do vendedor autorizadoObrigatório quando o "Tipo" é "Display", "Vídeo" ou "Áudio"stringSimConfiguração para segmentar vendedores diretos autorizados, vendedores diretos autorizados e revendedores ou vendedor autorizado + desconhecido. "Direto autorizado" significa que somente 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, listaSim

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

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

Formato da lista = (InventorySource.inventorySourceId; ExchangeId; SegmentaçãoOption.targetingOptionId; etc.)

Segmentação da origem de inventário – ExcluirNãostring, listaSim

Lista de origens de inventário, trocas e subtrocas a serem excluídas da segmentação.

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

Formato da lista = (InventorySource.inventorySourceId; ExchangeId; SegmentaçãoOption.targetingOptionId; etc.)

Segmentação da origem de inventário: segmentar novas trocasNãostringSimConfiguração para segmentar novas trocas.
  • Verdadeiro
  • Falso
Segmentação por ambienteNãostring, listaSimLista de ambientes a serem segmentados. Selecione um ou mais valores aceitáveis. A opção "Web não otimizada" não pode ser selecionada sem a seleção de "Web".
  • Web
  • Web não otimizada
  • App