> 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/de/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md).

# Epsilon Retail Media Partner-APIs – Übersicht

Willkommen zur Epsilon Retail Media Partner-API. Dieser Leitfaden hilft Ihnen bei der Integration mit unserer Werbeplattform, um Ihre Kampagnen, Wallets, Teams und Benutzer programmatisch zu verwalten. Sie können auch die Leistung verfolgen und Ihr Geschäft effektiv ausbauen.

## Was ist eine API?

Eine API steht für Application Programming Interface (Anwendungsprogrammierschnittstelle). Eine API fungiert als Vermittler, der zwei Softwarekomponenten die Kommunikation über eine Reihe von Funktionen und Prozeduren ermöglicht. APIs werden häufig verwendet, um Daten abzurufen oder zu senden und auf Funktionen und Dienste anderer Anwendungen zuzugreifen.

## Was ist die Partner-API?

Unsere Partner-API bietet Ihnen programmatischen Zugriff auf nahezu alles, was Sie in der Epsilon Benutzeroberfläche der Onsite Campaign Management-Plattformen tun können. Das bedeutet, dass sich Ihre Systeme oder Entwickler direkt mit unserer Plattform verbinden und deren Funktionen automatisieren, anpassen oder in Ihre eigenen Tools oder Workflows integrieren können, anstatt sich manuell durch die App zu klicken.

Die Partner-API wird von vielen Händlern und Partnern genutzt, darunter Aggregatoren wie Pacvue, Skai und Commerce IQ.

## API-Übersicht

Die Epsilon Retail Media Partner-API ermöglicht die programmatische Verwaltung von Retail Media [Kampagnen](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/createproductcampaign.md), [Team](/retail-media-interface/partner/de/team-user-api/team.md) & [Benutzer](/retail-media-interface/partner/de/team-user-api/user-1/createuserteaminvite.md), und [Wallets](/retail-media-interface/partner/de/billing-api/wallet.md). Verwenden Sie sie, um Kampagnen über mehrere Anzeigenformate hinweg zu erstellen und zu aktualisieren, einschließlich Sponsored Product Ads (SPAs), statischen Bannern und responsiven Banner X Anzeigen.

Unsere Partner-API ist eine REST-basierte API, die gängige GET-, POST-, PATCH- und DELETE-Protokolle über JSON-Payloads verwendet.

## Hauptvorteile

* Automatisieren Sie Kampagnen-, Team- & Benutzer- sowie Wallet-Vorgänge über REST-API-Endpunkte.
* Verwalten Sie mehrere Kampagnen und Ressourcen effizient mit Unterstützung für Sammelvorgänge.
* Ermöglicht Ihnen die Orchestrierung von API-Aufrufen zur Anpassung an Ihren bestehenden Workflow und Ihre Systemarchitektur.
* Erstellen und verwalten Sie Kampagnen über Sponsored Product Ads, Banner und Banner X -Formate.
* User-Key-basierte Authentifizierung mit zeitlich begrenzten Tokens für sichere API-Interaktionen.

## Voraussetzungen

<figure><img src="/files/rsaY50hUg9NSIA4xgpZU" alt="" width="100%"><figcaption></figcaption></figure>

Stellen Sie vor der Nutzung der Partner-API sicher, dass die folgenden Anforderungen erfüllt sind:

### Namespace-Zugriff

Sie müssen Zugriff auf Ihren zugewiesenen Namespace haben, der als Container für Ihre Daten und Konfigurationen dient. Wenden Sie sich an das Epsilon Support-Team, um Details zur Namespace-Konfiguration zu erhalten, die für Ihre Händler spezifisch sind.

### Team-Mitgliedschaft

Sie müssen Teil eines Lieferanten- oder primären Händler-Teams mit den entsprechenden Berechtigungen innerhalb Ihres Namespace sein.

### API-Aufnahmeanfrage

Werbeaggregatoren, Agenturen und Markenpartner müssen vor der Nutzung der Partner-APIs eine API-Aufnahmeanfrage stellen. Nutzen Sie das offizielle Aufnahmeformular, auf das in [KB0040933](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040933)verwiesen wird, um eine neue API-Verbindung zu initiieren.

