Stape
Suche
Kostenlos ausprobieren

Snapchat CAPI erklärt & vollständige Anleitung zur Einrichtung

Aktualisiert
3. Dez. 2024
Veröffentlicht
3. Apr. 2022
Auch erhältlich

Einschränkungen bei der Nachverfolgung haben einen großen Einfluss auf die Genauigkeit der Analysedaten. iOS-Updates haben das größte Problem für Web-Tracker und App-Tracker verursacht. Die jüngste Aktualisierung von Apple hat bei Unternehmen, die auf Werbung angewiesen sind, ein ernsthaftes Problem verursacht: Alle Apps müssen den Nutzer um Erlaubnis bitten, bevor sie Tracker verwenden. 

Jüngsten Studien zufolge lehnen rund 80 % der Nutzer eine Tracking ab. Dies betrifft vor allem Apps, deren Gewinne hauptsächlich von der Werbung abhängen, wie Facebook, TikTok und Snapchat. Diese Unternehmen haben damit begonnen, die Werbetreibenden aufzufordern, ein serverseitiges Tracking zu implementieren, um die Genauigkeit des Trackings zu verbessern.

Wir haben bereits Blogbeiträge über die Einrichtung der Facebook CAPI und der TikTok Events API veröffentlicht. In diesem Artikel spreche ich über die Snapchat Conversion API und wie man sie mit dem Google Tag Manager Container einrichtet.

Über die Snapchat Conversion API

Mit Snap Conversions API können Sie Web-, App- und Offline-Ereignisse von Ihrem Server auf den Server von Snap übertragen. In der offiziellen Dokumentation heißt es, dass Snap CAPI dabei hilft, Kampagnen zu optimieren und das Conversion Tracking und Targeting zu verbessern.

Mit der Snapchat Conversion API können Sie die gleichen Ereignisse und Ereignisparameter wie Webpixel senden. Es gibt zwei Möglichkeiten, die Snap CAPI zu implementieren: die direkte Integration, d.h. das Senden von Serverinformationen von Ihren Servern direkt an die Snap-Server, oder die Partnerintegration unter Einbeziehung des Google Tag Manager (GTM)-Servers. 

Das Stape Team hat ein Snap Conversion API Tag für den Google Tag Manager Server Container erstellt. Die Logik des Snap-Tags ist komplexer als die von FB und TikTok, was auch die Implementierung erschwert. Wir haben versucht, die Snap CAPI-Konfiguration für Stape-Benutzer einfacher zu gestalten. In diesem Blog-Artikel zeigen wir Ihnen, wie Sie es verwenden können. 

Snapchat Ereignis-Deduplizierung

Wie Facebook und TikTok unterstützt Snapchat die Ereignis-Deduplizierung, was bedeutet, dass Sie sowohl browserbasiertes als auch serverbasiertes Tracking verwenden können. Um redundante Ereignisse zu entfernen, sollten Sie die Ereignis-Deduplizierung verwenden. Die wichtigsten Deduplizierungsschlüssel sind Client_dedup_id (erlaubt ein Deduplizierungsfenster von 48 Stunden) und Transaction_id (erlaubt ein Deduplizierungsfenster von 30 Tagen).

Cookies sind nur über Web-Tracking verfügbar, d. h., wenn Sie sich dafür entscheiden, nur die Snap CAPI zu implementieren, kann diese keine Cookies verwenden. Solange Cookies also nicht völlig überflüssig sind, empfehlen die meisten Plattformen, einschließlich Snap, die Verwendung von Web+Server-Tracking. 

Das Snap-Tag für den Web Google Tag Manager  unterstützt event_id nicht, daher sollte ein benutzerdefiniertes HTML-Tag verwendet werden, um die Ereignisduplizierung einzurichten. 

Snapchat CAPI-Ereignisse: CAPI unterstützt alle Arten von Standard-Ereignisnamen, die für Snap-Webpixel verfügbar sind. Sie unterstützt auch benutzerdefinierte Ereignisnamen. 

Parameter des Ereignisses 

