Upload parcial de arquivo de dados estruturados (SDF)

O upload parcial de arquivos de dados estruturados (SDFs) permite que os usuários do Display & Video 360 atualizem um subconjunto de configurações de recursos para itens de linha atuais em massa usando arquivos de dados estruturados, com menos colunas do que o formato de arquivo de item de linhanormalmente exige.

Ao exigir menos colunas, o upload parcial de SDFs oferece os seguintes benefícios:

• Permite incluir um número maior de recursos em um único arquivo enviado.
• Facilita o gerenciamento manual de SDFs.
• Não exige mais que um SDF enviado seja criado com base em um arquivo baixado anteriormente.
• Reduz o tempo entre o upload inicial do arquivo e a propagação das atualizações.

O SDF parcial só é compatível com SDFs de itens de linha.

Como usar o upload parcial de SDFs

Siga estas etapas para criar e fazer upload de um SDF parcial:

1. Decida quais itens de linha e configurações você quer atualizar.

   • Identifique os itens de linha usando a coluna Line Item Id. Essa coluna é obrigatória em todos os SDFs parciais e precisa ser preenchida em todas as entradas de arquivo.

   • Escolha as colunas a serem atualizadas na seção "Grupos de colunas disponíveis".

     • Para atualizar qualquer coluna em um grupo, todas as colunas desse grupo precisam estar presentes no arquivo.
     • Um arquivo pode incluir vários grupos de colunas.
     • Arquivos com grupos de colunas incompletos ou colunas não especificamente compatíveis com o upload parcial de SDFs vão gerar um erro.

2. Crie o arquivo de uma das seguintes maneiras:

   • Use um SDF atual.

     • Faça o download de um SDF de item de linha que contenha os itens de linha relevantes, como faria ao gerenciar e fazer upload de um SDF padrão.
     • Faça o download de um SDF inicial que contenha todos os itens de linha selecionados.
     • Remova todas as colunas que não estão nos grupos de colunas de SDF parcial relevantes.
     • Remova todas as entradas de itens de linha que você não vai atualizar.

   • Crie um novo arquivo CSV.

     • Crie um arquivo CSV e inclua apenas cabeçalhos para as colunas nos grupos de colunas de SDF parcial relevantes.
     • Adicione uma entrada ao arquivo para cada ID do item de linha que será atualizado.

3. Preencha o novo SDF parcial.

   • Se estiver usando um arquivo baixado, atualize os valores atuais de cada entrada de item de linha. Os valores que não serão atualizados não precisam ser alterados. O SDF parcial não é compatível com a coluna Timestamp. Todas as mudanças feitas em um item de linha entre o download do arquivo e o upload parcial do SDF serão substituídas se a coluna relevante estiver incluída.
   • Se estiver usando um novo arquivo CSV, preencha todas as colunas incluídas para cada entrada de item de linha. Você pode deixar o valor de uma coluna intencionalmente vazio, mas, após o upload, esse valor vazio será salvo como o novo valor para essa configuração de item de linha.

4. Faça o upload do arquivo para o Display & Video 360 na interface usando o processo de upload de SDF padrão. Nenhuma configuração adicional é necessária para identificá-lo como um SDF parcial. Quando o arquivo enviado for processado, os arquivos de resultado estarão disponíveis na página de status em massa, indicando quais itens de linha foram atualizados e quais não foram. Ao contrário de um upload de SDF padrão, e-mails com arquivos de resultado não são enviados após o upload e o processamento de SDFs parciais.

Arquivos de exemplo

Fornecemos três arquivos de exemplo que podem ser usados para criar seu SDF parcial. Cada exemplo usa uma combinação diferente de grupos de colunas. Cada um inclui uma linha de cabeçalho que identifica as colunas relevantes e três linhas que precisam ser atualizadas com os dados pretendidos antes do upload.

Faça o download de um dos seguintes arquivos CSV com os grupos de colunas identificados para usar como modelo:

• Exemplo 1
  • Grupos de colunas: ID do item de linha, Nome, Status
• Exemplo 2
  • Grupos de colunas: ID do item de linha, campos de orçamento e ritmo
• Exemplo 3
  • Grupos de colunas: ID do item de linha, Segmentação por região geográfica campos, Segmentação por proximidade, Campos de segmentação por palavras-chave

Grupos de colunas disponíveis

A seguir, estão os grupos de colunas disponíveis para SDFs parciais. Cada grupo contém uma ou mais colunas do formato de arquivo de item de linha do SDF. Se um grupo de colunas tiver mais de uma coluna, todas as colunas desse grupo precisarão ser incluídas no arquivo enviado.

ID do item de linha

**Importante**: esse grupo de colunas é obrigatório para todos os arquivos de dados estruturados parciais.

Colunas incluídas:

• Line Item ID

Nome

Colunas incluídas:

• Name

Status

Colunas incluídas:

• Status

Campos de veiculação

Colunas incluídas:

• Start Date
• End Date

Campos de orçamento e ritmo

Colunas incluídas:

• Budget Type
• Budget Amount
• Pacing
• Pacing Rate
• Pacing Amount

Campos de limite de frequência

Atenção: algumas colunas nesse grupo só são obrigatórias se itens de linha TrueView estiverem incluídos no arquivo. Se você não tiver certeza de quais tipos de itens de linha seu arquivo vai incluir, recomendamos que você inclua todas as colunas ao usar esse grupo de arquivos.

Colunas incluídas para todos os tipos de itens de linha:

• Frequency Enabled
• Frequency Exposures
• Frequency Period
• Frequency Amount

Colunas adicionais, obrigatórias se itens de linha TrueView estiverem presentes:

• TrueView View Frequency Enabled
• TrueView View Frequency Exposures
• TrueView View Frequency Period

Campos do modelo de receita do parceiro

Colunas incluídas:

• Partner Revenue Model
• Partner Revenue Amount

Campos de acompanhamento de conversões

Colunas incluídas:

• Conversion Counting Type
• Conversion Counting Pct
• Conversion Floodlight Activity Ids
• Primary Attribution Model Id

Campos de informações de relatórios

Colunas incluídas:

• Integration Code
• Details

Campos de estratégia de lances

Colunas incluídas:

• Bid Strategy Type
• Bid Strategy Value
• Bid Strategy Unit
• Bid Strategy Do Not Exceed
• Apply Floor Price For Deals
• Algorithm Id

Atribuições de criativos

Colunas incluídas:

• Creative Assignments

Campos de segmentação por região geográfica

Colunas incluídas:

• Geography Targeting - Include
• Geography Targeting - Exclude

Segmentação por proximidade

Atenção:ao formatar um arquivo que contenha esse grupo de colunas, verifique se não há espaço entre a vírgula antes dessa coluna e os valores da coluna.

Colunas incluídas:

• Proximity Targeting

Campos de segmentação por palavras-chave

Colunas incluídas:

• Keyword Targeting - Include
• Keyword Targeting - Exclude

Considerações

Antes de tentar fazer upload de um SDF parcial, verifique o seguinte:

• A coluna "ID do item de linha" está presente e preenchida para todas as entradas.
• Todas as colunas incluídas fazem parte de um grupo de colunas de SDF parcial compatível.
• Todas as colunas nos grupos de colunas representados estão incluídas.
• Não há espaços entre vírgulas e os valores de coluna que elas separam.
• Cada valor em uma entrada presente é o valor pretendido para essa coluna.
• Se você estiver atualizando itens de linha de diferentes anunciantes, faça o upload do SDF parcial no nível do parceiro compartilhado. Não é possível atualizar dois itens de linha de parceiros diferentes no mesmo SDF.