Im Folgenden finden Sie einige häufig gestellte Fragen und Antworten zu Events API und Postback API.

Wie unterscheidet sich die Events API vom Bericht zur Medienoptimierung?

Die Events API nutzt ein End-to-End-System, das für eine schnellere Verarbeitung der Daten optimiert ist, um sicherzustellen, dass Benachrichtigungen über die Transaktionen in weniger als zehn Minuten erfolgen können. Der Medienoptimierungsbericht verwendet den traditionellen Datenflussansatz, bevor die Daten für die Berichterstellung verfügbar sind.

Welche Transaktionen sind über die Events API verfügbar?

Die Events API enthält alle Transaktionen, die an unser Netzwerk gemeldet werden. Da wir Advertisern die Möglichkeit bieten, Transaktionen über Enterprise Web Services, Pixel und Batch-Upload-Methoden zu melden, wirkt sich die Zeit, die für die Verarbeitung der über Batch-Prozesse hochgeladenen Transaktionen benötigt wird, auf den Zeitpunkt aus, zu dem die Daten in API verfügbar sind.

Welche Datenfelder sind über die Events API verfügbar?

Die API bietet die folgenden Transaktionsdatenfelder; klicken Sie auf das + für Beschreibungen und Anmerkungen:

etransaction_id

Beschreibung: Dieses Feld, das auch als TID bezeichnet wird, ist eine eindeutige ID für jede Transaktion innerhalb einer Bestellung.

Anmerkungen: Es ist ein alphanumerisches Feld. Wenn ein Verbraucher einen Kauf getätigt hat, der drei verschiedene SKUs enthält, wird API drei Datensätze zurückgeben, einen für jede SKU. Alle drei Datensätze teilen sich einen Wert für die order_id, aber die etransaction_id ist für jeden Datensatz eindeutig.

advertiser_id

Beschreibung: Dieses Feld, auch MID genannt, ist die eindeutige Werbetreibenden-ID.

Hinweise: Numerisches Feld.

SID

Beschreibung: Dieses Feld ist die eindeutige Herausgeber-ID.

Hinweise: Numerisches Feld.

Auftragsnummer (order_id)

Beschreibung: Dieses Feld enthält die eindeutige Bestell-ID des Werbetreibenden für die Bestellung.

Hinweise: Numerisches Feld.

Angebots-ID (offer_id)

Beschreibung: Dieses Feld, das auch als OID bezeichnet wird, enthält die Angebots-ID für das Angebot, für das die Transaktion in Auftrag gegeben wurde.

Anmerkungen: Numerisches Feld

sku_number

Beschreibung: Dieses Feld enthält die SKU für den Artikel.

Anmerkungen: Alphanumerisches Feld Diese ist nur verfügbar, wenn der Advertiser sie meldet.

sale_amount

Beschreibung: In diesem Feld steht der Betrag, den der Verbraucher für diesen Artikel in der Bestellung bezahlt hat.

Anmerkungen: Numerisches Feld

quantity

Beschreibung: Dieses Feld enthält die Menge des gekauften Artikels.

Anmerkungen: Numerisches Feld

Provisionen

Beschreibung: Dieses Feld enthält die gesamte Basisprovision für diese Transaktion.

Anmerkungen: Numerisches Feld

transaction_date

Beschreibung: Dieses Feld enthält das Datum und die Uhrzeit, zu der die Bestellung auf der Website des Werbetreibenden aufgegeben wurde.

Hinweise: Zeitformatfeld.

process_date

Beschreibung: Dieses Feld enthält das Datum und die Uhrzeit, zu der diese Transaktion von Rakuten Advertising verarbeitet wurde. Die Zeitzone ist GMT.

Anmerkungen: Feld Zeitformat

transaction_type

Beschreibung: Dieses Feld gibt an, ob es sich um eine Echtzeit- oder eine Batch-Transaktion handelt.

Anmerkungen: Alphanumerisches Feld.

product_name

Beschreibung: Dieses Feld enthält den Produktnamen des gekauften oder zurückgegebenen Artikels.

Anmerkungen: Alphanumerisches Feld.

u1

Beschreibung: Dies ist ein von Ihnen definiertes Feld, mit dem Sie auf einen bestimmten Kampagnen- oder Mitgliederwert verweisen können. Es bezieht sich auf Ihre &u1=Parameter.

