Upload em massa 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 os ativos individualmente. Os campos de informação são semelhantes ao objeto Ads para ajudar você a coordenar quais informações vão em cada lugar.

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

• Um arquivo de metadados do ativo (CSV)
• Arquivos criativos (por exemplo, imagens ou vídeos)

1

Etapa 1: Prepare o arquivo de metadados do ativo

Há campos obrigatórios e valores aceitos para o arquivo CSV que você enviar. Seus ativos aparecerão exatamente como no seu arquivo, então qualquer espaço, pontuação ou caractere especial estará presente se forem usados. Para começar, copie o modelo de 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 os detalhes do formato do arquivo disponíveis na tela Upload em Massa para verificar suas entradas antes de enviar!

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

• Atualizações parciais são suportadas. Se você deixar uma célula em branco, esse campo será ignorado e seu valor existente permanecerá inalterado.
• Para limpar ou apagar um valor, digite explicitamente $CLEAR$ nessa célula. Isso remove qualquer valor armazenado anteriormente 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,,Exemplo de banner,Este é um exemplo de um novo anúncio em banner que você enviaria.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NovoBanner",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,Exemplo de link de texto,Este é um exemplo de atualização de um anúncio de link de texto.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,Clique aqui para saber mais!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,

• O CREATE a linha mostra um novo ativo de banner.
• O UPDATE a linha demonstra uma atualização parcial — somente os campos preenchidos serão atualizados.
• Se você quisesse limpar um valor (por exemplo, remover Etiquetas), você usaria $CLEAR$ nessa coluna.

Exemplo de limpeza de campos (CSV):

UPDATE,123456,Exemplo de link de texto,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

2

Etapa 2: 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. Selecione  Escolher arquivo, envie seu arquivo em massa e selecione Aberto.

   • Selecione  Mostrar/ocultar detalhes do formato do arquivo para ver informações sobre as colunas obrigatórias, suas descrições, valores aceitos e se elas são obrigatórias nos cabeçalhos de Ad e cabeçalhos de Deal referências abaixo.

Observação: A impact.com avisará você se houver algum erro no arquivo.

1. Selecione Próximo.

cabeçalhos de Ad

