Caricamento Massivo di Asset

Usa lo strumento di caricamenti massivi per caricare più risorse contemporaneamente usando un file CSV, anziché caricare le risorse singolarmente. I campi informativi sono simili al Ads APIarrow-up-right per aiutarti a coordinare quali informazioni vanno dove.

Avrai bisogno di due file per eseguire un caricamento massivo di annunci:

  • Un file di metadati delle risorse

  • I file creativi delle risorse, che sono tipicamente immagini

1

Passaggio 1: Preparare il file di metadati degli annunci

Ci sono campi obbligatori e valori accettati per il file CSV che carichi. Le tue risorse appariranno esattamente come nel file, quindi eventuali spazi, segni di punteggiatura o caratteri speciali saranno presenti se utilizzati. Per iniziare, copia il modello CSV mostrato di seguito e incollalo in un'applicazione per fogli di calcolo oppure scaricalo quiarrow-up-right e importalo direttamente.

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
circle-exclamation
2

Passaggio 2: Esempio di file di metadati

Prima di creare o aggiornare risorse usando un file di metadati, nota i seguenti punti importanti sugli aggiornamenti parziali:

  • Gli aggiornamenti parziali sono supportati. Se lasci una cella vuota, quel campo verrà ignorato e il suo valore esistente rimarrà invariato.

  • Per cancellare o eliminare un valore, inserisci esplicitamente $CLEAR$ in quella cella. Questo rimuove qualsiasi valore precedentemente memorizzato per quel 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!,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
  • La CREATE riga mostra una nuova risorsa banner.

  • La UPDATE riga dimostra un aggiornamento parziale — verranno aggiornati solo i campi popolati.

  • Se volessi cancellare un valore (per esempio, rimuovere Etichette), useresti $CLEAR$ in quella colonna.

Esempio di cancellazione campi (CSV):

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

Passaggio 3: Carica il file di metadati delle risorse

  1. Dalla barra di navigazione a sinistra, seleziona [Engage] v2 [Engage]ContenutoAnnunciarrow-up-right.

  2. Nell'angolo in alto a destra, seleziona caricamento massivo.

  3. Seleziona  Scegli file, carica il tuo file massivo e seleziona Apri.

    • Seleziona  Mostra/nascondi dettagli del formato file per visualizzare informazioni sulle colonne richieste, le loro descrizioni, i valori accettati e se sono obbligatorie nelle colonne intestazione annuncio e colonne intestazione offerta riferimenti qui sotto.

      circle-exclamation
chevron-rightcolonne intestazione annunciohashtag
Nome colonna
Descrizione

Operazione (Stringa)

Obbligatorio - Sempre.

Operazione da eseguire sui dettagli dell'asset forniti.

Valori consentiti:

CREATE, UPDATE, ELIMINA.

ProgramId (Intero)

Obbligatorio - Sempre.

L'ID programma univoco di impact.com a cui appartiene la risorsa. Questo valore non può essere aggiornato e deve corrispondere al programma in cui viene eseguito il caricamento massivo.

AdID (Stringa)

Obbligatorio - Quando si esegue l'operazione su un'asset esistente.

Identificatore univoco impact.com per la risorsa. Lascia vuoto quando crei una nuova risorsa. Obbligatorio se Operazione = UPDATE, ELIMINA.

Stato (Stringa)

Obbligatorio - No.

Lo stato della risorsa.

Valori consentiti:

ATTIVO, IN ATTESA, SCADUTO.

Nome (Stringa)

Obbligatorio - Quando si crea una risorsa.

Nome della risorsa. Obbligatorio se Operazione = CREATE.

TipoAnnuncio (Stringa)

Obbligatorio - Quando si crea una risorsa.

Quando si aggiorna un annuncio esistente, il tipo di annuncio potrebbe non cambiare.

Obbligatorio se Operazione = CREATE.

Valori consentiti:

IMMAGINE, TESTO_LINK, COUPON.

HostedBy (Stringa)

Obbligatorio - Quando si crea una risorsa.

Dove è ospitata la creatività della risorsa. Obbligatorio se

Operazione = CREATE e TipoAnnuncio = IMMAGINE.

Valori consentiti:

IR, URL, HTML.

Creativo (Stringa)

Obbligatorio - Quando si crea una risorsa immagine.

Nome del file creativo da caricare. Obbligatorio se

Operazione = CREATE e TipoAnnuncio = IMMAGINE.

IabAdUnit (Stringa)

