Esta página foi traduzida pela API Cloud Translation.

Dados estruturados: v4 – Pedido de inserção

Consulte a visão geral para saber mais sobre o formato.

Campo

Obrigatório

Tipo

Gravável

Descrição

ID de pedido de inserção

Obrigatório somente ao editar pedidos de inserção existentes

número inteiro

Não

É o valor do ID numérico do pedido de inserção. Se deixado em branco, um novo ID do pedido de inserção será criado, e um ID exclusivo será atribuído. Ao criar um novo pedido de inserção, você pode usar um identificador personalizado para atribuir itens de linha a ele. O formato de um identificador personalizado é "ext[identificador personalizado]", por exemplo, ext123. Quando o arquivo for enviado e processado, todos os identificadores personalizados serão substituídos por IDs atribuídos pelo DBM, e os objetos serão associados (por exemplo, do item de linha ao pedido de inserção) com base nos identificadores personalizados.

ID da campanha

Não

número inteiro

Não

É o valor do ID numérico da campanha. É possível especificar um identificador personalizado (por exemplo, "ext[identificador de campanha personalizado]") para uma campanha que você está criando ao mesmo tempo que este pedido de inserção.

Nome

Sim

string

Sim

O nome da entrada.

Carimbo de data/hora

Obrigatório ao editar entradas existentes

número inteiro

Nã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.

Status

Sim

string

Sim

A configuração de status da entrada.

Ativo
Pausado
Rascunho
Arquivada
Excluído

Tipo de pedido de inserção

Sim

string

Sim

O tipo de pedido de inserção. Pode ser definido apenas na criação.

padrão

Taxas

Não

string, lista de listas

Sim

Todas as taxas para esta entrada. Formato da lista = (categoria da taxa; valor da taxa; tipo de taxa; faturada;).

Categoria da taxa
- CPM
- Mídia
Valor da taxa
- Ponto flutuante
- Pct como ponto flutuante
Tipo de taxa
- (string, consultar a tabela nas taxas)
Faturado
- Verdadeiro
- Falso
- em branco

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

Observação: a taxa de CPM de taxas premium é reservada pelo sistema e não pode ser alterada. A cardinalidade da taxa Premium é preservada em todas as mutações, inserindo as taxas de CPM padrão, se necessário.

Categoria da taxa	Tipo de taxa	Opção com fatura
CPM/mídia	Padrão	Não permitido (deixe em branco)
CPM/mídia	Servidor de anúncios de terceiros	Não permitido (deixe em branco)
CPM/mídia	DoubleVerify	Permitido (verdadeiro/falso)
CPM/mídia	Adsafe	Não permitido (deixe em branco)
CPM/mídia	Adxpose	Não permitido (deixe em branco)
CPM/mídia	Vizu	Não permitido (deixe em branco)
CPM/mídia	Aggregate Knowledge	Não permitido (deixe em branco)
CPM/mídia	Teracent	Não permitido (deixe em branco)
CPM/mídia	Evidon	Não permitido (deixe em branco)
CPM/mídia	Taxa das agências negociadoras	Não permitido (deixe em branco)
CPM/mídia	Adloox	Permitido (verdadeiro/falso)
CPM	ShopLocal	Obrigatório (verdadeiro)
CPM	TrustMetrics	Não permitido (deixe em branco)
CPM	Vídeo da Integral Ad Science	Permitido (verdadeiro/falso)
CPM	Vídeo da MOAT	Não permitido (deixe em branco)
Mídia	Taxa do Bid Manager	Obrigatório (verdadeiro)
Mídia	Dados de custo de mídia	Não permitido (deixe em branco)
CPM	Taxas premium	Não permitido (deixe em branco)

Código de integração

Não

string

Sim

Um código opcional para fins de rastreamento.

Detalhes

Não

string

Sim

Detalhes da entrada no formato de string.

Ritmo

Sim

string

Sim

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

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

Taxa de ritmo

Sim

string

Sim

A taxa de ritmo desta entrada.

Assim que possível
Uniforme
Adiante

Valor do ritmo

Sim

float

Sim

O valor a ser gasto pelo período definido pelo tipo de ritmo.

Frequência ativada

Sim

string

Sim

Ativa/desativa o limite de frequência com base em impressão no pedido de inserção.

TRUE
FALSE

Exposições de frequência

Obrigatório quando a opção "Frequência ativada" for "TRUE"

número inteiro

Sim

Um 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ência

Obrigatório quando a opção "Frequência ativada" for "TRUE"

string

Sim

Especifica a unidade do período de tempo para o limite de frequência.

Minutos
Horas
Dias
Semanas
Meses
Ciclo de vida

Valor de frequência

Obrigatório quando a opção "Frequência ativada" for "TRUE"

número inteiro

Sim

