Esta página foi traduzida pela API Cloud Translation.

Dados estruturados - v3.1: pedido de inserção

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

Campo

Obrigatório

Tipo

Gravável

Descrição

ID de pedido de inserção

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

número inteiro

Não

É o valor do ID numérico do pedido de inserção. Se o campo for deixado em branco, um novo ID de pedido de inserção será criado e um ID exclusivo será atribuído. Como opção, ao criar um novo pedido de inserção, é possível usar um identificador personalizado para atribuir itens de linha a ele. O formato do 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 a um 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 criada 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, 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
Arquivado
Excluído

Tipo de pedido de inserção

Sim

string

Sim

O tipo de pedido de inserção. Configurável apenas na criação.

padrão

Taxas

Não

string, lista de listas

Sim

Todas as taxas desta 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
- Parcela como ponto flutuante
Tipo de taxa
- (string, consulte a tabela em 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 entre as mutações, inserindo taxas de CPM padrão, se necessário.

Categoria da taxa	Tipo de tarifa	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 em formato de string.

Ritmo

Sim

string

Sim

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

Diário
Mensal
Voos

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 baseado em impressão no pedido de inserção.

VERDADEIRO
FALSO

Exposições de frequência

Obrigatório quando "Frequência ativada" é "VERDADEIRO"

número inteiro

Sim

Um valor inteiro positivo para o número de impressões em determinado valor de frequência, ou seja, o x em "Exibir x impressões ao longo de y".

Período de frequência

Obrigatório quando "Frequência ativada" é "VERDADEIRO"

string

Sim

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

Minutos
Horas
Dias
Semanas
Meses
Todo o período

Valor da frequência

Obrigatório quando "Frequência ativada" é "VERDADEIRO"

número inteiro

Sim

Um 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".

Tipo de meta de desempenho

Sim

string

Sim

A unidade da 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
Porcentagem de visibilidade
Nenhum
Outro

Valor da meta de desempenho

Sim

string

Sim

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

Medir o revendedor autorizado de distribuição

Sim

string

Sim

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

VERDADEIRO
FALSO

Medir canal de revendedor autorizado de distribuição

Obrigatório ao "Medir dados de revendedor autorizado de distribuição" é "VERDADEIRO"

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) para comprar.

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á no 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

VERDADEIRO
FALSO

Segmentação geográfica - Incluir

Não

string, lista

Sim

Lista de regiões geográficas a serem incluídas na segmentação. Formato da 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.).

Segmentação por idioma: incluir

Não

string, lista

Sim

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

Segmentação por idioma: 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

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

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 navegadores a serem incluídos na segmentação. Formato da lista = (ID do navegador; ID do navegador; etc.).

Segmentação por navegador: excluir

Não

string, lista

Sim

Lista de navegadores a serem excluídos da segmentação. Formato da lista = (ID do navegador; ID do navegador; 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 sensibilidade para bloquear inventário com base no conteúdo relacionado.

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

Configurações personalizadas de brand safety

Obrigatório ao definir a "Configuração personalizada de brand safety" é "Usar personalizado"

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 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 terceiros

Não

string

Sim

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

Nenhum
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 marcadores aceitos pelo provedor selecionado.

Segmentação de canal - Incluir

Não

string, lista

Sim

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

Segmentação de canal: excluir

Não

string, lista

Sim

Lista de canais a serem incluídos na segmentação. Formato de 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 elas não sejam encontradas 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 elas não sejam encontradas na tabela "Site universal". Formato da lista = (UniversalSite.Id;'http://someurl.com';etc.).

Segmentação por 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 de apps se não forem encontrados na tabela "Site universal". Formato da lista = (UniversalSite.Id; 'some.app.package';etc.).

Segmentação por aplicativo: excluir

Não

string, lista

Sim

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

Segmentação por categoria: incluir

Não

string, lista

Sim

Lista de categorias a serem incluídas na segmentação, de códigos de indústrias 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 códigos de indústrias do AdX. Formato da lista = (Verticals.Id;Verticals.Id;etc.).

Segmentação por palavra-chave - Incluir

Não

string, lista

Sim

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

Segmentação por palavras-chave: excluir

Não

string, lista

Sim

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

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

Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"

string

Sim

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

VERDADEIRO
FALSO

Segmentação por público-alvo – Incluir

Não

string, lista de pares

Sim

É uma lista de listas de público-alvo a serem incluídas na segmentação. Para listas de público-alvo próprio, cada público-alvo é listado como um par de ID da PCollection e de configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma amostra de tempo para retorno que representa um dia de tempo para retorno. O tempo para retorno não está disponível para públicos-alvo de terceiros, portanto, o formato da lista é (3;);(4;);. Para "AND" e "OR" grupos de públicos-alvo, siga este exemplo: Para combinar pares com e sem tempo para retorno: " ((1;1d;);(2;365d;);((3;);(4;5m;);(5;all;;").

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