### Reporting-API-Zugriff

Sie müssen Zugriff auf die Reporting-API (BigQuery Data Warehouse) haben, um relevante Tabellen wie dim\_product, dim\_catalog und dim\_placement abzufragen. Dies hilft bei der Überprüfung der Integrationsbereitschaft und der Erkundung von Metadaten.

### Erforderliche Metadaten

Stellen Sie sicher, dass Ihre Produktkatalog-, Platzierungs- und Team-Informationen erstellt und unter Ihrem Namespace verfügbar sind. Sie können dies überprüfen, indem Sie die entsprechenden BigQuery-Tabellen abfragen.

Wenn Sie keinen Zugriff auf BigQuery haben, fordern Sie diesen über das offizielle API-Zugriffsanforderungsformular an. Bitte beziehen Sie sich je nach Ihren Anforderungen auf den entsprechenden Wissensdatenbank-Artikel:

* **Reporting BigQuery API-Endpunkt ändern/entfernen**: Ändern eines bestehenden API-Endpunkts erforderlich - [KB0040934](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040934).
* NEUE Partner-API (Reporting-API)\*\* - [KB0040947](https://citrusad.service-now.com/now/nav/ui/classic/params/target/kb_view.do%3Fsysparm_article%3DKB0040947).

{% hint style="info" %}
Zugriffshinweis: Einige Links in diesem Dokument weisen auf interne oder eingeschränkte Ressourcen hin. Stellen Sie sicher, dass Sie mit den entsprechenden Anmeldeinformationen angemeldet sind, um auf die Inhalte zuzugreifen.
{% endhint %}

## Erste Schritte mit den Partner-APIs

<figure><img src="/files/73Dr6EZX83ODwQAqYZRl" alt="" width="100%"><figcaption></figcaption></figure>

### Authentifizierungsanforderungen

Die Partner-API nutzt einen Autorisierungsprozess, der einen User Key erfordert. Zugriffstokens werden durch Aufruf der User Key Authentication API abgerufen:

* Ihr abgerufener User Key wird im Header dieser Anfrage übergeben.
* Das abgerufene Zugriffstoken wird anschließend bei allen Methodenaufrufen an die Partner-API verwendet.
* Tokens laufen knapp 24 Stunden nach der Generierung ab.

{% hint style="info" %}
Ein neues Token sollte angefordert werden, wenn das vorherige abläuft. Ein Client sollte nicht bei jeder Anfrage an unsere API ein neues Token generieren.
{% endhint %}

### Holen Sie Ihre API-Anmeldeinformationen

Um mit der Nutzung der Epsilon Retail Media Partner-APIs zu beginnen, benötigen Sie die folgenden Informationen. Wenn Sie sich bei Details unsicher sind, wenden Sie sich an Ihren Support oder erstellen Sie ein Ticket, um Unterstützung zu erhalten.

* Ihr User Key zur Authentifizierung.
* Die Basis-URL für API-Aufrufe.

### Rufen Sie Ihren User Key ab

1. Melden Sie sich in Ihrem Epsilon Retail Media -Teamkonto an.
2. Wählen Sie ein Team.
3. Wählen Sie aus dem Profil-Dropdown-Menü **User settings**.
4. Navigieren Sie zur Registerkarte **User key**.
5. Klicken Sie auf **Show**, um Ihren API-Schlüssel anzuzeigen.

Verwenden Sie diesen Schlüssel zur Authentifizierung Ihrer API-Anfragen. Epsilon Retail Media verwendet eine User-Key-basierte Authentifizierung. Tauschen Sie Ihren User Key gegen ein zeitlich begrenztes Zugriffstoken aus, um API-Anfragen zu autorisieren. Weitere Informationen finden Sie unter [Authentifizierungsanfragen](/retail-media-interface/partner/de/partner-api-authentication/authenticating-requests.md).

### Rufen Sie Ihre Basis-URL ab

Wenden Sie sich an Ihren Support, um die korrekte Basis-URL für Ihre Umgebung zu erhalten. Beispiel-Endpunkt:

```
https://campaign.<env>.citrusad.com/v3/campaigns
```

Sobald Sie Ihren User Key haben, können Sie sich authentifizieren und mit den API-Aufrufen beginnen für:

* Anzeigen und Verwalten Ihrer Werbekampagnen.
* Verwalten Ihrer Werbebudgets und Ausgaben.
* Verwalten Ihrer Team- und Benutzerdetails.

## Richten Sie die Umgebung ein

Epsilon Retail Media bietet zwei verschiedene Umgebungen für jeden Händler: Production und Sandbox. Beide Umgebungen werden standardmäßig erstellt, wenn ein Händler geboardet wird.

### Sandbox-Umgebung

{% hint style="info" %}
Der Sandbox-Zugriff wird in der Regel nur Händlern und Aggregatoren zur Verfügung gestellt. Wenn Sie sich bezüglich Ihrer Berechtigung unsicher sind, wenden Sie sich an den Support.
{% endhint %}

Verwenden Sie diese sichere Umgebung, um Ihre Integration vor dem Go-Live zu testen. Händler müssen diese Umgebung nutzen, um API-Aufrufe zu validieren, Katalog-Uploads zu testen, die Erstellung von Kampagnen zu simulieren und die Durchgängigkeit der Funktionalität vor dem Go-Live sicherzustellen. Verwenden Sie die Sandbox für alle Entwicklungs-, Test- und QS-Aktivitäten. Jeder Händler hat eine eindeutige Sandbox-URL, typischerweise im Format:

```
https://<retailer>-sandbox.citrusad.com
```

Die Sandbox-Umgebung umfasst:

<figure><img src="/files/O3DjNatEdLOdVvRcmr9L" alt="" width="100%"><figcaption></figcaption></figure>

### Production-Umgebung

Wechseln Sie erst nach erfolgreicher Validierung in der Sandbox zur Produktion. Die Production-Umgebung wird für Live-Kampagnen und die Auslieferung von Anzeigen in Echtzeit verwendet. Sie unterstützt den vollständigen Betrieb, einschließlich Katalogaktualisierungen, Bestellsynchronisierung und Nachverfolgung der Anzeigenleistung. Die Production-URL folgt diesem Format:

```
https://<namespace>.citrusad.com
```

Stellen Sie sicher, dass alle Daten (Kataloge, Produkte, Bestellungen) genau und vollständig sind, bevor Sie diese Umgebung verwenden.

{% hint style="info" %}
Bestätigen Sie immer die korrekte Umgebung, bevor Sie API-Aufrufe tätigen, insbesondere bei der Verwendung von Anmeldeinformationen und Basis-URLs. Die Basis-URL stimmt möglicherweise nicht immer mit dem Namespace überein, abhängig von der Integrationskonfiguration des Händlers.
{% endhint %}

## Partner-API-Endpunkte

Epsilon Retail Media Die API bietet eine Reihe von Kernfunktionen, die in funktionale Kategorien unterteilt sind und jeweils von dedizierten Endpunkten unterstützt werden. Die folgende Tabelle fasst die wichtigsten Partner-APIs, ihren Zweck und die verwendeten HTTP-Methoden zusammen.

<figure><img src="/files/7IcwqkrpAsxYlBlDv3r1" alt="" width="100%"><figcaption></figcaption></figure>

### Kampagnenmanagement

**Was ist eine Gesponserte Produktanzeige?** Gesponserte Produktanzeigen (SPA) sind Anzeigen, die in Produktrastern auf der Händler-Website platziert werden. Sie befinden sich gewöhnlich auf Such- und Kategorieseiten sowie auf Produktdetailseiten und der Startseite, eingebettet zwischen organischen Angeboten.

**Was ist eine Banner X Ad?** Banner X Anzeigen sind vollständig responsive Anzeigeneinheiten, die sich mit dem Viewport des Benutzers vergrößern und verändern. Sie bestehen aus zahlreichen Werbemittel-Elementen, von Hero- und Hintergrundbildern bis hin zu Überschriftentexten und Call-to-Action-Buttons.

**Was ist eine Banner-Anzeige?** Ein Standard-Banner ist ein statisches Bild mit einer dahinterliegenden Ziel-URL.

#### Produkt-Kampagne

| Endpunkt                                                                                                                                                                   | Beschreibung                                                                                      | Methode |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------- |
| [Erstellen Sie eine Produktkampagne](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/createproductcampaign.md)                                | Erstellt eine neue Produkt-Kampagne unter Verwendung der im Anforderungstext angegebenen Details. | POST    |
| [Liste aller Produktkampagnen abrufen](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/listproductcampaigns.md)                               | Ruft eine Liste aller Produkt-Kampagnen basierend auf den angegebenen Parametern ab.              | GET     |
| [Eine Produktkampagne aktualisieren](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/updateproductcampaign.md)                                | Aktualisiert eine bestehende Produkt-Kampagne unter Verwendung der Kampagnen-ID                   | PATCH   |
| [Produktkampagne nach ID abrufen](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/getproductcampaign-1.md)                                    | Ruft Details zur Produkt-Kampagne für die angegebene Kampagnen-ID ab.                             | GET     |
| [Genehmigungsstatus einer Produktkampagne ändern](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/approveproductcampaign-1.md)                | Aktualisiert den Genehmigungsstatus einer angegebenen Produkt-Kampagne.                           | POST    |
| [Buchungsführbarkeit für Feste Platzierung-Kampagnen prüfen](/retail-media-interface/partner/de/campaign-management-api/productcampaign-1/checkfixedtenancyavailable-1.md) | Prüft, ob eine Buchung für Kampagnen mit Feste Platzierung möglich ist.                           | POST    |

#### Banner X Kampagne

| Endpunkt                                                                                                                                                         | Beschreibung                                                                                                                                                                     | Methode |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Erstellen Sie eine Banner X-Kampagne](/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1/createbannerxcampaign-1.md)                  | Erstellt eine neue Banner-X-Kampagne unter Verwendung der im Anforderungstext angegebenen Details.                                                                               | POST    |
| [Banner X-Kampagnendetails abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1/getbannerxcampaign-1.md)                        | Ruft Details zur Banner-X-Kampagne für die angegebene Kampagnen-ID ab.                                                                                                           | GET     |
| [Banner X-Kampagne aktualisieren](/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1/updatebannerxcampaign.md)                         | Aktualisiert eine bestehende Banner X Kampagne durch Bereitstellung der Kampagnen-ID und der aktualisierten Kampagnendaten im Anforderungstext.                                  | PATCH   |
| [Freigabestatus einer Banner X-Kampagne aktualisieren](/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1/approvebannerxcampaign-1.md) | Aktualisiert den Genehmigungsstatus einer angegebenen Banner-X-Kampagne.                                                                                                         | POST    |
| [Liste aller Banner X-Kampagnen abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcampaign-1/listbannerxcampaigns.md)                   | Ruft eine Liste von Banner-X-Kampagnen basierend auf angegebenen Filtern und Parametern ab, einschließlich Kampagnenname, Platzierungs-ID, Team-ID, Genehmigungsstatus und mehr. | GET     |

