Zum Hauptinhalt springen
Die Events API ermöglicht es Ihnen, Echtzeit-Benutzerinteraktionsdaten an Topsort zu senden. Diese Daten treiben Kampagnen-Attribution, Reporting und Optimierungsalgorithmen an.

​
Ereignistypen

Topsort verfolgt drei Kern-Ereignistypen:
EreignisBeschreibungWann senden
ImpressionBenutzer sieht ein beworbenes ProduktWenn ein gesponsertes Produkt auf dem Bildschirm gerendert wird
KlickBenutzer klickt auf ein beworbenes ProduktWenn ein Benutzer auf ein gesponsertes Produkt klickt
KaufBenutzer schließt eine Transaktion abWenn eine Bestellung bestätigt wird

​
Integrationsoptionen

Direkte API

Senden Sie Ereignisse direkt an die Events API von Topsort für maximale Kontrolle und Flexibilität.

Analytics.js

Verwenden Sie unser JavaScript SDK für einfache clientseitige Ereignisverfolgung.

Twilio Segment

Leiten Sie Ereignisse über Segment weiter, wenn Sie es bereits für Analytics verwenden.

RudderStack

Integrieren Sie über RudderStack für einheitliche Ereignisweiterleitung.

​
Schlüsselkonzepte

​
Resolved Bid ID

Die resolvedBidId ist eine eindeutige Kennung, die von der Auctions API zurückgegeben wird und ein Ereignis mit einem bestimmten Auktionsgewinner verknüpft. Diese ist für Impressions- und Klick-Ereignisse erforderlich, um eine korrekte Attribution zu ermöglichen. 
{
  "impressions": [
    {
      "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4MjgtOGVh...",
      "occurredAt": "2023-05-01T12:00:00Z"
    }
  ]
}

​
Ereignis-Attribution

Ereignisse werden Kampagnen basierend auf folgenden Kriterien zugeordnet:
  • Direkte Attribution: Benutzer interagiert mit einem beworbenen Produkt und konvertiert
  • Halo-Attribution: Benutzer sieht ein beworbenes Produkt, kauft aber ein anderes Produkt desselben Anbieters
Erfahren Sie mehr über Attributionsmodelle.

​
Implementierungsschritte

1

Resolved Bid ID speichern

Speichern Sie beim Anzeigen von Auktionsgewinnern die resolvedBidId aus der Auktionsantwort.
2

Impressionen verfolgen

Senden Sie ein Impressions-Ereignis, wenn ein gesponsertes Produkt für den Benutzer sichtbar wird.
3

Klicks verfolgen

Senden Sie ein Klick-Ereignis, wenn ein Benutzer auf ein gesponsertes Produkt klickt.
4

Käufe verfolgen

Senden Sie Kauf-Ereignisse, wenn Bestellungen abgeschlossen werden, einschließlich aller gekauften Produkte.

​
Beispiel: Ereignisse senden

curl -X POST https://api.topsort.com/v2/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "impressions": [
      {
        "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4...",
        "occurredAt": "2023-05-01T12:00:00Z"
      }
    ],
    "clicks": [
      {
        "resolvedBidId": "WyJiX01mazE1IiwiMTJhNTU4...",
        "occurredAt": "2023-05-01T12:00:05Z"
      }
    ]
  }'

​
Nächste Schritte

Agustin - Integrations Team MemberAmelia - Integrations Team MemberBernardita - Integrations Team MemberBorumy - Integrations Team MemberFelipe - Integrations Team MemberGui - Integrations Team MemberJaviera - Integrations Team MemberLinn - Integrations Team MemberMarcio - Integrations Team MemberMateus - Integrations Team MemberMax - Integrations Team MemberRodrigo - Integrations Team Member

Brauchen Sie Hilfe bei Ihrer Topsort-Integration?

Sprechen Sie mit uns, dem Integrations-Engineering-Team.Erreichen Sie uns über Ihren dedizierten Nachrichtenkanal oder unter support@topsort.com.Falls Sie noch kein Kunde sind, buchen Sie eine Demo mit unserem Vertriebsteam.