Upload em Lote de Ativos

Use a ferramenta de envios em massa para carregar vários ativos de uma vez usando um arquivo CSV, em vez de carregar ativos individualmente. Os campos de informação são semelhantes ao Objeto de anúncios para ajudá-lo a coordenar qual informação vai para onde.

Você precisará de dois arquivos para realizar um envio em massa de anúncios:

• Um arquivo de metadados de ativo (CSV)

• Arquivos criativos (por exemplo, imagens ou vídeos)

1

Passo 1: Prepare o arquivo de metadados do ativo

Há campos obrigatórios e valores aceitos para o arquivo CSV que você carrega. Seus ativos aparecerão exatamente como seu arquivo, portanto qualquer espaço, sinais de pontuação ou caracteres especiais estarão presentes se forem usados. Para começar, copie o modelo CSV exibido abaixo e cole-o em um aplicativo de planilha oubaixe-o aqui e importe-o diretamente.

Operation,AdID,State,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes

Dica: Recomendamos usar o Formato de arquivo detalhes disponíveis na tela de Envio em Massa para verificar suas entradas antes de carregar!

Antes de criar ou atualizar ativos usando um arquivo de metadados, observe os seguintes pontos importantes sobre atualizações parciais:

• Atualizações parciais são suportadas. Se você deixar uma célula vazia, esse campo será ignorado e seu valor existente permanecerá inalterado.

• Para limpar ou apagar um valor, insira explicitamente $CLEAR$ nessa célula. Isso remove qualquer valor previamente armazenado para esse campo.

Operation,AdID,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,LimitedTimeZone,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes
CREATE,,Banner Example,This is an example of a new banner ad you would upload.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NewBanner",TRUE,,,,,,,ENGLISH,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,FRAME_ONLY,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

• O CREATE a linha mostra um novo ativo banner.

• O UPDATE a linha demonstra uma atualização parcial — apenas os campos preenchidos serão atualizados.

• Se você quisesse limpar um valor (por exemplo, remover Rótulos), você usaria $CLEAR$ nessa coluna.

Exemplo de campos sendo limpos (CSV):

UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

2

Passo 2: Carregue o arquivo de metadados do ativo

1. Na barra de navegação esquerda, selecione [Engage] → Conteúdo → Anúncios.

2. No canto superior direito, selecione tela de Envio em Massa.

3. Selecionar  Escolher arquivo, carregue seu arquivo em massa e selecione Abrir.

   • Selecionar  Mostrar/ocultar detalhes do formato do arquivo para ver informações sobre colunas obrigatórias, suas descrições, valores aceitos e se elas são obrigatórias no colunas do cabeçalho do anúncio e colunas do cabeçalho da oferta referências abaixo.

Observação: impact.com avisará você se houver quaisquer erros no arquivo.

1. Selecionar Próximo.

colunas do cabeçalho do anúncio