#### Banner-Kampagne

| Endpunkt                                                                                                                                                 | Beschreibung                                                                                     | Methode |
| -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ------- |
| [Banner-Kampagne erstellen](/retail-media-interface/partner/de/campaign-management-api/bannercampaign/createbannercampaign-1.md)                         | Erstellt eine neue Banner-Kampagne unter Verwendung der im Anforderungstext angegebenen Details. | POST    |
| [Banner-Kampagnendetails abrufen](/retail-media-interface/partner/de/campaign-management-api/bannercampaign/getbannercampaign-1.md)                      | Ruft Details zur Banner-Kampagne für die angegebene Kampagnen-ID ab.                             | GET     |
| [Banner-Kampagne aktualisieren](/retail-media-interface/partner/de/campaign-management-api/bannercampaign/updatebannercampaign.md)                       | Aktualisiert eine bestehende Banner-Kampagne unter Verwendung der Kampagnen-ID.                  | PATCH   |
| [Freigabestatus einer Banner-Kampagne aktualisieren](/retail-media-interface/partner/de/campaign-management-api/bannercampaign/approvebannercampaign.md) | Aktualisiert den Genehmigungsstatus einer angegebenen Banner-Kampagne                            | POST    |

#### Kampagnendateien

| Endpunkt                                                                                                                      | Beschreibung                                                                                      | Methode |
| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------- |
| [Eine Kampagnendatei hochladen](/retail-media-interface/partner/de/campaign-management-api/creativeassets/uploadfile.md)      | Lädt verschiedene Typen von Kampagnendateien hoch                                                 | POST    |
| [Kampagnendatei-URL abrufen](/retail-media-interface/partner/de/campaign-management-api/creativeassets/getcampaignfileurl.md) | Ruft die URL einer Kampagnendatei unter Verwendung der angegebenen Datei-ID und des Dateityps ab. | POST    |

