Segment-Integration mit Personyze

Segment und Personyze tauschen Daten in beide Richtungen aus.

Segment → Personyze. Segment sendet identify -Aufrufe an Personyze. Jeder Aufruf legt aus seinen Traits ein Personyze-Besucherprofil an oder aktualisiert es. Diese Traits können aus Ihrem CRM, Ihrer E-Mail-Plattform, Offline-Transaktionen sowie aus berechneten Traits und Audiences von Segment Engage stammen. Sie können sie dann in Targeting-Regeln, dynamischen Inhalten, Empfehlungen und Berichten verwenden.
Personyze → Segment. Personyze sendet Kampagnen-Ereignisse (Impressionen, Klicks, Conversions) an Segment. Auf Ihrer Website laufen sie über analytics.js von Segment, aus Automations über die Server-API von Segment.

Sie können jede Richtung einzeln einrichten oder beide.

Teil 1: Segment-Daten an Personyze senden

Schritt 1: Einen Segment-Schlüssel in Personyze erzeugen

Öffnen Sie im Personyze-Panel Einstellungen → Integrationen.
Suchen Sie die Karte Segment und klicken Sie darauf.
Klicken Sie im Abschnitt Segment → Personyze auf Neuen Schlüssel erzeugen.
Bewahren Sie den Schlüssel sicher auf — Sie tragen ihn in Segment ein.

Diese Segment-Schlüssel sind von Ihren Schlüsseln der Vollwertigen API getrennt. Wenn Sie hier einen widerrufen, wird nur Segment getrennt.

Das Segment-Fenster in Personyze — Einstellungen → Integrationen → Segment: der Schlüssel für das Personyze-Ziel, die Webhook-URL als Alternative und der Schalter, der Kampagnen-Ereignisse an Segment meldet. Zum Vergrößern klicken.

Schritt 2: Das Personyze-Ziel in Segment hinzufügen

Öffnen Sie in Segment Connections → Catalog → Destinations.
Suchen Sie nach Personyze und wählen Sie es aus.
Wählen Sie die Quelle, die Daten an Personyze senden soll. Meist ist das die Quelle Ihrer Website.
Tragen Sie in den Einstellungen des Ziels den Schlüssel aus Schritt 1 unter API Key ein.
Speichern und aktivieren Sie das Ziel.

Ab jetzt legt jeder identify -Aufruf aus dieser Quelle ein Personyze-Besucherprofil an oder aktualisiert es.

Schritt 3: Die Besucher-ID von Segment dem Website-Besucher zuordnen (empfohlen)

So wird das Profil, das Segment aufbaut, mit dem Besucher verbunden, den Personyze auf Ihrer Website sieht.

Gehen Sie in Personyze zu Einstellungen → Besucherattribute.
Öffnen Sie Geräteübergreifende Benutzer-Identifikatoren.
Legen Sie einen Internal-ID-Identifikator vom Typ Cookie an, der das Cookie ajs_anonymous_id ausliest.
Speichern und aktivieren Sie ihn.

Alternative: identify-Aufrufe an die Webhook-URL senden

Nutzen Sie dies, wenn Sie das Personyze-Ziel nicht verwenden können — zum Beispiel mit einem Webhooks-Ziel in Segment oder mit einer anderen CDP.

Einstellung	Wert
URL	`https://app.personyze.com/rest/segment_identify`
Methode	`POST`
Header	`Authorization: Bearer <your Segment key from Step 1>`
Body	Der Filter `identify` -Aufruf im Standard-JSON von Segment. Er muss eine `userId` oder eine `anonymousId`sowie ein `traits` -Objekt enthalten.

Beispiel-Body:

{
  "type": "identify",
  "userId": "u-1029",
  "anonymousId": "5b1c2e9a-7c1f-4f0e-9b1e-2a3c4d5e6f70",
  "traits": {
    "email": "dana@example.com",
    "firstName": "Dana",
    "plan": "pro"
  }
}

Statt des Bearer-Headers können Sie auch HTTP-Basic-Authentifizierung verwenden, mit dem Schlüssel als Benutzername und leerem Passwort.