Snapchat hat eine detaillierte Dokumentation, die beschreibt, welche Ereignisparameter die CAPI unterstützt. Folgen Sie diesem Link, um ihn zu lesen. Alle Benutzerparameter (Klartext-E-Mail, Handy-ID, IP-Adresse und Telefonnummer) müssen normalisiert werden. Sobald die Parameter normalisiert sind, müssen sie unter Verwendung des hexadezimalen SHA256-Formats gehasht werden.

Testen von Server-Ereignissen 

Während Snapchat mit seiner Pixeldiagnoseseite über eine hervorragende Funktionalität zum Testen von Pixelereignissen verfügt, fehlt bei Snapchat derzeit leider eine ähnliche Funktionalität wie die Test-ID von FB zum Testen von Serverereignissen in Echtzeit.

Die einzige Möglichkeit zu überprüfen, ob Snap die Serverdaten korrekt empfangen und verarbeitet hat, ist die Überprüfung der Conversion-API-Daten im Snap-Ereignismanager.

Zulassungsanforderungen

Snapchat steuert alle Berechtigungen und Anfragen an die Marketing-API mithilfe von Zugriffstokens. Um eine Snapchat-CAPI einzurichten, musst du dir ein Zugriffstoken besorgen. Snapchat Access Token sind kurzlebig. Deshalb haben wir Firestore verwendet, um Snap Access Tokens zu aktualisieren. In diesem Blog-Artikel zeige ich Ihnen, wie Sie ein Snap Access Token generieren können.

Vorteile der Snapchat Conversion API

Datenschutz. Die Server-zu-Server-Tracking ist eine Technologie, die von Natur aus mit Blick auf den Datenschutz entwickelt wurde. Im Gegensatz zum Web-Pixel-Tracking können Sie beim s2s-Tracking genau kontrollieren, welche Daten Sie an die einzelnen Netzwerke senden. Sie erhalten nur die in den Anfragen an den Server angegebenen Daten. 

Bessere Optimierung von Anzeigen. CAPI hilft dabei, mehr Daten über seine Nutzer zu erhalten, damit die Werbealgorithmen von Snap besser funktionieren. Snapchat sagt in der offiziellen Dokumentation, dass die Implementierung von CAPI dazu beitragen wird, die Kosten pro Aktion zu erhöhen. 

Mehr hochwertiges Publikum. CAPI wird Remarketing- und Lookalike-Kampagnen verbessern, indem es Snapchat mehr Daten über Ihre Nutzer übermittelt, und die Anzahl der Events sollte steigen. Wenn die Nutzer nicht zulassen, dass Anwendungen oder Websites die Nutzer verfolgen, kann CAPI dennoch zum Senden von Ereignissen verwendet werden. 

Verbesserte Conversion-Tracking. Da Server-Ereignisse in den meisten Fällen nicht blockiert werden können, ermöglicht dies den Nutzern, alle vom Nutzer erzeugten Ereignisse zu überwachen.

So funktioniert der sGTM Snapchat Conversion API Tag

Die CAPI-Tag-Logik von Snapchat ist aufgrund der Verifizierungsanforderungen von Snap komplexer als die von Facebook und TikTok. Um Serverereignisse an Snap zu senden, müssen Zugriffstoken verwendet werden. Die von Snapchat generierten Zugriffstoken sind kurzlebig. Wenn ein Token abläuft, sendet Snapchat eine Fehlermeldung 401 token expired. Sie müssen Access Token mit Refresh Access Token aktualisieren und erneut Anfragen senden. 

Das Stape Snap CAPI-Tag verwendet Firebase, um das Access Token zu empfangen und zu speichern. Die Logik dieses Tags wird im folgenden Diagramm beschrieben. 

access token

Die Anforderungen für das Setzen dieser Markierung sind für Stape-Benutzer und Nicht-Stape-Benutzer unterschiedlich.

Wenn Sie Stape verwenden, müssen Sie ein Firebase-Konto erstellen, ein Google Services-Konto einrichten und es mit Ihrem Stape-Konto verknüpfen. Ich werde Ihnen später in diesem Blog-Artikel zeigen, wie Sie das tun können. 

Wenn Sie nicht mit Stape arbeiten, müssen Sie den Aktualisierungsprozess des Access Token selbst durchführen. Weitere Informationen finden Sie in der Snap Marketing API-Dokumentation.