Nome da Coluna	Descrição
Operação (String) Obrigatório - Sempre.	Operação a ser executada sobre os detalhes do ativo fornecidos. Valores permitidos: CREATE, UPDATE, EXCLUIR.
ProgramId (Inteiro) Obrigatório - Sempre.	O ID único de Programa da impact.com ao qual o ativo pertence. Esse valor não pode ser atualizado e deve corresponder ao programa no qual o envio em massa está sendo executado.
AdID (String) Obrigatório - Ao executar operação sobre um ativo existente.	Identificador único da impact.com para o ativo. Deixe em branco ao criar um novo ativo. Obrigatório se Operação = UPDATE, EXCLUIR.
Estado (String) Obrigatório - Não.	O estado do ativo. Valores permitidos: ATIVO, PENDENTE, EXPIRADO.
Nome (String) Obrigatório - Ao criar um ativo.	Nome do ativo. Obrigatório se Operação = CREATE.
TipoDeAnúncio (String) Obrigatório - Ao criar um ativo.	Ao atualizar um anúncio existente, o tipo de anúncio pode não mudar. Obrigatório se Operação = CREATE. Valores permitidos: IMAGEM, LINK_DE_TEXTO, CUPOM.
HospedadoPor (String) Obrigatório - Ao criar um ativo.	Onde o criativo do ativo está hospedado. Obrigatório se Operação = CREATE e TipoDeAnúncio = IMAGEM. Valores permitidos: IR, URL, HTML.
Criativo (String) Obrigatório - Ao criar um ativo de imagem.	Nome do arquivo criativo a ser carregado. Obrigatório se Operação = CREATE e TipoDeAnúncio = IMAGEM.
IabAdUnit (String) Obrigatório - Ao criar um ativo de imagem.	Tamanho padrão IAB do ativo. Obrigatório se Operação = CREATE e TipoDeAnúncio = IMAGEM e HospedadoPor != IR. Valores permitidos: DESCONHECIDO, RETÂNGULO_MÉDIO, POP_UP_QUADRADO, RETÂNGULO_VERTICAL, RETÂNGULO_GRANDE, RETÂNGULO, RETÂNGULO_3_1_, POP_UNDER, BANNER_COMPLETO, MEIO_BANNER, MICRO_BANNER, BOTÃO_1, BOTÃO_2, BANNER_VERTICAL, BOTÃO_QUADRADO, LEADERBOARD, WIDE_SKYSCRAPER, SKYSCRAPER, MEIA_PÁGINA, PERSONALIZADO.
ThirdPartyServableAdCreativeHeight (Inteiro) Obrigatório - Ao criar um ativo de imagem.	Altura da imagem servível de terceiros, em pixels. Obrigatório se Operação = CREATE e IabAdUnit = PERSONALIZADO.
ThirdPartyServableAdCreativeWidth (Inteiro) Obrigatório - Ao criar um ativo de imagem.	Largura da imagem servível de terceiros, em pixels. Obrigatório se Operação = CREATE e IabAdUnit = PERSONALIZADO.
Idioma (String) Obrigatório - Ao criar um ativo.	Valores permitidos: AFRIKAANS, ARÁBICO, BÚLGARO, CHINÊS, CHINÊS_TRADICIONAL, TCHÊCO, DINAMARQUÊS, HOLANDÊS, INGLÊS, INGLÊS_GB, INGLÊS_AU, INGLÊS_CA, INGLÊS_NZ, INGLÊS_ZA, ESTONIANO, FILIPINO, FINLANDÊS, FRANCÊS, FRANCÊS_CA, ALEMÃO, HEBRAICO, HINDI, INDONÉSIO, ITALIANO, JAPONÊS, COREANO, LETONA, LITUANO, MALAIO, MALTESE, NORUEGUÊS, PORTUGUÊS, PORTUGUÊS_BR, POLONÊS, RUSSO, ESLOVÊNIO, ESPANHOL, ESPANHOL_MX, SUECO, TAILANDÊS, TURCO, VIETNAMITA.
LimitedTimeEndDate (Data) Obrigatório - Se LimitedTimeStartDate for fornecido	Esta é uma data ISO8601. Formato de exemplo: 2013-06-30T00:00:00-07:00.
LinkText (String) Obrigatório - Ao criar um link de texto ou ativo de cupom.	Texto real exibido para o link. Obrigatório se Operação = CREATE e TipoDeAnúncio = LINK_DE_TEXTO ou CUPOM.
Descrição Obrigatório - Não.	Descrição do ativo.
Rótulos (string CSV) Obrigatório - Não.	Rótulos do ativo.
AllowDeepLinking (Booleano) Obrigatório - Não.	Determina se a vinculação a uma página mais profunda dentro do site do anunciante será permitida. Padrão para true.
AllowCustomPromoCode (Booleano) Obrigatório - Não.	Permite que o Parceiro solicite seu próprio código promocional único para esta promoção. Padrão para false.
CustomisationCharge (Decimal 10.2) Obrigatório - Não.	Valor da taxa de customização do ativo.
ImageAlternativeTag (String) Obrigatório - Não.	Tag alternativa a ser usada no código do ativo de imagem.
LandingPage (String) Obrigatório - Não.	A URL da página de destino. Deve conter o protocolo da URL. Padrão para a página de destino padrão do programa ao criar um ativo e não fornecer.
iOSMobileFallbackAppId (String) Obrigatório - Não.	Especifique se o tráfego móvel deve reencaminhar para sua página de destino do app iOS caso nenhum app seja detectado. O id do app deve corresponder ao id do app do sistema.
AndroidMobileFallbackAppId (String) Obrigatório - Não.	Especifique se o tráfego móvel deve reencaminhar para sua página de destino do app Android caso nenhum app seja detectado. O id do app deve corresponder ao id do app do sistema.
LimitedTimeStartDate (String) Obrigatório - Não.	Esta é uma data ISO8601. Formato de exemplo: 2013-06-30T00:00:00-07:00.
FallbackAd (String) Obrigatório - Não.	Especifique um ID de ativo de fallback, aplicável apenas a IMAGEM ativos.
GetHtmlCodeType (String) Obrigatório - Não.	Valores permitidos: APENAS_IFRAME, HTML_E_IFRAME.
Season (String) Obrigatório - Não.	Valores permitidos: INVERNO, PRIMAVERA, VERÃO, OUTONO, ANO_NOVO, DIA_DOS_PRESIDENTES, DIA_DOS_NAMORADOS, DIA_DE_SAO_PATRICIO, PÁSCOA, DIA_DAS_MÃES, DIA_DA_MEMÓRIA, DIA_DOS_PAIS, DIA_DA_INDEPENDÊNCIA, VOLTA_AS_AULAS, DIA_DO_TRABALHO, HALLOWEEN, AÇÃO_DE_GRAÇAS, BLACK_FRIDAY, CYBER_MONDAY, HANUKKAH, NATAL, DIA_DA_FAMÍLIA, SEXTA_FEIRA_SANTA, VICTORIA_DAY, CANADA_DAY, FERIADO_CÍVICO_DE_AGOSTO, REMEMBRANCE_DAY, BOXING_DAY, DIA_DA_AUSTRÁLIA, ANZAC_DAY, QUEENS_BIRTHDAY, FIM_DO_EXERCÍCIO_FINANCEIRO, WAITANGI_DAY, OUTRO.
TopSeller (Booleano) Obrigatório - Não.	Mais Vendido. Padrão para false.
ThirdPartyImpressionPixel (String) Obrigatório - Não.	Pixel de impressão HTML de terceiros a ser usado com este ativo.
RestrictedToPartners (string CSV) Obrigatório - Não.	IDs de Parceiros separados por vírgula que devem ter acesso a este ativo.
RestrictedToGroups (string CSV) Obrigatório - Não.	IDs de Grupo de Parceiros separados por vírgula que devem ter acesso a este ativo.
Metadata (string CSV) Obrigatório - Não.	Parâmetros de string de consulta separados por vírgula que serão anexados à URL de rastreamento.