#### Inhaltsstandard

| Endpunkt                                                                                                                                                                     | Beschreibung                                                                                                                                       | Methode |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Banner X Standard-Inhaltsdetails abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcontentstandard/getbannerxcontentstandard-1.md)                 | Ruft Banner X Inhaltsstandard-Details für die angegebene Inhaltsstandard-ID ab.                                                                    | GET     |
| [Liste der Inhaltsstandards für Banner X-Kampagnen abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcontentstandard/listbannerxcontentstandard.md) | Ruft die Liste der Inhaltsstandards für Banner X Kampagnen basierend auf den angegebenen Parametern wie Namespace, Name und Inhaltsstandard-ID ab. | GET     |
| [Standard-Inhaltsdetails für Banner abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcontentstandard/getbannercontentstandard.md)                  | Ruft Banner-Inhaltsstandard-Details für die angegebene Inhaltsstandard-ID ab.                                                                      | GET     |
| [Liste der Inhaltsstandards für Banner-Kampagnen abrufen](/retail-media-interface/partner/de/campaign-management-api/bannerxcontentstandard/listbannercontentstandard.md)    | Ruft die Liste der Inhaltsstandards für Banner-Kampagnen basierend auf den angegebenen Parametern wie Namespace, Name und Inhaltsstandard-ID ab.   | GET     |