Was brauchen Sie, um die Snapchat Conversion API einzurichten

1. Snapchat-Pixel

Diese Option ist leicht zu finden. Führen Sie die folgenden Schritte aus, um ein Snap-Pixel zu erstellen. 

2. Oauth-Apps.

Dies ist erforderlich, um die Client-ID, das Client-Geheimnis und das API-Aktualisierungs-Token zu erstellen, die für die Konfiguration des Snap sGTM-Tags benötigt werden. Um eine OAuth-App zu erstellen, müssen Sie über Administratorrechte für die Organisation verfügen.

Öffnen Sie den Snap Business Manager -> Klicken Sie auf Business Details -> Klicken Sie auf +OAuth Apps -> Add App Name -> Add Snap Redirect URI. Wenn Sie stape verwenden, um Snap CAPI zu konfigurieren, verwenden Sie diesen Wert:

https://app.stape.io/integration/snapchat/callback 

Wenn Sie nicht Stape verwenden, müssen Sie einen Redirect URI erstellen. 

business settings

3. Kunden-ID und Kundengeheimnis.

Dieser Parameter ist erforderlich, um das Snap-Tag zu setzen. Sie wird nach der Erstellung von OAuth-Apps generiert. 

!

Speichern Sie den Snap Client Secret Key.

Stellen Sie sicher, dass Sie den geheimen Snap Client Secret Key speichern. Er wird nicht wieder verfügbar sein. 

save snap client secret key

4. Google service account

1. Öffnen Sie Ihr stape.io-Konto -> Öffnen Sie den sGTM-Container -> Klicken Sie auf Power-Ups -> Klicken Sie auf Config unter Google Service Account.

stape account

2. Melden Sie sich bei dem Google Cloud-Konto an (oder erstellen Sie eines) -> Wählen Sie im Navigationsmenü oben links IAM & Admin -> Service-Accounts -> Klicken Sie auf Create service account. 

create google cloud account

3. Konto hinzufügen -> Klicken Sie auf Next  -> Wählen Sie Roles BigQuery Data Editor role für den BigQuery-Zugang oder die Cloud Datastore User role für Firestore. 

datastore

Im dritten Schritt brauchen Sie nichts mehr auszuwählen; klicken Sie einfach auf Done. 

4. Öffnen Sie das kürzlich erstellte Dienstkonto -> Öffnen Sie Keys tab -> Klicken Sie auf Add Key -> Wählen Sie den JSON-Typ im Popup -> Klicken Sie auf Create. Es wird eine Datei auf Ihren Computer heruntergeladen. 

json

5. Gehen Sie zurück zum stape.io-Konto -> Laden Sie den kürzlich erzeugten Schlüssel hoch -> Klicken Sie auf Save.  

stape account

5. Firebase account

1. Öffnen Sie https://firebase.google.com/ -> klicken Sie auf create project -> wählen Sie das Projekt, das Sie in Google Cloud verwendet haben -> klicken Sie auf continue -> klicken Sie im dritten Schritt auf Add Firebase. 

2. klicken Sie auf Build -> Firestore Database.

firebase database

3. Klicken Sie auf create database -> wählen Sie Start im Produktionsmodus -> klicken Sie auf Next

production mode

4. Wählen Sie die Region Ihrer Firebase. Sie sollte mit der Region deines sGTM-Serverstandorts übereinstimmen. Sie können die Region überprüfen, indem Sie ein stape.io-Konto öffnen -> den sGTM-Container öffnen -> Server Location überprüfen. Um den Standort des sGTM-Servers mit Firebase abzugleichen, besuchen Sie bitte diesen Link.

firebase database

5. Klicken Sie auf Start a collection. Hier müssen Sie den Firebase Pfad festlegen, der später im CAPI Snap Tag verwendet werden soll. Ich habe den übergeordneten Dokumentparent path/stape-demo und die Dokument-ID Snapchat-auth hinzugefügt -> Klicken Sie auf Save.

CAPI Snap Tag
CAPI Snap Tag
CAPI Snap Tag

6. API Refresh Token

Wenn Sie kein Stape verwenden, folgen Sie dem Snap-Dokument zum Erstellen von API Refresh Token. Wenn Sie Stape verwenden, befolgen Sie bitte die folgenden Schritte:

1. Melden Sie sich bei Ihrem Stape-Konto an und klicken Sie auf Tools -> Snapchat Authentication helper -> Fügen Sie die in Schritt 3 erstellte Snap Client ID hinzu -> Autorisierung starten.

snapchat tag

2. Sie werden zur Snap-Autorisierungsseite weitergeleitet. Autorisierung beenden. 

snapchat tag

3. Fügen Sie Client ID, Client Secret hinzu und klicken Sie auf Generate Refresh Token. 

Generate Refresh Token 

4. Auf dem nächsten Bildschirm sehen Sie Snap Refresh Token. Sie benötigen dieses Refresh Token, um Snap Tag einzurichten. Kopieren Sie das Refresh Token. 

snapchat in stape

So richten Sie die Snapchat Conversion API mit dem Server Google Tag Manager ein

2. Senden Sie Daten an den Server-GTM-Container. Die beiden beliebtesten Methoden zum Senden von Daten an sGTM sind Google Analytics 4 und Data Tag/Data Client.

3. Laden Sie das Snapchat-Tag von GitHub herunter -> Öffnen Sie die Vorlagenabschnitte im Google Tag Manager-Container auf dem Server -> Klicken Sie auf " New.

4. Klicken Sie auf die drei Punkte in der oberen rechten Ecke -> Klicken Sie auf Import -> Wählen Sie die Snapchat-Tag-Vorlage aus, die Sie kürzlich von GitHub heruntergeladen haben -> Klicken Sie auf Save.

snapchat tag

5. Snap-Tag im sGTM-Container erstellen -> Event-Name auswählen. 

Standard - wählen Sie einen der Standardnamen.

Vererben vom Klienten - in diesem Fall wird das Tag versuchen, die Namen der sGTM-Ereignisse zu analysieren und sie mit den Snap-Standard-Ereignissen abzugleichen. 

Benutzerdefiniert - verwenden Sie einen benutzerdefinierten Namen. 

6. Snap Pixel ID hinzufügen -> API Refresh Token hinzufügen. Wir haben schon früher in diesem Artikel beschrieben, wie man sie erzeugt -> Client ID und Client Secret hinzufügen.

snapchat api tag

7. Öffnen Sie den Abschnitt Firebase Settings des Tags und fügen Sie Firebase Path hinzu. 

firebase Settings

8. Hinzufügen von Nutzer- und Ereignisdaten. 

user and events data

9. Wenn Sie die hybride Methode (Web+Server) für Snap verwenden möchten, müssen Sie sicherstellen, dass Sie den Web- und Server-Snap-Tags die Ereignis-ID hinzugefügt haben. Im Moment unterstützt das Web-Snap-Tag keine event_id, verwenden Sie also benutzerdefiniertes HTML, um Snap-Web-Tags einzurichten. 

default event data

10. Öffnen von Web- und Server-GTM-Debugs und Testen, ob Snap-Tags korrekt ausgelöst werden. 

snapchat tag details

11. Leider verfügt Snap nicht über ein Tool, das bei der Fehlersuche von Serverereignissen in Echtzeit hilft. Die einzige Möglichkeit, zu überprüfen, ob Snap Server-Ereignisse empfangen hat, besteht darin, zu warten, bis Sie diese Ereignisse im Snap Events Manager sehen. 

events manager

Schlussfolgerung

In der offiziellen Dokumentation von Snap heißt es, dass die Implementierung der Conversion-API dazu beitragen wird, die Gebotsabgabe zu verbessern und die Kosten pro Aktion zu senken. Die Implementierung ist zwar komplexer als bei FB oder TikTok, kann aber dazu beitragen, die Ergebnisse Ihrer bezahlten Kampagnen zu verbessern. 

Wenn Sie Hilfe beim Einrichten des serverseitigen Trackings für Snapchat Conversion API benötigen, zögern Sie nicht, uns zu kontaktieren. Unser Expertenteam unterstützt Sie gerne bei den ersten Schritten. Danke fürs Lesen!

Tagged with:sGTM tag

Probieren Sie Stape für alles rund um Server-seitigejetzt!