> 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/frequently-asked-questions.md). # Häufig gestellte Fragen ## Sammeloperationen mit Partner-APIs ### Was sind Sammeloperationen? Sammeloperationen ermöglichen es Ihnen, mehrere Kampagnen, Wallets oder Teams in einer einzigen API-Anfrage zu erstellen, zu bearbeiten oder zu genehmigen, anstatt einzelne Aufrufe zu tätigen. ### Sind Sammeloperationen synchron oder asynchron? Asynchron. Sie senden einen Auftrag (Job) ab und fragen die Ergebnisse unter Verwendung der Sammel-ID (Bulk ID) ab. ### Was passiert, wenn einige Elemente in meiner Sammelanfrage fehlschlagen? Jedes Element wird unabhängig validiert. Sie erhalten detaillierte Ergebnisse, die zeigen, welche erfolgreich waren und welche mit spezifischen Fehlermeldungen fehlgeschlagen sind. ## Team und Benutzer ### Was ist eine Einladung? Eine Einladung ermöglicht es einem Benutzer, einem Team in der Epsilon Retail Media Plattform beizutreten. Einladungen werden in der Regel von Team-Administratoren gesendet und müssen entweder per E-Mail oder innerhalb der Plattform akzeptiert werden, bevor der Benutzer auf Team-Ressourcen zugreifen kann. ### Wie erstelle ich ein neues Team? Verwenden Sie den [Team erstellen](/retail-media-interface/partner/de/team-user-api/team/createteam-1.md) Endpunkt mit den erforderlichen Feldern wie Teamname, Unternehmensinformationen und Namespace-ID. Sie benötigen entsprechende Berechtigungen, um Teams innerhalb Ihrer Organisation zu erstellen. ### Kann ich mehreren Teams angehören? Ja, Benutzer können gleichzeitig mehreren Teams angehören. Jede Team-Mitgliedschaft kann unterschiedliche Berechtigungsstufen und Rollen haben. ### Was ist der Unterschied zwischen Retailer- und Supplier-Teams? Retailer-Teams verwalten und überprüfen Kampagnen, während Supplier-Teams (Werbetreibende) Kampagnen erstellen und verwalten. Der Teamtyp bestimmt die verfügbaren Funktionen und Berechtigungen. ### Wie ändere ich meine Benutzerberechtigungen? Team-Administratoren können Benutzerberechtigungen über den Endpunkt Benutzerberechtigung ändern anpassen. Zu den Berechtigungstypen gehören Vollzugriff und Berichtsansicht für Retailer- und Supplier-Rollen. ### Was passiert, wenn ich einen Benutzer aus einem Team entferne? Wenn Sie einen Benutzer entfernen, wird dessen Zugriff auf die Ressourcen, Kampagnen und Daten dieses Teams widerrufen. Der Benutzer erhält keine Team-Benachrichtigungen mehr und kann keine teamspezifischen Aktionen mehr ausführen. ### Wie lange sind Einladungs-Tokens gültig? Einladungs-Tokens haben eine Ablauffrist. Wenden Sie sich an Ihren Team-Administrator, wenn Ihre Einladung abgelaufen ist und Sie eine neue benötigen. ### Kann ich Team-Informationen nach der Erstellung aktualisieren? Ja, verwenden Sie den Endpunkt Team aktualisieren, um Teamdetails einschließlich Name, Unternehmensinformationen, Telefonnummer, Website-URL und Adresse zu ändern. ### Welche Dateitypen kann ich für Logos hochladen? Der [Eine Datei hochladen](/retail-media-interface/partner/de/team-user-api/user-1/uploadfile-1.md) Endpunkt unterstützt gängige Bildformate für Team- und Benutzerprofil-Logos. Überprüfen Sie die API-Dokumentation auf spezifische Dateigrößen- und Format-Anforderungen. ### Wie finde ich Teams, denen ich beitreten kann? Verwenden Sie den Endpunkt Alle Teams auflisten mit entsprechenden Filtern wie Name, `namespace_id`, or `seller_id` um verfügbare Teams innerhalb Ihrer Organisation zu entdecken. ## Kampagnen auflisten ### Wann sollte ich `managedOnly`verwenden? Im Epsilon Retail Media System werden einige Kampagnen von Händlern (Retailern) statt von Lieferanten (Suppliern) verwaltet. Für Produktanzeigen ist der einzige verfügbare Ausgabentyp Feste Platzierung. Verwenden Sie den `managedOnly` Parameter, um nur Kampagnen mit fester Platzierung abzurufen. ## Kampagnen erstellen oder aktualisieren ### Wann verwende ich `managerTeamId`? Verwenden Sie den `managerTeamId` Parameter beim Erstellen oder Aktualisieren von Kampagnen mit fester Platzierung. Wenn Sie `managerTeamId`angeben, müssen Sie auch die relevanten Strategieeinstellungen für die Feste Platzierung festlegen. ### Was ist ein `namespaceId`? Der `namespaceId` ist der eindeutige Bezeichner für den Namespace, in dem Kampagnen erstellt oder aktualisiert werden. Weitere Informationen finden Sie unter Namespaces. Sie können sich auch an Ihren Customer Integration Engineer (CIE) wenden, um diesen Wert zu erhalten. ### Was ist ein `placementId`? Platzierungen geben die Orte an, an denen Anzeigen angezeigt werden. Jede Platzierung im Epsilon Retail Media System hat einen eindeutigen Bezeichner namens `placementId`. Verwenden Sie die [Gibt eine Liste von Platzierungen zurück](/retail-media-interface/partner/de/global-api/placements/listplacements.md) API, um die `placementId`abzurufen. Alternativ können Sie sich an Ihren CIE wenden, um diesen Wert zu erhalten. ### Was ist ein `walletId`? Eine walletId ist der Bezeichner für das Wallet eines Werbetreibenden. Jeder Werbetreibende kann ein oder mehrere Wallets haben. Jedes Wallet verfügt über ein Guthaben an Credits, das es ausgeben kann. Durch das Festlegen der walletId legen Sie fest, welches Wallet des Werbetreibenden für die Kampagne belastet wird. ### Was ist ein `templateId`? Der `templateId` wird in Ad Genius-Implementierungen verwendet. Es wird von den meisten Kunden nicht häufig verwendet und kann im Allgemeinen ignoriert werden. ### Was sind benutzerdefinierte Felder? In der Epsilon Retail Media Plattform benötigen einige Händler benutzerdefinierte Attribute für Kampagnen, wie Bestellungen und Käuferdetails. Ein Beispiel finden Sie unten:
Custom fields.png
Wenn Ihre Integration diese nicht erfordert, können Sie dieses Feld ignorieren. Wenn sie diese erfordert, stellt Ihnen Ihr CIE die notwendigen IDs zur Verfügung. ### Was sind benutzerdefinierte Fragen? In Namespaces mit integrierten Kunden-Targeting-Daten können Werbetreibende Kundensegmente mithilfe von `key:value` -Paarungen ansprechen. Weitere Informationen finden Sie unter Kundendaten. In Namespaces mit benutzerdefinierten Fragen können Sie Werbetreibenden anzeigen, ob diese Fragen optional oder erforderlich sind, und die entsprechende Konfiguration bereitstellen. Ihr CIE kann die `customQuestionIds` bereitstellen, wenn sie in Ihrem Namespace konfiguriert sind. ### Muss ich `startTime` und `endTime`angeben? Sie können dies weglassen, wenn die Kampagne durchgehend laufen soll (always on). Wenn Ihr Werbetreibender einen aktiven Zeitraum festlegen möchte, sollten Sie beide Werte im ISO-8601-Format angeben. ### Wie kann ich eine bestimmte Eigenschaft aktualisieren, ohne das gesamte Kampagnenobjekt bei einer Aktualisierung (PATCH) zu senden? Unsere APIs verwenden eine `mask` Eigenschaft, mit der Sie eine bestimmte Eigenschaft aktualisieren können, ohne das gesamte Kampagnenobjekt zu senden. #### Wichtige Punkte * Platzierung\*\*: Stellen Sie sicher, dass die `mask` Eigenschaft in Ihrer Anfrage korrekt positioniert ist. * **Fehlerbehebung:** Wenn ein Berechtigungsfehler auftritt, überprüfen Sie das Format der Maske in Ihrer Anfrage. #### Beispiele **Ändern einer einfachen Eigenschaft** wie des Kampagnennamens, verwenden Sie Folgendes: ```json { "productCampaign": { "name": "new campaign name" }, "mask": "name" } ``` Ändern einer verschachtelten Eigenschaft\*\* wie der `maxBid`: ```json { "productCampaign": { "strategy": { "auction": { "maxBid": "5" } } }, "mask": "strategy.auction.maxBid" } ``` Ändern mehrerer Eigenschaften\*\* wie `searchTerms` und der `maxBid`, verwenden Sie eine durch Kommas getrennte Liste der Eigenschaften, die Sie aktualisieren, in `mask` Eigenschaft: ```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" } ``` ## Wallet ### Warum benötige ich ein Wallet? Wallets werden verwendet, um Kampagnengelder zu verwalten und sicherzustellen, dass Transaktionen in der richtigen Währung verarbeitet werden. Weitere Informationen finden Sie unter Zweck. ### Kann ich mehrere Wallets haben? Ja, Sie können mehrere Wallets erstellen, um verschiedene Währungen oder Kampagnenbudgets separat zu verwalten. Weitere Informationen finden Sie unter Mehrere Wallets. ### Wo finde ich eine Wallet-ID? Um eine Wallet-ID zu finden, können Sie diese Schritte befolgen: **Legacy-Plattform:** Gehen Sie zur Seite **Team-Abrechnung**, um Ihre Wallet-ID anzuzeigen. **Neue Benutzeroberfläche:** Öffnen Sie den **Wallet-Manager**, um Ihre Wallet-ID zu finden. {% hint style="info" %} Einige Teams verfügen möglicherweise über mehrere Wallets in verschiedenen Währungen. Stellen Sie daher sicher, dass Sie das richtige auswählen. {% endhint %} ### Was ist das aktuelle Guthaben? Das aktuelle Guthaben ist das Guthaben des Wallets ohne angewendete Guthaben-Aufladungen oder Limits. ### Was ist das verfügbare Guthaben? Das verfügbare Guthaben ist der Gesamtbetrag im Wallet, der zu einem bestimmten Zeitpunkt zum Ausgeben zur Verfügung steht. Es umfasst das aktuelle Guthaben zuzüglich eines etwaigen Kreditlimits. ### Was ist ein Tageslimit oder tägliche Ausgaben? Ein Tageslimit ist der maximale Betrag, den Ihr Wallet an einem einzigen Tag ausgeben kann. ### Was ist Budget-Pacing? Budget-Pacing bedeutet, dass alle nicht genutzten Mittel des Tageslimits auf das Tageslimit des nächsten Tages übertragen werden. ### Was ist das verbleibende Tageslimit? Das verbleibende Tageslimit sind die nicht genutzten Mittel des Tageslimits vom Vortag. ### Was ist das gedeckelte verfügbare Guthaben? Das gedeckelte verfügbare Guthaben ist der Betrag, den das Wallet Ihnen für den Tag zum Ausgeben erlaubt, unter Berücksichtigung etwaiger Ausgabenlimits und/oder Aufladeguthaben. Dieser Wert ist entscheidend, da er bestimmt, ob Geld zum Ausgeben verfügbar ist. **Berechnung des gedeckelten verfügbaren Guthabens**: * **Nur Kreditlimit**: Gedeckeltes verfügbares Guthaben = Verfügbares Guthaben. * **Nur Tageslimit**: Gedeckeltes verfügbares Guthaben = Tageslimit + nicht genutzter Übertrag * **Sowohl Kreditlimit als auch Tageslimit werden angewendet**: Minimum von (Verfügbares Guthaben, Tageslimit + Übertrag) Hier sind ein paar Beispiele: * **Beispiel 1**: Kreditlimit ist 10, Wallet-Guthaben ist 20. * **Beispiel 2**: Tagesbudget ist 1000, Wallet-Guthaben ist 10.000. * **Beispiel 3**: Tagesbudget ist 250, Kreditlimit ist 20, Wallet-Guthaben ist 200. In diesem Fall beträgt das gedeckelte verfügbare Guthaben 220, da das verfügbare Guthaben (aktuelles Guthaben + Kreditlimit) geringer ist als das Tageslimit zuzüglich des nicht genutzten Übertrags (250). {% hint style="info" %} Kreditlimits sind eine Legacy-Funktion und werden von den meisten Händlern nicht unterstützt. {% endhint %} ### Kann das Wallet-Guthaben im negativen Bereich liegen? Nein. Wallet-Guthaben können über die Partner-API nicht absichtlich auf negativ gesetzt werden. Obwohl Kampagnenaktivitäten die Guthaben vorübergehend beeinflussen können, ist dieses Verhalten systemgesteuert und nicht vom Benutzer gesteuert. ### Warum kann ich beim Erstellen einer Kampagne kein Wallet auswählen? Die Währung des Wallets muss mit der Währung des Katalogs übereinstimmen. Wenn Ihr Katalog beispielsweise in AUD ist, können Sie kein Wallet in GBP auswählen. Weitere Informationen finden Sie unter [Währungskompatibilität mit Katalogen](/retail-media-interface/partner/de/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/de/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.