Diese Funktion befindet sich gerade in der Beta-Phase.

 

In diesem Artikel erfährst du, wie du dich mit der Conversions-API von Spotify verbindest.

 

Inhaltsverzeichnis

Conversions-API von Spotify

Onboarding-Zusammenfassung

Integrationsmethoden

      Google Tag Manager-Integration

      Direkte Integration

Verbindung zur Conversions-API im Ads Manager herstellen

Google Tag Manager-Integration erstellen

Direkte Server-zu-Server-Integration erstellen

Verwendung der API

Problembehebung bei der Conversions-API

 

Conversions-API von Spotify

Was ist die Conversions-API von Spotify?

Die Conversions-API von Spotify ist ein Attributionstool ohne Tags, mit dem du Online- und Offline-Conversion-Ereignisse direkt an Spotify übermitteln kannst. Die Conversions-API wurde entwickelt, um eine umfassende, detailgetreue Attribution zu bieten, mit der du die Leistung deiner Kampagnen auf Spotify verstehen kannst. 

 

Nach der Erstellung sollte die Conversions-API-Verbindung als Datenquelle für die Conversion-Messung während des Buchungsvorgangs für die Kampagne im Ads Manager ausgewählt werden.

 

Mit der Conversions-API von Spotify und dem Ads Manager kannst du:

  • die Conversions-API einmal installieren, um alle deine Kampagnen auf Spotify zu messen 

  • Einblicke in wichtige geräteübergreifende Aktionen erhalten, die Hörer*innen auf deiner Website, in deiner App oder offline ausführen

  • den ROI deiner Ausgaben im Ads Manager besser verstehen

 

Was kann die Conversions-API messen?

Die Conversions-API unterstützt die folgenden Ereignisse auf deiner Website, in deiner App oder offline:

  • Zum Warenkorb hinzufügen

  • Alias

  • Leads

  • Seitenaufrufe

  • Kauf

  • Anmelden

  • Start des Zahlungsvorgangs

  • Produktaufrufe

  • Benutzerdefinierte Ereignisse (bis zu 5)

 

Onboarding-Zusammenfassung

Werbetreibende können mit der Spotify Conversions API (CAPI) Web-, App- und Offline-Ereignisse über eine Server-zu-Server-Integration senden. Genau wie beim Spotify Pixel kannst du mit dieser Integration die Kampagnenattribution für deine Spotify Kampagnen verfolgen und messen, indem du diese Ereignisse an Spotify übermittelst.

 

 

Integrationsmethoden

Google Tag Manager-Integration

Werbetreibende, die Google Tag Manager (GTM) verwenden, können unsere GTM-Vorlage für eine schnellere, einfachere Integrationsoption verwenden, die keine Entwicklungsarbeit erfordert. 

Bevor du eine GTM-Integration einrichtest, stelle bitte sicher, dass du Zugriff auf das Abrechnungskonto und Berechtigungen zum Erstellen von Projekten in deiner GCP-Organisation hast, um die automatische Bereitstellung durchzuführen. Wenn du eine manuelle Bereitstellung anstelle einer automatischen Bereitstellung planst, benötigst du Hilfe von einem/einer Nutzer*in mit den entsprechenden GCP-Berechtigungen, um die Cloud Run-Infrastruktur gemäß der Google-Dokumentation einzurichten.

Direkte Integration

Um die Kontrolle über deinen Integrationsprozess zu maximieren, empfehlen wir dir, eine direkte Integration mit der Conversions-API zu erstellen. Dies erfordert die Beteiligung eines/einer Entwickler*in.

 

Verbindung zur Conversions-API im Ads Manager herstellen

  1. Melde dich beim Ads Manager an und gehe über das globale Navigationssymbol oben links zu „Ereignisse“.

  2. Auf dieser Seite kannst du „Datenquelle verbinden“ aufrufen und Conversions-API auswählen.
     

  3. Gib deiner Conversions-API einen Namen.

  4. Wenn du auch das Spotify Pixel verwenden möchtest, solltest du einen Datensatz erstellen, um eine deduplizierte Conversion-Messung mit Daten vom Spotify Pixel und der Conversions-API zu ermöglichen.

  5. Wähle über die Suchleiste die Anzeigen-Konten aus, die mit deiner Conversions-API verknüpft werden sollen. Die gewünschten Anzeigen-Konten müssen mit deinem Unternehmenskonto verknüpft sein.
     

  6. Lies unter „Anweisungen zur Conversions-API anzeigen“ den Abschnitt „Zugriff auf die Conversions-API“ und rufe dann den Abschnitt „Token“ auf.

  7. Klicke auf „Token generieren“.

  8. Generiere dein Authentifizierungstoken (du kannst bis zu 3 Token generieren).
     

  9. Kopiere deinen Token und deine Verbindungs-ID.

    1. Du kannst nur Ereignisse für die Verbindungs-ID senden, die zu dem Unternehmen gehört, das das Token generiert hat. 

 

