Consulte a visão geral para saber mais sobre o formato.
Field | Obrigatório | Tipo | Gravável | Descrição | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ID do item de linha | Obrigatório somente ao editar itens de linha existentes | número inteiro | Não | É o valor do ID numérico do item de linha. Se deixado em branco, um novo item de linha será criado e um ID exclusivo será atribuído. Ao criar novos itens de linha, você pode usar um identificador personalizado para atribuir grupos de anúncios TrueView ao novo item de linha. O formato de um identificador personalizado é "ext[identificador personalizado]", 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, grupo de anúncios para item de linha) com base nos identificadores personalizados. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID de pedido de inserção | Sim | número inteiro | Não | É o valor do ID numérico do pedido de inserção. É possível especificar um identificador personalizado (por exemplo, "ext[identificador do pedido de veiculação personalizado]") para um pedido de inserção que você está criando ao mesmo tempo que este item de linha. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Nome da ordem de inserção | Não | string | Não | Nome do pedido de inserção | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tipo | Sim | string | Sim | O tipo de entrada. Pode ser gravado apenas durante a criação, e não durante a edição.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Subtipo | Sim | string | Sim | Campo obrigatório para que os itens de linha diferenciem formatos diferentes
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data de início | Sim | string | Sim | É um carimbo de data/hora da data de início do período de veiculação da entrada no formato MM/DD/AAAA ou "Igual ao pedido de inserção" para usar a mesma data de início do pedido de inserção pai. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Data de término | Sim | string | Sim | É um carimbo de data/hora da data de término do período de veiculação da entrada no formato MM/DD/AAAA ou "Igual ao pedido de inserção" para usar a mesma data de término do pedido de inserção pai. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tipo de orçamento | Sim | string | Sim | Especifica se o orçamento é baseado em dinheiro ou em impressões. Se o IO dessa entrada estiver habilitado para alocação automática de orçamento, você poderá defini-lo como "Automático" para permitir que o DBM automaticamente ordene essa entrada.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Valor do orçamento | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio" | float | Sim | Um 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 valor 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 uma unidade monetária). Se a alocação de orçamento "Automática" estiver definida na entrada, será possível especificar um valor mínimo para gastar (por exemplo, "gastar pelo menos" esse valor). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio". Obrigatório quando o "Tipo" for "TrueView" e o "Ritmo" for "Diário". | 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 item de linha.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 para o limite de frequência. Para itens de linha TrueView, os períodos compatíveis são dias, semanas e meses.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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". Esse valor não é compatível com itens de linha TrueView. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Frequência de visualizações de TrueView ativada | Obrigatório quando o "Tipo" é "TrueView" | string | Sim | Ativa/desativa o limite de frequência com base em visualização no item de linha TrueView
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Exposições de frequência de visualização de TrueView | Obrigatório quando a opção "Frequência de visualização de TrueView ativada" for "TRUE" | número inteiro | Sim | Um valor inteiro positivo para o número de visualizações de TrueView, ou seja, o "x" em "Exibir x visualizações no período" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Período de frequência de visualização do TrueView | Obrigatório quando a opção "Frequência de visualização de TrueView ativada" for "TRUE" | string | Sim | Especifica a unidade do período para o limite de frequência do TrueView com base em visualizações
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Modelo de receita do parceiro | Não | string | Sim | Um modelo de receita do parceiro é um mecanismo que controla o cálculo da receita no Bid Manager. Use o modelo de receita do parceiro para acompanhar a margem de suas taxas de serviço. A coluna Valor da receita do parceiro deverá ser especificada quando a coluna Modelo de receita do parceiro estiver incluída.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Valor da receita do parceiro | Obrigatório somente quando a coluna Modelo de receita do parceiro estiver especificada. | float | Sim | Um valor flutuante positivo correspondente ao modelo de receita do parceiro. Aplicável somente quando a coluna Modelo de receita do parceiro está especificada. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tipo de contagem de conversões | Obrigatório quando o "Tipo" for "Display", "Vídeo", "Áudio" ou "TrueView" | string | Sim | Escolha os tipos de conversões que serão contabilizados.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
% de contagem de conversões | Obrigatório quando o "Tipo" for "Display", "Vídeo", "Áudio" ou "TrueView" | float | Sim | Especifique a porcentagem do tipo de contagem de conversões "Contagem %". Formate a porcentagem como um ponto flutuante (3,123% = 3,123), com precisão limitada a milhares (3 casas decimais). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IDs das atividades de conversão do Floodlight | Não | string, lista de listas | Sim | As atividades do Floodlight usadas para conversões e configurações relacionadas. Essa coluna usa IDs de recursos Lista de formatos de lista = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;););). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID do modelo de atribuição principal | Não | número inteiro | Sim | O ID do modelo de atribuição usado para o item de linha associado. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 Display & Video 360; Falso) ; (Mídia; 13; Padrão; Verdadeiro);'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tipo de estratégia de lances | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio" | string | Sim | Selecione uma das estratégias de lances aplicáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Valor de estratégia de lances | Obrigatório, a menos que "Tipo de estratégia de lances" seja "Minimizar", "Maximizar" ou "Tipo" seja "TrueView" | float | Sim | Para os tipos de estratégia "Beat", "Otimizar VCPM" e "Fixa", escolha um valor para o lance da meta. Nenhum valor da estratégia de lances é necessário para o tipo "Minimizar" ou "Maximizar" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Unidade de estratégia de lances | Obrigatório quando o "Tipo de estratégia de lances" é "Superar" ,"Minimizar" ou "Maximizar" | string | Sim | Para os tipos de estratégia "Superar", "Minimizar" ou "Maximizar", selecione a unidade correspondente:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
A estratégia de lances não excederá | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio" | float | Sim | Defina um valor de CPM "não exceder". Se 0, 'não exceder' não está ativado. Essa opção só estará disponível se a estratégia de lances for "Minimizar", "Maximizar" ou "Superar". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Aplicar preço mínimo para ofertas | Obrigatório quando o "Tipo de estratégia de lances" é "Minimizar" ou "Maximizar" | string | Sim | Indica se as transações devem ser priorizadas em relação ao inventário de leilão aberto
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID do algoritmo | Obrigatório quando o valor/custo de impr. personalizado da "Unidade de estratégia de lances" | número inteiro | Sim | Esse ID de algoritmo correspondente precisa ser usado quando a Unidade de estratégia de lances está definida como valor/custo de impr. personalizado. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Atribuições de criativos | Não | string, lista | Sim | Lista de IDs de criativos a serem atribuídos à entrada. Esta coluna usa IDs de recurso Formato da lista = (Creative.creativeId; Creative.creativeId; etc.). Essa lista é gerada em ordem numérica crescente. No upload, os usuários também podem incluir IDs de posição do Campaign Manager 360. Os IDs de posição precisam ser precedidos pelas letras "CM", por exemplo, "CM789". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação geográfica - Incluir | Não | string, lista | Sim | Lista de regiões geográficas a serem incluídas na segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação geográfica - Excluir | Não | string, lista | Sim | Lista de regiões geográficas a serem excluídas da segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por lista de locais regionais por região geográfica: incluir | Não | string, lista | Sim | Lista de IDs de listas de locais geográficos a serem incluídos. Formato da lista = (11; 22; 33;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por lista de locais regionais por região: excluir | Não | string, lista | Sim | Lista de IDs de listas de localizações geográficas regionais a serem excluídas. Formato da lista = (11; 22; 33;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por proximidade | Não | string, lista de listas | Sim | Lista de áreas de segmentação por proximidade, cada uma no formato "(Latitude; Longitude; Raio; Unidade; FullAddress;);". A latitude está entre -90 e 90 graus (inclusive); a longitude está entre -180 e 180 graus (inclusive); o raio é uma distância entre 1 e 500 (inclusive) na unidade; a unidade pode ser "mi" ou "km"; o FullAddress é opcional. Por exemplo: "(38,907192; -77,03687; 1,0; mi; Washington D.C., DC, EUA;); (40.712775; -74.005972; 20,5; km; 40,712775, -74.005972;); (20.000234; -56.675423; 5,0; mi; ;);". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por lista de locais por proximidade | Não | string, lista de listas | Sim | Lista de segmentações de listas de proximidade para pedidos de inserção ou itens de linha que não são TrueView, cada um no formato "(NearbyListId; Radius; Unit; );". NearbyListId é um ID da lista de locais disponível nos recursos do anunciante. O raio é uma distância entre 1 e 500 (inclusive) na unidade. A unidade pode ser "mi" ou "km". Há um limite de segmentação de duas listas de locais por entidade, além das listas de locais regionais regionais. Por exemplo: "(10041691678; 20.0; mi;); (10038858567; 20,5; km;);". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Idioma de destino - Incluir | Não | string, lista | Sim | Lista de idiomas a serem incluídos na segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Idioma de destino: excluir | Não | string, lista | Sim | Lista de idiomas a serem excluídos da segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por dispositivo: incluir | Não | string, lista | Sim | Lista de dispositivos a serem incluídos na segmentação. Esta coluna usa IDs de recursos do
Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por dispositivo: excluir | Não | string, lista | Sim | Lista de dispositivos a serem excluídos da segmentação. Esta coluna usa IDs de recursos do
Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por navegador: incluir | Não | string, lista | Sim | Lista de navegadores a serem incluídos na segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por navegador: excluir | Não | string, lista | Sim | Lista de navegadores a serem excluídos da segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Classificação de conteúdo digital: excluir | Não | string, lista | Sim | Lista das classificações de conteúdo digital a serem excluídas. 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, (Sexual; Á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 | Lista de canais a serem incluídos na segmentação. Esta coluna usa IDs de recurso Formato da lista = (Channel.channelId; Channel.channelId; etc.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação de canal: excluir | Não | string, lista | Sim | Lista de canais a serem excluídos da segmentação. Esta coluna usa IDs de recurso Formato da lista = (Channel.channelId; Channel.channelId; etc.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por site - Incluir | Não | string, lista | Sim | Lista de sites a serem incluídos na segmentação. A lista é composta por strings de URLs. Formato da lista = (someurl.com; someurltwo.com; etc.). Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por site - Excluir | Não | string, lista | Sim | Lista de sites a serem excluídos da segmentação. A lista é composta por strings de URLs. Formato da lista = (someurl.com; someurltwo.com; etc.). Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação de aplicativo: incluir | Não | string, lista | Sim | Lista de apps a serem incluídos na segmentação. A lista é composta por strings concatenadas da plataforma do app e do ID da plataforma do app. Os valores a seguir são usados para definir a plataforma do app:
A string concatenada da plataforma do app e do ID é separada por dois pontos, por exemplo: Formato da lista = (APP:com.google.android.gm; APP:422689480; etc.). Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação de aplicativo: excluir | Não | string, lista | Sim | Lista de aplicativos a serem excluídos da segmentação. A lista é composta por strings concatenadas da plataforma do app e do ID da plataforma do app. Os valores a seguir são usados para definir a plataforma do app:
A string concatenada da plataforma do app e do ID é separada por dois pontos, por exemplo: Formato da lista = (APP:com.google.android.gm; APP:422689480; etc.). Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por categoria - Incluir | Não | string, lista | Sim | Lista de categorias a serem incluídas na segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por categoria - Excluir | Não | string, lista | Sim | Lista de categorias a serem excluídas da segmentação. Esta coluna usa IDs de recurso TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_CATEGORY . Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por gênero de conteúdo - Incluir | Não | string, lista | Sim | Lista de gêneros de conteúdo a serem incluídos na segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por gênero de conteúdo: excluir | Não | string, lista | Sim | Lista de gêneros de conteúdo a serem excluídos da segmentação. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por palavras-chave - Incluir | Não | string, lista | Sim | Lista de strings de palavras-chave a serem incluídas na segmentação. Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por palavra-chave: excluir | Não | string, lista | Sim | Lista de strings de palavras-chave a serem excluídas da segmentação. Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. Esta coluna usa IDs de recurso Formato da lista = (negativeKeywordList.negativeKeywordListId; negativeKeywordList.negativeKeywordListId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação otimizada | Não | string | Sim | Ative a segmentação otimizada.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por público-alvo: incluir | Não | string, lista de lista de pares | Sim | Lista de listas de público-alvo a serem incluídas na segmentação. Esta coluna usa IDs de recurso Para listas de público-alvo próprias, cada público-alvo é listado como um par de FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId 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úblicos-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 tempo para retorno de 365 dias) E (lista 3 sem tempo para retorno especificado OU lista 4 com tempo para retorno de 5 minutos OU lista 5 com todos os usuários). Os valores de atualidade válidos são:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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. Esta coluna usa IDs de recurso Cada público-alvo será listado como um par de FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId e configuração de tempo para retorno, se a lista de público-alvo for uma lista de público-alvo própria. 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;);. Formato da lista = (((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency opcional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency opcional;);) Os valores de atualidade válidos são:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por afinidade e no mercado - Incluir | Não | string, lista | Sim | Lista de listas de público-alvo de afinidade e/ou no mercado a serem incluídas. Os códigos de listas de público-alvo podem ser recuperados na interface do Display & Video 360. Formato da lista = (ID do público-alvo, ID do público-alvo etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por afinidade e no mercado: excluir | Não | string, lista | Sim | Lista de listas de público-alvo de afinidade e/ou no mercado a serem excluídas. Os códigos de listas de público-alvo podem ser recuperados na interface do Display & Video 360. Formato da lista = (ID do público-alvo, ID do público-alvo etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por público-alvo combinado | Não | string, lista | Sim | Lista de listas de público-alvo combinado a serem segmentadas. Esta coluna usa IDs de recurso Formato da lista = (CombineAudience.combinedAudienceId; CombineAudience.combinedAudienceId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação de lista personalizada | Não | string, lista | Sim | Lista de listas personalizadas a serem segmentadas. Esta coluna usa IDs de recurso Formato da lista = (CustomList.customListId; CustomList.customListId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação da origem de inventário – opções do vendedor autorizado | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio" | string | Sim | Configuração para segmentar vendedores diretos autorizados, vendedores diretos autorizados e revendedores autorizados ou vendedor autorizado + desconhecido. "Direto autorizado" significa que somente vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar os vendedores e revendedores autorizados. "Editor autorizado e não participante" significa que ele vai segmentar vendedores autorizados, revendedores e vendedores desconhecidos.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação da origem de inventário: incluir | Obrigatório quando o "Tipo" for "Display", "Vídeo" ou "Áudio" | string, lista | Sim | É uma lista de origens de inventário, trocas e subtrocas para incluir na segmentação. Esta coluna usa IDs de recurso Formato da lista = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; etc.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação da origem de inventário: excluir | Não | string, lista | Sim | Lista de origens de inventário, trocas e subtrocas a serem excluídas da segmentação. Esta coluna usa IDs de recurso Formato da lista = (InventorySource.inventorySourceId; ExchangeId; TargetingOption.targetingOptionId; etc.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação da origem de inventário: segmentar novas trocas | Não | string | Sim | Configuração para segmentar novas trocas.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
A segmentação de grupo de transações particulares inclui | Não | string, lista | Sim | É uma lista de IDs de transações agrupadas para incluir na segmentação. É possível encontrar os IDs de transações agrupadas na seção "Transações agrupadas" de "Meu inventário" e na seção "Grupos" das configurações da origem de inventário em itens de linha, pedidos de inserção e campanhas. Formato da lista = (DealGroupId; DealGroupId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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: Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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 | Não | string, lista | Sim | Lista de ambientes a serem segmentados. Selecione um ou mais valores aceitáveis. Observe que "Web não otimizada" não pode ser selecionada sem selecionar "Web".
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação de OMID de visibilidade ativada | Não | string | Sim | Permite a segmentação apenas de impressões mensuráveis pelo padrão Open Measurement.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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} | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por posicionamento – Na tela | Não | string, lista | Sim | Segmentação por posicionamentos de anúncio na tela. Selecione um ou mais valores aceitáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por posicionamento - posição de exibição no conteúdo | Não | string, lista | Sim | Posições do conteúdo do anúncio gráfico a serem segmentadas. Selecione um ou mais valores aceitáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por posicionamento - posição do vídeo no conteúdo | Não | string, lista | Sim | Posições do conteúdo do anúncio em vídeo a serem segmentadas. Selecione um ou mais valores aceitáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por posicionamento - posição do áudio no conteúdo | Não | string, lista | Sim | Posições do conteúdo do anúncio em áudio 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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por duração do conteúdo | Não | string, lista | Sim | Lista de durações de conteúdo a serem segmentadas. O valor da unidade é em minutos. Selecione um ou mais valores aceitáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por tipo de fluxo de conteúdo | Não | string, lista | Sim | Lista de tipos de transmissão de conteúdo para segmentar. Selecione um ou mais valores aceitáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por tipo de conteúdo de áudio | Não | string, lista | Sim | Lista de tipos de conteúdo de áudio a serem segmentados. 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 aceitáveis de Top_of_Range/Bottom_of_Range. Exemplo 1: para segmentar os 10% a 50% de Intervalo_inferior aceitável; para segmentar os 10% a 50% de Famílias_inferiores; e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; inclua desconhecido Verdadeiro/Falso} = 10% superior; 41% a 50%; verdadeiro; Exemplo 2: para segmentar somente os 50% das famílias_inferiores e 50% superiores com renda desconhecida, incluindo as famílias com renda desconhecida, especifique 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. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por operadora: excluir | Não | string, lista | Sim | Lista de ISPs ou operadoras a serem excluídos. Esta coluna usa IDs de recurso Formato da lista = (TargetOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Multiplicadores de lance | Não | string, lista de listas | Sim | Todos os multiplicadores de lance desta entrada. Formato da lista = (tipo de linha;ID dos critérios;valor do multiplicador de lance); (tipo de linha;ID dos critérios;valor do multiplicador de lance);. Os valores do multiplicador de lance podem variar entre 0,1 e 10,0. Os tipos de linha aceitáveis e seus IDs de critérios correspondentes estão listados na tabela a seguir:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Formatos de anúncio em vídeo TrueView | Sim para itens de linha TrueView | string | Sim | É o formato do anúncio em vídeo do item de linha. In-stream / Vídeo In-feed são tipos de anúncio em vídeo TrueView vendidos com base no CPV. Os anúncios in-stream e bumper são tipos de anúncio em vídeo TrueView vendidos com base no CPM. Os bumpers são anúncios em vídeo de até seis segundos vendidos com base no CPM. Os anúncios em vídeo não puláveis são anúncios in-stream com duração de 6 a 15 segundos e vendidos com base em CPM. Anúncios em vídeo in-stream, bumper ou não puláveis são tipos de anúncio em vídeo TrueView aceitáveis para itens de linha de frequência desejada vendidos com base no CPM.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Tipo de estratégia de lances do TrueView | Sim para itens de linha TrueView | string | Sim | Selecione uma das estratégias de lances TrueView aplicáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Valor da estratégia de lances do TrueView | Sim para itens de linha TrueView | float | Sim | Para o tipo de estratégia de lances "CPA desejado" ou "ROAS desejado", escolha um valor para o lance desejado. Para os outros valores de "Tipo de estratégia de lances TrueView" ou itens de linha que não são TrueView, a coluna precisa ter o valor 0 ao fazer o upload. Para o ROAS desejado, essa coluna precisa ser a porcentagem como uma fração. Por exemplo, se você quiser que o ROAS desejado seja 150%, insira 1,5. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Opção de ajuste de lance para dispositivos móveis do TrueView | Não | string | Sim | "Aumentar" ou "Diminuir"
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Porcentagem do ajuste de lance para dispositivos móveis do TrueView | Sim quando o tipo de estratégia de lances TrueView é CPA desejado ou "Maximizar conversões" | número inteiro | Sim | Ajuste de lance para aumentar as chances de exibir anúncios em dispositivos móveis. Os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": [0;900%] e para "Diminuir": [0;90%] ou 100%. Quando o tipo de estratégia de lances para TrueView é CPA desejado ou Maximizar conversões, os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": 0 e para "Diminuir": 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Opção de ajuste de lance para computadores do TrueView | Não | string | Sim | "Aumentar" ou "Diminuir"
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Porcentagem do ajuste de lance para computadores do TrueView | Sim quando o tipo de estratégia de lances TrueView é CPA desejado ou "Maximizar conversões" | número inteiro | Sim | Ajuste de lance para aumentar as chances de exibir anúncios em computadores. Os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": [0;900%] e para "Diminuir": [0;90%] ou 100%. Quando o tipo de estratégia de lances para TrueView é CPA desejado ou Maximizar conversões, os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": 0 e para "Diminuir": 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Opção de ajuste de lance para tablets do TrueView | Não | string | Sim | "Aumentar" ou "Diminuir"
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Porcentagem do ajuste de lance para tablets do TrueView | Sim quando o tipo de estratégia de lances TrueView é CPA desejado ou "Maximizar conversões" | número inteiro | Sim | Ajuste de lance para aumentar as chances de exibir anúncios em tablets. Os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": [0;900%] e para "Diminuir": [0;90%] ou 100%. Quando o tipo de estratégia de lances para TrueView é CPA desejado ou Maximizar conversões, os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": 0 e para "Diminuir": 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Opção de ajuste de lance para smart TVs TrueView | Não | string | Sim | "Aumentar" ou "Diminuir"
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Porcentagem do ajuste de lance para smart TV TrueView | Sim quando o tipo de estratégia de lances TrueView é CPA desejado ou "Maximizar conversões" | número inteiro | Sim | Ajuste de lance para aumentar as chances de exibir anúncios em smart TVs. Os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": [0;900%] e para "Diminuir": [0;90%] ou 100%. Quando o tipo de estratégia de lances para TrueView é CPA desejado ou Maximizar conversões, os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": 0 e para "Diminuir": 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação por exclusões de categoria de TrueView | Não | string, lista | Sim | Lista de categorias a serem excluídas. Formato da lista = Jogos; Tragédia e conflito etc.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Filtro de conteúdo TrueView | Não | string | Sim | Filtro de conteúdo TrueView.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Segmentação da origem de inventário do TrueView | Não | string, lista | Sim | Listas de origens de inventário TrueView a serem incluídas
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fornecedor de visibilidade terceirizado para TrueView | Obrigatório somente para editar itens de linha TrueView existentes | string, lista de listas | Sim | Fornecedor terceirizado medindo a visibilidade do item de linha TrueView. Se esse campo for deixado em branco durante a criação do item de linha TrueView e houver um fornecedor de visibilidade padrão ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código do relatório de visibilidade terceirizado para TrueView | Sim, quando o fornecedor de visibilidade de terceiros não for "Nenhum". | string | Sim | É o ID usado pelo seu fornecedor de visibilidade terceirizado para identificar eventos em relatórios específicos. Uma string vazia é válida para essa coluna, o que define o ID de relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fornecedor de brand safety terceirizado para TrueView | Obrigatório somente para editar itens de linha TrueView existentes | string, lista de listas | Sim | Fornecedor terceirizado medindo o brand safety do item de linha TrueView. Se esse campo for deixado em branco durante a criação do item de linha TrueView e houver um fornecedor de brand safety padrão ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código do relatório de brand safety terceirizado para TrueView | Sim, quando o fornecedor de brand safety terceirizado não for "Nenhum". | string | Sim | É o ID usado pelo fornecedor de brand safety terceirizado para identificar eventos em relatórios específicos. Uma string vazia é válida para essa coluna, o que define o ID de relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fornecedor de alcance terceirizado para TrueView | Obrigatório somente ao atualizar itens de linha TrueView existentes | string, lista de listas | Sim | Fornecedor terceirizado medindo o alcance do item de linha TrueView. Se esse campo for deixado em branco durante a criação do item de linha TrueView e houver um fornecedor de alcance padrão ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Código do relatório de alcance terceirizado para TrueView | Sim, quando o fornecedor de alcance de terceiros não for "Nenhum". | string | Sim | ID usado pelo fornecedor de alcance terceirizado para identificar eventos em relatórios específicos. Uma string vazia é válida para essa coluna, o que define o ID de relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fornecedor de Brand Lift terceirizado para TrueView | Obrigatório somente ao atualizar itens de linha TrueView existentes | string, lista de listas | Sim | Fornecedor terceirizado medindo o Brand Lift do item de linha TrueView. Se esse campo for deixado em branco durante a criação do item de linha TrueView e houver um fornecedor de Brand Lift padrão ativado no nível do anunciante, o item de linha será criado com o fornecedor padrão no nível do anunciante ativado.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ID do relatório de Brand Lift terceirizado para TrueView | Sim, quando o fornecedor de Brand Lift terceirizado não é "Nenhum". | string | Sim | ID usado pelo seu fornecedor de Brand Lift terceirizado para identificar eventos em relatórios específicos. Uma string vazia é válida para essa coluna, o que define o ID de relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Contagem de frequência desejada de TrueView | Sim quando o subtipo de item de linha é "Frequência desejada" | número inteiro | Sim | É a contagem de frequência desejada definida para um item de linha do YouTube do tipo frequência desejada. Esse campo só pode ser definido com o valor 2, 3 ou 4. Para itens de linha do YouTube que não são do tipo "Frequência desejada", esse campo precisa ficar vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Janela de tempo da frequência desejada do TrueView | Sim quando o subtipo de item de linha é "Frequência desejada" | string | Sim | É a janela de tempo de frequência desejada para um item de linha do YouTube do tipo frequência desejada. Por enquanto, esse campo só pode ser definido como Semanalmente. Para itens de linha do YouTube que não são do tipo "Frequência desejada", esse campo deve ficar em branco.
|