Consulte a visão geral para conferir uma explicação sobre o formato.
| Campo | Obrigatório | Tipo | Gravável | Descrição | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ID do item de linha | Obrigatório apenas ao editar itens de linha | 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. Opcionalmente, 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 do identificador personalizado é "ext[custom identifier]", por exemplo: ext123. Quando o arquivo é enviado e processado, todos os identificadores personalizados são substituídos por IDs atribuídos pela DBM, e os objetos são associados (por exemplo, grupo de anúncios a item de linha) com base nos identificadores personalizados. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ID do Io | Sim | número inteiro | Não | É o valor do ID numérico do pedido de inserção. Você pode especificar um identificador personalizado (por exemplo, "ext[custom IO identifier]") para um pedido de inserção criado ao mesmo tempo que este item de linha. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Nome do io | Não | string | Não | Nome do pedido de inserção | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Tipo | Sim | string | Sim | O tipo de entrada. Só pode ser gravado ao criar, não ao editar. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Subtipo | Sim | string | Sim | Campo obrigatório para que os itens de linha distingam entre formatos diferentes. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Status | Sim | string | Sim | A configuração de status da entrada.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Data de início | Sim | string | Sim | Um carimbo de data para a data de início do voo 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 para a data de término do voo da entrada no formato MM/DD/YYYY 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 a IO dessa entrada estiver ativada para a alocação automática de orçamento, defina como "Automático" para permitir que a DBM aloque orçamentos automaticamente para essa entrada.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Valor do orçamento | Obrigatório quando "Type" for "Display", "Video" ou "Audio" | 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 número flutuante para um valor de moeda. As moedas vão ser mostradas 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ático" estiver definida na entrada, você poderá especificar um valor mínimo a ser gasto, por exemplo, "gasta pelo menos". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Ritmo | Sim | string | Sim | O período de tempo usado para gastar o valor do ritmo. Os itens de linha TrueView e de Geração de demanda só podem ser "Diário" ou "Vô". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Taxa de ritmo | Sim | string | Sim | A taxa de ritmo dessa entrada. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Valor do ritmo | Obrigatório quando "Tipo" é "Display", "Vídeo" ou "Áudio". Obrigatório quando o "Tipo" for "TrueView" ou "Geração de demanda" e o "Ritmo" for "Diário". | float | Sim | O valor a ser gasto por período definido pelo tipo de ritmo. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Frequência ativada | Obrigatório quando "Subtype" não é "Demand Gen" | string | Sim | Ativa/desativa o limite de frequência com base nas impressões no item de linha. Selecione um destes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Exposições de frequência | Obrigatório quando "Frequency Enabled" 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 "Mostrar x impressões no período y". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Período de frequência | Obrigatório quando "Frequency Enabled" for "TRUE" | string | Sim | Especifica a unidade de período de tempo do limite de frequência. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Valor da frequência | Obrigatório quando "Frequency Enabled" for "TRUE" | número inteiro | Sim | Um valor inteiro positivo para a duração do tipo "Período de frequência", ou seja, o "y" em "Mostrar x impressões no período y".Esse valor não é aceito para itens de linha TrueView ou Geração de demanda. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Taxa de visualização do TrueView ativada | Obrigatório quando "Type" for "TrueView" | string | Sim | Ativa/desativa o limite de frequência com base nas visualizações no item de linha TrueView
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Exposições de frequência de visualização do TrueView | Obrigatório quando "TrueView View Frequency Enabled" é "TRUE" | número inteiro | Sim | Um valor inteiro positivo para o número de visualizações TrueView, ou seja, o x em "Mostrar x visualizações no período" | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Período de frequência de visualização do TrueView | Obrigatório quando "TrueView View Frequency Enabled" é "TRUE" | string | Sim | Especifica a unidade de tempo do limite de frequência baseado em visualizações da TrueView
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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" precisa ser especificada quando a coluna "Modelo de receita do parceiro" for incluída.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Valor da receita do parceiro | Obrigatório apenas quando a coluna "Modelo de receita do parceiro" é 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" é especificada. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Tipo de contagem de conversões | Obrigatório quando "Type" for "Display", "Video", "Audio" ou "TrueView" | string | Sim | Escolha os tipos de conversão que serão contabilizados.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Contagem de conversões (em %) | Obrigatório quando "Type" for "Display", "Video", "Audio" ou "TrueView" | float | Sim | Especifique o percentual para o tipo de contagem de conversões "Contagem de %". Formate o % como um número flutuante (3,123% = 3,123), com precisão limitada aos milhares (três casas decimais). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| IDs de atividade do Floodlight de conversão | Não | string, lista de listas | Sim | As atividades do Floodlight usadas para conversões e configurações relacionadas. Essa coluna usa os IDs e as medições de recursos da API Formato da lista de listas = ((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 referentes a essa entrada. Formato da lista = (categoria de taxa; valor da taxa; tipo de taxa; faturado).
Exemplo: "(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Tipo de estratégia de lances | Obrigatório quando "Type" for "Display", "Video" ou "Audio" | string | Sim | Selecione uma das estratégias de lances aplicáveis:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Valor de estratégia de lances | Obrigatório, a menos que o "Tipo de estratégia de lances" seja "Minimizar", "Maximizar" ou "Tipo" seja "TrueView" | float | Sim | Para os tipos de estratégia "Superar", "Maximizar o VCPM" e "Fixo", escolha um valor para o lance desejado. Nenhum valor de estratégia de lances é necessário para o tipo de estratégia de lances "Minimizar" ou "Maximizar". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Unidade da 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 "Vencer", "Minimizar" ou "Maximizar", selecione a unidade correspondente:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Estratégia de lances "Não exceder" | Obrigatório quando "Type" for "Display", "Video" ou "Audio" | float | Sim | Defina um valor de CPM "não exceder". Se for 0, a opção "não exceder" não será ativada. Essa opção só fica disponível se a estratégia de lances for "Minimizar", "Maximizar" ou "Superar". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Aplicar preço mínimo para transações | Obrigatório quando o "Tipo de estratégia de lances" é "Minimizar" ou "Maximizar" | string | Sim | Se quer priorizar transações em vez de inventário de leilão aberto
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ID do algoritmo | Obrigatório quando "Valor/custo de impr. personalizado da unidade da estratégia de lances". | número inteiro | Sim | Esse ID de algoritmo correspondente precisa ser usado quando a unidade da estratégia de lances estiver 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. Essa coluna usa IDs de recursos da API Display & Video 360 Formato da lista = (Creative.creativeId; Creative.creativeId; etc.). Essa lista é gerada em ordem numérica crescente. Durante o upload, os usuários também podem incluir IDs de posição do Campaign Manager 360. Os IDs de posicionamento precisam ser precedidos pelas letras "CM", por exemplo, "CM789". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação geográfica: incluir | Não | string, lista | Sim | Lista de localidades a serem incluídas na segmentação. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação geográfica: excluir | Não | string, lista | Sim | Lista de localidades a serem excluídas da segmentação. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por lista de local regional – incluir | Não | string, lista | Sim | Lista de IDs de listas de locais regionais a serem incluídas. Formato da lista = (11; 22; 33;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por lista de locais regionais de área geográfica: excluir | Não | string, lista | Sim | Lista de IDs de listas de locais regionais para excluir. Formato da lista = (11; 22; 33;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por proximidade | Não | string, lista de listas | Sim | Lista de segmentações de proximidade, cada uma no formato "(Latitude; Longitude; Radius; Unit; FullAddress;)". A latitude varia entre -90 e 90 graus. A longitude varia entre -180 e 180 graus. O raio é uma distância entre 1 e 500 (inclusive) na unidade. A unidade pode ser "mi" ou "km". O endereço completo é 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 de proximidade | Não | string, lista de listas | Sim | Lista de segmentações de lista de proximidade para pedidos de inserção ou itens de linha não TrueView, cada uma no formato "(ProximityListId; Radius; Unit; );". ProximityListId é um ID de lista de local nos recursos de um 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 com as listas de locais regionais geográficas. Por exemplo: "(10041691678; 20,0; mi); (10038858567; 20,5; km);". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por idioma: incluir | Não | string, lista | Sim | Lista de idiomas a serem incluídos na segmentação. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por idioma: excluir | Não | string, lista | Sim | Lista de idiomas a serem excluídos da segmentação. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recursos
Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recursos
Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Classificações 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ções de sensibilidade de brand safety | Não | string | Sim | Escolha a configuração de sensibilidade para bloquear o inventário com base no objeto em questão do conteúdo relacionado a ele.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Configurações personalizadas de brand safety | Obrigatório quando a "Configuração personalizada de proteção de marca" é "Usar personalizado" | string, lista | Sim | Se a configuração de sensibilidade à proteção de marca 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 de terceiros.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 compatíveis com o provedor selecionado. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por canal: incluir | Não | string, lista | Sim | Lista de canais a serem incluídos na segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 Formato da lista = (Channel.channelId; Channel.channelId; etc.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por canal: excluir | Não | string, lista | Sim | Lista de canais a serem excluídos da segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 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 apps: incluir | Não | string, lista | Sim | Lista de apps a serem incluídos na segmentação. A lista é uma concatenação de strings 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 app: excluir | Não | string, lista | Sim | Lista de apps a serem excluídos da segmentação. A lista é uma concatenação de strings 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 apps: incluir | Não | string, lista | Sim | Lista de coleções de apps a serem incluídas na segmentação. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por categoria: incluir | Não | string, lista | Sim | Lista de categorias a serem incluídas na segmentação. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recurso TargetingOption da API Display & Video 360 para o tipo de segmentação TARGETING_TYPE_CATEGORY. Formato da lista = (TargetingOption.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 os IDs de recurso Formato da lista = (TargetingOption.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 os IDs de recurso Formato da lista = (TargetingOption.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 palavras-chave: excluir | Não | string, lista | Sim | Lista de strings de palavras-chave a serem excluídas na segmentação. Essa lista é gerada em ordem alfabética crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por lista de palavras-chave: excluir | Não | string, lista | Sim | Lista de listas de palavras-chave negativas a serem excluídas na segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 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.
A segmentação otimizada não é compatível com todas as estratégias de lances. Esta coluna precisa ser "FALSO" se:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por público-alvo: incluir | Não | string, lista de listas de pares | Sim | Lista de listas de público-alvo a serem incluídas na segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 Nas listas de público-alvo próprio, cada público-alvo é listado como um par de FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId e configuração de recência. Um par é (1;1d;), em que 1d é uma amostra de 1 dia. A recência não está disponível para públicos-alvo de terceiros. Portanto, o formato da lista é (3;);(4;). Para grupos de públicos-alvo "E" e "OU", siga este exemplo: para combinar pares com e sem recência: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;))'. Isso significa (lista 1 com recência de 1 dia OU lista 2 com recência de 365 dias) E (lista 3 sem recência especificada OU lista 4 com recência de 5 minutos OU lista 5 com todos os usuários). Os valores de recência válidos são:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por público-alvo: excluir | Não | string, lista de listas de pares | Sim | Lista de listas de público-alvo a serem excluídas na segmentação. Essa coluna usa IDs de recursos da API Display & Video 360 Cada público-alvo é listado como um par de FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId e a configuração de recência, se a lista de público-alvo for uma lista de público-alvo próprio. Um par é (1;1d;), em que 1d é uma amostra de 1 dia. No entanto, para públicos-alvo de terceiros, a recência não está disponível. Portanto, o formato da lista é (3;);(4;). Formato da lista = ((FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;); (FirstAndThirdPartyAudience.firstAndThirdPartyAudienceId; recency optional;);) Os valores de recência 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 IDs das 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 IDs das 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 combinadas a serem segmentadas. Essa coluna usa IDs de recursos da API Display & Video 360 Formato da lista = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; etc.). Essa lista é gerada em ordem numérica crescente. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por lista personalizada | Não | string, lista | Sim | Lista de listas personalizadas a segmentar. Essa coluna usa IDs de recursos da API Display & Video 360 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 de vendedor autorizado | Obrigatório quando "Type" for "Display", "Video" ou "Audio" | string | Sim | A configuração para segmentar vendedores diretos autorizados, vendedores diretos autorizados e revendedores ou vendedores autorizados e desconhecidos. "Autorizado direto" significa que apenas os vendedores autorizados serão segmentados. "Vendedores diretos e revendedores autorizados" significa segmentar os vendedores diretos e revendedores autorizados. "Editor autorizado e não participante" significa que o público-alvo será composto por vendedores autorizados, revendedores e vendedores desconhecidos.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação da origem de inventário: incluir | Obrigatório quando "Type" for "Display", "Video" ou "Audio" | string, lista | Sim | Lista de origens de inventário, trocas e subtrocas a serem incluídas na segmentação. Essa 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 na segmentação. Essa 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 | A configuração para segmentar novas trocas.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Incluir segmentação de grupos de ofertas particulares | Não | string, lista | Sim | Lista de IDs de transações agrupadas a serem incluídas na segmentação. Os IDs de transações agrupadas podem ser encontrados 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 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 "Segmentação por período do dia" está incluída. | string | Sim | Fuso horário a ser usado para segmentação por período do dia. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação de ambiente | Não | string, lista | Sim | Lista de ambientes a serem segmentados. Selecione um ou mais dos valores aceitáveis. Não é possível selecionar "Web não otimizada" sem selecionar "Web".
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação de OMID por visibilidade ativada | Não | string | Sim | Permite segmentar apenas impressões mensuráveis pelo padrão de medição aberto.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação de visibilidade do Active View | Não | string | Sim | Segmentar por porcentagens de visibilidade previstas. As porcentagens são representadas como números de ponto flutuante. Um dos valores {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9} | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por posição: na tela | Não | string, lista | Sim | Segmentação por posição do anúncio na tela. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por posição: posição de exibição no conteúdo | Não | string, lista | Sim | Mostrar posições de conteúdo de anúncios de display para segmentar. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por posição: posição do vídeo no conteúdo | Não | string, lista | Sim | Posições de conteúdo de anúncios em vídeo para segmentação. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por posição: posição do áudio no conteúdo | Não | string, lista | Sim | Posições de conteúdo de anúncios em áudio para segmentação. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por tamanho do player de vídeo | Não | string, lista | Sim | Lista de tamanhos de player de anúncios em vídeo para segmentação. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por duração do conteúdo | Não | string, lista | Sim | Lista de durações de conteúdo a segmentar. O valor da unidade é em minutos. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por tipo de transmissão de conteúdo | Não | string, lista | Sim | Lista de tipos de transmissão de conteúdo a serem segmentados. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação demográfica: gênero | Não | string, lista | Sim | Lista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitos:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação demográfica por idade | Não | string, lista | Sim | Segmentar por faixa etária. Especifique um intervalo de "de/até" selecionando uma única idade de início e uma única idade de término e se deseja incluir idades desconhecidas (verdadeiro/falso). Consulte a lista de idades de início/término aceitáveis. Exemplo 1: para segmentar pessoas de 18 a 55 anos e incluir idades desconhecidas, especifique o formato {De; Até ; Incluir desconhecido Verdadeiro/Falso} = 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 aceitos para "Para":
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação demográfica: renda familiar | Não | string, lista | Sim | Segmentar uma faixa de renda familiar. Especifique um intervalo de "de/até" selecionando um único intervalo de renda "Top_of_Range" e um único intervalo de renda "Bottom_of_Range" e se é necessário incluir domicílios com renda desconhecida (verdadeiro/falso). Consulte a lista de intervalos aceitáveis de Top_of_Range/Bottom_of_Range. Exemplo 1: para segmentar os 10% a 50% mais ricos e incluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true; Exemplo 2: para segmentar apenas os 50% mais pobres e excluir famílias com renda desconhecida, especifique o formato {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true; Valores aceitáveis para 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 dos valores aceitáveis.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação por velocidade de conexão | Não | string | Sim | Segmentar 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 a serem segmentadas. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.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. Essa coluna usa os IDs de recurso Formato da lista = (TargetingOption.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 lances para essa entrada. Formato da lista = (tipo de linha;ID de critério;valor do multiplicador de lance); (tipo de linha;ID de critério;valor do multiplicador de lance). Os valores do multiplicador de lances podem variar entre 0,1 e 10,0. Os tipos de linha aceitáveis e os IDs de critérios correspondentes estão listados na tabela a seguir:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Formatos de anúncios em vídeo TrueView | Sim para itens de linha TrueView | string | Sim | O formato do anúncio em vídeo do item de linha. Os anúncios em vídeo in-stream / In-feed são tipos de anúncios TrueView vendidos com base no CPV. Os anúncios in-stream / bumper são tipos de anúncios em vídeo TrueView vendidos com base no CPM. Os bumper são anúncios em vídeo de seis segundos ou menos vendidos com base no CPM. Os anúncios em vídeo não puláveis são in-stream com duração entre 6 e 15 segundos vendidos com base no CPM. Anúncios em vídeo in-stream / bumper / não puláveis são tipos de anúncios em vídeo TrueView aceitáveis para itens de linha de frequência desejada vendidos com base no CPM. Os anúncios em vídeo responsivos são tipos de anúncios veiculados em vários formatos.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Tipo de estratégia de lances do TrueView | Obrigatório para itens de linha TrueView e Geração de demanda | string | Sim | A estratégia de lances usada por um item de linha TrueView ou Geração de demanda. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Valor da estratégia de lances do TrueView | Obrigatório para itens de linha TrueView e Geração de demanda | float | Sim | Para o tipo de estratégia de lances de CPA ou ROAS desejado, escolha um valor para o lance desejado. Para os outros valores de "Tipo de estratégia de lances TrueView" ou outros tipos de itens de linha, essa coluna precisa ser 0 no momento do 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 de 150%, insira 1,5 nessa coluna. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Opção de ajuste de lance para dispositivos móveis do TrueView | Não | string | Sim | "Aumentar" ou "Diminuir"
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Porcentagem de ajuste de lance para dispositivos móveis do TrueView | Obrigatório quando o tipo de estratégia de lances da 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 TrueView" é "CPA desejado" ou "Maximizar conversões", ou para grupos de anúncios de Geração de demanda, 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 de ajuste de lance para computadores do TrueView | Obrigatório quando o tipo de estratégia de lances da 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%. O "Tipo de estratégia de lances TrueView" é "CPA desejado" ou "Maximizar conversões". Para grupos de anúncios de Geração de demanda, 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 de ajuste de lance para tablets do TrueView | Obrigatório quando o tipo de estratégia de lances da 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 TrueView" é "CPA desejado" ou "Maximizar conversões" ou para grupos de anúncios de Geração de demanda, 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 TV do TrueView | Não | string | Sim | "Aumentar" ou "Diminuir"
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Porcentagem do ajuste de lances de smart TV do TrueView | Obrigatório quando o tipo de estratégia de lances da 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 TrueView" é "CPA desejado" ou "Maximizar conversões" ou para grupos de anúncios de Geração de demanda, os ajustes aceitáveis são para a opção de ajuste de lance "Aumentar": 0; e para "Diminuir": 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação de exclusões de categoria do TrueView | Não | string, lista | Não | Lista de categorias a serem excluídas. Formato da lista = vídeos incorporados; famílias; etc.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Filtro de conteúdo TrueView | Não | string | Sim | Filtro de conteúdo TrueView ou Demand Gen. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Segmentação da origem de inventário TrueView | Não | string, lista | Sim | Listas de origens de inventário TrueView a serem incluídas
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Fornecedor de visibilidade terceirizado do TrueView | Obrigatório apenas ao atualizar itens de linha "TrueView" ou "Geração de demanda" | string, lista de listas | Sim | Fornecedor terceirizado que mede a visibilidade dos itens de linha TrueView e Geração de demanda. Se esse campo for deixado em branco durante a criação de um item de linha TrueView ou Geração de demanda 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. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Código do relatório de visibilidade terceirizado para TrueView | Sim, quando o fornecedor de visibilidade de terceiros não é "Nenhum". | string | Sim | ID usado pelo fornecedor de visibilidade de terceiros para identificar eventos de relatórios específicos. Uma string vazia é válida para essa coluna, que define o ID do relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Fornecedor de brand safety terceirizado do TrueView | Obrigatório apenas ao atualizar itens de linha TrueView ou Geração de demanda | string, lista de listas | Sim | Fornecedor terceirizado que mede a brand safety para itens de linha TrueView e Geração de demanda. Se esse campo for deixado em branco durante a criação de um item de linha TrueView ou de Geração de demanda 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 do anunciante ativado. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ID do relatório de brand safety terceirizado para TrueView | Sim, quando o fornecedor de brand safety terceirizado não é "Nenhum". | string | Sim | ID usado pelo fornecedor de brand safety terceirizado para identificar eventos de relatórios específicos. Uma string vazia é válida para essa coluna, que define o ID do relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Fornecedor de alcance terceirizado do TrueView | Obrigatório apenas ao atualizar itens de linha TrueView ou Geração de demanda | string, lista de listas | Sim | Fornecedor terceirizado que mede o alcance dos itens de linha TrueView e Geração de demanda. Se esse campo for deixado em branco durante a criação de um item de linha TrueView ou de Geração de demanda 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. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Código do relatório de alcance terceirizado para TrueView | Sim, quando o fornecedor de alcance terceirizado não é "Nenhum". | string | Sim | ID usado pelo fornecedor de alcance terceirizado para identificar eventos de relatórios específicos. Uma string vazia é válida para essa coluna, que define o ID do relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Fornecedor de Brand Lift terceirizado para TrueView | Obrigatório apenas ao atualizar itens de linha "TrueView" ou "Geração de demanda" | string, lista de listas | Sim | Fornecedor terceirizado que mede o Brand Lift para itens de linha TrueView e Geração de demanda. Se esse campo for deixado em branco durante a criação de um item de linha TrueView ou de Geração de demanda e houver um fornecedor de aumento de marca 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. Selecione um dos seguintes valores:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Código 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 fornecedor de aumento de marca terceirizado para identificar eventos de relatórios específicos. Uma string vazia é válida para essa coluna, que define o ID do relatório como vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Contagem de frequência desejada do TrueView | Sim, quando o subtipo do 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 estar vazio. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Janela de tempo da frequência desejada do TrueView | Sim, quando o subtipo do item de linha é "Frequência desejada" | string | Sim | Janela de tempo da frequência desejada para um item de linha do YouTube do tipo "Frequência desejada". Por enquanto, esse campo só pode ser definido como "Semanal". Para itens de linha do YouTube que não são do tipo "Frequência desejada", esse campo precisa estar vazio.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| Controle de inventário de anúncios em vídeo TrueView | Sim, quando o subtipo do item de linha TrueView é "Alcance" e usa anúncios in-feed e do YouTube Shorts | string, lista | Sim | O controle de inventário de anúncios em vídeo para itens de linha de alcance ou visualização. Selecione um ou mais dos valores de formato de anúncio aceitos:
|