Dados estruturados - v10 - Pedido de inserção

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

CampoObrigatórioTipoGravávelDescrição
ID do pedido de inserçãoObrigatório apenas ao editar pedidos de inserção atuaisnúmero inteiroNãoÉ o valor do ID numérico do pedido de inserção. Se deixado em branco, um novo código do pedido de inserção será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar um novo pedido de inserção, você pode usar um identificador personalizado para atribuir itens de linha ao novo pedido de inserção. 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, item de linha ao pedido de inserção) com base nos identificadores personalizados.
ID da campanhaNãonúmero inteiroNãoÉ o valor do ID numérico da campanha. Você pode especificar um identificador personalizado (por exemplo, "ext[custom campaign identifier]") para uma campanha criada ao mesmo tempo que este pedido de inserção.
NomeSimstringSimO nome da entrada.
Carimbo de data/horaObrigatório ao editar entradas atuaisnú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
  • Rascunho
  • Arquivado
Tipo de pedido de inserçãoSimstringSimO tipo de pedido de inserção. Só pode ser definido na criação.
  • padrão
Subtipo de pedido de inserçãoSimstringSimCampo obrigatório para que os pedidos de inserção distingam entre diferentes formatos. Se o campo for deixado em branco, o valor "padrão" será usado.
  • Padrão
  • Over-the-top normal
Objetivo do pedido de inserçãoSimstringSimO objetivo do pedido de inserção.

Esse campo está na versão Beta e, no momento, só está disponível para clientes participantes. Essa coluna sempre estará vazia para clientes que não participam da versão Beta.
  • Reconhecimento da marca
  • Clique
  • Conversão
  • Personalizado
  • Nenhum objetivo
TaxasNãostring, lista de listasSimTodas as taxas dessa entrada. Formato da lista = (categoria da taxa; valor da taxa; tipo de taxa; faturado;).
  • Categoria da taxa
    • CPM
    • Mídia
  • Valor da taxa
    • Ponto flutuante
    • Porcentagem como ponto flutuante
  • Tipo de taxa
    • (string, consulte a tabela em taxas)
  • Faturado
    • Verdadeiro
    • Falso
    • em branco

Exemplo: "(CPM; 2; Taxa do Display & Video 360; Falso) ; (Mídia; 13; Padrão; Verdadeiro);"
Os valores aceitáveis são fornecidos na tabela a seguir:

Categoria da taxaTipo de taxaOpção faturada
CPM/MídiaPadrãoNão permitido (deixe em branco)
CPM/MídiaServidor de anúncios de terceirosNão permitido (deixe em branco)
CPM/MídiaDoubleVerifyPermitido (verdadeiro/falso)
CPM/MídiaAdsafeNão permitido (deixe em branco)
CPM/MídiaAdxposeNão permitido (deixe em branco)
CPM/MídiaVizuNão permitido (deixe em branco)
CPM/MídiaAggregate KnowledgeNão permitido (deixe em branco)
CPM/MídiaTeracentNão permitido (deixe em branco)
CPM/MídiaEvidonNão permitido (deixe em branco)
CPM/MídiaTaxa das agências negociadorasNão permitido (deixe em branco)
CPM/MídiaAdlooxPermitido (verdadeiro/falso)
CPMShopLocalObrigatório (verdadeiro)
CPMTrustMetricsNão permitido (deixe em branco)
CPMVídeo da Integral Ad SciencePermitido (verdadeiro/falso)
CPMVídeo da MOATNão permitido (deixe em branco)
MídiaTaxa do Display &Video 360Obrigatório (verdadeiro)
MídiaDados de custo de mídiaNão permitido (deixe em branco)
MídiaTaxa da ScibidsObrigatório (verdadeiro)
Código de integraçãoNãostringSimUm código opcional para fins de acompanhamento.
DetalhesNãostringSimDetalhes da entrada em formato de string.
RitmoSimstringSim

O período usado para gastar o valor do ritmo.

  • Diário
  • Mensal
  • Período de veiculação
Taxa de ritmoSimstringSim

A taxa de ritmo dessa entrada.

  • Assim que possível
  • Uniforme
  • Adiante

"Assim que possível" não é compatível com o ritmo "Período de veiculação".
Valor do ritmoSimfloatSimO valor a ser gasto por período definido pelo tipo de ritmo.
Limite de frequência ativadoSimstringSimAtiva/desativa o limite de frequência com base em impressões no pedido de inserção.
  • TRUE
  • FALSE
