Dados estruturados: v8 - campanha

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

CampoObrigatórioTipoGravávelDescrição
ID da campanhaObrigatório apenas ao editar campanhas existentesnú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. Como opção, ao criar uma nova campanha, é possível usar um identificador personalizado com o objetivo de 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 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. O ID do anunciante precisa ser válido
NomeSimstringSimO nome da entrada.
Carimbo de data/horaObrigatório ao editar entradas existentesnúmero inteiroNãoO carimbo de data/hora da entrada, 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ável:
  • CPM
  • % 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 de meta da campanhaSimfloatSimUm número positivo para o KPI de meta da campanha. Para o KPI de meta da campanha "% visível" e CTR insira o valor em porcentagem para este campo, 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 criativo 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 serão exibidas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de 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 baseado em impressão na campanha.
  • VERDADEIRO
  • FALSO
Exposições de frequênciaObrigatório quando "Frequência ativada" é "VERDADEIRO"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 do período para o limite de frequência.
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
  • Todo o período
Valor da frequênciaObrigatório quando "Frequência ativada" é "VERDADEIRO"número inteiroSimUm valor inteiro positivo para a duração do tipo de período de frequência, ou seja, o y em "Exibir x impressões ao longo de y".
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 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 aceitáveis são fornecidos na tabela a seguir:

    Nome da colunaObrigatórioDescrição
    IDNãoO ID exclusivo do segmento do orçamento da campanha. É necessário fornecer essas informações ao editar um segmento de orçamento. Se deixado em branco, o segmento de orçamento será gravado como novo.
    NomeSimNome de exibição do segmento de orçamento da campanha.
    TipoSimO tipo 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 valor de impressão de número inteiro simples ou um número flutuante para um valor de moeda. As moedas serão exibidas na moeda do anunciante em unidades padrão (não em 1/1.000.000 de unidade monetária).
    Data de inícioNãoÉ um 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 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
    Código do orçamento externoApenas para segmentos de orçamento da MediaoceanSe definido, todas as impressões veiculadas nesse segmento de orçamento incluirão 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 os mesmos IDs 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 é compatível com a pesquisa e a filtragem nesse 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 é compatível com a pesquisa e a filtragem nesse campo.
    Código de 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 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 por 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 a faixa etária do usuário. Especifique um intervalo de/para selecionando uma única idade "De" e uma única idade "Para" e se você quer incluir idades desconhecidas como verdadeiro/falso. Veja a lista de faixas etárias "De/Até" aceitáveis.
Exemplo 1: para segmentar de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Para ; Incluir Verdadeiro/Falso desconhecido} = 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 por renda familiarNãostring, listaSimSegmente uma faixa de renda familiar. Especifique um intervalo de/para selecionando uma faixa de renda Top_of_Range e uma única faixa de renda Bottom_of_Range e se deseja incluir famílias com renda desconhecida como 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 com maior renda e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Incluir Verdadeiro/Falso desconhecido} = Top 10%;41-50%;true;
Exemplo 2: para segmentar apenas os 50% com menor renda das famílias e excluir as famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Incluir Verdadeiro/Falso desconhecido} = 50% mais baixos; 50% mais baixos;verdadeiro;
Valores aceitáveis para Intervalo_superior/Parte inferior do_intervalo:
  • 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 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 campanhas da Rede de Display e IDs de recurso TargetingOption da API 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, listaSim

Lista de localidades a serem excluídas da segmentação.

Esta coluna usa campanhas da Rede de Display e IDs de recurso TargetingOption da API 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, listaSim

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

Esta coluna usa campanhas da Rede de Display e IDs de recurso TargetingOption da API 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, listaSim

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

Esta coluna usa campanhas da Rede de Display e IDs de recurso TargetingOption da API 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çã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 sensibilidade para bloquear inventário com base no conteúdo relacionado.
  • Não bloquear
  • Usar a verificação do Campaign Manager 360
  • Usar personalizado
Configurações personalizadas de brand safetyObrigatório ao definir a "Configuração personalizada de brand safety" é "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, (sexual, álcool, tabaco etc.).
  • Conteúdo sexual
  • Depreciativo
  • Downloads e Compartilhando
  • 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 terceirizado de serviços de verificação.
  • 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 marcadores aceitos pelo provedor selecionado.
Segmentação de visibilidade do Active ViewNãostringSimPorcentagem de visibilidade prevista desejada. As porcentagens são representadas como flutuações. Um de {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Segmentação por posicionamento: exibição na telaNãostring, listaSimSegmentação de posições de anúncios de display na tela. Selecione um ou mais dos valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posicionamento: vídeo na telaNãostring, listaSimSegmentação por posição do anúncio em vídeo na tela. Selecione um ou mais dos valores aceitáveis:
  • Acima da dobra
  • Abaixo da dobra
  • Desconhecido
Segmentação por posicionamento: mostrar posição no conteúdoNãostring, listaSimMostrar posições de conteúdo de anúncios de display para segmentar. Selecione um ou mais dos 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 de conteúdo de anúncios em vídeo para segmentação. 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 "Type" for "Display", "Video" ou "Audio"stringSimConfiguração para segmentar vendedores diretos autorizados, vendedores diretos e revendedores autorizados ou vendedor autorizado + desconhecido. "Direto autorizado" significa que somente vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar vendedores e vendedores autorizados. "Editor autorizado e não participante" significa que ele 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.

Esta coluna usa campanhas da Rede de Display e Os IDs de recursos InventorySource da API Video 360, IDs de trocas publicadas e do Display & IDs de recurso TargetingOption da API Video 360 do tipo de segmentação TARGETING_TYPE_SUB_EXCHANGE.

Formato da lista = (InventorySource.inventorySourceId; conversionId; TargetingOption.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 publicados e IDs de recurso TargetingOption da API Display & Video 360 do tipo de segmentação TARGETING_TYPE_SUB_EXCHANGE.

Formato da lista = (InventorySource.inventorySourceId; conversionId; TargetingOption.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 dos valores aceitáveis. A opção "Web não otimizada" não pode ser selecionado sem selecionar "Web".
  • Web
  • Web não otimizada
  • App