Um valor inteiro positivo referente à duração do tipo "Período de frequência", ou seja, o y em "Exibir x impressões em y período".

Tipo de meta de desempenho

Sim

string

Sim

A unidade de meta do pedido de inserção

CPM
CPA
CPC
CPV
Custo por impressão audível e visível na conclusão (CPIAVC, na sigla em inglês)
CTR
% de visibilidade
Nenhuma
Outros

Valor da meta de desempenho

Sim

string

Sim

O valor da meta na moeda (CPM, CPA, CPC, CPV, CPIAVC), porcentagem (porcentagem de visibilidade, CTR) ou como uma string (Outro).

Medir a DAR

Sim

string

Sim

Ativa/desativa a medição de público-alvo usando a Nielsen Digital Ad Ratings

TRUE
FALSE

Medir o canal do revendedor autorizado de distribuição

Obrigatório quando "Medir DAR" for "TRUE"

número inteiro

Sim

O canal a ser medido com a Nielsen Digital Ad Ratings. Formato = UniversalChannel.id

Tipo de orçamento

Sim

string

Sim

Especifica o tipo de orçamento em termos de um valor de "receita" para gastar (valor) ou um número de impressões (impressões) a ser comprado.

Valor
Impressões

Segmentos de orçamento

Sim

string, lista de listas

Sim

Especifica os segmentos de orçamento específicos. Formato da lista = (orçamento, data de início, data de término). O orçamento está em formato flutuante de moeda. As datas estão no formato MM/DD/AAAA. Exemplo: "(100.50;01/01/2016;03/31/2016;);(200.00;04/01/2016;06/30/2016;);”

Alocação automática de orçamento

Sim

string

Sim

Ativa/desativa a alocação automática de orçamento

TRUE
FALSE

Segmentação geográfica - Incluir

Não

string, lista

Sim

Lista de geografias a serem incluídas na segmentação. Formato de lista = (GeoLocation.id; GeoLocation.id; etc.).

Segmentação geográfica - Excluir

Não

string, lista

Sim

Lista de regiões geográficas a serem excluídas da segmentação. Formato da lista = (GeoLocation.id;GeoLocation.id; etc.).

Idioma de destino - Incluir

Não

string, lista

Sim

É a lista de idiomas a serem incluídos na segmentação. Formato da lista = (Language.id;Language.id;etc.).

Idioma de destino: excluir

Não

string, lista

Sim

Lista de idiomas a serem excluídos da segmentação. Formato da lista = (Language.id;Language.id;etc.).

Segmentação por dispositivo: incluir

Não

string, lista

Sim

É a lista de dispositivos a serem incluídos na segmentação. Formato da lista = (DeviceCriteria.id;DeviceCriteria.id;etc.).

Segmentação por dispositivo: excluir

Não

string, lista

Sim

É a lista de dispositivos a serem excluídos da segmentação. Formato da lista = (DeviceCriteria.id;DeviceCriteria.id;etc.).

Segmentação por navegador: incluir

Não

string, lista

Sim

Lista de navegador a ser incluído na segmentação. Formato da lista = (Browser.id;Browser.id;etc.).

Segmentação por navegador: excluir

Não

string, lista

Sim

Lista de navegador a ser excluído da segmentação. Formato da lista = (Browser.id;Browser.id;etc.).

Rótulos de brand safety

Não

string, lista

Sim

Lista de classificações de conteúdo digital a serem segmentadas. Formato da lista = (G;PG; etc.).

Configuração de sensibilidade de brand safety

Não

string

Sim

Escolha a configuração de confidencialidade para bloquear inventário com base no objeto em questão.

Não bloquear
Use a Verificação da DoubleClick
Usar personalizado

Configurações personalizadas de brand safety

Obrigatório quando a "Configuração personalizada de brand safety" é "Usar personalizada"

string, lista

Sim

Se a configuração de sensibilidade de brand safety for "Usar personalizado", especifique a lista de classificadores de conteúdo padrão. Por exemplo, (Adulto;Álcool; Tabaco etc.).

Adulto
Depreciativo
Downloads e compartilhamento
Armas
Jogos de azar
Violência
Sugestivo
Linguagem obscena
Álcool
Drogas
Tabaco
Política
Religião
Tragédia
Acidentes no transporte
Problemas sociais sensíveis
Conflitante

Serviços de verificação de terceiros

Não

string

Sim

Provedor de serviços de verificação terceirizado.

Nenhuma
Integral Ad Science
DoubleVerify
Adloox

Rótulos de verificação de terceiros

Não

string, lista

Sim

Se a opção "Serviços de verificação de terceiros" não for "Nenhum", especifique uma lista de rótulos aceitos pelo provedor selecionado.

Segmentação de canal - Incluir

Não

string, lista

Sim

