Einführung

Sie können alle Ihre Rakuten Advertising Berichte, sowohl standardisierte als auch angepasste, über die Reporting-API ausführen. Dies ermöglicht es Ihnen, Berichte zu erstellen, ohne sich in Ihr Konto einzuloggen.

Anleitung

Befolgen Sie diese Schritte, um die API-URL für Ihre Berichte zu erhalten:

1. Zugriff auf die Reporting-Schnittstelle.
2. Wählen Sie einen Standardbericht aus dem Dropdown-Menü Berichte auswählen oder erstellen Sie Ihren eigenen.
3. Legen Sie einen Datumsbereich für Ihren Bericht fest.
4. Wenn Sie den Bericht weiter anpassen möchten, wenden Sie Filter an oder fügen Sie Metriken und Datenpunktspalten hinzu oder entfernen Sie diese, und klicken Sie dann auf Bericht speichern.
5. Klicken Sie auf den Pfeil neben Bericht anzeigen und wählen Sie API abrufen:

   

6. Ein Pop-up zum Abrufen der API-URL erscheint. Es zeigt eine URL an, die Ihr Web-Token enthält. Kopieren Sie die API-URL und speichern Sie sie an einem sicheren Ort.

Anwendung

Sie können die API-URL jederzeit in einen Browser einfügen, um Ihren Bericht zu generieren, ohne auf die Reporting-Schnittstelle zugreifen zu müssen. Die CSV-Datei mit Ihren Berichtsdaten wird auf Ihren Computer heruntergeladen. CSV-Dateien können in Excel geöffnet werden.

API-URL

Sie können bestehende API-Parameter, die Sie derzeit verwenden, ändern oder neue Reporting-API-URLs erstellen, ohne zur Reporting-Schnittstelle zurückzukehren. Dies ist ein Beispiel für eine API-URL:

https://ran-reporting.rakutenmarketing.com/en/reports/revenue-report-by-day/filters?start_date=20XX-10-25&end_date=20XX-10-26&include_summary=Y&network=1&previous-start-date=20XX-09-25& previous-end-date=20XX-09-26&tz=GMT&date_type=process&date_format=m-d-yy&token=xxxxxxx

Sie können die in Grün dargestellten Teile bearbeiten. Klicken Sie auf das + neben jedem Parameternamen für weitere Informationen:

Voreingestellte Datumsbereiche

Sie können genaue Start- und Enddaten sowie voreingestellte Datumsbereiche in der API-URL verwenden. Die Verwendung voreingestellter Datumsbereiche erspart Ihnen die Berechnung der spezifischen Daten für Ihre API-Aufrufe. Wenn Sie einen voreingestellten Datumsbereich aus dem Dropdown-Menü in der Reporting-Schnittstelle auswählen, verwendet die Get-API-URL diesen voreingestellten Wert wie folgt:

Wenn Sie Ihren Bericht mit einem anderen Zeitraum vergleichen, können Sie diese Werte für den previous_date_range verwenden:

Wenn Sie einen benutzerdefinierten Datumsbereich mit dem Datumswähler in der Reporting-Schnittstelle auswählen, zeigt die API-URL die spezifischen Daten an. Wenn Sie beispielsweise einen benutzerdefinierten Datumsbereich mit dem 22. April 20XX als Startdatum und dem 5. Mai 20XX als Enddatum auswählen, enthält die URL:

/filters?start_date=20XX-04-22&end_date=20XX-05-05

Der ausgewählte Zeitzonenversatz wird auf Ihren Bericht angewendet. Daten und Zeiten spiegeln nur die Zeitzone für die Spalten Transaktionsdatum, Transaktionszeit, Bearbeitungsdatum und Bearbeitungszeit wider.

Der Zeitzonenversatz wird auf Berichte angewendet, die diese Spalten nicht enthalten, wie den Sales and Activity Report. Berichte, die diese Spalten enthalten, wie der Individual Item Report, haben ebenfalls den Zeitzonenversatz angewendet, wie im konvertierten Transaktionsdatum und -zeit zu sehen ist.

Die Zeitzonenumrechnung wird jedoch nicht für die folgenden Datums- und Zeitspalten durchgeführt:

• Buchungsverbrauchsdatum
• Klickdatum
• Bestellversanddatum
• Signature-Abgleichsdatum
• Signature-Abgleichszeit
• Transaktionserstellungsdatum
• Transaktionserstellungszeit

Datumsformat-Parameter

Dieser Parameter ist optional und hat Standardwerte. Sie können die date_format-Parameterwerte in der Get-API-URL eingeben. Sie können entweder kodierte oder nicht kodierte Werte verwenden.

API-Limit

Sie können jeweils nur einen Reporting-API-Aufruf ausführen. Wenn Sie mehr als eine Anfrage gleichzeitig senden, erhalten Sie einen Fehler bei den zusätzlichen Anfragen und bei allen weiteren Anfragen, bis eine oder mehrere Ihrer bestehenden Anfragen abgeschlossen sind. Der Fehler ist eine HTTP 429-Antwort mit der Nachricht Sie haben Ihre Anfragelimits für diese Sitzung überschritten, bitte versuchen Sie es später erneut.

Wenn Sie Skripte verwenden, um API-Aufrufe auszuführen, stellen Sie sicher, dass Ihr Skript nicht versucht, mehrere Aufrufe gleichzeitig auszuführen. Vermeiden Sie beispielsweise die Verwendung von Thread-Schleifen, die unbegrenzte Aufrufe tätigen. Wenn Sie viele Aufrufe tätigen müssen, fügen Sie eine Pause oder ein Limit in Ihrem Code zwischen den Anfragen ein.

API-Fehler

Sie können einen Fehlercode oder eine Fehlermeldung erhalten, wenn Sie Ihre Berichte über die API ausführen. Sehen Sie sich Beispiele für mögliche API-Fehler und Anweisungen zur Behebung an. Für zusätzliche Unterstützung bei API-Fehlern kontaktieren Sie den Kundensupport.