Twilio Segment

Erfahren Sie, wie Sie Topsort Events mit Twilio Segment integrieren

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-Ereignis	Standard-Segment-Mapping	Alternatives Mapping
   impressions	Product Viewed	Product List Viewed
   clicks	Product Clicked	Product Added
   purchases	Order 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 [e-mail], 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)

   
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

   

   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

   

   Vermeiden Sie Doppelzählung, indem Sie Ihre Ereignisauslösungslogik überprüfen.

   2. 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: '[e-mail]'
   });
   

   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.