Obbligatorio - Quando si crea una risorsa immagine.

Dimensione standard IAB dell'asset. Obbligatorio se Operazione =

CREATE e TipoAnnuncio = IMMAGINE e HostedBy != IR.

Valori consentiti: SCONOSCIUTO, Rettangolo medio, Finestra quadrata pop-up, Rettangolo verticale, Rettangolo grande, Rettangolo, Rettangolo 3:1, POP_UNDER, BANNER_COMPLETO, MEZZO_BANNER, MICRO_BANNER, PULSANTE_1, PULSANTE_2, BANNER_VERTICALE, PULSANTE_QUADRATO, LEADERBOARD, WIDE_SKYSCRAPER, SKYSCRAPER, HALF_PAGE_AD, PERSONALIZZATO.

ThirdPartyServableAdCreativeHeight (Intero)

Obbligatorio - Quando si crea una risorsa immagine.

Altezza dell'immagine servibile di terze parti, in pixel.

Obbligatorio se Operazione = CREATE e IabAdUnit =

PERSONALIZZATO.

ThirdPartyServableAdCreativeWidth (Intero)

Obbligatorio - Quando si crea una risorsa immagine.

Larghezza dell'immagine servibile di terze parti, in pixel.

Obbligatorio se Operazione = CREATE e IabAdUnit =

PERSONALIZZATO.

Lingua (Stringa)

Obbligatorio - Quando si crea una risorsa.

Valori consentiti:

AFRICAANS, ARABO, BULGARO, CINESE, CINESE_TRADIZIONALE, CECO, DANESE, OLLANDESE, INGLESE, INGLESE_GB, INGLESE_AU, INGLESE_CA, INGLESE_NZ, INGLESE_ZA, ESTONE, FILIPPINO, FINLANDESE, FRANCESE, FRANCESE_CA, TEDESCO, EBRAICO, HINDI, INDONESIANO, ITALIANO, GIAPPONESE, COREANO, LETTO, LITUANO, MALAY, MALTESE, NORVEGESE, PORTOGHESE, PORTOGHESE_BR, POLACCO, RUSSO, SLOVENO, SPAGNOLO, SPAGNOLO_MX, SVEDESE, THAI, TURCO, VIETNAMITA.

LimitedTimeEndDate (Data)

Obbligatorio - Se viene fornita LimitedTimeStartDate

Questa è una data ISO8601. Esempio di formato: 2013-06-30T00:00:00-07:00.

TestoLink (Stringa)

Obbligatorio - Quando si crea un link testuale o una risorsa coupon.

Testo effettivamente visualizzato per il link. Obbligatorio se Operazione = CREATE e TipoAnnuncio = TESTO_LINK o COUPON.

Descrizione

Obbligatorio - No.

Descrizione della risorsa.

Etichette (stringa CSV)

Obbligatorio - No.

Etichette della risorsa.

AllowDeepLinking (Booleano)

Obbligatorio - No.

Determina se sarà consentito il collegamento a una pagina più profonda all'interno del sito dell'inserzionista.

Impostazione predefinita vero.

AllowCustomPromoCode (Booleano)

Obbligatorio - No.

Consente al Partner di richiedere il proprio codice promozionale unico per questa promozione.

Impostazione predefinita falso.

CustomisationCharge (Decimale 10.2)

Obbligatorio - No.

Importo della commissione di personalizzazione della risorsa.

ImageAlternativeTag (Stringa)

Obbligatorio - No.

Tag alternativo da usare nel codice della risorsa immagine.

LandingPage (Stringa)

Obbligatorio - No.

L'URL della pagina di destinazione. Deve contenere il protocollo URL.

Di default utilizza la pagina di destinazione predefinita del programma quando si crea una risorsa e non viene fornita.

iOSMobileFallbackAppId (Stringa)

Obbligatorio - No.

Specifica se il traffico mobile deve ricadere sulla pagina di destinazione della tua app iOS se non viene rilevata alcuna app. L'ID dell'app deve corrispondere all'ID sistema dell'app.

AndroidMobileFallbackAppId (Stringa)

Obbligatorio - No.

Specifica se il traffico mobile deve ricadere sulla pagina di destinazione della tua app Android se non viene rilevata alcuna app. L'ID dell'app deve corrispondere all'ID sistema dell'app.

LimitedTimeStartDate (Stringa)

Obbligatorio - No.

Questa è una data ISO8601. Esempio di formato: 2013-06-30T00:00:00-07:00.

FallbackAd (Stringa)