#### Kampagne

| Endpunkt                                                                                                                                        | Beschreibung                                                                                                                                                                          | Methode |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Liste aller Kampagnen abrufen](/retail-media-interface/partner/de/campaign-management-api/campaign/listcampaigns-1.md)                         | Ruft eine Liste von Kampagnen basierend auf angegebenen Filtern und Parametern ab, einschließlich Kampagnenname, Kampagnentyp, Platzierungs-ID, Team-ID, Genehmigungsstatus und mehr. | POST    |
| [Kampagnenverlauf abrufen](/retail-media-interface/partner/de/campaign-management-api/campaign/getcampaignhistory.md)                           | Ruft den Verlauf einer Kampagne anhand ihrer Kampagnen-ID ab.                                                                                                                         | GET     |
| [Details zum Mindestgebot für Keywords abrufen](/retail-media-interface/partner/de/campaign-management-api/campaign/retrievekeywordsminbid.md)  | Ruft einzelne Mindestgebot-Details und das Gesamtmindestgebot der Kampagne für ein Array von angegebenen Keywords in Kampagnen vom Platzierungstyp Suche sowie Kategorie & Suche ab.  | POST    |
| [Details zum Mindestgebot für Kategorie abrufen](/retail-media-interface/partner/de/campaign-management-api/campaign/retrievecategoryminbid.md) | Ruft einzelne Mindestgebot-Details und das Gesamtmindestgebot der Kampagne für Kampagnen vom Platzierungstyp Kategorie ab.                                                            | POST    |

## Werbemittel-Asset-Management

### Was ist ein Werbemittel-Asset?

Werbemittel-Assets sind Bilder, die in Banner- und Banner X -Kampagnen verwendet werden. Diese Assets müssen spezifische technische Anforderungen erfüllen, um eine ordnungsgemäße Anzeige und Leistung zu gewährleisten.

### Richtlinien zum Hochladen:

* Dateigröße < 4 MB
* Dateitypen: PNG, JPEG, JPG, GIF, SVG und PDF
* Eine Datei auf einmal
* Team-ID, Slot-ID und Inhaltsstandard-ID sind Pflichtfelder
* Geben Sie einen vollständigen absoluten Pfad zur Datei an