Exposições de frequênciaObrigatório quando "Limite de frequência ativado" 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 em y período".
Período de frequênciaObrigatório quando "Limite de frequência ativado" for "TRUE"stringSimEspecifica a unidade de período para o limite de frequência.
  • Minutos
  • Horas
  • Dias
  • Semanas
  • Meses
Valor de frequênciaObrigatório quando "Limite de frequência ativado" for "TRUE"número inteiroSimUm valor inteiro positivo para o período do tipo "Período de frequência", ou seja, o y em 'Mostrar x impressões em y período'.

Os períodos do limite de frequência precisam ser de, no máximo, 30 dias.
Tipo de KPISimstringSimA unidade de KPI do pedido de inserção
  • CPM
  • CPA
  • CPC
  • CPV
  • CPIAVC
  • CTR
  • % de visibilidade
  • CPE
  • CVR de cliques
  • CVR de impressões
  • VCPM
  • VTR
  • Tx. conclusão de áudio
  • Tx. conclusão de vídeo
  • CPCL
  • CPCV
  • TOS10
  • Maximizar o ritmo
  • Valor de impressão personalizada em relação ao custo
  • Nenhum
  • Outro
Valor do KPISimstringSimO valor do KPI em moeda (CPM, CPA, CPC, CPV, CPIAVC, CPE, VCPM), porcentagem (% de visibilidade, CTR, CVR de cliques, CVR de impressões, VTR, Tx. conclusão de áudio, Tx. conclusão de vídeo, CPCL, CPCA, TOS10), sem unidade (valor de impressão personalizada em relação ao custo) ou como uma string (outro). Se o tipo de KPI fornecido for "Maximizar o ritmo" ou "Nenhum", essa coluna será ignorada.
ID do algoritmo de KPIObrigatório quando "Tipo de KPI" for "Valor de impressão personalizada em relação ao custo"número inteiroSimO ID do algoritmo de lances personalizados associado ao KPI se o tipo de KPI for CUSTOM_BIDDING_VALUE_COST. Caso contrário, essa coluna será ignorada.
Tipo de orçamentoSimstringSimEspecifica o tipo de orçamento em termos de um valor de "receita" para gastos (valor) ou um número de impressões (impressões) para compra.
  • Valor
  • Impressões
Segmentos de orçamentoSimstring, lista de listasSimEspecifica os segmentos de orçamento. Formato da lista = (orçamento, data de início, data de término, ID do orçamento da campanha, descrição). O orçamento está no formato flutuante da moeda. As datas estão no formato MM/DD/AAAA. O ID do orçamento da campanha fica vazio se não for especificado. A descrição não pode ficar vazia para nenhum segmento de orçamento. Se um segmento de orçamento atual tiver uma descrição vazia, será necessário fornecer uma descrição para que a linha seja enviada. Exemplo: "(100,50;01/01/2016;03/31/2016;12345;segmento de orçamento 1;);(200,00;04/01/2016;06/30/2016;;segmento de orçamento 1 atualizado;);"
Alocação automática de orçamentoSimstringSimAtiva/desativa a alocação automática de orçamento
  • TRUE
  • FALSE
Otimização do pedido de inserçãoSimstringSim

Ativa/desativa a otimização do pedido de inserção

Se essa coluna estiver definida como "TRUE", os itens de linha desse pedido de inserção vão usar a estratégia de lances do pedido de inserção.

  • TRUE
  • FALSE
Unidade da estratégia de lancesObrigatório quando "Otimização do pedido de inserção" for "Verdadeiro"stringSimSelecione a unidade da estratégia de lances para otimizar os lances:
  • CPA
  • CPC
  • valor/custo de impr. personalizado
  • CIVA
  • IVO_TEN
  • AV_VIEWED
Estratégia de lances "Não exceder"Obrigatório quando "Otimização do pedido de inserção" for "Verdadeiro"floatSimDefina um valor de CPM "não exceder". Se for 0, "não exceder" não será ativado.
Aplicar preço mínimo para transaçõesObrigatório quando "Otimização do pedido de inserção" for "Verdadeiro"stringSimSe as transações devem ser priorizadas em relação ao inventário de leilão aberto
  • TRUE
  • FALSE
ID do algoritmoObrigatório quando o valor/custo de impr. personalizado da "Unidade da estratégia de lances"número inteiroSim

Esse ID de algoritmo correspondente precisa ser usado quando a unidade da estratégia de lances estiver definida como valor/custo de impr. personalizado.

Todas as atividades do Floodlight usadas no algoritmo atribuído a essa coluna precisam ser incluídas na coluna "IDs de atividades do Floodlight de conversão". As tentativas de atribuir um algoritmo sem atualizar corretamente a coluna "IDs de atividades do Floodlight de conversão" resultarão em um erro.