Consulte a visão geral para uma explicação do formato.
| Campo | Obrigatório | Tipo | Gravável | Descrição |
|---|---|---|---|---|
| ID do grupo de anúncios | Obrigatório apenas ao editar grupos de anúncios | número inteiro | Não | É o valor do ID numérico do grupo de anúncios. Se deixado em branco, um novo ID de grupo de anúncios será criado e um ID exclusivo será atribuído. Opcionalmente, ao criar novos grupos de anúncios, você pode usar um identificador personalizado para atribuir anúncios TrueView ao novo grupo. 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, anúncio a grupo de anúncios) com base nos identificadores personalizados. |
| ID do item de linha | Sim | número inteiro | Não | É o valor do ID numérico do item de linha principal. Você pode especificar um identificador personalizado (por exemplo, "ext[custom ID do item de linha]") para um item de linha criado ao mesmo tempo que este grupo de anúncios. |
| Nome do item de linha | Não | string | Não | Nome do item de linha |
| Nome | Sim | string | Sim | O nome da entrada. |
| Status | Sim | string | Sim | A configuração de status da entrada.
|
| Formato do anúncio em vídeo | Sim | string | Sim | O formato do anúncio do grupo de anúncios. Selecione um dos seguintes valores:
|
| Origem do anúncio TrueView | Não | string | Sim | A origem do anúncio. Selecione um dos seguintes valores:
Essa coluna precisa ser definida se "Atribuições de criativos TrueView" não estiver vazia. Se "Atribuições de criativos TrueView" estiver vazio, essa coluna também precisará estar. |
| Atribuições de criativos do TrueView | Não | string, lista | Sim | Lista de IDs numéricos dos criativos do Display & Video 360 atribuídos a esse grupo de anúncios. Formato da lista = (ID do criativo; ID do criativo; etc.). Essa lista é gerada em ordem numérica crescente. Essa coluna só pode ser definida se a "Origem do anúncio TrueView" for "Criativo do Display & Video 360". |
| Custo do lance | Sim | float | Sim | O valor que representa o custo máximo do lance desejado para o grupo de anúncios com base no tipo de lance definido na coluna "Tipo de estratégia de lances TrueView". Por exemplo, se o "Tipo de estratégia de lances TrueView" for "CPV manual", ele será o custo máximo por visualização. Observação: se a coluna "Tipo de estratégia de lances TrueView" for "Maximizar Conversões", "Maximizar o Valor de Conversão" ou "Maximizar cliques", ou se uma transação garantida de transação instantânea do YouTube estiver sendo criada, essa coluna precisará ser 0 no upload. |
| 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. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por palavras-chave: exclusão | 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. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por categoria: incluir | Não | string, lista | Sim | Lista de categorias a serem incluídas na segmentação. Essa coluna usa IDs de recursos Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por categoria: exclusão | Não | string, lista | Sim | Lista de categorias a serem excluídas da segmentação. Essa coluna usa IDs de recursos 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. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: canais do YouTube: incluir | Não | string, lista | Sim | Lista de canais do YouTube a serem incluídos. Formato da lista = (ID do canal do YouTube; ID do canal do YouTube; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por posição: canais do YouTube (excluir) | Não | string, lista | Sim | Lista de canais do YouTube a serem excluídos. Formato da lista = (ID do canal do YouTube; ID do canal do YouTube; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: vídeos do YouTube (incluir) | Não | string, lista | Sim | Lista de vídeos do YouTube a serem incluídos. Formato da lista = (ID do vídeo do YouTube; ID do vídeo do YouTube; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por posição: vídeos do YouTube: excluir | Não | string, lista | Sim | Lista de vídeos do YouTube a serem excluídos. Formato da lista = (ID do vídeo do YouTube; ID do vídeo do YouTube; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: conteúdo em alta: incluir | Não | string, lista | Sim | Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google para incluir. Cada agrupamento de conteúdo individual deve ter o 'video_content::ID do agrupamento de conteúdo' estruturado. Formato da lista = (video_content::ID do agrupamento de conteúdo; video_content::ID do agrupamento de conteúdo; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: conteúdo em alta (excluir) | Não | string, lista | Sim | Lista de conteúdo em alta no YouTube e nos parceiros de vídeo do Google para exclusão. Cada agrupamento de conteúdo individual deve ter o 'video_content::ID do agrupamento de conteúdo' estruturado. Formato da lista = (video_content::ID do agrupamento de conteúdo; video_content::ID do agrupamento de conteúdo; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: URLs: incluir | Não | string, lista | Sim | Lista de URLs a serem incluídos na segmentação. A lista consiste em strings de URL. Formato da lista = (algumsite.com; algumsite2.com; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: URLs - Excluir | Não | string, lista | Sim | Lista de URLs a serem excluídos da segmentação. A lista consiste em strings de URL. Formato da lista = (algumsite.com; algumsite2.com; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: apps (incluir) | Não | string, lista | Sim | Lista de apps para dispositivos móveis a serem excluídos da segmentação. A lista consiste em IDs de plataforma de apps. O ID é fornecido pela plataforma relevante, como um ID de pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID de app da App Store da Apple (exemplo: 422689480). Formato da lista = (com.google.android.gm; 422689480; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: apps (excluir) | Não | string, lista | Sim | Lista de apps para dispositivos móveis a serem excluídos da segmentação. A lista consiste em IDs de plataforma de apps. O ID é fornecido pela plataforma relevante, como um ID de pacote da Play Store do Android (exemplo: com.google.android.gm) ou um ID de app da App Store da Apple (exemplo: 422689480). Formato da lista = (com.google.android.gm; 422689480; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal - Coleções de apps - Incluir | Não | string, lista | Sim | Lista de coleções de apps a serem incluídas na segmentação. Essa coluna usa IDs de recursos Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por canal: coleções de apps (excluir) | Não | string, lista | Sim | Lista de coleções de apps a serem excluídas da segmentação. Essa coluna usa IDs de recursos Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação demográfica por gênero | Sim | string, lista | Sim | Lista de gêneros a serem segmentados. Selecione um ou mais dos valores aceitáveis:
Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Idade da segmentação demográfica | Sim | string, lista | Sim | Lista de faixas etárias a serem segmentadas. Selecione um ou mais dos valores aceitáveis. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação demográfica por renda familiar | Sim | string, lista | Sim | Lista de rendas familiares a serem segmentadas. Selecione um ou mais dos valores aceitáveis. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação demográfica por status parental | Sim | string, lista | Sim | Lista de status parentais para segmentação. Selecione um ou mais dos valores aceitáveis. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| 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. Essa coluna precisa ser "FALSE" se:
Essa restrição também se aplica se o item de linha herdar uma das estratégias de lances acima da ordem de inserção mãe. As estratégias de lances definidas no nível do pedido de inserção serão herdadas pelos itens de linha se a coluna "Otimização do pedido de inserção" estiver definida como "TRUE". |
| Nível de expansão de público-alvo | Não | número inteiro | Sim | Nível de expansão de público-alvo. Só pode ser definido como "AdGroups" com valor 0, 1, 2 ou 3. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo" |
| A lista de origem da expansão de público-alvo foi excluída | Não | string | Sim | Ative a exclusão da seedlist da expansão de público-alvo.
Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo" |
| Segmentação por público-alvo: incluir | Não | string, lista | Sim | Lista de públicos-alvo a serem incluídos. Essa coluna usa IDs de recursos Formato da lista = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). Essa lista é gerada em ordem numérica crescente. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por público-alvo: exclusão | Não | string, lista | Sim | Lista de públicos-alvo a serem excluídos. Essa coluna usa IDs de recursos Formato da lista = (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.). Essa lista é gerada em ordem numérica crescente. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por público-alvo semelhante: incluir | Não | string, lista | Sim | Uma lista de públicos-alvo semelhantes para incluir na segmentação. 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 semelhante; ID do público-alvo semelhante; etc.) Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por público-alvo semelhante: exclusão | Não | string, lista | Sim | Uma lista de públicos-alvo semelhantes a serem excluídos da segmentação. 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 semelhante; ID do público-alvo semelhante; etc.) Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por afinidade e no mercado: incluir | Não | string, lista | Sim | Lista de públicos-alvo de afinidade e/ou no mercado a serem excluídos. 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. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por afinidade e no mercado: exclusão | Não | string, lista | Sim | Lista de públicos-alvo de afinidade e/ou no mercado a serem excluídos. 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. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por eventos importantes: incluir | Não | string, lista | Sim | Lista de públicos-alvo de eventos importantes a serem incluídos. 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. Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda". Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por eventos importantes: exclusão | Não | string, lista | Sim | Lista de públicos-alvo de eventos importantes a serem excluídos. 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. Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda". Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por informações demográficas detalhadas: incluir | Não | string, lista | Sim | Lista de públicos-alvo com informações demográficas detalhadas a serem incluídos. 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. Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda". Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por informações demográficas detalhadas: exclusão | Não | string, lista | Sim | Lista de públicos-alvo de demonstrações detalhadas a serem excluídos. 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. Válido apenas se "Tipo" for "TrueView" ou "Geração de demanda". Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por público-alvo combinado | Não | string, lista | Sim | Lista de públicos-alvo combinados a serem segmentados. Essa coluna usa IDs de recursos Formato da lista = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; etc.). Essa lista é gerada em ordem numérica crescente. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por lista personalizada | Não | string, lista | Sim | Lista de listas personalizadas para segmentação. Essa coluna usa IDs de recursos Formato da lista = (CustomList.customListId; CustomList.customListId; etc.). Essa lista é gerada em ordem numérica crescente. Não disponível para grupos de anúncios de itens de linha "Sequência de vídeo". |
| Segmentação por idioma: incluir | Não | string, lista | Sim | Lista de idiomas a serem incluídos na segmentação. Essa coluna usa IDs de recursos Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. Só disponível se as seguintes condições forem atendidas:
|
| Segmentação geográfica: incluir | Não | string, lista | Sim | Lista de regiões geográficas a serem incluídas na segmentação. Essa coluna usa IDs de recursos Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. Só disponível se as seguintes condições forem atendidas:
|
| Segmentação geográfica: exclusão | Não | string, lista | Sim | Lista de regiões geográficas a serem excluídas da segmentação. Essa coluna usa IDs de recursos Formato da lista = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). Essa lista é gerada em ordem numérica crescente. Só está disponível se as seguintes condições forem atendidas:
|
| Segmentação por lista de locais regionais geográficos: incluir | Não | string, lista | Sim | Lista de IDs de listas de locais regionais geográficos a serem incluídos. Formato da lista = (11; 22; 33;). |
| Segmentação por lista de locais regionais geográficos: exclusão | Não | string, lista | Sim | Lista de IDs de listas de locais regionais geográficas a serem excluídos. Formato da lista = (11; 22; 33;). |
| Estratégia de origem de inventário da Geração de Demanda | Sim para grupos de anúncios da Geração de demanda | string | Sim | Estratégia de fontes de inventário da Geração de Demanda.
|
| Origens de inventário ativadas para a Geração de demanda | Não | string, lista | Sim | Fontes de inventário ativadas para a Geração de demanda. Isso é usado quando a estratégia de origem do inventário não está definida.
|
| Tipo de filtro de produto | Obrigatório quando o "ID da conta do Merchant Center" está definido para o item de linha principal | string | Sim | A seleção da opção de filtro de produto.
|
| Configuração de filtro de produto | Obrigatório quando o "Tipo de filtro de produto" é "Produtos específicos" ou "Rótulo personalizado". | string, lista | Sim | A configuração do filtro de produto. Dependendo da seleção de "Tipo de filtro de produto", ele consiste em uma lista de IDs ou pares de chave-valor. Se o "Tipo de filtro de produto" for "Produtos específicos", a lista vai conter IDs numéricos de produtos que podem ser encontrados no Google Merchant Center. Exemplo: (1; 2; 3; etc.). Se "Tipo de filtro de produto" for "Rótulo personalizado", a lista vai conter pares de chave-valor em que as chaves são do tipo "Rótulo personalizado [0-4]" e os valores são strings. Exemplo: (rótulo personalizado 0: valor; rótulo personalizado 1: valor; etc.) Se o "Tipo de filtro de produto" for "Todos os produtos" ou "Nenhum produto", essa coluna vai ficar vazia. |
| ID da etapa da sequência de vídeo | Obrigatório quando o subtipo do item de linha principal é "Sequência de vídeo" | número inteiro | Sim | O ID da etapa da sequência a que este grupo de anúncios pertence. A etapa precisa estar em "Etapas de sequência de vídeo" do item de linha principal antes da criação do grupo de anúncios. Esse campo é imutável depois de definido. Disponível apenas para grupos de anúncios de itens de linha de sequência de vídeo. |
| Segmentação por Primeira Posição | Não | string | Sim | A segmentação por posição do grupo de anúncios.
Essa coluna só é compatível com grupos de anúncios em itens de linha de transação instantânea. O suporte da SDF para itens de linha de transação instantânea e os grupos de anúncios e anúncios deles está na versão Beta e só está disponível para parceiros na lista de permissões. Os anúncios em itens de linha de transação instantânea não serão incluídos nos arquivos baixados e precisam ser enviados pelo fluxo de trabalho de criação de transação instantânea do YouTube na interface do Display & Video 360. |