Anmerkungen: Alphanumerisches Feld.

Währung (currency)

Beschreibung: Die Währung des Verkaufsbetrags für die Transaktion.

Anmerkungen: Alphanumerisches Feld.

is_event

Beschreibung: Dieses Feld gibt an, ob es sich bei der Echtzeittransaktion um ein Event oder eine Transaktion handelt.

Anmerkungen: Ja/Nein-Feld

Event: Diese Transaktionen sollen als Indikator für das Auftreten einer Transaktion dienen, die nach der Überprüfung durch den Advertiser eliminiert und per Batch-Upload abgeschlossen werden kann. Sie sollten diese Transaktionen NICHT verwenden, um die endgültigen Provisionszahlungen an Sie zu berechnen. Wenn dies ausgelassen wird, können Fehler beim Reporting auftreten.

Transaktion: Diese Transaktionen sind abgeschlossen, so dass Sie sie als Transaktionen verbuchen können, die vorbehaltlich eventueller Stornierungen bezahlt werden.

Wie hoch ist die erwartete Datenlatenz?

Das SLA für Transaktionen, die über Events API verfügbar sind, beträgt 10 Minuten.

Was bedeutet die „is_event“-Flagge?

Advertiser, die den Batch-Prozess für das Hochladen von Transaktionen verwenden, können Publishern mit Hilfe des Rakuten Affiliate Media Optimization Pixel mit bidirektionalen Informationen über Transaktionen liefern. Die über das Media Optimization Pixel gemeldeten Transaktionen werden in den Ergebnissen mit dem Wert Y (Ja) gekennzeichnet. Sie sollten diese Transaktionen nicht zur Bestimmung der Gesamtprovisionen verwenden, die Sie erhalten. Es ist wichtig zu beachten, dass diese Daten nur von Advertiser unterstützt werden, die für den Bericht zur Medienoptimierungaktiviert sind.

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

Wie oft kann ich den Service abfragen?

Die Häufigkeit der Serviceaufrufe wird durch die Stufe bestimmt, die Sie während des Abonnementprozesses im API Developer Portal ausgewählt haben.

Kann ich Push-Benachrichtigungen über Transaktionen und Ereignisse erhalten, wenn diese eintreten (Postback)?

Ja, Sie können eine URL über die Postback API registrieren. Diese Daten und das Format entsprechen denen, die in der Pull API bereitgestellt werden.

Postbacks können dynamische URLs unterstützen, sodass Sie die Ausgabe Ihres Postbacks anpassen können. Weitere Informationen zu den verfügbaren Feldern und zur Anpassung der Postback-URL finden Sie auf dem Developer Portal.

Warum werden einige Transaktionen nicht von der Events API gemeldet?

Die Events API meldet sowohl Transaktionen, als auch Events, die über die Enterprise Web Services und Batch an Rakuten Affiliate gemeldet werden. Transaktionen, die dem Rakuten Affiliate über eine Batch-Upload-Methode gemeldet werden, werden nicht in der gleichen Zeitspanne angezeigt wie die über Enterprise-Webdienste gemeldeten Transaktionen.

Warum liefert die Events API andere Daten als andere Berichte?

Die Events API meldet sowohl Transaktionen, als auch Events, die über die Enterprise Web Services und Batch an Rakuten Affiliate gemeldet werden. Transaktionen, die Rakuten Affiliate mit einer Batch Upload-Methode gemeldet werden, werden nicht in der gleichen Zeitspanne angezeigt wie die über Enterprise Web Services gemeldeten Transaktionen. Um die Geschwindigkeit sicherzustellen, beschränken wir außerdem die Menge der gespeicherten Klickdaten auf 30 Tage. Für Transaktionen, die aus Klicks resultieren, die älter als 30 Tage sind, hat Events API also keinen u1-Wert, der mit der Transaktion verbunden ist.

Wie funktionieren Stornierungen? Wie wird es in der Events API aussehen?

Stornierungen in der Events API sehen genauso aus wie in anderen Reporting-Tools. Das Transaktionsdatum und die Bestellnummer stimmen mit der ursprünglichen Transaktion überein. Das Bearbeitungsdatum ist das Datum der Stornierung. Einige Werte, wie z.B. "commissions" (Kommissionen) und "sales_amount" (Umsatz), werden negativ sein.