Einführung

Das Postback API wird über das Rakuten Advertising API Developer Portal bereitgestellt. Besuchen Sie das Portal, um eine vollständige Liste der von uns angebotenen APIs zu finden.

Anwendung

Das Postback API ermöglicht es Ihnen, Transaktionsereignisse zu empfangen, während sie in unserem System verarbeitet werden. Es ist so konzipiert, dass sie ähnliche Daten wie das Events API bereitstellt, mit dem Unterschied, dass wir diese Daten an Sie weiterleiten, damit Sie es nicht über das Events API abrufen müssen.

Sie können das API verwenden, um:

• Postbacks für eine bestimmte Publisher ID einzurichten.
• Postback URL zu aktualisieren.
• Die Postback-URL zu löschen.
• Postback zu aktivieren oder deaktivieren.

Beta Funktionalität

Die Postback-API befindet sich derzeit in der Beta-Phase, da wir auf der Suche nach Benutzer-Feedback für Verbesserungen sind. Die Funktionalität des Postbacks wird durch künftige Ergänzungen nicht beeinträchtigt. Die Verbesserungen betreffen nur die Interaktion der Benutzer mit dem API.

Zugang

Eine ausführliche Anleitung zur Verwendung des Postback API finden Sie im Portal. Verwenden Sie Ihre Anmeldedaten für das Publisher Dashboard, um sich anzumelden.

Bevor Sie beginnen, benötigen Sie Folgendes:

• Eine URL für das Postback. Diese URL ist anpassbar, wie unten beschrieben.
• Den API Zugangstoken. Anweisungen zum Abrufen eines API-Zugriffstokens anzeigen.

Außerdem muss Ihr Benutzerkonto mit der Publisher ID verknüpft sein, die das Postback implementiert.

Einrichten einer Postback-URL

Die Postback-API kann dynamische URLs unterstützen, so dass Sie die Ausgabe individuell anpassen können. Ihre Postback-URL sollte enthalten:

1. Ihre Website-URL.
2. Das Feld is_event=<is_event>.
3. Parameter für alle anderen Felder, die Sie aufnehmen möchten. Diese sind anpassbar; weitere Informationen finden Sie im Abschnitt Anpassbare Felder weiter unten. Wenn Sie mehrere Parameter angeben, sollten diese durch ein Ampersand (&) getrennt werden.

Wenn Ihre Website beispielsweise https://www.my-pretty-postback-URL.com ist und Sie die Felder transaction_date und sku_number einbeziehen möchten, lautet Ihre Postback URL:

https://www.my-pretty-postback-URL.com?is_event=<is_event>& transaction_date=<transaction_date>&sku_number=<sku_number>

Weitere Informationen über den Zweck des Feldes is_event=<is_event> und wie Sie Ihre Daten interpretieren können, finden Sie in der Anleitung zu den Events API-Transaktionen im Developer Portal.

Anpassbare Felder

Die folgenden Anpassungen sind zulässig:

• Umbenennung von Feldnamen.
• Empfang nur bestimmter Felder.
• Neuanordnung der Felder.
• Verwendung statischer Werte.

Wir empfehlen Ihnen, die allgemeinen Fragen zum Events API und den Anleitungen zum Events API Push/Postback im Developer Portal zu lesen, um eine Liste der verfügbaren Felder und Beispiele für Postback-Anpassungen zu erhalten

Beispiele für Anpassungswünsche

• Beispiel 1: Umbenennen von u1 in unique_id
• Beispiel 2: Füllen Sie nur die folgenden Felder aus:
  • transaction_date
  • sku_number
  • Menge
  • Kommissionen
• Beispiel 3: Nehmen Sie nur die folgenden Felder auf und benennen Sie diese um:
  • transaction_date
  • sku_number
  • Menge
  • Kommissionen
  • Umbenennen von u1 in unique_id

Fehlerbehebung

Wenn Ihr Postback-Endpunkt falsche oder gar keine Daten empfängt, bitte:

• Vergewissern Sie sich, dass Ihr Endpunkt unser Timeout-Limit von 400 ms einhält. Unser Server sendet keine Daten, wenn Ihre Endpunkt-URL länger als 400 ms braucht, um auf die Anfrage zu antworten. Es wird nur ein Verbindungsversuch unternommen. Die Daten werden nicht erneut gesendet, wenn ein Verbindungsversuch abgebrochen wird oder fehlschlägt.
• Prüfen Sie, ob Daten vorhanden sind, indem Sie einen Individual Item Report mit dem Feld Mitglieds-ID (u1) ausführen. Beachten Sie, dass es bis zu vier Stunden dauern kann, bis die Daten in einem Bericht angezeigt werden.
• Sie werden nicht benachrichtigt, wenn Ihr Postback automatisch deaktiviert wird. Wir empfehlen Ihnen, den API-Aufruf für den Endpunktstatus zu verwenden, um zu prüfen, ob ein Postback deaktiviert oder aktiv ist.

Eine Liste spezifischer Fehlermeldungen und deren Bedeutung finden Sie auch in den Anleitungen des Developer Portals Wenn Sie immer noch Probleme haben, wenden Sie sich an den Kundendienst und geben Sie die Bestell-IDs oder die Daten an, an denen die Daten nicht empfangen wurden.