Senden Sie nur identify -Aufrufe an diese URL. Aufrufe ohne traits -Objekt (track, page) werden ignoriert, aber ein group -Aufruf enthält ebenfalls Traits — die des Unternehmens —, und sie würden in das Profil der Person geschrieben. Setzen Sie in einem Webhooks-(Actions-)Ziel von Segment den Trigger auf Event Type is identify.

Was in Personyze ankommt

Ein identify -Aufruf legt aus seinen Traits ein Profil an oder aktualisiert es. Trait-Namen in camelCase werden zu snake_case (firstName wird zu first_name). Traits, die zu einem Personyze-Profilfeld passen, füllen dieses Feld. Alles andere wird als eigenes Besucherattribut gespeichert.
Umgang mit Identitäten. Wenn ein Aufruf previousId oder anonymousId zusammen mit userIdenthält, schlüsselt Personyze das bestehende Profil auf die userIdum. Ein Besucher, der vor der Anmeldung anonym war, behält seine Historie, statt ein zweites Profil zu bekommen.
Engage. Berechnete Traits und Audiences kommen als gewöhnliche identify -Traits an (zum Beispiel order_completed_last_30days: true). Laut Segment kann die erste Audience-Synchronisation sechs Stunden oder länger dauern.

Teil 2: Personyze-Kampagnen-Ereignisse an Segment senden

Von Ihrer Website (analytics.js)

Das funktioniert auf Seiten, auf denen analytics.js von Segment installiert ist. Personyze lädt analytics.js nie selbst. Auf einer Seite ohne das Skript wird nichts gesendet, und nichts geht kaputt.

Jedes Ereignis wird mit analytics.track() gesendet und nach der Kampagnenaktion benannt. Eine Impression sieht so aus:

analytics.track('<action name>', {event: 'shown', source: 'personyze'})

Sie können auf drei Arten wählen, welche Ereignisse an Segment gehen:

Alle Kampagnen. Öffnen Sie Einstellungen → Integrationen → Segment. Schalten Sie im Abschnitt Personyze → Segment die Option Kampagnen-Ereignisse hier melden ein. Impressionen, Klicks und Conversions aller Kampagnen werden an Segment gesendet.
Eine Aktion. Aktivieren Sie in den Ereigniseinstellungen der Aktion Segment unter Dieses Ereignis senden an. So melden Sie die Ereignisse einer bestimmten Aktion an Segment, mit eigenem Ereignisnamen und eigenen Eigenschaften.
Ein eigenes Ereignis. Fügen Sie einer Kampagne die Aktion Send Event to Analytics hinzu und aktivieren Sie Segment. Sie wählen den Ereignisnamen und die Eigenschaften.

Aus Automations (Server-API von Segment)

Das funktioniert, ohne dass der Besucher auf Ihrer Website ist — zum Beispiel, wenn die Zielgruppe einer Offline-Kampagne auf jemanden passt.

Rufen Sie in Segment den write key der Quelle auf, die die Ereignisse empfangen soll (Connections → Sources → Ihre Quelle → Settings → API Keys).
Fügen Sie in Personyze der Automation die Aktion Send Event to Analytics (Automation) hinzu.
Aktivieren Sie Segment und tragen Sie den write key unter Segment write key ein.
Speichern und veröffentlichen Sie.

Jeder passende Nutzer wird als track -Ereignis an Segment gesendet. Seine E-Mail-Adresse dient als userIdbei Segment. Nutzer ohne E-Mail-Adresse werden übersprungen.

Segment-Daten in Personyze nutzen

Targeting

Segment-Traits erscheinen als Profilfelder in Targeting-Regeln. Fügen Sie Zielgruppenregeln zu Demografie, Rolle, Funnel-Phase oder jedem eigenen Trait hinzu.

Dynamische Inhalte

Fügen Sie Segment-Felder als dynamische Variablen in Kampagnen ein, zum Beispiel „Willkommen zurück, {first_name}“.

Empfehlungen

Nutzen Sie Profildaten als Empfehlungsfilter, oder lassen Sie die Algorithmen sie automatisch verwenden.

Hilfe benötigt?

Schreiben Sie an info@personyze.com.

Auf der Personyze-Website

Segment-Personalisierung mit Personyze — Segment-Audiences auf der Website aktivieren.
Website-Personalisierung — die Targeting- und Content-Engine dahinter.