colunas do cabeçalho da oferta

Nome da Coluna	Descrição
DealName (String) Obrigatório - Ao criar uma nova oferta.	Nome da oferta a ser criada e vinculada ao ativo. Obrigatório se DealId não for fornecido.
DealType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de oferta a ser criada. Obrigatório se DealId não for fornecido e DealName for. Valores permitidos: VENDA_GERAL,FRETE_GRÁTIS, BRINDE_COM_COMPRA, REBATE, BOGO, LANÇAMENTO_DE_PRODUTO.
DealScope (String) Obrigatório - Ao criar uma nova oferta.	Obrigatório se DealId não é fornecido, DealName é, e DealType != BOGO. Valores permitidos: LOJA_INTEIRA, CATEGORIA, PRODUTO, PRODUTOS.
DealProducts (string CSV) Obrigatório - Ao criar uma nova oferta.	Produtos da oferta. Obrigatório se DealId não é fornecido, DealName é, e DealScope = PRODUTO. Valores permitidos: Opção 1: Lista de nomes de produtos ex.: "Produto1, Produto2". Opção 2: Lista de pares de valor do produto ex.: "name=Produto1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Produto2;" onde os múltiplos produtos são separados por vírgula e os vários campos do produto são separados por ponto e vírgula. Campos válidos: name - nome do produto, image - nome do arquivo de imagem do produto que você pretende carregar na etapa dois do envio em massa, limit - quantidade permitida, regularPrice - preço antes do desconto, dealPrice - preço após o desconto.
DealCategories (string CSV) Obrigatório - Ao criar uma nova oferta.	Categorias da oferta. Obrigatório se DealId não é fornecido, DealName é, e DealScope = CATEGORIA.
DealLandingPage (String) Obrigatório - Não	A URL da página de destino para esta oferta. Se deixada em branco ao criar uma nova oferta, a página de destino padrão do programa será usada.
DealMetadata (String CSV) Obrigatório - Não	Parâmetros de string de consulta separados por vírgula para o link de rastreamento da oferta. Se deixado em branco, nenhum parâmetro extra será adicionado.
DealAllowDeepLinking (Booleano) Obrigatório - Não	Determina se o deeplinking é permitido para a página de destino da oferta. Se deixado em branco, isso será padrão para FALSE.
DealDiscountType (string CSV) Obrigatório - Ao criar uma nova oferta.	Obrigatório se DealId não é fornecido, DealName é, e DealType = VENDA_GERAL. Valores permitidos: FIXO, PERCENTUAL, INTERVALO_PERCENTUAL, PERCENTUAL_MÁXIMO.
DealDiscountAmount (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor do desconto da venda. Obrigatório se DealId não é fornecido, DealName for, DealType = VENDA_GERAL, e DealDiscountType = FIXO.
DealDiscountPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual de desconto da venda. Obrigatório se DealId não é fornecido, DealName for, DealType = VENDA_GERAL, e DealDiscountType = PERCENTUAL.
DealDiscountStartPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual inicial do intervalo de desconto da oferta. Obrigatório se DealId não é fornecido, DealName for, DealType = VENDA_GERAL, e DealDiscountType = INTERVALO_PERCENTUAL.
DealDiscountEndPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual inicial do intervalo de desconto da oferta. Obrigatório se DealId não é fornecido, DealName for, DealType = VENDA_GERAL, e DealDiscountType = INTERVALO_PERCENTUAL.
DealDiscountMaximumPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual máximo de desconto da oferta. Obrigatório se DealId não é fornecido, DealName for, DealType = VENDA_GERAL, e DealDiscountType = PERCENTUAL_MÁXIMO.
DealGift (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Detalhes do brinde. Obrigatório se DealId não é fornecido, DealName é, e DealType = BRINDE_COM_COMPRA.
DealRebate (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor do rebate. Obrigatório se DealId não é fornecido, DealName é, e DealType = REBATE.
DealMinimumPurchaseAmount (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor mínimo de compra da oferta. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealMaximumSavingsAmount (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor máximo de economia da oferta. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealBogoPurchaseLimit (Inteiro) Obrigatório - Ao criar uma nova oferta.	Quantidade máxima de itens permitidos a esse preço. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealBogoBuyQty (Inteiro) Obrigatório - Ao criar uma nova oferta.	Quantidade de compra do BOGO. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealBogoBuyType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de item de compra do BOGO. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO. Valores permitidos: PRODUTO, CATEGORIA.
DealBogoBuyName (String) Obrigatório - Ao criar uma nova oferta.	Nome do produto ou categoria de compra. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealBogoGetQty (Inteiro) Obrigatório - Ao criar uma nova oferta.	Quantidade de obtenção do BOGO. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealBogoGetType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de item de obtenção do BOGO. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO. Valores permitidos: PRODUTO, CATEGORIA.
DealBogoGetName (String) Obrigatório - Ao criar uma nova oferta.	Nome do produto ou categoria de obtenção. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO.
DealBogoGetDiscountType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de desconto do BOGO. Obrigatório se DealId não é fornecido, DealName é, e DealType = BOGO. Valores permitidos: GRÁTIS, VALOR, PERCENTUAL.
DealBogoGetDiscountAmount (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor do desconto do BOGO. Obrigatório se DealId não é fornecido, DealName for, DealType = BOGO, e DealBogoGetDiscountType = VALOR.
DealBogoGetDiscountPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual do desconto do BOGO. Obrigatório se DealId não é fornecido, DealName for, DealType = BOGO, e DealBogoGetDiscountType = PERCENTUAL.
DealId (String) Obrigatório - Não.	Identificador único da impact.com para a oferta à qual o ativo será vinculado.
DealDefaultDiscountCode (String) Obrigatório - Não.	Código de desconto padrão da oferta.
DealSyncAdsPromoCodes (Booleano) Obrigatório - Não.	Mantenha anúncios associados e códigos promocionais sincronizados com esta oferta. A sincronização se aplica a datas de tempo limitado, acesso restrito a parceiros e estado.

3

Passo 3: Carregue os arquivos criativos do ativo

Em seguida, você precisará dos arquivos criativos do seu ativo prontos para que possam ser carregados.

1. Na Especificar imagens página, selecione Escolher arquivos para enviar em massa os arquivos criativos do ativo. Os nomes dos arquivos carregados devem corresponder exatamente aos nomes no campo criativo do seu arquivo de metadados (por exemplo, se o campo criativo contém Example.jpg, o arquivo criativo do ativo que você carregar também deve ser nomeado Example.jpg).

   • Mantenha pressionado Command ⌘ no macOS ou CTRL no PC para selecionar vários arquivos criativos do ativo para carregar ao mesmo tempo.

2. Selecionar Aceitar & Criar Anúncios. Uma vez que todos os ativos tenham sido carregados, eles aparecerão na Anúncios página.