Skip to content

Foursquare

Foursquare ist eine Plattform für Standortdaten, die Standort-Targeting in Ihren Braze-Campaigns ermöglicht. Verwenden Sie das Pilgrim SDK von Foursquare für iOS- und Android-Apps, um Events in Realtime auf der Grundlage des Standorts zu triggern. So können Sie die leistungsstarken Geo-Targeting-Funktionen von Foursquare nutzen, um relevante, personalisierte Nachrichten mit Braze zu versenden.

Diese Integration wird von Foursquare gepflegt.

Voraussetzungen

Anforderung Beschreibung
Foursquare-Konto Um diese Partnerschaft zu nutzen, benötigen Sie ein Foursquare-Konto.
Braze REST-API-Schlüssel Ein Braze REST-API-Schlüssel mit users.track-Berechtigungen.

Dieser kann im Braze-Dashboard unter Einstellungen > API-Schlüssel erstellt werden.
Braze-Workspace und App-IDs Die Braze-Workspace- und App-IDs finden Sie in der Entwicklungskonsole.

Integration

Um die beiden Plattformen zu integrieren, müssen Sie die beiden SDKs integrieren und die passenden Nutzer:innen-Felder zuordnen. Nach der Integration des Pilgrim SDK erhalten Sie Standort-Events auf dem Gerät oder über einen Webhook.

1. Schritt: Nutzer-ID-Felder zuordnen

Um die Felder zwischen den beiden SDKs korrekt zuzuordnen, setzen Sie in beiden Systemen dieselbe Nutzer-ID – mit der changeUser-Methode im Braze SDK und der setUserId-Methode von PilgrimUserInfo im Pilgrim SDK.

2. Schritt: Pilgrim-Konsole konfigurieren

Ein Bild der Pilgrim-Konsole, die nach der Gruppen-ID, der Android-App-ID und der iOS-App-ID fragt.

Suchen Sie die Workspace- und App-IDs in der Braze-Entwicklungskonsole. Geben Sie anschließend Ihren Braze REST-API-Schlüssel und Ihre App-IDs in der Foursquare-Pilgrim-Konsole ein.

Sobald Sie die Pilgrim-Konsole konfiguriert haben, zeichnet das Pilgrim SDK Standort-Events auf und leitet sie an Braze weiter. So können Sie qualifizierte Kund:innen retargeten und segmentieren. Weitere Informationen finden Sie auf der Foursquare-Entwicklerseite.

Nachrichten triggern

Sobald die Integration eingerichtet ist, können Sie eine Campaign oder ein Canvas einrichten, das auf Standort-Events reagiert, die vom Pilgrim SDK generiert werden. Diese Integrationsroute ist ideal für Messaging in Realtime, direkt nachdem Nutzer:innen einen Ort von Interesse betreten haben, oder für eine verzögerte Nachkommunikation, nachdem sie ihn verlassen haben – zum Beispiel eine Danksagung oder eine Erinnerung.

So senden Sie eine Campaign, die Nachrichten auf der Grundlage eines bestimmten Standorts versendet:

  • Erstellen Sie eine Braze-Campaign oder ein Canvas, das mit aktionsbasierter Zustellung versendet wird.
  • Verwenden Sie für Ihren Trigger ein angepasstes Event von arrival mit einem Filter für die Event-Eigenschaft locationType, wie im folgenden Screenshot gezeigt.

Eine aktionsbasierte Campaign im Zustellungsschritt, bei der „arrival“ als Option „Angepasstes Event durchführen“ ausgewählt wurde, wobei „locationType“ gleich „home“ ist.

Retargeting

Um Ihre Nutzer:innen zu retargeten, verwenden Sie das Pilgrim SDK, um ein angepasstes Attribut last_location in den Nutzerprofilen Ihrer Braze-Nutzer:innen zu setzen. Sie können dann den matches regex-Vergleich verwenden, um Nutzer:innen zu retargeten, die einen bestimmten Standort in der realen Welt aufgesucht haben – zum Beispiel alle Nutzer:innen segmentieren, die kürzlich in einer Pizzeria waren.

Eine aktionsbasierte Campaign im Schritt „Zielgruppe zusammenstellen“, bei der „last_location“ gleich „Pizza Place“ ist.

Sie können in Braze auch Nutzer:innen segmentieren, die in einem bestimmten Zeitfenster eine bestimmte Art von Ort auf der Grundlage von Foursquares primaryCategoryId besucht haben. Um diesen Datenpunkt für Ihre Retargeting-Anwendungsfälle zu nutzen, protokollieren Sie primaryCategoryId als Event-Eigenschaft während Ihrer Zielgruppen-Segmentierung. Um die Nutzer:innen und Eigenschaften zu identifizieren, die von der Foursquare API und dem Pilgrim SDK verwendet werden, besuchen Sie die Foursquare-Entwicklerseite.
New Stuff!