Não

string, 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 própria, cada público-alvo será listado como um par de ID da lista de usuários e uma configuração de tempo para retorno. Um par é (1;1d;), em que 1d é uma amostra de tempo para retorno que representa um dia de tempo para retorno. 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= (PCollection.id; recency opcional;);

Afinidade e Segmentação no mercado - Incluir

Não

string, lista

Sim

É uma lista de públicos-alvo no mercado e/ou afinidade para incluir. List format= ID da lista de usuários ID da lista de usuários

Afinidade e Segmentação no mercado: excluir

Não

string, lista

Sim

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

Segmentação por afinidade personalizada

Não

string, lista

Sim

Lista de listas personalizadas para segmentação. 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ários a serem incluídos 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ários a serem excluídos da segmentação. Formato da lista = (InventorySource.id; InventorySource.id;).

Segmentação por período do dia

Não

string, lista

Sim

Todos os IDs, em que cada um desses IDs é criado com o seguinte formato:
daypart_id = base_daypart

um número inteiro de 0 a 95, representando slots de 15 minutos
start < end
Para novas entidades, os horários serão definidos no fuso horário dos usuários (por exemplo, "Local"). No caso das entidades atuais, o fuso horário não será alterado.

Segmentação por ambiente

Obrigatório quando "Tipo" é "Display" ou "Vídeo" ou "Áudio"

string, lista

Sim

Lista de ambientes para segmentar. Formato da lista = (Web para computadores, App para dispositivos móveis etc.).
Para ambiente de exibição:

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 do app para dispositivos móveis

Para áudio:

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

Segmentação de visibilidade do Active View

Não

string

Sim

Porcentagem 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úncio. Selecione um ou nenhum dos valores aceitáveis:

Todos
ATF
BTF
Desconhecido

Posição do anúncio com segmentação por visibilidade: excluir

Não

string

Sim

Exclua posições de anúncio 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 para segmentar. Selecione um ou mais dos valores aceitáveis:

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

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

Não

string, lista

Sim

Lista de tamanhos do player de anúncios em vídeo a serem segmentados. Selecione um ou mais dos valores aceitáveis:

desconhecido
pequeno
grande
HD

Segmentação demográfica por gênero

Não

string, lista

Sim

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

Feminino
Masculino
Desconhecido

Segmentação demográfica Idade

Não

string, lista

Sim

Segmentar 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:

Valores aceitáveis para Para:

Segmentação por velocidade de conexão

Não

string

Sim

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

Todos
2G
3G
DSL
4G

Segmentação por operadora: incluir

Não

string, lista

Sim

Lista de ISPs ou operadoras a serem segmentadas. List format = {ISP.id; ISP.id;}

Segmentação por operadora: excluir

Não

string, lista

Sim

Lista de ISPs ou operadoras a serem excluídas. List format = {ISP.id; ISP.id;}