É uma lista de canais a serem incluídos na segmentação. Formato da lista = (UniversalChannel.id;UniversalChannel.id; etc.).

Segmentação de canal: excluir

Não

string, lista

Sim

É uma lista de canais a serem incluídos na segmentação. Formato da lista = (UniversalChannel.id;UniversalChannel.id; etc.).

Segmentação por site - Incluir

Não

string, lista

Sim

Lista de sites a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs de sites ou strings de URLs, caso não seja encontrado na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).

Segmentação por site - Excluir

Não

string, lista

Sim

Lista de sites a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs de sites ou strings de URLs, caso não seja encontrado na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).

Segmentação de aplicativo: incluir

Não

string, lista

Sim

Lista de apps a serem incluídos na segmentação. A lista pode incluir um conjunto de IDs do UniversalSite ou strings de pacotes do app, se ele não aparecer na tabela "Universal Site". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).

Segmentação de aplicativo: excluir

Não

string, lista

Sim

Lista de aplicativos a serem excluídos da segmentação. A lista pode incluir um conjunto de IDs do UniversalSite ou strings de pacotes do app, se ele não aparecer na tabela "Universal Site". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).

Segmentação por coleção de aplicativos: incluir

Não

string, lista

Sim

Lista de coleções de apps a serem incluídas na segmentação. Formato da lista= ID do conjunto de aplicativos; ID do conjunto de aplicativos;

Segmentação por coleção de apps: excluir

Não

string, lista

Sim

Lista de coleções de apps a serem excluídas da segmentação. Formato da lista= ID do conjunto de aplicativos; ID do conjunto de aplicativos;

Segmentação por categoria - Incluir

Não

string, lista

Sim

Lista de categorias a serem incluídas na segmentação, dos IDs de indústria do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).

Segmentação por categoria - Excluir

Não

string, lista

Sim

Lista de categorias a serem excluídas da segmentação, dos IDs de indústria do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).

Segmentação por palavras-chave - Incluir

Não

string, lista

Sim

Lista de strings de palavras-chave a serem incluídas na segmentação.

Segmentação por palavra-chave: excluir

Não

string, lista

Sim

Lista de strings de palavras-chave a serem excluídas da segmentação.

Segmentação por lista de palavras-chave - Excluir

Não

string, lista

Sim

É uma lista de palavras-chave negativas a serem excluídas da segmentação. Formato da lista= ID da lista de palavras-chave negativas; ID da lista de palavras-chave negativas;

Segmentação por público-alvo – Públicos-alvo semelhantes

Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio"

string

Sim

Ative os Públicos-alvo semelhantes para as listas próprias segmentadas positivamente.

TRUE
FALSE

Segmentação por público-alvo: incluir

Não

string, lista de lista de pares

Sim

São as listas de público-alvo a serem incluídas na segmentação. Para listas de público-alvo próprias, cada público-alvo é listado como um par de ID da lista de usuários e configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma amostra de tempo para retorno de um dia. Como o tempo para retorno não está disponível para públicos-alvo de terceiros, o formato da lista é (3;);(4;);. Para os grupos de público-alvo "AND" e "OR", siga este exemplo: para combinar pares com e sem tempo para retorno: ' ((1;1d;);(2;365d; rapidamente((3;);(4;5m;);(5;all;);'. Isso significa (lista 1 com tempo para retorno de 1 dia OU lista 2 com atualidade de 365 dias ) E (lista 3 sem atualidade especificada OU lista 4 com atualidade de 5 minutos OU lista 5 com todos os usuários).
Os valores de atualidade válidos são:
todos, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 30m, 1h, 2h, 3h

Segmentação por público-alvo: excluir

Não

string, lista de lista de pares

Sim

Lista de listas de público-alvo a serem excluídas da segmentação. Se a lista de público-alvo for uma lista de público-alvo próprio, cada público-alvo será listado como um par de IDs da lista de usuários e configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma amostra de tempo para retorno de um dia. No entanto, para públicos-alvo de terceiros, o tempo para retorno não está disponível, portanto, o formato da lista é (3;);(4;);. List format= (JobScheduler.id; recency opcional;); (número.id; recency opcional;);
Exemplo: "(1;1d;);(2;);".
Os valores de recência válidos são:
all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 6h, 12h, 1d, 2.

Segmentação por afinidade e no mercado - Incluir

Não

string, lista

Sim

listas de públicos-alvo de afinidade e/ou no mercado a serem incluídas. List format= ID da lista de usuários; ID da lista de usuários;

Segmentação por afinidade e no mercado: excluir

Não

string, lista

Sim

Listas de públicos-alvo de afinidade e/ou no mercado a serem excluídas. List format= ID da lista de usuários; ID da lista de usuários;

Segmentação por afinidade personalizada

Não

string, lista

Sim

