> 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/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).
# Panoramica delle API Partner di Epsilon Retail Media
Benvenuto nella Epsilon Retail Media API Partner. Questa guida ti aiuta a integrarti con la nostra piattaforma pubblicitaria per gestire in modo programmatico campagne, portafogli, team e utenti. Puoi anche monitorare le prestazioni e far crescere la tua attività in modo efficace.
## Che cos'è un'API?
API sta per Application Programming Interface (Interfaccia di programmazione delle applicazioni). Un'API funge da intermediario consentendo a due componenti software di comunicare utilizzando un insieme di funzioni e procedure. Le API vengono comunemente utilizzate per ricevere o inviare dati, accedendo a funzionalità e servizi da altre applicazioni.
## Che cos'è l'API Partner?
La nostra API Partner ti offre un accesso programmatico a quasi tutte le operazioni che puoi eseguire nell' Epsilon interfaccia utente delle piattaforme di Gestione campagne Onsite. Ciò significa che, invece di fare clic manualmente nell'app, i tuoi sistemi o sviluppatori possono connettersi direttamente alla nostra piattaforma e automatizzare, personalizzare o integrare le sue funzionalità nei tuoi strumenti o flussi di lavoro.
L'API Partner è utilizzata da molti retailer e partner, inclusi aggregatori come Pacvue, Skai e Commerce IQ.
## Panoramica delle API
La Epsilon Retail Media API Partner consente la gestione programmatica del retail media [Campagne](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/createproductcampaign.md), [Team](/retail-media-interface/partner/it/team-user-api/team.md) & [Utente](/retail-media-interface/partner/it/team-user-api/user-1/createuserteaminvite.md), e [Wallet](/retail-media-interface/partner/it/billing-api/wallet.md). Utilizzala per creare e aggiornare campagne su più formati pubblicitari, inclusi Sponsored Product Ads (SPA), banner statici e responsive Banner X annunci.
La nostra API Partner è un'API basata su REST che utilizza i comuni protocolli GET, POST, PATCH e DELETE tramite payload JSON.
## Vantaggi principali
* Automatizza le operazioni su campagne, team e utenti, e portafogli tramite endpoint API REST.
* Gestisci in modo efficiente più campagne e risorse grazie al supporto per le operazioni bulk.
* Ti consente di orchestrare le chiamate API per adattarle al tuo flusso di lavoro esistente e all'architettura di sistema.
* Crea e gestisci campagne per Sponsored Product Ads, Banner e Banner X formati.
* Autenticazione basata su User key con token a tempo limitato per interazioni API sicure.
## Prerequisiti
Prima di utilizzare l'API Partner, assicurati che siano soddisfatti i seguenti requisiti:
### Accesso al namespace
Devi avere accesso al namespace designato, che funge da contenitore per i tuoi dati e le tue configurazioni. Contatta il Epsilon team di supporto per ottenere i dettagli di configurazione del namespace specifici per i tuoi retailer.
### Appartenenza al team
Devi far parte di un team fornitore o di un team retailer principale con le autorizzazioni appropriate all'interno del tuo namespace.
### Richiesta di acquisizione API
Gli aggregatori pubblicitari, le agenzie e i brand partner devono inviare una richiesta di acquisizione API prima di utilizzare le API Partner. Utilizza il modulo di acquisizione ufficiale indicato in [KB0040933](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)per avviare una nuova connessione API.
### Accesso alla Reporting API
Devi avere accesso alla Reporting API (data warehouse BigQuery) per interrogare le tabelle rilevanti come dim\_product, dim\_catalog e dim\_placement. Questo aiuta a verificare la idoneità all'integrazione ed esplorare i metadati.
### Metadati richiesti
Assicurati che il tuo catalogo prodotti, i posizionamenti e le informazioni sul team siano creati e disponibili nel tuo namespace. Puoi verificarlo interrogando le opportune tabelle BigQuery.
Se non disponi dell'accesso a BigQuery, richiedilo tramite il modulo ufficiale di richiesta di accesso API. A seconda delle tue esigenze, consulta l'articolo appropriato della knowledge base:
* **Modifica/Rimuovi endpoint API Reporting BigQuery**: È necessario modificare un endpoint API esistente - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NUOVA API Partner (API di reporting)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).
{% hint style="info" %}
Nota sull'accesso: Alcuni link in questo documento puntano a risorse interne o con restrizioni. Assicurati di aver effettuato l'accesso con le credenziali appropriate per accedere al contenuto.
{% endhint %}
## Guida introduttiva alle API Partner
### Requisiti di autenticazione
L'API Partner utilizza un processo di autorizzazione che richiede una User Key. I token di accesso vengono recuperati chiamando l'API di autenticazione User Key:
* La User Key recuperata viene passata nell'intestazione di questa richiesta.
* Il token di accesso recuperato viene successivamente utilizzato in qualsiasi chiamata ai metodi dell'API Partner.
* I token scadono poco prima che siano trascorse 24 ore dalla generazione.
{% hint style="info" %}
È necessario richiedere un nuovo token alla scadenza del precedente. Un client non deve generare un nuovo token a ogni richiesta alla nostra API.
{% endhint %}
### Ottieni le tue credenziali API
Per iniziare a utilizzare le Epsilon Retail Media API Partner, hai bisogno delle seguenti informazioni. In caso di dubbi su uno qualsiasi dei dettagli, contatta il Supporto o apri un ticket per ricevere assistenza.
* La tua User key per l'autenticazione.
* L'URL di base per effettuare chiamate API.
### Recupera la tua User key
1. Accedi al tuo Epsilon Retail Media account di team.
2. Scegli un team.
3. Dal menu a discesa del profilo, seleziona **Impostazioni utente**.
4. Naviga fino alla scheda **User key**.
5. Fai clic su **Mostra** per rivelare la tua chiave API.
Utilizza questa chiave per autenticare le tue richieste API. Epsilon Retail Media utilizza l'autenticazione basata su User key. Scambia la tua User key con un token di accesso a tempo limitato per autorizzare le richieste API. Per ulteriori informazioni, consulta [Richieste di autenticazione](/retail-media-interface/partner/it/partner-api-authentication/authenticating-requests.md).
### Ottieni il tuo URL di base
Contatta il Supporto per ottenere l'URL di base corretto per il tuo ambiente. Esempio di endpoint:
```
https://campaign..citrusad.com/v3/campaigns
```
Una volta ottenuta la tua User key, puoi autenticarti e iniziare a effettuare chiamate API a:
* Visualizzare e gestire le tue campagne pubblicitarie.
* Gestire i tuoi budget pubblicitari e le tue spese.
* Gestire i dettagli del tuo team e dei tuoi utenti.
## Configurare l'ambiente
Epsilon Retail Media fornisce due ambienti distinti per ciascun retailer: Production e Sandbox. Entrambi gli ambienti vengono creati per impostazione predefinita quando un retailer viene integrato.
### Ambiente Sandbox
{% hint style="info" %}
L'accesso a Sandbox viene generalmente fornito solo a retailer e aggregatori. Se non sei sicuro della tua idoneità, contatta il Supporto.
{% endhint %}
Utilizza questo ambiente sicuro per testare la tua integrazione prima di passare alla fase di produzione. I retailer devono utilizzare questo ambiente per convalidare le chiamate API, testare i caricamenti dei cataloghi, simulare la creazione di campagne e garantire la funzionalità end-to-end prima di andare online. Utilizza la Sandbox per tutte le attività di sviluppo, test e QA. Ogni retailer ha un URL sandbox univoco, in genere nel formato:
```
https://-sandbox.citrusad.com
```
L'ambiente sandbox include:
### Ambiente Production
Passa alla produzione solo dopo un'esito positivo della convalida in sandbox. L'ambiente di produzione viene utilizzato per le campagne attive e l'erogazione di annunci in tempo reale. Supporta operazioni su vasta scala, inclusi aggiornamenti del catalogo, sincronizzazione degli ordini e tracciamento delle prestazioni degli annunci. L'URL di produzione segue questo formato:
```
https://.citrusad.com
```
Assicurati che tutti i dati (cataloghi, prodotti, ordini) siano accurati e completi prima di utilizzare questo ambiente.
{% hint style="info" %}
Confermare sempre l'ambiente corretto prima di effettuare chiamate API, specialmente quando si utilizzano credenziali e URL di base. L'URL di base potrebbe non corrispondere sempre al namespace, a seconda della configurazione di integrazione del retailer.
{% endhint %}
## Endpoint dell'API Partner
Epsilon Retail Media L'API offre un insieme di funzionalità principali raggruppate in categorie funzionali, ciascuna supportata da endpoint dedicati. La tabella seguente riassume le principali API rivolte ai partner, il loro scopo e i metodi HTTP utilizzati.
### Gestione delle campagne
**Che cos'è un annuncio Sponsored Product?** Gli annunci Sponsored Product (SPA) sono annunci posizionati nelle griglie di prodotti sul sito del retailer, solitamente presenti nelle pagine di ricerca e di categoria, oltre che nella PDP e nella homepage, inseriti tra gli elenchi organici.
**Che cos'è un Banner X Ad?** Banner X gli annunci sono unità pubblicitarie completamente responsive che crescono e si adattano con la viewport dell'utente. Sono composti da numerosi elementi di materiale creativo, dalle immagini hero e di sfondo al testo del titolo e ai pulsanti di chiamata all'azione.
**Che cos'è un annuncio Banner?** Un Banner standard è un'immagine statica con un URL di destinazione associato.
#### Campagna prodotto
| Endpoint | Descrizione | Metodo |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------ |
| [Crea una campagna prodotto](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/createproductcampaign.md) | Crea una nuova campagna prodotto utilizzando i dettagli forniti nel corpo della richiesta. | POST |
| [Recupera l'elenco di tutte le campagne di prodotto](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/listproductcampaigns.md) | Recupera un elenco di tutte le campagne prodotto in base ai parametri forniti. | GET |
| [Aggiorna una campagna di prodotto](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/updateproductcampaign.md) | Aggiorna una campagna prodotto esistente utilizzando l'ID campagna | PATCH |
| [Ottieni la campagna prodotto tramite ID](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/getproductcampaign-1.md) | Recupera i dettagli della campagna prodotto per l'ID campagna specificato. | GET |
| [Modifica lo stato di approvazione di una campagna prodotto](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/approveproductcampaign-1.md) | Aggiorna lo stato di approvazione di una campagna prodotto specificata. | POST |
| [Verifica la fattibilità della prenotazione per le campagne a Canone fisso](/retail-media-interface/partner/it/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Verifica se la prenotazione è fattibile per le campagne a Canone fisso. | POST |
#### Banner X Campagna
| Endpoint | Descrizione | Metodo |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Crea una campagna Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md) | Crea una nuova campagna banner X utilizzando i dettagli forniti nel corpo della richiesta. | POST |
| [Ottieni i dettagli della campagna Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md) | Recupera i dettagli della campagna banner X per l'ID campagna specificato. | GET |
| [Aggiorna la campagna Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md) | Aggiorna una campagna Banner X esistente fornendo l'ID campagna e i dati aggiornati della campagna nel corpo della richiesta. | PATCH |
| [Aggiorna lo stato di approvazione della campagna Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Aggiorna lo stato di approvazione di una campagna banner X specificata. | POST |
| [Recupera l'elenco di tutte le campagne Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md) | Recupera un elenco di campagne banner X in base ai filtri e ai parametri specificati, tra cui nome della campagna, ID posizionamento, ID team, stato di approvazione e altro. | GET |
#### Campagna Banner
| Endpoint | Descrizione | Metodo |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ------ |
| [Crea una campagna banner](/retail-media-interface/partner/it/campaign-management-api/bannercampaign/createbannercampaign-1.md) | Crea una nuova campagna banner utilizzando i dettagli forniti nel corpo della richiesta. | POST |
| [Ottieni i dettagli della campagna banner](/retail-media-interface/partner/it/campaign-management-api/bannercampaign/getbannercampaign-1.md) | Recupera i dettagli della campagna banner per l'ID campagna specificato. | GET |
| [Aggiorna la campagna banner](/retail-media-interface/partner/it/campaign-management-api/bannercampaign/updatebannercampaign.md) | Aggiorna una campagna banner esistente utilizzando l'ID campagna. | PATCH |
| [Aggiorna lo stato di approvazione della campagna banner](/retail-media-interface/partner/it/campaign-management-api/bannercampaign/approvebannercampaign.md) | Aggiorna lo stato di approvazione di una campagna banner specificata | POST |
#### File della campagna
| Endpoint | Descrizione | Metodo |
| ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------ |
| [Carica un file della campagna](/retail-media-interface/partner/it/campaign-management-api/creativeassets/uploadfile.md) | Carica diversi tipi di file della campagna | POST |
| [Recupera l'URL del file della campagna](/retail-media-interface/partner/it/campaign-management-api/creativeassets/getcampaignfileurl.md) | Recupera l'URL di un file della campagna utilizzando l'ID file e il tipo di file specificati. | POST |
#### Standard di contenuto
| Endpoint | Descrizione | Metodo |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Ottieni i dettagli dello standard di contenuto Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md) | Recupera Banner X i dettagli dello standard di contenuto per l'ID standard di contenuto specificato. | GET |
| [Recupera l'elenco degli standard di contenuto per le campagne Banner X](/retail-media-interface/partner/it/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Recupera l'elenco degli standard di contenuto per Banner X le campagne in base ai parametri specificati, come namespace, nome e ID dello standard di contenuto. | GET |
| [Ottieni i dettagli dello standard di contenuto del banner](/retail-media-interface/partner/it/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md) | Recupera i dettagli dello standard di contenuto Banner per l'ID standard di contenuto specificato. | GET |
| [Recupera l'elenco degli standard di contenuto per le campagne banner](/retail-media-interface/partner/it/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md) | Recupera l'elenco degli standard di contenuto per le campagne banner in base ai parametri specificati, come namespace, nome e ID dello standard di contenuto. | GET |
#### Campagna
| Endpoint | Descrizione | Metodo |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Recupera l'elenco di tutte le campagne](/retail-media-interface/partner/it/campaign-management-api/campaign/listcampaigns-1.md) | Recupera un elenco di campagne in base ai filtri e ai parametri specificati, tra cui nome della campagna, tipo di campagna, ID posizionamento, ID team, stato di approvazione e altro. | POST |
| [Recupera la cronologia della campagna](/retail-media-interface/partner/it/campaign-management-api/campaign/getcampaignhistory.md) | Recupera la cronologia di una campagna utilizzando il relativo ID campagna. | GET |
| [Recupera i dettagli dell'offerta minima per le parole chiave](/retail-media-interface/partner/it/campaign-management-api/campaign/retrievekeywordsminbid.md) | Recupera i dettagli delle singole offerte minime e l'offerta minima complessiva della campagna per un array di parole chiave specificate nelle campagne con tipo di posizionamento Ricerca e Categoria & Ricerca. | POST |
| [Recupera i dettagli dell'offerta minima per la categoria](/retail-media-interface/partner/it/campaign-management-api/campaign/retrievecategoryminbid.md) | Recupera i dettagli delle singole offerte minime e l'offerta minima complessiva della campagna per le campagne con tipo di posizionamento categoria. | POST |
## Gestione degli asset del materiale creativo
### Che cos'è un asset di materiale creativo?
Gli asset di materiale creativo sono immagini utilizzate nelle campagne Banner e Banner X . Questi asset devono soddisfare requisiti tecnici specifici per garantire una visualizzazione e prestazioni adeguate.
### Linee guida per il caricamento:
* Dimensione file < 4 MB
* Tipi di file: PNG, JPEG, JPG, GIF, SVG e PDF
* Un file alla volta
* ID team, ID slot e ID standard di contenuto sono obbligatori
* Fornire un percorso assoluto completo verso il file
{% hint style="info" %}
I caricamenti degli asset del materiale creativo vengono gestiti tramite gli endpoint File della campagna elencati nella sezione Gestione delle campagne sopra.
{% endhint %}
## Gestione degli standard di contenuto
### Che cos'è uno standard di contenuto?
Gli standard di contenuto sono linee guida e parametri tecnici che determinano come un annuncio Banner o Banner X debba essere visualizzato all'interno di uno spazio designato su un sito web o una piattaforma digitale. Gli standard includono parametri quali dimensioni e grandezza, formato e dimensioni del file, risoluzione e qualità, posizionamento e allineamento, restrizioni del contenuto e interattività.
### Gestione di team e utenti
#### Che cos'è un team?
Un team è una raccolta di utenti ed è classificato come team fornitore (inserzionista) o team retailer. I team fornitori di solito creano campagne, mentre i retailer esaminano le campagne ed eseguono attività amministrative. Un utente nel sistema può appartenere a più team o solo a uno. In genere, a un team sono associati utenti, campagne e wallet.
#### Team
| Endpoint | Descrizione | Metodo |
| ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ------ |
| [Crea team](/retail-media-interface/partner/it/team-user-api/team/createteam-1.md) | Crea un nuovo team. | POST |
| Aggiorna un team | Aggiorna i dettagli di un team specificato da team\_id. | PATCH |
| Elenca tutti i team | Recupera un elenco di team fornendo parametri quali name, namespace\_id e seller\_id. | GET |
| [Ottieni il team per l'ID specificato](/retail-media-interface/partner/it/team-user-api/team/getteam-1.md) | Recupera informazioni dettagliate su uno specifico team, inclusi i suoi membri. | GET |
| Unisciti a un team con un token di invito | Consente agli utenti di unirsi a un team utilizzando un token di invito valido e non scaduto. | POST |
#### Utente
| Endpoint | Descrizione | Metodo |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | ------ |
| [Invita un utente nel team](/retail-media-interface/partner/it/team-user-api/user-1/createuserteaminvite.md) | Invia un invito a un utente per unirsi a uno specifico team. | POST |
| Recupera i dettagli dell'utente utilizzando l'ID utente | Recupera i dettagli dell'utente attualmente connesso alla Epsilon Retail Media piattaforma. | GET |
| [Recupera i dettagli dell'utente](/retail-media-interface/partner/it/team-user-api/user-1/getusersforteam.md) | Recupera i dettagli dell'utente in base all'ID team fornito. | GET |
| [Aggiorna i dettagli dell'utente corrente](/retail-media-interface/partner/it/team-user-api/user-1/updateuserprofile.md) | Modifica i dettagli dell'utente attualmente connesso alla Epsilon Retail Media piattaforma. | PATCH |
| [Modifica l'autorizzazione dell'utente](/retail-media-interface/partner/it/team-user-api/user-1/modifyuserpermission.md) | Aggiorna i permessi di un utente fornendo sia l'ID utente che l'ID team. | PATCH |
| [Carica un file](/retail-media-interface/partner/it/team-user-api/user-1/uploadfile-1.md) | Carica i loghi per i profili utente e i team. | POST |
| [Recupera l'URL del file](/retail-media-interface/partner/it/team-user-api/user-1/getfileurl.md) | Recupera l'URL per il logo di un team o utente utilizzando l'ID file specificato. | POST |
| Rimuovi un utente | Rimuove un utente dal team. | DELETE |
### Fatturazione e gestione del Wallet
#### Che cos'è un Wallet?
Un wallet conserva i fondi di un inserzionista allo scopo di effettuare pagamenti (ad es. pagare per gli annunci realizzati).
#### Wallet
| Endpoint | Descrizione | Metodo |
| --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------ |
| [Crea un wallet](/retail-media-interface/partner/it/billing-api/wallet/createwallet.md) | Crea un wallet all'interno di un namespace specificato e lo associa a un team utilizzando l'ID team. | POST |
| [Aggiorna un wallet](/retail-media-interface/partner/it/billing-api/wallet/updatewallet-1.md) | Aggiorna un wallet all'interno di un namespace e teamId specificati. | PATCH |
| [Recupera wallet tramite ID](/retail-media-interface/partner/it/billing-api/wallet/getwallet-1.md) | Recupera i dettagli di uno specifico wallet utilizzando il suo identificatore univoco, {id}. | GET |
| [Elenca tutti i wallet](/retail-media-interface/partner/it/billing-api/wallet/listwallets.md) | Recupera un elenco di wallet in base a filtri e parametri specificati, tra cui ID team, nome wallet, ID wallet, ID esterno e altro ancora. | GET |
| [Ottieni il saldo di uno specifico wallet](/retail-media-interface/partner/it/billing-api/wallet/getwalletbalance.md) | Recupera il saldo attuale di uno specifico wallet. | GET |
| [Gestisci i fondi per uno specifico wallet](/retail-media-interface/partner/it/billing-api/wallet/managefunds.md) | Gestisce le operazioni sui fondi per uno specifico wallet. | POST |
#### Spesa
| Endpoint | Descrizione | Metodo |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------ |
| [Recupera i dettagli di spesa della campagna](/retail-media-interface/partner/it/billing-api/spend/getcampaignspend.md) | Calcola il budget rimanente per campagne specifiche in base al saldo disponibile e ai limiti di spesa. | POST |
### Operazione in blocco
#### Campagna
| Endpoint | Descrizione | Metodo |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------ |
| [Crea campagne in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md) | Crea più campagne contemporaneamente (fino a 1.000) in base al tipo di campagna. | POST |
| [Aggiorna campagne in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md) | Aggiorna le campagne all'interno di un namespace specificato. | PATCH |
| [Aggiorna lo stato di approvazione della campagna](/retail-media-interface/partner/it/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Approva o rifiuta le campagne all'interno di un namespace specificato. | POST |
| Recupera lo stato dell'operazione in blocco | Recupera lo stato e i dettagli di un'operazione di campagna in blocco utilizzando l'ID dell'operazione in blocco. | GET |
#### Wallet
| Endpoint | Descrizione | Metodo |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | ------ |
| [Crea wallet in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md) | Crea più wallet contemporaneamente all'interno della tua organizzazione (fino a 1.000). | POST |
| [Recupera lo stato dell'operazione di wallet in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Recupera lo stato di un'operazione wallet in blocco utilizzando il relativo ID in blocco. | GET |
| [Aggiorna wallet in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md) | Aggiorna più wallet contemporaneamente. | PATCH |
#### Team
| Endpoint | Descrizione | Metodo |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- | ------ |
| [Crea team in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md) | Crea team in blocco per un'organizzazione. | POST |
| [Aggiorna team in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md) | Aggiorna più team contemporaneamente. | PATCH |
| [Recupera lo stato dell'operazione di team in blocco](/retail-media-interface/partner/it/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Recupera lo stato di un'operazione team in blocco utilizzando il relativo ID in blocco. | GET |
### Termine di ricerca consigliato
#### Cosa sono i Termini di ricerca consigliati?
I termini di ricerca consigliati sono una raccolta di termini forniti tramite un file dal retailer che associa i prodotti a termini specifici che vengono presentati all'utente durante la creazione di una campagna nella fase dei termini di ricerca. Per ulteriori informazioni, consultare Termini di ricerca consigliati.
| Endpoint | Descrizione | Metodo |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------ |
| [Elenca tutti i termini di ricerca suggeriti](/retail-media-interface/partner/it/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Recupera i termini di ricerca consigliati per il targeting da catalogo in base a parametri specificati come ID catalogo, codice prodotto e altro. | GET |
## Best Practice
Segui queste best practice per garantire un'integrazione fluida, efficiente e affidabile con le Epsilon Retail Media API partner:
* Esegui sempre i test in sandbox prima del rilascio in produzione.
* Utilizza endpoint in blocco per operazioni multiple.
* Verifica la presenza di problemi di dati specifici nelle risposte di errore.
* Utilizza file compressi per caricamenti di dati più rapidi.
* Aggiorna i token di accesso solo quando sono scaduti.
* Convalida i campi obbligatori prima di inviare le richieste.
## Gestione degli errori
Le nostre API partner restituiscono risposte di errore JSON strutturate per supportare una gestione affidabile delle eccezioni.
* **Codice di stato HTTP**: codici di errore standard (400, 401, 403, 500, ecc.)
* **Codice di errore**: identificatore di errore specifico.
* **Messaggio**: descrizione dell'errore leggibile dall'uomo.
* **Violazioni dei campi**: errori specifici di convalida dei campi per problemi di inserimento dati.
Per informazioni dettagliate sulla gestione degli errori, consultare [Gestione degli errori](/retail-media-interface/partner/it/partner-api-overview/error-handling.md).
## Supporto e risorse
| Risorsa | Descrizione |
| ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| [Domande frequenti](/retail-media-interface/partner/it/partner-api-overview/frequently-asked-questions.md) | Domande frequenti e risposte relative all'uso e all'integrazione delle API. |
| Note di rilascio | Riepilogo dei recenti aggiornamenti o modifiche all'API. |
| [Glossario](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1) | Definizioni dei termini chiave utilizzati in tutta la documentazione API. |
---
# 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/partner-api-overview/epsilon-retail-media-partner-apis-overview-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.