> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1.md). # Campagna Banner X Banner X offre annunci banner responsive e multicomponente che migliorano l'esperienza di acquisto online integrandosi perfettamente nei siti web dei retailer. Epsilon Retail Media fornisce i componenti, mentre il frontend del retailer gestisce lo stile per garantire la coerenza con il design e-commerce del sito. Questo approccio aiuta a mantenere l'integrità del brand coinvolgendo al tempo stesso i clienti in modo efficace.
## Vantaggi principali * **Integrazione nativa**: gli annunci si inseriscono in modo naturale all'interno dei caroselli di prodotti, mantenendo lo stile del sito. * **Personalizzazione**: eroga annunci personalizzati in tempo reale, adattati agli interessi dell'utente. * **Coinvolgimento avanzato**: migliora la visibilità dei prodotti, stimola il coinvolgimento dei clienti e aumenta le vendite con CTA efficaci. ## Banner X componenti Comprendi i componenti del banner X per garantire che il tuo design sia conforme agli standard del retailer. Ogni componente è essenziale per mantenere la funzionalità e la coerenza visiva. ### Immagine di sfondo primaria Lo sfondo primario è uno sfondo semplice che garantisce chiarezza di design e coerenza tra i vari dispositivi. Evita di incorporare immagini di prodotti o contenuti troppo invadenti per prevenire problemi di ritaglio, specialmente su dispositivi e larghezze di browser differenti. Le sei configurazioni disponibili per lo sfondo primario sono: * Ripetuto * Riempimento * Allineato in alto * Allineato in basso * Allineato a destra * Allineato a sinistra
### Immagine di sfondo secondaria Utilizza l'immagine di sfondo secondaria per aggiungere elementi decorativi al tuo banner. Le sei configurazioni disponibili per il banner secondario sono: * Ripetuto * Riempimento * Allineato in alto * Allineato in basso * Allineato a destra * Allineato a sinistra ### Testo del banner Il testo del banner è il testo visualizzato sull'annuncio banner, che supporta tag HTML limitati come `strong` per il grassetto e `i` per il corsivo. Puoi anche personalizzare il colore del testo. Ad esempio,
### Immagine Hero L'immagine Hero è l'immagine promozionale principale, in genere utilizzata per mostrare il prodotto o il logo. Le due configurazioni disponibili per l'immagine Hero sono: * Orizzontale * Verticale
### Immagine Hero secondaria Utilizza l'immagine Hero secondaria per mostrare il tuo prodotto o logo. Le due configurazioni disponibili sono: * Orizzontale * Blocco (un'immagine con la stessa larghezza e altezza)
### Invito all'azione (CTA) Un invito all'azione (CTA) è un testo o un pulsante cliccabile che sollecita gli utenti ad agire, ad esempio effettuando un acquisto o visitando un'altra pagina. Le CTA devono essere chiare, orientate all'azione e visivamente evidenti per aumentare il coinvolgimento. Ad esempio, "Acquista ora" incoraggia gli acquisti.
## Tipi di posizionamento degli annunci Banner X supporta diversi posizionamenti strategici [posizionamenti degli annunci](https://developers.citrusad.com/integration/docs/introduction-to-placement-types) sui siti web dei retailer, tra cui: * **Ricerca**: mostra gli annunci quando i clienti inseriscono nella campagna i termini di ricerca configurati, come ad esempio cioccolato. Per ulteriori informazioni, consulta [Posizionamenti di ricerca](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#search). * **Categoria**: mostra gli annunci nelle pagine di categoria relative al tuo prodotto. Targettizza categorie specifiche fornendo i dettagli di tassonomia rilevanti, come ad esempio `Category:Cupboard/Snacks`. Per ulteriori informazioni, consulta [Posizionamenti per categoria](https://developers.citrusad.com/integration/docs/introduction-to-placement-types#category). * **Categoria e ricerca**: mostra gli annunci quando i clienti visitano una pagina di categoria relativa ai tuoi prodotti o utilizzano i termini di ricerca configurati nella tua campagna. * **Cross-selling di categoria**: i posizionamenti di cross-selling di categoria consentono agli inserzionisti di targettizzare categorie complementari oltre a quelle predefinite dei loro prodotti. Questo approccio aumenta la visibilità per i prodotti in categorie correlate, come ad esempio mostrare prodotti a base di caffè nella sezione latticini del sito di un retailer. Per ulteriori informazioni, consulta [posizionamenti di cross-selling](https://help.citrusad.com/retail-media-interface/integration/it/feature-integrations/category-cross-sell/difference-between-category-and-category-cross-sell-placements). * **Corrispondenza generica**: mostra annunci su pagine ad alto traffico non collegate a categorie o termini di ricerca specifici. Ideale per posizioni generali come le homepage o le pagine di checkout. Per ulteriori informazioni, consulta [Posizionamenti a corrispondenza generica](https://help.citrusad.com/retail-media-interface/integration/it/generating-ads/banner-x-responsive/requesting-banner-x-ads#broad-match-placements). ## Formati di slot pubblicitari supportati Banner X può essere distribuito nei seguenti formati: * Tassello singolo * Tassello doppio * Banner completo
## Implementa gli annunci banner X Per configurare gli annunci banner X, segui questi passaggi: ### Passaggio 1: Rivedi gli standard dei contenuti del retailer Gli standard dei contenuti sono linee guida e parametri tecnici che determinano il modo in cui un annuncio Banner X deve essere visualizzato all'interno di uno spazio designato su un sito web o una piattaforma digitale. Questi standard possono includere: * **Dimensioni e misura**: specifiche sulla larghezza e sull'altezza esatte del banner. * **Formato file**: formati di file immagine o video accettati, come JPEG, JPG, PNG, SVG o GIF. * **Limite di dimensione del file**: dimensione massima consentita del file per garantire tempi di caricamento rapidi e prestazioni ottimali sulla pagina web. * **Risoluzione e qualità**: requisiti minimi di risoluzione per garantire che il banner abbia un aspetto nitido e professionale. * **Posizionamento e allineamento**: linee guida su come il banner deve essere allineato all'interno dello spazio disponibile. * **Restrizioni sui contenuti**: regole su quali contenuti possono o non possono essere inclusi nel banner (ad es. nessun contenuto offensivo, inclusione di disclaimer legali obbligatori). * **Interattività**: specifiche per elementi interattivi, come aree cliccabili, animazioni o eventi attivati dall'utente, se applicabile. Prendi confidenza con le linee guida sugli standard dei contenuti del retailer per avviare la tua campagna. Queste linee guida includono URL di esempio, posizionamento nella pagina e restrizioni specifiche sui contenuti della grafica. Consulta il tuo Customer Integration Engineer (CIE) per informazioni dettagliate sugli Slot banner X disponibili e sulle relative specifiche. Ecco un esempio:
### Passaggio 2: Prepara gli asset del materiale creativo Sviluppa i tuoi asset del materiale creativo in base agli standard dei contenuti del retailer. Questo include elementi come lo sfondo primario, lo sfondo secondario, l'immagine Hero e l'immagine Hero secondaria. Utilizza l'API [Ottieni i dettagli dello standard di contenuto Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) per recuperare i dettagli dello standard dei contenuti. ### Passaggio 3: Identifica il formato dello slot pubblicitario Determina il formato dello slot pubblicitario per la tua distribuzione, che potrebbe essere un banner completo, un tassello singolo o un tassello doppio. ### Passaggio 4: Carica gli asset del materiale creativo Dopo aver creato gli asset del materiale creativo e identificato il formato dello slot pubblicitario, caricali utilizzando l'API [Carica l'asset del materiale creativo](/retail-media-interface/partner/it/team-user-api/user-1/uploadfile-1.md) . L'API restituisce l'ID del file e l'URL dell'immagine caricata. * **ID file**: gli ID file sono richiesti quando si crea una campagna banner X. È necessario fornire un ID file specifico per ciascun tipo di asset, come lo sfondo primario, lo sfondo secondario, l'immagine Hero e l'immagine Hero secondaria. * **URL**: l'URL viene utilizzato principalmente per visualizzare in anteprima l'immagine caricata. ### (Opzionale) Passaggio 5: Recupera l'URL pubblico dell'immagine Utilizza il [API per recuperare l'URL del file](/retail-media-interface/partner/it/campaign-management-api/creativeassets/getcampaignfileurl.md) per ottenere l'URL pubblico dell'immagine. Puoi utilizzare questo URL per verificare o condividere l'immagine con gli stakeholder. ### Passaggio 6: Crea una campagna banner X Crea una campagna banner X utilizzando l'API [Crea una campagna Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) . Assicurati di avere `backgroundImageId`, `secondaryBackgroundImageId`, `heroImageId`, e `secondaryHeroImageId`che sono gli ID dei file restituiti dall'API [Carica l'asset del materiale creativo](/retail-media-interface/partner/it/team-user-api/user-1/uploadfile-1.md) . --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.citrusad.com/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.