> 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/onboarding-checklist.md).
# Checklist di onboarding
## Prerequisiti e configurazione dell'accesso
### Accesso richiesto
| Attività | Stato |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| L'accesso al namespace è gestito a livello di team. Per richiedere l'accesso, fornisci i dettagli del namespace e dell'ambiente (ad esempio, `EU3_retailerco`) al Epsilon Team di supporto. | ☐ |
| Assicurati di appartenere al team fornitore o al team retailer primario corretto. L'accesso al team appropriato è necessario per generare il token API. | ☐ |
| Richiesta di presa in carico API inviata (KB0040933). | ☐ |
| Richiesto l'accesso alla Reporting API (BigQuery), se necessario. | ☐ |
| User Key recuperata dalle impostazioni del profilo. | ☐ |
| Base URL ottenuto dal team di supporto. | ☐ |
### Configurazione dell'ambiente
| Attività | Stato |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| URL dell'API dell'ambiente sandbox confermato.
(Contatta il Service Desk per confermare il dominio sandbox corretto per il tuo account).
| ☐ |
| URL dell'ambiente confermati.
(Contatta il Service Desk per confermare il dominio dell'ambiente corretto per il tuo account).
| ☐ |
| I metadati richiesti (catalogo prodotti, posizionamento, informazioni sul team) sono verificati tramite:
- Apertura di un ticket con il Service Desk, oppure
- Accesso alle tabelle BigQuery: dim\_product, dim\_catalog e dim\_placement.
| ☐ |
## Autenticazione e integrazione principale
### Configurazione dell'autenticazione
| Attività | Stato |
| ------------------------------------------------------------ | ----- |
| Token di autenticazione User Key implementato. | ☐ |
| Recupero del token di accesso funzionante (scadenza 24 ore). | ☐ |
| Header di autenticazione configurati correttamente. | ☐ |
| Autenticazione sandbox testata. | ☐ |
### Integrazione API principale
| Attività | Stato |
| --------------------------------------------- | ----- |
| Endpoint di Campaign Management integrati. | ☐ |
| Endpoint di Team & User Management integrati. | ☐ |
| Endpoint di Wallet Management integrati. | ☐ |
| Endpoint di Content Standard integrati. | ☐ |
| Endpoint dell'API Bulk Operation configurati. | ☐ |
### Convalida del formato dati
| Attività | Stato |
| ----------------------------------------------------------------------------------------- | ----- |
| Strutture del payload JSON convalidate. | ☐ |
| Mappature dei campi obbligatori completate. | ☐ |
| Definizioni dei campi della campagna comprese. | ☐ |
| Requisiti degli asset di materiale creativo verificati (< 4MB, PNG/JPEG/JPG/GIF/SVG/PDF). | ☐ |
| Formato del timestamp ISO-8601 implementato. | ☐ |
## Test delle campagne e delle funzionalità
### Test delle campagne
| Attività | Stato |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| Creazione di Sponsored Product Ads (SPA) testata. | ☐ |
| Creazione di campagne banner testata. | ☐ |
| Banner X creazione della campagna testata. | ☐ |
| Modifiche allo stato di approvazione della campagna testate (richiesto solo per le integrazioni Retailer; non applicabile per i Fornitori). | ☐ |
| Operazioni in bulk sulle campagne testate (opzionale, in base al caso d'uso). | ☐ |
### Test di Wallet e Team
| Attività | Stato |
| ------------------------------------------------- | ----- |
| Creazione e gestione dei wallet testata. | ☐ |
| Operazioni di gestione dei fondi testate. | ☐ |
| Creazione dei team e invito degli utenti testati. | ☐ |
| Modifiche ai permessi degli utenti testate. | ☐ |
| Endpoint per il calcolo della spesa testati. | ☐ |
### Test di file e asset
| Attività | Stato |
| -------------------------------------------------------------- | ----- |
| Caricamento degli asset di materiale creativo testato. | ☐ |
| Convalida delle dimensioni e del formato dei file funzionante. | ☐ |
| Recupero dei Content Standard testato. | ☐ |
| Caricamento dei loghi per team/utenti testato. | ☐ |
## Implementazione delle best practice
| Attività | Stato |
| ------------------------------------------------------- | ----- |
| Endpoint bulk utilizzati per operazioni multiple. | ☐ |
| File compressi implementati per i caricamenti. | ☐ |
| Gestione degli errori con risposte JSON strutturate. | ☐ |
| Validazione dei campi prima dell'invio della richiesta. | ☐ |
## Monitoraggio e supporto
| Attività | Stato |
| -------------------------------------------------------------- | ----- |
| Monitoraggio delle chiamate API implementato. | ☐ |
| Registrazione degli errori e avvisi configurati. | ☐ |
| Configurazione del tracciamento delle metriche di prestazioni. | ☐ |
| Informazioni di contatto del supporto documentate. | ☐ |
| Procedure di escalation stabilite. | ☐ |
## Checklist dei requisiti
### Indispensabile prima del Go-Live
| Attività | Stato |
| -------------------------------------------------------------------------------------------- | ----- |
| Autenticazione User Key funzionante in produzione. | ☐ |
| Creazione della campagna (SPA/Banner/Banner X) funzionale. | ☐ |
| Caricamento degli asset di materiale creativo funzionante (limite < 4MB). | ☐ |
| Gestione degli errori per tutti i codici di stato HTTP. | ☐ |
| Operazioni bulk testate per l'efficienza. | ☐ |
| Standard di contenuto e posizionamenti convalidati (inclusa la verifica del componente PDF). | ☐ |
### Validazioni specifiche per l'API
| Attività | Stato |
| ------------------------------------------------------------- | ----- |
| Accesso al namespace confermato. | ☐ |
| Appartenenza al team e permessi verificati. | ☐ |
| Metadati richiesti (catalogo, posizionamento) disponibili. | ☐ |
| Accesso a BigQuery per la reportistica (se necessario). | ☐ |
| Validazione del formato file (PNG, JPEG, JPG, GIF, SVG, PDF). | ☐ |
| Conformità al formato dei timestamp ISO-8601. | ☐ |
---
# 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/onboarding-checklist.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.