{% hint style="info" %}
Das Hochladen von Werbemittel-Assets erfolgt über die im Abschnitt Kampagnenmanagement oben aufgeführten Kampagnendatei-Endpunkte.
{% endhint %}

## Inhaltsstandard-Management

### Was ist ein Inhaltsstandard?

Inhaltsstandards sind Richtlinien und technische Parameter, die festlegen, wie eine Banner- oder Banner X -Anzeige in einem dafür vorgesehenen Bereich auf einer Website oder digitalen Plattform angezeigt werden soll. Standards umfassen Parameter wie Abmessungen und Größe, Dateiformat und -größen, Auflösung und Qualität, Positionierung und Ausrichtung, Inhaltsbeschränkungen und Interaktivität.

### Team- & Benutzer-Management

#### Was ist ein Team?

Ein Team ist eine Sammlung von Benutzern und wird entweder als Lieferanten- (Werbetreibenden-) oder Händler-Team klassifiziert. Lieferanten-Teams erstellen in der Regel Kampagnen, während Händler Kampagnen überprüfen und administrative Aufgaben ausführen. Ein Benutzer im System kann mehreren Teams oder nur einem angehören. Typischerweise sind einem Team Benutzer, Kampagnen und Wallets zugeordnet.

#### Team

| Endpunkt                                                                                                 | Beschreibung                                                                                                             | Methode |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------- |
| [Team erstellen](/retail-media-interface/partner/de/team-user-api/team/createteam-1.md)                  | Erstellt ein neues Team.                                                                                                 | POST    |
| Ein Team aktualisieren                                                                                   | Aktualisiert die Details eines durch die team\_id angegebenen Teams.                                                     | PATCH   |
| Alle Teams auflisten                                                                                     | Ruft eine Liste von Teams unter Angabe von Parametern wie name, namespace\_id und seller\_id ab.                         | GET     |
| [Team für die angegebene ID abrufen](/retail-media-interface/partner/de/team-user-api/team/getteam-1.md) | Ruft detaillierte Informationen über ein bestimmtes Team ab, einschließlich seiner Mitglieder.                           | GET     |
| Einem Team mit einem Einladungstoken beitreten                                                           | Ermöglicht Benutzern den Beitritt zu einem Team unter Verwendung eines gültigen und nicht abgelaufenen Einladungstokens. | POST    |

#### Benutzer

| Endpunkt                                                                                                                      | Beschreibung                                                                                          | Methode |
| ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ------- |
| [Laden Sie einen Benutzer in das Team ein](/retail-media-interface/partner/de/team-user-api/user-1/createuserteaminvite.md)   | Sendet eine Einladung an einen Benutzer, einem bestimmten Team beizutreten.                           | POST    |
| Benutzerdetails mithilfe der Benutzer-ID abrufen                                                                              | Ruft die Details des Benutzers ab, der derzeit angemeldet ist bei der Epsilon Retail Media Plattform. | GET     |
| [Benutzerdetails abrufen](/retail-media-interface/partner/de/team-user-api/user-1/getusersforteam.md)                         | Ruft Benutzerdetails basierend auf der angegebenen Team-ID ab.                                        | GET     |
| [Details des aktuellen Benutzers aktualisieren](/retail-media-interface/partner/de/team-user-api/user-1/updateuserprofile.md) | Ändert die Details des derzeit angemeldeten Benutzers auf der Epsilon Retail Media Plattform.         | PATCH   |
| [Benutzerberechtigung ändern](/retail-media-interface/partner/de/team-user-api/user-1/modifyuserpermission.md)                | Aktualisiert die Berechtigungen eines Benutzers durch Angabe von Benutzer-ID und Team-ID.             | PATCH   |
| [Eine Datei hochladen](/retail-media-interface/partner/de/team-user-api/user-1/uploadfile-1.md)                               | Lädt Logos für Benutzerprofile und Teams hoch.                                                        | POST    |
| [Datei-URL abrufen](/retail-media-interface/partner/de/team-user-api/user-1/getfileurl.md)                                    | Ruft die URL für ein Team- oder Benutzer-Logo unter Verwendung der angegebenen Datei-ID ab.           | POST    |
| Einen Benutzer entfernen                                                                                                      | Entfernt einen Benutzer aus dem Team.                                                                 | DELETE  |

