Upload em Lote de Ativos

Use a ferramenta de uploads em massa para enviar vários ativos de uma vez usando um arquivo CSV, em vez de enviar ativos individualmente. Os campos de informação são semelhantes ao Ads API para ajudá-lo a coordenar qual informação vai para onde.

Você precisará de dois arquivos para executar um upload em massa de anúncios:

• Um arquivo de metadados dos ativos

• Os arquivos criativos dos ativos, que normalmente são imagens

1

Passo 1: Prepare o Arquivo de Metadados dos Anúncios

Existem campos obrigatórios e valores aceitos para o arquivo CSV que você envia. Seus ativos aparecerão exatamente como seu arquivo, então quaisquer espaços, 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 ou baixe-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,AndroidMobileFallbackAddId,Language,LimitedTimeStartDate,LimitedTimeEndDate,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes

Importante: Recomendamos usar o Formato de arquivo detalhes disponíveis no Upload em Massa para verificar suas entradas antes de enviar!

2

Passo 2: Exemplo de Arquivo de Metadados

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,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",,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Text Link Example,This is an example of updating a text link ad.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Click here for more!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

• A CREATE linha mostra um novo ativo de banner.

• A UPDATE linha demonstra uma atualização parcial — somente os campos preenchidos serão atualizados.

• Se você quiser limpar um valor (por exemplo, remover Labels), você usaria $CLEAR$ nessa coluna.

Exemplo de campos sendo limpos (CSV):

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

3

Passo 3: Envie 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 Upload em Massa.

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

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

     Importante: impact.com alertará você se houver quaisquer erros no arquivo.