Google Tag Manager-Integration erstellen

Für eine Google Tag Manager-Integration benötigst du ein Authentifizierungstoken und eine Verbindungs-ID, die auf der Seite „Ereignisse“ im Spotify Ads Manager generiert wurden. Du kannst nur als Unternehmensadministrator*in im Ads Manager auf das Dashboard zugreifen und die folgenden Schritte ausführen.

Bevor du eine GTM-Integration einrichtest, stelle bitte sicher, dass du Zugriff auf das Abrechnungskonto und Berechtigungen zum Erstellen von Projekten in deiner GCP-Organisation hast, um die automatische Bereitstellung durchzuführen. Wenn du eine manuelle Bereitstellung anstelle einer automatischen Bereitstellung planst, benötigst du Hilfe von einem/einer Nutzer*in mit den entsprechenden GCP-Berechtigungen, um die Cloud Run-Infrastruktur gemäß der Google-Dokumentation einzurichten.

  1. Folge den Anweisungen im obigen Abschnitt, um eine Verbindung zur Conversions-API im Ads Manager herzustellen.

  2. Gehe zum Google Tag Manager und erstelle einen neuen Server-Container.

  3. Klicke in der linken Seitenleiste auf „Tags“ und wähle „Neu“ aus.

  4. Klicke auf „Tag-Konfiguration“ und wähle im Fenster „Tag-Typ auswählen“ die Option „Weitere Tag-Typen in der Community-Vorlagengalerie entdecken“ aus.

  5. Suche nach „Spotify“ und wähle „Spotify CAPI 3P Integration Tag“ > Zum Arbeitsbereich hinzufügen.

  6. Füge dein Authentifizierungstoken und deine Verbindungs-ID aus dem Events Manager ein.

  7. Konfiguriere Events, Aktionsquelle und wähle Trigger aus.

  8. Klicke auf „Speichern“, um das Tag bereitzustellen.

 

Du kannst hier direkt auf die Tag-Vorlage für Google Tag Manager der Conversions-API zugreifen: https://tagmanager.google.com/gallery/#/owners/spotify/templates/conversion-api-tag-template

 

Das öffentliche Repository für die GTM-Tag-Vorlage findest du auch hier: https://github.com/spotify/conversion-api-tag-template 

 

Direkte Server-zu-Server-Integration erstellen

Für das Erstellen einer direkten Server-zu-Server-Integration und Zugriff auf die Conversions-API benötigst du ein Authentifizierungstoken und eine Verbindungs-ID, die auf der Seite „Ereignisse“ im Spotify Ads Manager generiert wurden. Du kannst nur als Unternehmensadministrator*in im Ads Manager auf das Dashboard zugreifen und die folgenden Schritte ausführen.

 

Authentifizierung

Spotify unterstützt ein langlebiges Token. Du kannst bis zu 3 Token gleichzeitig generieren. Nachdem dein drittes Token erstellt wurde, musst du ein vorheriges Token löschen, um ein neues zu generieren. Dein Token läuft nicht ab und kann auf unbestimmte Zeit verwendet werden. 

 

Verbindungs-ID

Um auf die API zugreifen zu können, benötigst du deine Verbindungs-ID. Die Verbindungs-ID ist ein eindeutiger Schlüssel, der deinem Unternehmen zugewiesen wurde und mit dem du auf die API zugreifen kannst, wenn du es mit dem Token verwendest. Die Verbindungs-ID findest du im Ads Manager unter „Anweisungen zur Conversions-API anzeigen“.

 

Nutzerdaten

Die Conversions-API akzeptiert derzeit vier (4) Identifikationstypen: IP-Adresse, Geräte-ID, gehashte E-Mail-Adresse und gehashte Telefonnummer. Es muss mindestens eine Art von Kennung übermittelt werden. Wenn möglich sollten sowohl die IP-Adresse als auch die Geräte-ID angegeben werden.

 

Verwendung der API

 

Endpunkt

Ressourcen-URL: https://capi.spotify.com/capi-direct/events/

ConversionService
Ressourcen-URL: https://capi.spotify.com/capi-direct/events/


Anforderungsmethode: POST
Beschreibung: Diese Methode sendet Conversion-Ereignisse und ermöglicht das Tracking von Nutzerinteraktionen wie Käufe, Zahlvorgänge und andere Arten von Interaktionen über den angegebenen direkten API-Endpunkt.

