Attribution und Abrechnung - Topsort Documentation

Attribution und Conversion-Tracking

Ihr Conversion-Tracking-Setup bestimmt, wie Umsätze Anzeigen zugeordnet werden und welche Metriken in Topsort verfügbar sind. Einen Überblick über die Integrationsoptionen finden Sie unter Conversion-Tracking.

Topsort interne Attribution

Wenn Ihr Marktplatz Klick- und Kauf-Events an Topsort sendet, kann Topsort Käufe über die interne Attribution den Anzeigen zuordnen. Sie können dasselbe Attributionsfenster und dieselbe Konfiguration über die unterstützten Werbeplattformen hinweg anwenden und so Umsatz und Return on Ad Spend (ROAS) direkt vergleichen. Events an Topsort zu senden bedeutet nicht automatisch, dass jede Werbeplattform sie erhält. Bei einigen Werbeplattformen, darunter Google, leitet Topsort geeignete Conversions weiter. Andere Werbeplattformen benötigen ein separates Conversion-Sharing, um Conversion-Optimierung zu unterstützen. Die Implementierungsschritte finden Sie unter Offsite-Event-Tracking mit Topsort implementieren.

Attribution der Werbeplattform

Wenn Ihr Marktplatz Conversions direkt an eine Werbeplattform sendet, ruft Topsort die resultierenden Reports ab und zeigt sie in der eigenen UI an. Diese Metriken folgen der Attributionsmethodik der Werbeplattform. Unterschiede bei Attributionsfenstern und Einstellungen können Vergleiche zwischen Werbeplattformen beeinflussen. Die interne Attribution von Topsort ist für die Offsite-Integration nicht zwingend erforderlich.

Abrechnungsmodell

Die Offsite-Abrechnung ist marktplatzgesteuert und konsolidiert:

Vendors nutzen kanal-spezifische Wallet-Kapazität (z. B. Google-, Meta-, Snapchat-, TikTok- oder Universal Ads-Wallet).
Der Marktplatz wird für Media Spend direkt vom Kanal abgerechnet.
Der Marktplatz rechnet Vendors gemäß seinen kommerziellen Konditionen ab.

Zahlungsmodelle

Prepay: Vendor lädt Guthaben auf, bevor Ausgaben entstehen.
Postpay: Der Marktplatz setzt Ausgabenlimits und rechnet später ab.

Offsite-Event-Tracking mit Topsort implementieren

Dieser Abschnitt richtet sich an Entwickler, etwa Frontend-Entwickler, die das Event-Tracking implementieren. Er erklärt, wie Klick- und Kauf-Events des Marktplatzes für die interne Attribution an Topsort gesendet werden. Melden Sie Offsite-Events über denselben /v2/events-Endpoint wie Onsite-Events, mit den unten gezeigten zusätzlichen Offsite-Parametern. Die folgende Beispiel-Klick-URL und das Klick-Payload zeigen das Google-Klick-Tracking. Sie sind keine Spezifikation für eine Conversion-Integration mit OpenAI oder Universal Ads.

Opaque User ID

Die für Onsite-Events genutzte opaqueUserId sollte auch für die Offsite-Attribution wiederverwendet werden. Ein separater Offsite-Identifier ist nicht erforderlich. Topsort benötigt einen persistenten, datenschutzkonformen Nutzer-Identifier, um Klicks und Käufe kanalübergreifend zu verknüpfen. Für die Offsite-Nutzung gelten dieselben Anforderungen wie onsite:

Persistenz: Sollte über das Attributionsfenster hinweg stabil bleiben (typischerweise 7–30 Tage).
Konsistenz: Derselbe Nutzer sollte nach Möglichkeit über Besuche und Kanäle hinweg dieselbe ID erhalten.
Datenschutzkonform: Darf keine PII wie E-Mail, Telefonnummer oder Namen enthalten.

Klick-URL

Die URL, auf der ein Nutzer nach einem Offsite-Anzeigenklick auf Ihrer Website landet, enthält wichtige Query-Parameter. Beispiel für eine Klick-URL:

https://www.retailer.com/search?q=shampoo&
externalCampaignId=9d2d7d7d-5d4f-4d8e-a8d0-2d7a6f9c1234&
externalVendorId=vendor_abc123&
gclid=CjwKCAj_example123&
utm_source=google&
utm_medium=c

Query-Parameter:

gclid — von Google angehängte Klick-ID
externalCampaignId und externalVendorId — Query-Parameter mit der Topsort-Kampagnen-ID und der Vendor-ID, von Topsort angehängt. Sie sollten zusammen mit dem Attributionsstatus des Nutzers mindestens für die Dauer des Attributionsfensters (konfigurierbar 7–30 Tage) bestehen bleiben. Sie sollten Navigation und wiederholte Besuche überdauern, damit spätere Kauf-Events korrekt dem ursprünglichen Offsite-Anzeigenklick zugeordnet werden können.

Klicks melden

Senden Sie das folgende Event, wenn ein Nutzer über einen Offsite-Anzeigenklick auf Ihrer Website landet. Alle Felder sind erforderlich.

POST /v2/events

{
  "clicks": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "opaqueUserId": "<string>",
      "id": "<string>",
      "entity": {
        "id": "product1",
        "type": "product"
      },
      "externalCampaignId": "<Topsort UUID>",
      "externalVendorId": "<Topsort externalVendorId>",
      "dsp_metadata": {
        "gclid": "<Google click ID>"
      },
      "channel": "offsite"
    }
  ]
}

Käufe melden

Alle Felder sind erforderlich.

POST /v2/events

{
  "purchases": [
    {
      "occurredAt": "2023-11-07T05:31:56Z",
      "opaqueUserId": "<string>",
      "id": "<string>",
      "items": [
        {
          "productId": "product1",
          "vendorId": "<externalVendorId>",
          "unitPrice": 75.0,
          "quantity": 1
        },
        {
          "productId": "product2",
          "vendorId": "<externalVendorId>",
          "unitPrice": 25.0,
          "quantity": 1
        }
      ]
    }
  ]
}

​Attribution und Conversion-Tracking

​Topsort interne Attribution

​Attribution der Werbeplattform

​Abrechnungsmodell

​Zahlungsmodelle

​Offsite-Event-Tracking mit Topsort implementieren

​Opaque User ID

​Klick-URL

​Klicks melden

​Käufe melden