colunas de 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, DELETE.
ProgramId (Inteiro) Obrigatório - Sempre.	O ID único do Programa impact.com ao qual o ativo pertence. Este valor não pode ser atualizado e deve corresponder ao programa no qual o upload em massa está sendo executado.
AdID (String) Obrigatório - Ao executar operação sobre um ativo existente.	Identificador único do impact.com para o ativo. Deixe vazio ao criar um novo ativo. Obrigatório se Operação = UPDATE, DELETE.
State (String) Obrigatório - Não.	O estado do ativo. Valores permitidos: ACTIVE, PENDING, EXPIRED.
Name (String) Obrigatório - Ao criar um ativo.	Nome do ativo. Obrigatório se Operação = CREATE.
AdType (String) Obrigatório - Ao criar um ativo.	Ao atualizar um anúncio existente, o tipo de anúncio pode não ser alterado. Obrigatório se Operação = CREATE. Valores permitidos: IMAGE, TEXT_LINK, COUPON.
HostedBy (String) Obrigatório - Ao criar um ativo.	Onde o criativo do ativo está hospedado. Obrigatório se Operação = CREATE e AdType = IMAGE. Valores permitidos: IR, URL, HTML.
Creative (String) Obrigatório - Ao criar um ativo de imagem.	Nome do arquivo criativo a ser enviado. Obrigatório se Operação = CREATE e AdType = IMAGE.
IabAdUnit (String) Obrigatório - Ao criar um ativo de imagem.	Tamanho padrão IAB do ativo. Obrigatório se Operação = CREATE e AdType = IMAGE e HostedBy != IR. Valores permitidos: UNKNOWN, MEDIUM_RECTANGLE, SQUARE_POP_UP, VERTICAL_RECTANGLE, LARGE_RECTANGLE, RECTANGLE, RECTANGLE_3_1_, POP_UNDER, FULL_BANNER, HALF_BANNER, MICRO_BANNER, BUTTON_1, BUTTON_2, VERTICAL_BANNER, SQUARE_BUTTON, LEADERBOARD, WIDE_SKYSCRAPER, SKYSCRAPER, HALF_PAGE_AD, CUSTOM.
ThirdPartyServableAdCreativeHeight (Inteiro) Obrigatório - Ao criar um ativo de imagem.	Altura da imagem servível por terceiros, em pixels. Obrigatório se Operação = CREATE e IabAdUnit = CUSTOM.
ThirdPartyServableAdCreativeWidth (Inteiro) Obrigatório - Ao criar um ativo de imagem.	Largura da imagem servível por terceiros, em pixels. Obrigatório se Operação = CREATE e IabAdUnit = CUSTOM.
Language (String) Obrigatório - Ao criar um ativo.	Valores permitidos: AFRIKAANS, ARABIC, BULGARIAN, CHINESE, CHINESE_TRADITIONAL, CZECH, DANISH, DUTCH, ENGLISH, ENGLISH_GB, ENGLISH_AU, ENGLISH_CA, ENGLISH_NZ, ENGLISH_ZA, ESTONIAN, FILIPINO, FINISH, FRENCH, FRENCH_CA, GERMAN, HEBREW, HINDI, INDONESIAN, ITALIAN, JAPANESE, KOREAN, LATVIAN, LITHUANIAN, MALAY, MALTESE, NORWEGIAN, PORTUGUESE, PORTUGUESE_BR, POLISH, RUSSIAN, SLOVENIAN, SPANISH, SPANISH_MX, SWEDISH, THAI, TURKISH, VIETNAMESE.
LimitedTimeEndDate (Date) Obrigatório - Se LimitedTimeStartDate for fornecido	Esta é uma data ISO8601. Exemplo de formato: 2013-06-30T00:00:00-07:00.
LinkText (String) Obrigatório - Ao criar um link de texto ou cupom.	Texto real exibido para o link. Obrigatório se Operação = CREATE e AdType = TEXT_LINK ou COUPON.
Descrição Obrigatório - Não.	Descrição do ativo.
Labels (string CSV) Obrigatório - Não.	Rótulos do ativo.
AllowDeepLinking (Booleano) Obrigatório - Não.	Determina se será permitido vincular para uma página mais profunda dentro do site do anunciante. Padrão para true.
AllowCustomPromoCode (Booleano) Obrigatório - Não.	Permitir 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 para usar 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 quando não fornecida.
iOSMobileFallbackAppId (String) Obrigatório - Não.	Especifique se o tráfego móvel deve reencaminhar para sua página de destino do aplicativo 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 aplicativo 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. Exemplo de formato: 2013-06-30T00:00:00-07:00.
FallbackAd (String) Obrigatório - Não.	Especifique um ID de ativo de fallback, aplicável apenas a IMAGE ativos.
GetHtmlCodeType (String) Obrigatório - Não.	Valores permitidos: IFRAME_ONLY, HTML_AND_IFRAME.
Season (String) Obrigatório - Não.	Valores permitidos: WINTER, SPRING, SUMMER, FALL, NEW_YEAR, PRESIDENTS_DAY, VALENTINES_DAY, ST_PATRICKS_DAY, EASTER, MOTHERS_DAY, MEMORIAL_DAY, FATHERS_DAY, INDEPENDANCE_DAY, BACK_TO_SCHOOL, LABOR_DAY, HALLOWEEN, THANKSGIVING, BLACK_FRIDAY, CYBER_MONDAY, HANUKKAH, CHRISTMAS, FAMILY_DAY, GOOD_FRIDAY, VICTORIA_DAY, CANADA_DAY, AUGUST_CIVIC_HOLIDAY, REMEMBRANCE_DAY, BOXING_DAY, AUSTRALIA_DAY, ANZAC_DAY, QUEENS_BIRTHDAY, END_OF_FINANCIAL_YEAR, WAITANGI_DAY, OTHER.
TopSeller (Booleano) Obrigatório - Não.	Mais Vendido. Padrão para false.
ThirdPartyImpressionPixel (String) Obrigatório - Não.	Pixel de impressão em 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 de cabeçalho de 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: GENERAL_SALE,FREE_SHIPPING, GIFT_WITH_PURCHASE, REBATE, BOGO, PRODUCT_LAUNCH.
DealScope (String) Obrigatório - Ao criar uma nova oferta.	Obrigatório se DealId não for fornecido, DealName for, e DealType != BOGO. Valores permitidos: ENTIRE_STORE, CATEGORY, PRODUCT, PRODUCTS.
DealProducts (string CVS) Obrigatório - Ao criar uma nova oferta.	Produtos da oferta. Obrigatório se DealId não for fornecido, DealName for, e DealScope = PRODUCT. Valores permitidos: Opção 1: lista de nomes de produtos, ex.: "Product1, Product2". Opção 2: lista de pares de valores do produto, ex.: "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" 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 do arquivo que você pretende enviar no passo dois do upload em massa, limit - quantidade permitida, regularPrice - preço antes do desconto, dealPrice - preço após desconto.
DealCategories (string CSV) Obrigatório - Ao criar uma nova oferta.	Categorias da oferta. Obrigatório se DealId não for fornecido, DealName for, e DealScope = CATEGORY.
DealDiscountType (string CSV) Obrigatório - Ao criar uma nova oferta.	Obrigatório se DealId não for fornecido, DealName for, e DealType = GENERAL_SALE. Valores permitidos: FIXED, PERCENT, PERCENT_RANGE, PERCENT_MAXIMUM.
DealDiscountAmount (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor do desconto da venda. Obrigatório se DealId não for fornecido, DealName for, DealType = GENERAL_SALE, e DealDiscountType = FIXED.
DealDiscountPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual de desconto da venda. Obrigatório se DealId não for fornecido, DealName for, DealType = GENERAL_SALE, e DealDiscountType = PERCENT.
DealDiscountStartPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual inicial do intervalo de desconto. Obrigatório se DealId não for fornecido, DealName for, DealType = GENERAL_SALE, e DealDiscountType = PERCENT_RANGE.
DealDiscountEndPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual inicial do intervalo de desconto. Obrigatório se DealId não for fornecido, DealName for, DealType = GENERAL_SALE, e DealDiscountType = PERCENT_RANGE.
DealDiscountMaximumPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual máximo de desconto da oferta. Obrigatório se DealId não for fornecido, DealName for, DealType = GENERAL_SALE, e DealDiscountType = PERCENT_MAXIMUM.
DealGift (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Detalhes do presente. Obrigatório se DealId não for fornecido, DealName for, e DealType = GIFT_WITH_PURCHASE.
DealRebate (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor do reembolso. Obrigatório se DealId não for fornecido, DealName for, 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 for fornecido, DealName for, 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 for fornecido, DealName for, e DealType = BOGO.
DealBogoPurchaseLimit (Inteiro) Obrigatório - Ao criar uma nova oferta.	Quantidade máxima de itens permitidos a este preço. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO.
DealBogoBuyQty (Inteiro) Obrigatório - Ao criar uma nova oferta.	Quantidade de compra BOGO. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO.
DealBogoBuyType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de item de compra BOGO. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO. Valores permitidos: PRODUCT, CATEGORY.
DealBogoBuyName (String) Obrigatório - Ao criar uma nova oferta.	Nome do produto ou categoria de compra. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO.
DealBogoGetQty (Inteiro) Obrigatório - Ao criar uma nova oferta.	Quantidade de 'ganhe' BOGO. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO.
DealBogoGetType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de item 'ganhe' BOGO. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO. Valores permitidos: PRODUCT, CATEGORY.
DealBogoGetName (String) Obrigatório - Ao criar uma nova oferta.	Nome do produto ou categoria 'ganhe'. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO.
DealBogoGetDiscountType (String) Obrigatório - Ao criar uma nova oferta.	Tipo de desconto da oferta BOGO. Obrigatório se DealId não for fornecido, DealName for, e DealType = BOGO. Valores permitidos: FREE, AMOUNT, PERCENT.
DealBogoGetDiscountAmount (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Valor do desconto da oferta BOGO. Obrigatório se DealId não for fornecido, DealName for, DealType = BOGO, e DealBogoGetDiscountType = AMOUNT.
DealBogoGetDiscountPercent (Decimal 10.2) Obrigatório - Ao criar uma nova oferta.	Percentual do desconto da oferta BOGO. Obrigatório se DealId não for fornecido, DealName for, DealType = BOGO, e DealBogoGetDiscountType = PERCENT.
DealId (String) Obrigatório - Não.	Identificador único do 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.	Manter anúncios associados e códigos promocionais sincronizados com esta oferta. A sincronização se aplica às datas de tempo limitado, acesso restrito de parceiros e estado.

1. Selecionar Próximo.

4

Passo 4: Envie os Arquivos Criativos do Ativo

Em seguida, você precisará ter seus arquivos criativos do ativo prontos para que possam ser enviados.

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

   • Segure Command ⌘ no macOS ou CTRL no PC para selecionar vários arquivos criativos de anúncios para enviar de uma vez.

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