Auf Spotify for Developers erfährst du mehr über das Senden von API-Anfragen. 

 

Ereignisdefinitionen

Name des Ereignistyps 

Beschreibung 

Seitenaufrufe 

optional

Der Akt des Landens oder Anzeigens einer bestimmten Seite auf einer Website. Zum Beispiel, wenn eine Person auf der Startseite der Website landet oder sich eine bestimmte Produktseite ansieht. Beachte, dass das Ereignis „Seitenaufrufe“ für alle Werbetreibenden erforderlich ist, wenn sie sich für die Verwendung des Spotify Pixel entscheiden. 

Leads 

optional

Die Übermittlung von Informationen über eine Person oder über ein Unternehmen, die/das in irgendeiner Form Interesse an einem Produkt oder einer Dienstleistung bekundet hat. Zum Beispiel durch Angabe einer E-Mail-Adresse, um sich für einen Newsletter anzumelden. Beachte, dass Lead je nach Werbetreibenden und Branche unterschiedliche Bedeutungen haben kann.

Zum Warenkorb hinzufügen

optional

Die Aktion zum Hinzufügen eines Artikels zu einem virtuellen Warenkorb oder Einkaufswagen. Wenn beispielsweise auf einer Website auf die Schaltfläche „In den Einkaufswagen legen“ geklickt, aber der Kauf nicht abgeschlossen wird.

Kauf

optional

Der Abschluss eines Onlinekaufs, in der Regel durch den Erhalt einer Bestellung oder Kaufbestätigung oder eines Transaktionsbelegs. Zum Beispiel wenn eine Person auf einer „Danke“- oder „Bestellbestätigungs“-Seite landet.

Produktaufrufe 

optional

Misst die Aktion einer Person, die eine Webseite zu einem bestimmten Produkt aufruft. 


Bewährte Verfahren: 

  • Der Ereigniscode „Produktaufruf“ muss auf jeder Produktseite installiert werden, die der/die Werbetreibende messen möchte.

  • Um weitere Informationen zu bestimmten Produktnamen zu erhalten, sollte der Parameter „produkt_name“ verwendet werden, um den Namen der Seite oder des Produkts zu übergeben, die bzw. das mit dem Ereignis für den Produktaufruf verknüpft ist. 

Anmelden

optional

Misst die Aktion der Anmeldung oder Registrierung für eine Veranstaltung, ein Produkt, eine Dienstleistung usw. 

Start des Zahlungsvorgangs 

optional

Misst die Einleitung des Zahlungsvorgangs durch ein*e Nutzer*in.

Alias

optional

Sendet die Kundendaten des/der Werbetreibenden an Spotify (E-Mail, Telefonnummer).

Benutzerdefiniertes Ereignis

optional

Misst maßgeschneiderte oder benutzerdefinierte Ereignis-Aktivitäten auf einer Website, die Spotify nicht als Standard-Ereignistyp anbietet. Dies sind Ereignisse, die du selbst definierst.


In der Beta-Phase können benutzerdefinierte Ereignisse nicht umbenannt werden. Sie werden in den Berichten als benutzerdefiniertes Ereignis 1, benutzerdefiniertes Ereignis 2 usw. angezeigt. Daher ist es wichtig, bei der Erstkonfiguration zu dokumentieren, welche benutzerdefinierten Ereignisse bestimmten Aktionen auf der Website zugeordnet sind. 


Hinweis: Der Ads Manager unterstützt derzeit bis zu 5 benutzerdefinierte Ereignisse. 



Problembehebung bei der Conversions-API

Du hast die Conversions-API implementiert und nach mindestens 20 Minuten werden immer noch keine Aktivitäten im Diagramm „Ereignis-Aktivitäten“ im Ads Manager angezeigt. Was machst du jetzt? 

 

Tipps zur Problembehebung

  • Stelle sicher, dass du dein Token und deine Verbindungs-ID korrekt eingegeben hast.

  • Bestätige, dass die Conversions-API als Datenquelle für die Conversion-Messung für deine Kampagne ausgewählt wurde.

  • Wenn du Google Tag Manager verwendest, stelle sicher, dass du einen Server-Container und keinen Web-Container eingerichtet hast.

  • Wenn du die direkte Server-zu-Server-Integration verwendest, stelle sicher, dass dein API-Aufruf korrekt formatiert ist.

 

Wenn du immer noch keine Ereignisaktivität siehst, wende dich an dein Engineering-Team, um herauszufinden, wie die Conversions-API konfiguriert wurde und welche Ereignisse geteilt werden.