> 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/frequently-asked-questions.md).
# Domande frequenti
## Operazioni in blocco con le Partner API
### Cosa sono le operazioni in blocco?
Le operazioni in blocco consentono di creare, modificare o approvare più campagne, portafogli o team in un'unica richiesta API anziché effettuare singole chiamate.
### Le operazioni in blocco sono sincrone o asincrone?
Asincrone. Invii un job ed effettui il polling dei risultati utilizzando l'ID bulk.
### Cosa succede se alcuni elementi della mia richiesta in blocco falliscono?
Ogni elemento viene convalidato in modo indipendente. Riceverai risultati dettagliati che mostrano quali hanno avuto successo e quali sono falliti con messaggi di errore specifici.
## Team e Utente
### Che cos'è un invito?
Un invito consente a un utente di unirsi a un team nella Epsilon Retail Media piattaforma. Gli inviti vengono in genere inviati dagli amministratori del team e devono essere accettati via e-mail o all'interno della piattaforma prima che l'utente possa accedere alle risorse del team.
### Come creo un nuovo team?
Utilizza l'endpoint [Crea team](/retail-media-interface/partner/it/team-user-api/team/createteam-1.md) con i campi obbligatori come nome del team, informazioni sull'azienda e ID namespace. Avrai bisogno delle autorizzazioni appropriate per creare team all'interno della tua organizzazione.
### Posso appartenere a più team?
Sì, gli utenti possono appartenere a più team contemporaneamente. Ogni appartenenza a un team può avere livelli di autorizzazione e ruoli diversi.
### Qual è la differenza tra i team Retailer e Supplier?
I team Retailer gestiscono e revisionano le campagne, mentre i team Supplier (inserzionisti) creano e gestiscono le campagne. Il tipo di team determina le funzionalità e le autorizzazioni disponibili.
### Come modifico le mie autorizzazioni utente?
Gli amministratori del team possono modificare le autorizzazioni utente utilizzando l'endpoint Modify user permission. I tipi di autorizzazione includono Accesso completo e Visualizzazione report sia per i ruoli Retailer che Supplier.
### Cosa succede quando rimuovo un utente da un team?
La rimozione di un utente revoca il suo accesso alle risorse, alle campagne e ai dati di quel team. L'utente non riceverà più le notifiche del team né potrà eseguire azioni specifiche del team.
### Per quanto tempo sono validi i token di invito?
I token di invito hanno un periodo di scadenza. Contatta l'amministratore del tuo team se il tuo invito è scaduto e ne hai bisogno di uno nuovo.
### Posso aggiornare le informazioni del team dopo la creazione?
Sì, utilizza l'endpoint Update a team per modificare i dettagli del team, inclusi nome, informazioni sull'azienda, numero di telefono, URL del sito web e indirizzo.
### Quali tipi di file posso caricare per i loghi?
L'endpoint [Carica un file](/retail-media-interface/partner/it/team-user-api/user-1/uploadfile-1.md) supporta i formati di immagine più comuni per i loghi del profilo del team e dell'utente. Consulta la documentazione API per i requisiti specifici di dimensione e formato del file.
### Come trovo i team a cui posso unirmi?
Utilizza l'endpoint Lists all teams con filtri appropriati come il nome, `namespace_id`, or `seller_id` per scoprire i team disponibili all'interno della tua organizzazione.
## Elenca campagne
### Quando dovrei usare `managedOnly`?
Nel sistema Epsilon Retail Media , alcune campagne sono gestite dai retailer anziché dai supplier. Per gli annunci di prodotti, l'unico tipo di spesa disponibile è a Canone fisso. Utilizza il parametro `managedOnly` per recuperare solo le campagne a Canone fisso.
## Crea o aggiorna campagne
### Quando uso `managerTeamId`?
Utilizza il parametro `managerTeamId` quando crei o aggiorni campagne a Canone fisso. Quando specifichi `managerTeamId`, dovrai anche specificare le impostazioni della strategia a Canone fisso pertinenti.
### Che cos'è un `namespaceId`?
Il `namespaceId` è l'identificatore univoco per il namespace in cui le campagne vengono create o aggiornate. Per ulteriori informazioni, consulta Namespaces. Puoi anche contattare il tuo Customer Integration Engineer (CIE) per ottenere questo valore.
### Che cos'è un `placementId`?
I posizionamenti specificano i luoghi in cui vengono visualizzati gli annunci. Ogni posizionamento nel sistema Epsilon Retail Media ha un identificatore univoco chiamato `placementId`.
Utilizza l'API [Restituisce un elenco di posizionamenti](/retail-media-interface/partner/it/global-api/placements/listplacements.md) per recuperare il `placementId`. In alternativa, contatta il tuo CIE per ottenere questo valore.
### Che cos'è un `walletId`?
Un walletId è l'identificatore del portafoglio di un inserzionista. Ogni inserzionista può avere uno o più portafogli. Ogni portafoglio avrà un valore di crediti che può spendere. Impostando il walletId, stai impostando quale portafoglio dell'inserzionista verrà addebitato per la campagna.
### Che cos'è un `templateId`?
Il `templateId` viene utilizzato nelle implementazioni di Ad Genius. Non viene comunemente utilizzato dalla maggior parte dei clienti e può generalmente essere ignorato.
### Cosa sono i campi personalizzati?
Nella piattaforma Epsilon Retail Media , alcuni retailer necessitano di attributi personalizzati per le campagne, come ordini di acquisto e dettagli dell'acquirente. Di seguito è riportato un esempio:
Se la tua integrazione non richiede questi campi, puoi ignorare questo campo. Se li richiede, il tuo CIE fornirà gli ID necessari.
### Cosa sono le domande personalizzate?
Nei namespace con dati di targeting clienti integrati, gli inserzionisti possono indirizzare i segmenti di clienti utilizzando combinazioni di `key:value` . Per ulteriori informazioni, consulta Dati cliente.
Nei namespace con domande personalizzate, puoi indicare agli inserzionisti se queste domande sono opzionali o obbligatorie e fornire la configurazione pertinente. Il tuo CIE può fornire il `customQuestionIds` se sono configurate nel tuo namespace.
### Devo specificare `startTime` e `endTime`?
Puoi omettere questo se la campagna è intesa per essere sempre attiva. Se il tuo inserzionista desidera impostare un periodo attivo, dovresti fornire entrambi i valori nel formato ISO-8601.
### Come posso aggiornare una proprietà specifica senza inviare l'intero oggetto campagna quando effettuo un aggiornamento (PATCH)?
Le nostre API utilizzano una proprietà `mask` che ti consente di aggiornare una proprietà specifica senza inviare l'intero oggetto campagna.
#### Punti chiave
* Placement\*\*: Assicurati che la proprietà `mask` sia posizionata correttamente nella tua richiesta.
* **Gestione degli errori:** Se riscontri un errore di autorizzazione, controlla il formato della maschera nella tua richiesta.
#### Esempi
**Modifica di una proprietà semplice** come il nome della campagna, utilizza quanto segue:
```json
{
"productCampaign": {
"name": "new campaign name"
},
"mask": "name"
}
```
Modifica di una proprietà annidata\*\* come `maxBid`:
```json
{
"productCampaign": {
"strategy": {
"auction": {
"maxBid": "5"
}
}
},
"mask": "strategy.auction.maxBid"
}
```
Modifica di più proprietà\*\* come `searchTerms` e il `maxBid`, utilizza un elenco separato da virgole delle proprietà che stai aggiornando in `mask` proprietà:
```json
{
"productCampaign": {
"targeting": {
"searchTerms": [
{
"matchType": "MATCH_TYPE_EXACT_MATCH",
"phrase": "yoghurt_new",
"suggested": false
},
{
"matchType": "MATCH_TYPE_EXACT_MATCH",
"phrase": "dairy",
"suggested": false
},
{
"matchType": "MATCH_TYPE_EXACT_MATCH",
"phrase": "cheezy_new",
"suggested": false
}
]
},
"strategy": {
"auction": {
"maxBid": "6.5"
}
}
},
"mask": "targeting.searchTerms,strategy.auction"
}
```
## Portafoglio
### Perché ho bisogno di un portafoglio?
I portafogli vengono utilizzati per gestire i fondi delle campagne e garantire che le transazioni vengano elaborate nella valuta corretta. Per ulteriori informazioni, consulta Scopo.
### Posso avere più portafogli?
Sì, puoi creare più portafogli per gestire separatamente valute diverse o budget di campagna differenti. Per ulteriori informazioni, consulta Più portafogli.
### Dove posso trovare l'ID di un portafoglio?
Per trovare l'ID di un portafoglio, puoi seguire questi passaggi:
**Piattaforma legacy:** Vai alla pagina **Fatturazione del team** per visualizzare il tuo ID portafoglio.
**Nuova UI:** Apri **Gestore portafoglio** per trovare il tuo ID portafoglio.
{% hint style="info" %}
Alcuni team potrebbero avere più portafogli in valute diverse, quindi assicurati di selezionare quello corretto.
{% endhint %}
### Cos'è il saldo corrente?
Il saldo corrente è il saldo del portafoglio senza alcuna ricarica di credito o limite applicato.
### Cos'è il saldo disponibile?
Il saldo disponibile è l'importo totale nel portafoglio che è disponibile da spendere in qualsiasi momento. Include il saldo corrente più qualsiasi limite di credito.
### Cos'è un limite giornaliero o una spesa giornaliera?
Un limite giornaliero è l'importo massimo che il tuo portafoglio può spendere in un singolo giorno.
### Cos'è il pacing del budget?
Il pacing del budget indica che eventuali fondi del limite giornaliero non spesi verranno trasferiti al limite giornaliero del giorno successivo.
### Cos'è il limite giornaliero rimanente?
Il limite giornaliero rimanente è costituito dai fondi del limite giornaliero non spesi del giorno precedente.
### Cos'è il saldo disponibile con cap?
Il saldo disponibile con cap è l'importo che il portafoglio ti consente di spendere per la giornata, considerando eventuali limiti di spesa e/o crediti di ricarica. Questo valore è fondamentale perché determina se ci sono soldi disponibili da spendere.
**Calcolo del saldo disponibile con cap**:
* **Solo limite di credito**: Saldo disponibile con cap = Saldo disponibile.
* **Solo limite giornaliero**: Saldo disponibile con cap = Limite giornaliero + riparto non speso
* **Sono applicati sia il limite di credito che il limite giornaliero**: Minimo tra (Saldo disponibile, Limite giornaliero + riparto)
Ecco alcuni esempi:
* **Esempio 1**: Il limite di credito è 10, il saldo del portafoglio è 20.
* **Esempio 2**: Il budget giornaliero è 1000, il saldo del portafoglio è 10.000.
* **Esempio 3**: Il budget giornaliero è 250, il limite di credito è 20, il saldo del portafoglio è 200. In questo caso, il saldo disponibile con cap è 220 perché il saldo disponibile (saldo corrente + limite di credito) è inferiore al limite giornaliero più il riparto non speso (250).
{% hint style="info" %}
I limiti di credito sono una funzionalità legacy e non sono supportati dalla maggior parte dei rivenditori.
{% endhint %}
### Il saldo del portafoglio può andare in negativo?
No. I saldi del portafoglio non possono essere impostati intenzionalmente su un valore negativo tramite la Partner API. Sebbene l'attività della campagna possa influire temporaneamente sui saldi, questo comportamento è gestito dal sistema e non è controllato dall'utente.
### Perché non posso selezionare un portafoglio durante la creazione di una campagna?
La valuta del portafoglio deve corrispondere alla valuta del catalogo. Ad esempio, se il tuo catalogo è in AUD, non puoi selezionare un portafoglio in GBP. Per ulteriori informazioni, consulta [Compatibilità della valuta con i cataloghi](/retail-media-interface/partner/it/billing-api/wallet.md#currency-compatibility-with-catalogs).
---
# 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/frequently-asked-questions.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.