### Abrechnung & Wallet-Verwaltung

#### Was ist ein Wallet?

Ein Wallet speichert das Guthaben eines Werbetreibenden zum Zweck von Zahlungen (z. B. für die Bezahlung geschalteter Anzeigen).

#### Wallet

| Endpunkt                                                                                                                 | Beschreibung                                                                                                                                           | Methode |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [Erstellen Sie eine Geldbörse](/retail-media-interface/partner/de/billing-api/wallet/createwallet.md)                    | Erstellt ein Wallet innerhalb eines angegebenen Namespaces und verknüpft es unter Verwendung der Team-ID mit einem Team.                               | POST    |
| [Ein Wallet aktualisieren](/retail-media-interface/partner/de/billing-api/wallet/updatewallet-1.md)                      | Aktualisiert ein Wallet innerhalb eines angegebenen Namespaces und einer teamId.                                                                       | PATCH   |
| [Geldbörse nach ID abrufen](/retail-media-interface/partner/de/billing-api/wallet/getwallet-1.md)                        | Ruft die Details eines bestimmten Wallets unter Verwendung seiner eindeutigen Kennung {id} ab.                                                         | GET     |
| [Alle Geldbörsen auflisten](/retail-media-interface/partner/de/billing-api/wallet/listwallets.md)                        | Ruft eine Liste von Wallets basierend auf angegebenen Filtern und Parametern ab, einschließlich Team-ID, Wallet-Name, Wallet-ID, externer ID und mehr. | GET     |
| [Guthaben einer bestimmten Geldbörse abrufen](/retail-media-interface/partner/de/billing-api/wallet/getwalletbalance.md) | Ruft den aktuellen Kontostand eines angegebenen Wallets ab.                                                                                            | GET     |
| [Guthaben für eine bestimmte Geldbörse verwalten](/retail-media-interface/partner/de/billing-api/wallet/managefunds.md)  | Verwaltet Guthaben-Aktionen für ein bestimmtes Wallet.                                                                                                 | POST    |

#### Ausgaben

| Endpunkt                                                                                                         | Beschreibung                                                                                                           | Methode |
| ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ------- |
| [Ausgabendetails der Kampagne abrufen](/retail-media-interface/partner/de/billing-api/spend/getcampaignspend.md) | Berechnet das verbleibende Budget für bestimmte Kampagnen basierend auf deren verfügbarem Guthaben und Ausgabenlimits. | POST    |

### Massenoperation

#### Kampagne

| Endpunkt                                                                                                                                              | Beschreibung                                                                                                 | Methode |
| ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ------- |
| [Kampagnen in Gesamtheit erstellen](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkcreatecampaign.md)               | Erstellt mehrere Kampagnen gleichzeitig (bis zu 1.000) basierend auf dem Kampagnentyp.                       | POST    |
| [Kampagnen in Gesamtheit aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkupdatecampaign-1.md)         | Aktualisiert Kampagnen innerhalb eines angegebenen Namespaces.                                               | PATCH   |
| [Genehmigungsstatus der Kampagne aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkcampaignoperations/bulkcampaignapproval.md) | Genehmigt oder lehnt Kampagnen innerhalb eines angegebenen Namespaces ab.                                    | POST    |
| Status der Massenoperation abrufen                                                                                                                    | Ruft den Status und die Details einer Kampagnen-Massenoperation unter Verwendung der Massenoperations-ID ab. | GET     |

#### Wallet

| Endpunkt                                                                                                                                        | Beschreibung                                                                          | Methode |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------- |
| [Geldbörsen in Gesamtheit erstellen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations/bulkcreatewallet.md)            | Erstellen Sie mehrere Wallets auf einmal innerhalb Ihrer Organisation (bis zu 1.000). | POST    |
| [Status der Geldbörsen-Sammeloperation abrufen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations/bulkwalletstatus.md) | Ruft den Status einer Wallet-Massenoperation unter Verwendung ihrer Massen-ID ab.     | GET     |
| [Geldbörsen in Gesamtheit aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations/bulkupdatewallet.md)        | Aktualisiert mehrere Wallets gleichzeitig.                                            | PATCH   |