Nome da coluna	Descrição
Operação (String) Obrigatório - Sempre.	Operação a executar sobre os detalhes do ativo fornecidos. Valores permitidos: CREATE, UPDATE, DELETE.
ID do programa (Integer) Obrigatório - Sempre.	O ID exclusivo do programa na impact.com ao qual o ativo pertence. Esse valor não pode ser atualizado e deve corresponder ao programa no qual o upload em massa está sendo executado.
ID do anúncio (String) Obrigatório - Ao executar a operação sobre um ativo existente.	Identificador exclusivo da impact.com para o ativo. Deixe em branco ao criar um novo ativo. Obrigatório se Operação = UPDATE, DELETE.
Estado (String) Obrigatório - Não.	O estado do ativo. Valores permitidos: ACTIVE, PENDING, EXPIRED.
Nome (String) Obrigatório - Ao criar um ativo.	Nome do ativo. Obrigatório se Operação = CREATE.
Tipo de anúncio (String) Obrigatório - Ao criar um ativo.	Ao atualizar um anúncio existente, o tipo do anúncio não pode mudar. Obrigatório se Operação = CREATE. Valores permitidos: IMAGE, TEXT_LINK, COUPON.
Hospedado por (String) Obrigatório - Ao criar um ativo.	Onde o criativo do ativo está hospedado. Obrigatório se Operação = CREATE e Tipo de anúncio = IMAGE. Valores permitidos: IR, URL, HTML.
Criativo (String) Obrigatório - Ao criar um ativo de imagem.	Nome do arquivo criativo a ser enviado. Obrigatório se Operação = CREATE e Tipo de anúncio = IMAGE.
IabAdUnit (String) Obrigatório - Ao criar um ativo de imagem.	Tamanho padrão de ativo do IAB. Obrigatório se Operação = CREATE e Tipo de anúncio = IMAGE e Hospedado por != 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 (Integer) 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 (Integer) 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.
Idioma (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.
Data de término do período limitado (Date) Obrigatório - Se LimitedTimeStartDate for fornecido	Esta é uma data ISO8601. Exemplo de formato: 2013-06-30T00:00:00-07:00.
Texto do link (String) Obrigatório - Ao criar um ativo de link de texto ou cupom.	Texto real exibido para o link. Obrigatório se Operação = CREATE e Tipo de anúncio = TEXT_LINK ou COUPON.
Descrição Obrigatório - Não.	Descrição do ativo.
Etiquetas (string CSV) Obrigatório - Não.	Rótulos do ativo.
AllowDeepLinking (Boolean) Obrigatório - Não.	Determina se será permitida a vinculação para uma página mais profunda dentro do site do anunciante. Padrão para true.
AllowCustomPromoCode (Boolean) Obrigatório - Não.	Permite que o parceiro solicite seu próprio código promocional exclusivo para esta promoção. Padrão para false.
CustomisationCharge (Decimal 10.2) Obrigatório - Não.	Valor da taxa de personalizaçã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. Ela deve conter o protocolo da URL. Usa por padrão a página de destino padrão do programa quando um ativo é criado e isso não é fornecido.
iOSMobileFallbackAppId (String) Obrigatório - Não.	Especifique se o tráfego móvel deve fazer fallback para a página de destino do seu app iOS se nenhum app for 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 fazer fallback para a página de destino do seu app Android se nenhum app for 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 somente 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, OUTRO.
TopSeller (Boolean) Obrigatório - Não.	Mais vendido. Padrão para false.
ThirdPartyImpressionPixel (String) Obrigatório - Não.	HTML do pixel de impressão 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 grupos de parceiros separados por vírgula que devem ter acesso a este ativo.
Metadados (string CSV) Obrigatório - Não.	Parâmetros de query string separados por vírgula que serão anexados à URL de rastreamento.

cabeçalhos de Deal

Nome da coluna	Descrição
Nome do acordo (String) Obrigatório - Ao criar um novo acordo.	Nome do acordo a ser criado e vinculado ao ativo. Obrigatório se DealId não for fornecido.
Tipo de acordo (String) Obrigatório - Ao criar um novo acordo.	Tipo de acordo a criar. Obrigatório se DealId não for fornecido e DealName for. Valores permitidos: GENERAL_SALE,FREE_SHIPPING, GIFT_WITH_PURCHASE, REBATE, Compre um, leve outro grátis (BOGO), PRODUCT_LAUNCH.
Escopo do acordo (String) Obrigatório - Ao criar um novo acordo.	Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo != BOGO. Valores permitidos: ENTIRE_STORE, CATEGORY, PRODUCT, PRODUCTS.
Produtos do acordo (string CSV) Obrigatório - Ao criar um novo acordo.	Produtos do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, e Escopo do acordo = PRODUCT. Valores permitidos: Opção 1: lista de nomes de produtos, por exemplo "Product1, Product2". Opção 2: lista de pares de valores do produto, por exemplo "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" em que vários 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: nome - nome do produto, imagem - nome do arquivo de imagem do produto que você pretende enviar na segunda etapa do upload em massa, limite - quantidade permitida, regularPrice - preço antes do desconto, dealPrice - preço após o desconto.
Categorias do acordo (string CSV) Obrigatório - Ao criar um novo acordo.	Categorias do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, e Escopo do acordo = CATEGORY.
DealLandingPage (String) Obrigatório - Não	A URL da página de destino para este acordo. Se deixada em branco ao criar um novo acordo, será usada a página de destino padrão do programa.
DealMetadata (CSV String) Obrigatório - Não	Parâmetros de query string separados por vírgula para o link de rastreamento do acordo. Se deixados em branco, nenhum parâmetro extra será adicionado.
DealAllowDeepLinking (Boolean) Obrigatório - Não	Determina se o deeplinking é permitido para a página de destino do acordo. Se deixado em branco, o padrão será FALSE.
Tipo de desconto do acordo (string CSV) Obrigatório - Ao criar um novo acordo.	Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = GENERAL_SALE. Valores permitidos: FIXED, PERCENT, PERCENT_RANGE, PERCENT_MAXIMUM.
DealDiscountAmount (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Valor do desconto da promoção. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = GENERAL_SALE, e Tipo de desconto do acordo = FIXED.
DealDiscountPercent (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Percentual de desconto da promoção. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = GENERAL_SALE, e Tipo de desconto do acordo = PERCENT.
DealDiscountStartPercent (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Percentual inicial da faixa de desconto do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = GENERAL_SALE, e Tipo de desconto do acordo = PERCENT_RANGE.
DealDiscountEndPercent (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Percentual inicial da faixa de desconto do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = GENERAL_SALE, e Tipo de desconto do acordo = PERCENT_RANGE.
DealDiscountMaximumPercent (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Percentual máximo de desconto do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = GENERAL_SALE, e Tipo de desconto do acordo = PERCENT_MAXIMUM.
DealGift (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Detalhes do brinde. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = GIFT_WITH_PURCHASE.
DealRebate (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Valor do reembolso. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = REBATE.
DealMinimumPurchaseAmount (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Valor mínimo de compra do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealMaximumSavingsAmount (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Valor máximo de economia do acordo. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealBogoPurchaseLimit (Integer) Obrigatório - Ao criar um novo acordo.	Quantidade máxima de itens permitidos a este preço. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealBogoBuyQty (Integer) Obrigatório - Ao criar um novo acordo.	Quantidade de compra do BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealBogoBuyType (String) Obrigatório - Ao criar um novo acordo.	Tipo de item de compra do BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO). Valores permitidos: PRODUCT, CATEGORY.
DealBogoBuyName (String) Obrigatório - Ao criar um novo acordo.	Nome do produto ou categoria comprada. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealBogoGetQty (Integer) Obrigatório - Ao criar um novo acordo.	Quantidade recebida no BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealBogoGetType (String) Obrigatório - Ao criar um novo acordo.	Tipo de item recebido no BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO). Valores permitidos: PRODUCT, CATEGORY.
DealBogoGetName (String) Obrigatório - Ao criar um novo acordo.	Nome do produto ou categoria obtido. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO).
DealBogoGetDiscountType (String) Obrigatório - Ao criar um novo acordo.	Tipo de desconto da oferta BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, e Tipo de acordo = Compre um, leve outro grátis (BOGO). Valores permitidos: GRÁTIS, VALOR, PERCENT.
DealBogoGetDiscountAmount (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Valor do desconto da oferta BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = Compre um, leve outro grátis (BOGO), e DealBogoGetDiscountType = VALOR.
DealBogoGetDiscountPercent (Decimal 10.2) Obrigatório - Ao criar um novo acordo.	Percentual de desconto da oferta BOGO. Obrigatório se DealId não for fornecido, Nome do acordo for, Tipo de acordo = Compre um, leve outro grátis (BOGO), e DealBogoGetDiscountType = PERCENT.
DealId (String) Obrigatório - Não.	Identificador exclusivo do impact.com para o qual o ativo será vinculado.
DealDefaultDiscountCode (String) Obrigatório - Não.	Código de desconto padrão da oferta.
DealSyncAdsPromoCodes (Boolean) Obrigatório - Não.	Mantenha anúncios e códigos promocionais associados sincronizados com esta oferta. A sincronização se aplica a datas de prazo limitado, acesso restrito de parceiros e estado.

3

Etapa 3: Envie os arquivos criativos do ativo

Em seguida, você precisará deixar prontos os arquivos criativos do seu ativo para que possam ser enviados.

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

   • Mantenha pressionado Command ⌘ no macOS ou CTRL no PC para selecionar vários arquivos criativos do ativo para enviar de uma vez.
2. Selecione Aceitar e criar anúncios. Depois que todos os ativos tiverem sido enviados, eles aparecerão em Anúncios página.