Obbligatorio - No.

Specifica un ID risorsa di fallback, applicabile solo agli IMMAGINE asset.

GetHtmlCodeType (Stringa)

Obbligatorio - No.

Valori consentiti: SOLO_IFRAME, HTML_E_IFRAME.

Stagione (Stringa)

Obbligatorio - No.

Valori consentiti:

INVERNO, PRIMAVERA, ESTATE, AUTUNNO, CAPODANNO, GIORNO_DEI_PRESIDENTI, SAN_VALENTINO, SAN_PATRIZIO, PASQUA, FESTA_DELLA_MAMMA, MEMORIAL_DAY, FESTA_DEL_PADRE, GIORNO_DELLA_INDEPENDENZA, RITORNO_A_SCUOLA, FESTA_DEI_LAVORATORI, HALLOWEEN, GRAZIE, VENERDÌ_NERO, LUNEDÌ_CIBERNETICO, HANUKKAH, NATALE, FESTA_DELLA_FAMIGLIA, VENERDÌ_SANTO, GIORNO_DI_VICTORIA, GIORNO_DEL_CANADA, FESTIVITÀ_CIVICA_AGOSTO, GIORNO_DEL_RICORDO, SANTO_STEFANO, GIORNO_DELL_AUSTRALIA, GIORNO_ANZAC, COMPLEANNO_DELLA_REGINA, FINE_ESERCIZIO, GIORNO_DI_WAITANGI, ALTRO.

TopSeller (Booleano)

Obbligatorio - No.

Top Seller. Impostazione predefinita falso.

ThirdPartyImpressionPixel (Stringa)

Obbligatorio - No.

HTML del pixel di impression di terze parti da usare con questa risorsa.

RestrictedToPartners (stringa CSV)

Obbligatorio - No.

ID Partner separati da virgola che dovrebbero avere accesso a questa risorsa.

RestrictedToGroups (stringa CSV)

Obbligatorio - No.

ID Gruppo Partner separati da virgola che dovrebbero avere accesso a questa risorsa.

Metadata (stringa CSV)

Obbligatorio - No.

Parametri della query string separati da virgola che saranno aggiunti all'URL di tracciamento.

chevron-rightcolonne intestazione offertahashtag
Nome colonna
Descrizione

