Zum Hauptinhalt springen
Wenn Sie Twilio Segment verwenden, um Ereignisse auf Ihrer Website zu verfolgen, können Sie Ereignisse direkt an Topsort senden, indem Sie das Topsort-Ziel in Ihrem Segment-Konto hinzufügen. Bitte beachten Sie die Topsort-Dokumentation in der Twilio Segments Knowledge Base. Als Voraussetzung für diese Integration benötigen Sie ein Segment-Konto und eine funktionierende Source (Website oder App).
1

Erforderliche Ereignisse verstehen

Topsort verwendet drei Hauptereignisse, alle aus der eCommerce Spec von Segment abgebildet:
Topsort-EreignisStandard-Segment-MappingAlternatives Mapping
impressionsProduct ViewedProduct List Viewed
clicksProduct ClickedProduct Added
purchasesOrder Completed—
  • Vermeiden Sie das Senden doppelter Klicks. Wenn sowohl Product Clicked als auch Product Added durch dieselbe Benutzeraktion ausgelöst werden, wählen Sie nur eines.
  • Wenn Sie benutzerdefinierte Ereignisse verwenden, kontaktieren Sie support@topsort.com, um diese korrekt abzubilden.
2

Topsort-Ziel in Segment hinzufügen

  1. Gehen Sie in Segment zu Connections > Catalog > Destinations
  2. Suchen Sie nach Topsort und klicken Sie auf Add Destination
  3. Wählen Sie die relevante Source aus (Ihre Website oder App)
Segment App
3

Zieleinstellungen konfigurieren

  1. Gehen Sie in der Topsort Manager Platform zu Einstellungen > API-Integration
  2. Kopieren oder erstellen Sie Ihren Marketplace API Key
  3. Öffnen Sie in Segment die Registerkarte Einstellungen des Topsort-Ziels und fügen Sie Ihren API Key ein
Segment Einstellungen
Der API Key ermöglicht es Segment, Ereignisse an Ihr Topsort-Konto zu senden.
4

Track-Ereignisse aktivieren und Metadaten hinzufügen

  1. Aktivieren Sie nur die Track-Ereignisse, die Sie aktiv von Ihrer Website senden
Segment Mappings
Vermeiden Sie Doppelzählung, indem Sie Ihre Ereignisauslösungslogik überprüfen.
  1. Fügen Sie das Feld resolvedBidId hinzu zu:
  • Product Viewed-Ereignissen
  • Product Clicked-Ereignissen
Die resolvedBidId identifiziert eindeutig den beworbenen Gewinner der Auktion. Sie können sie aus der Auctions API oder Proxy-Antwort abrufen.Beispielaufruf:
analytics.track('Product Clicked', {
  productId: '12345',
  resolvedBidId: '67890' // erforderlich für Topsort-Attribution
});
5

Benutzer identifizieren

Topsort empfiehlt, angemeldete Benutzer mit der identify-Methode von Segment zu identifizieren. Beispiel:
analytics.identify('361b1fdfbeaa9d64a13c033eb9f970dc6740f6bc', {
  email: 'john.doe@example.com'
});
Nicht angemeldete Benutzer werden mit einer anonymousId verfolgt. Wenn Sie serverseitige Sources verwenden, fügen Sie mindestens userId oder anonymousId ein. Sobald ein Benutzer identifiziert ist, zeichnet jeder Aufruf der Track-Methode von Segment automatisch die Benutzer-ID auf. Benutzer, die nicht angemeldet sind, können mit einer anonymousId verfolgt werden.
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.