Listas personalizadas que serão segmentadas. List format= ID da lista de usuários; ID da lista de usuários;

Segmentação da origem de inventário: incluir

Não

string, lista

Sim

Lista de inventário a ser incluído na segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).

Segmentação da origem de inventário: excluir

Não

string, lista

Sim

Lista 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 trocas

Não

string

Sim

Configuração para segmentar novas trocas.

Verdadeiro
Falso

Segmentação por período do dia

Não

string, lista

Sim

Lista de IDs, em que cada ID de parte do dia é construído no seguinte formato:
daypart_id = base_dayparting_id
+ days_ since_monday * 10.000
+ start * 100
+ end

base_dayparting_id = 300000
days_ since_monday: 0=Monday, 1=Monday, ...0.0 dias:0=segunda-feira, 6.0 dias:

"Local"). Para entidades atuais, o fuso horário não será alterado.

Fuso horário da segmentação por período do dia

Obrigatório quando a "Segmentação por período do dia" estiver incluída.

string

Sim

Fuso horário a ser usado na segmentação por período do dia.

Local
Advertiser

Segmentação por ambiente

Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio"

string, lista

Sim

Lista de ambientes a serem segmentados. Formato da lista = (Web para computadores, app para dispositivos móveis etc.).
Para o ambiente de display:

Web para computadores
Web para dispositivos móveis
App para dispositivos móveis
Intersticial de app para dispositivos móveis
Web para computadores em dispositivos móveis

Para vídeo:

Vídeo da Web para computadores
Jogo da Web para computadores
In-Read da Web para computadores
In-feed da Web para computadores
Vídeo da Web para dispositivos móveis
Vídeo de app para dispositivos móveis
Intersticial em vídeo de app para dispositivos móveis

Para áudio:

Áudio da Web para computadores
Áudio da Web para dispositivos móveis
Áudio de apps para dispositivos móveis

Segmentação de visibilidade do Active View

Não

string

Sim

Porcentagens 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}

Posição do anúncio de segmentação por visibilidade - Incluir

Não

string

Sim

Segmentar posições de anúncios. Selecione um ou nenhum dos valores aceitáveis:

All
ATF
BTF
Desconhecido

Posição do anúncio da segmentação por visibilidade - Excluir

Não

string

Sim

Excluir posições de anúncios na segmentação. Selecione um ou nenhum dos valores aceitáveis:

ATF
BTF
Desconhecido

Segmentação por posição do anúncio em vídeo

Não

string, lista

Sim

Lista de posições de anúncios em vídeo a serem segmentadas. Selecione um ou mais valores aceitáveis:

desconhecido
Anúncio precedente
Durante a exibição
Anúncio final

Segmentação do tamanho do player de vídeo

Não

string, lista

Sim

Lista de tamanhos do player de anúncios em vídeo para segmentar. Selecione um ou mais valores aceitáveis:

desconhecido
pequeno
grande
HD

Sexo de segmentação demográfica

Não

string, lista

Sim

Lista de gêneros a serem segmentados. Selecione um ou mais valores aceitáveis:

Feminino
Male
Desconhecido

Idade da segmentação demográfica

Não

string, lista

Sim

segmentar para uma faixa etária do usuário; Especifique um intervalo de/para selecionando uma única idade "De" e uma única idade "Até" e se as idades desconhecidas serão incluídas como verdadeiro/falso. Confira a lista de idades "De/Até" aceitáveis.
Exemplo 1: para segmentar de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Para ; Incluir desconhecido Verdadeiro/Falso} = 18;55;true;
Exemplo 2: para segmentar apenas usuários com mais de 35 anos e excluir idades desconhecidas, especifique os seguintes valores = 35;+;false;

Valores aceitáveis para "Para":

Segmentação demográfica: renda familiar

Não

string, lista

Sim

Segmente 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". Também é possível 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 primeiros 10% a 50% de lares e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range;Include known True/False} = Top 10%;41-50%;true;
Exemplo 2: para segmentar apenas os menores valores de Famílias_inferiores e de 50% com rendas desconhecidas, especificando o formato {Top_of_Range; Bottom_of_Range;

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 parental

Sim

string, lista

Sim

Lista de status parentais a serem segmentados. Selecione um ou mais valores aceitáveis.

Com filhos
Sem filhos
Desconhecido

Segmentação por velocidade de conexão

Não

string

Sim

Segmente para uma velocidade de conexão específica. Selecione um dos valores aceitáveis:

Segmentação por operadora: incluir

Não

string, lista

Sim

Lista de ISPs ou operadoras para segmentar. Formato da lista = {ISP.id; ISP.id;}

Segmentação por operadora: excluir

Não

string, lista

Sim

Lista de ISPs ou operadoras a serem excluídos. Formato da lista = {ISP.id; ISP.id;}