DealName (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Nome dell'offerta da creare e collegare alla risorsa. Obbligatorio se DealId non è fornito.

DealType (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Tipo di offerta da creare. Obbligatorio se DealId non è fornito e DealName lo è.

Valori consentiti:

SALDO_GENERALE,SPEDIZIONE_GRATUITA, REGALO_CON_ACQUISTO, RIMBORSO, BOGO, LANCIO_PRODOTTO.

DealScope (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Obbligatorio se DealId non è fornito, DealName è, e DealType != BOGO.

Valori consentiti:

INTERO_NEG0ZIO, CATEGORIA, PRODOTTO, PRODOTTI.

DealProducts (stringa CVS)

Obbligatorio - Quando si crea una nuova offerta.

Prodotti dell'offerta. Obbligatorio se DealId non è fornito, DealName è, e DealScope = PRODOTTO.

Valori consentiti:

Opzione 1: elenco di nomi di prodotto es. "Product1, Product2".

Opzione 2: elenco di coppie di valori del prodotto es. "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" dove i prodotti multipli sono separati da virgola e i vari campi del prodotto sono separati da punto e virgola.

Campi validi: nome - nome del prodotto, immagine - nome file dell'immagine del prodotto del file che intendi caricare nel secondo passaggio del caricamento massivo, limite - quantità consentita, prezzoRegular - prezzo prima dello sconto, prezzoOfferta - prezzo dopo lo sconto.

DealCategories (stringa CSV)

Obbligatorio - Quando si crea una nuova offerta.

Categorie dell'offerta. Obbligatorio se DealId non è fornito, DealName è, e DealScope = CATEGORIA.

DealDiscountType (stringa CSV)

Obbligatorio - Quando si crea una nuova offerta.

Obbligatorio se DealId non è fornito, DealName è, e DealType = SALDO_GENERALE.

Valori consentiti:

FISSO, PERCENTUALE, INTERVALLO_PERCENTUALE, PERCENTUALE_MASSIMA.

DealDiscountAmount (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Importo dello sconto in vendita. Obbligatorio se DealId non è fornito, DealName è, DealType = SALDO_GENERALE, e DealDiscountType = FISSO.

DealDiscountPercent (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Percentuale dello sconto in vendita. Obbligatorio se DealId non è fornito, DealName è, DealType = SALDO_GENERALE, e DealDiscountType = PERCENTUALE.

DealDiscountStartPercent (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Percentuale di inizio dell'intervallo di sconto. Obbligatorio se DealId non è fornito, DealName è, DealType = SALDO_GENERALE, e DealDiscountType = INTERVALLO_PERCENTUALE.

DealDiscountEndPercent (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Percentuale di inizio dell'intervallo di sconto. Obbligatorio se DealId non è fornito, DealName è, DealType = SALDO_GENERALE, e DealDiscountType = INTERVALLO_PERCENTUALE.

DealDiscountMaximumPercent (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Percentuale massima di sconto. Obbligatorio se DealId non è fornito, DealName è, DealType = SALDO_GENERALE, e DealDiscountType = PERCENTUALE_MASSIMA.

DealGift (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Dettagli del regalo. Obbligatorio se DealId non è fornito, DealName è, e DealType = REGALO_CON_ACQUISTO.

DealRebate (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Importo del rimborso. Obbligatorio se DealId non è fornito, DealName è, e DealType = RIMBORSO.

DealMinimumPurchaseAmount (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Importo minimo di acquisto per l'offerta. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealMaximumSavingsAmount (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Importo massimo di risparmio dell'offerta. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealBogoPurchaseLimit (Intero)

Obbligatorio - Quando si crea una nuova offerta.

Quantità massima di articoli consentiti a questo prezzo. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealBogoBuyQty (Intero)

Obbligatorio - Quando si crea una nuova offerta.

Quantità di acquisto BOGO. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealBogoBuyType (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Tipo di articolo da acquistare BOGO. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

Valori consentiti:

PRODOTTO, CATEGORIA.

DealBogoBuyName (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Nome del prodotto o della categoria di acquisto. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealBogoGetQty (Intero)

Obbligatorio - Quando si crea una nuova offerta.

Quantità da ottenere BOGO. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealBogoGetType (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Tipo di articolo da ottenere BOGO. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

Valori consentiti:

PRODOTTO, CATEGORIA.

DealBogoGetName (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Nome del prodotto o della categoria da ottenere. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

DealBogoGetDiscountType (Stringa)

Obbligatorio - Quando si crea una nuova offerta.

Tipo di sconto per l'offerta BOGO. Obbligatorio se DealId non è fornito, DealName è, e DealType = BOGO.

Valori consentiti:

GRATUITO, IMPORTO, PERCENTUALE.

DealBogoGetDiscountAmount (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Importo dello sconto per l'offerta BOGO. Obbligatorio se DealId non è fornito, DealName è, DealType = BOGO, e DealBogoGetDiscountType = IMPORTO.

DealBogoGetDiscountPercent (Decimale 10.2)

Obbligatorio - Quando si crea una nuova offerta.

Percentuale di sconto per l'offerta BOGO. Obbligatorio se DealId non è fornito, DealName è, DealType = BOGO, e DealBogoGetDiscountType = PERCENTUALE.

DealId (Stringa)

Obbligatorio - No.

Identificatore univoco impact.com per l'offerta a cui la risorsa sarà collegata.

DealDefaultDiscountCode (Stringa)

Obbligatorio - No.

Codice sconto predefinito dell'offerta.

DealSyncAdsPromoCodes (Booleano)

Obbligatorio - No.

Mantieni annunci e codici promozionali associati sincronizzati con questa offerta. La sincronizzazione si applica a date a tempo limitato, accesso partner limitato e stato.

  1. Seleziona Avanti.

4

Passaggio 4: Carica i file creativi delle risorse

Successivamente, avrai bisogno dei file creativi delle risorse pronti in modo che possano essere caricati.

  1. Nella Specifica immagini pagina, seleziona Scegli file per caricare in massa i file creativi delle risorse. I nomi dei file caricati devono corrispondere esattamente ai nomi presenti nel campo creativo del tuo file di metadati (per esempio, se il campo creativo contiene Example.jpg, il file creativo della risorsa che carichi dovrebbe essere chiamato anch'esso Example.jpg.)

    • Tieni premuto Command ⌘ su macOS o CTRL su PC per selezionare più file creativi di annunci da caricare contemporaneamente.

  2. Seleziona Accetta e crea annunci. Una volta che tutti gli annunci sono stati caricati, appariranno nella Annunciarrow-up-right pagina.

Ultimo aggiornamento

È stato utile?