#### Team

| Endpunkt                                                                                                                                  | Beschreibung                                                                    | Methode |
| ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------- |
| [Teams in Gesamtheit erstellen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations-1/bulkcreateteam.md)           | Erstellt Massen-Teams für eine Organisation.                                    | POST    |
| [Teams in Gesamtheit aktualisieren](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations-1/bulkupdateteam.md)       | Aktualisiert mehrere Teams gleichzeitig.                                        | PATCH   |
| [Status der Team-Sammeloperation abrufen](/retail-media-interface/partner/de/bulk-operation-api/bulkwalletoperations-1/bulkteamstatus.md) | Ruft den Status einer Team-Massenoperation unter Verwendung ihrer Massen-ID ab. | GET     |

### Vorgeschlagener Suchbegriff

#### Was sind vorgeschlagene Suchbegriffe?

Vorgeschlagene Suchbegriffe sind eine Sammlung von Begriffen, die über eine Datei vom Händler bereitgestellt werden und Produkte mit bestimmten Begriffen verknüpfen, die dem Benutzer beim Erstellen einer Kampagne im Schritt „Suchbegriffe“ präsentiert werden. Weitere Informationen finden Sie unter Vorgeschlagene Suchbegriffe.

| Endpunkt                                                                                                                                                     | Beschreibung                                                                                                                                      | Methode |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| [Listet alle vorgeschlagenen Suchbegriffe auf](/retail-media-interface/partner/de/suggested-search-term-api/suggestedsearchterm/listsuggestedsearchterms.md) | Ruft vorgeschlagene Suchbegriffe für Katalog-Targeting-Suchbegriffe basierend auf angegebenen Parametern wie Katalog-ID, Produktcode und mehr ab. | GET     |

## Best Practices

Befolgen Sie diese Best Practices, um eine reibungslose, effiziente und zuverlässige Integration mit den Epsilon Retail Media Partner-APIs zu gewährleisten:

* Testen Sie vor der Bereitstellung in der Produktionsumgebung immer in der Sandbox.
* Verwenden Sie Massen-Endpunkte für mehrere Operationen.
* Prüfen Sie Fehlerantworten auf spezifische Datenprobleme.
* Verwenden Sie komprimierte Dateien für schnellere Daten-Uploads.
* Aktualisieren Sie Zugriffstoken nur, wenn sie abgelaufen sind.
* Validieren Sie erforderliche Felder vor dem Absenden von Anfragen.

## Fehlerbehandlung

Unsere Partner-APIs liefern strukturierte JSON-Fehlerantworten, um eine robuste Ausnahmebehandlung zu unterstützen.

* **HTTP-Statuscode**: Standard-Fehlercodes (400, 401, 403, 500 usw.)
* **Fehlercode**: Spezifische Fehlerkennung.
* **Meldung**: Menschenlesbare Fehlerbeschreibung.
* **Feldverletzungen**: Spezifische Feldvalidierungsfehler für Dateneingabeprobleme.

Detaillierte Informationen zur Fehlerbehandlung finden Sie unter [Fehlerbehandlung](/retail-media-interface/partner/de/partner-api-overview/error-handling.md).

## Support und Ressourcen

| Ressource                                                                                                        | Beschreibung                                                                                 |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| [Häufig gestellte Fragen](/retail-media-interface/partner/de/partner-api-overview/frequently-asked-questions.md) | Häufige Fragen und Antworten zur API-Nutzung und -Integration.                               |
| Versionshinweise                                                                                                 | Zusammenfassung der jüngsten Aktualisierungen oder Änderungen an der API.                    |
| [Glossar](https://developers.citrusad.com/partner/docs/createupdate-campaign-fields-1)                           | Definitionen von Schlüsselbegriffen, die in der gesamten API-Dokumentation verwendet werden. |


---

# 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/de/partner-api-overview/epsilon-retail-media-partner-apis-overview-1.md?ask=<question>&goal=<endgoal>
```

`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.