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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tipo de pedido de inserção | Sim | string | Sim | O tipo de pedido de inserção. Pode ser definido apenas na criaçã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;).
Exemplo "(CPM; 2; Taxa do Bid Manager; Falso) ; (Mídia; 13; Padrão; Verdadeiro);' 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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Taxa de ritmo | Sim | string | Sim | A taxa de ritmo desta entrada.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Serviços de verificação de terceiros | Não | string | Sim | Provedor de serviços de verificação terceirizado.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 de lista 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 – somente vendedor autorizado | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio" | string | Sim | Configuração para segmentar somente vendedor autorizado, vendedor e revendedores autorizados ou vendedor autorizado + desconhecido. "Direto autorizado" significa que somente vendedores autorizados serão segmentados. VERDADEIRO significa segmentar os vendedores e revendedores autorizados. FALSO significa que vai segmentar vendedores autorizados, revendedores e vendedores desconhecidos.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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: 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;
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação demográfica: status parental | Sim | string, lista | Sim | Lista de status parentais a serem segmentados. Selecione um ou mais valores aceitáveis.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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;} |