Conversions API

Erste Schritte

Diese Seite beschreibt den Implementierungsprozess der Conversions API und führt die Details zu den Implementierungsvoraussetzungen auf. Falls du ein Drittanbieter-Partner bist, der Funktionalitäten der Conversions API für Werbetreibende anbietet, gelten für deine ersten Schritte abweichende Voraussetzungen.

Wenn dein Unternehmen über eine Firewall für ausgehende Anfragen verfügt, findest du unter Crawler-IPs und Nutzer-Agenten Informationen zum Abrufen von Facebooks IP-Adressen. Beachte, dass sich die Liste der Adressen häufig ändert.

Für Web-, App- und physische Store-Events, die mit der Conversions API geteilt werden, sind bestimmte Parameter erforderlich. Die Liste der erforderlichen Parameter ist hier verfügbar.

Überblick über den Prozess

Der Einrichtungsprozess der Integration der Conversions API besteht aus den folgenden allgemeinen Schritten:

  1. Auswählen der für dich richtigen Integrationsmethode
  2. Erfüllen der erforderlichen Voraussetzungen für diese Implementierungsmethode
  3. Implementieren anhand dieser Integrationsmethode
  4. Verifizieren deiner Einrichtung und Befolgen der Best Practices für die Optimierung der Werbeanzeigen-Performance

Integrationsmethoden

Es gibt mehrere Methoden zur Integration mit der Conversions API, die sich darin unterscheiden, wie viel Aufwand und Kosten entstehen und welche Features ermöglicht werden. Sieh dir für eine Übersicht von Einrichtungsoptionen für die Conversions API diesen Artikel an.

Der primäre Fokus dieser Entwicklerdokumentation ist das Entwickeln von direkten Integrationen.

Anforderungen

Pixel-ID

Du benötigst eine Pixel-ID, um die Conversions API nutzen zu können. Falls du bereits ein Pixel für deine Webseite eingerichtet hast, empfehlen wir die Verwendung derselben Pixel-ID für deine Browser- und Server-Events.

Business Manager

Du benötigst außerdem einen Business Manager, um die API verwenden zu können. Der Business Manager hilft Werbetreibenden bei der Integration von Facebook-Marketingmaßnahmen in allen Unternehmensbereichen und bei der Zusammenarbeit mit externen Partnern. Wenn du noch keinen Business Manager hast, findest du im Hilfebereich Informationen zum Erstellen eines Business Managers.

Zugriffsschlüssel

Zum Verwenden der Conversions API benötigst du einen Zugriffsschlüssel. Es gibt zwei Möglichkeiten, einen Zugriffsschlüssel zu erhalten:

  • Über den Events Manager (empfohlen)
  • Mit deiner eigenen App

Über den Events Manager (empfohlen)

Um die Conversions API verwenden zu können, musst du einen Zugriffsschlüssel generieren, der als Parameter in jedem API-Aufruf übergeben wird. Führe im Events Manager die folgenden Schritte aus:

Schritt 1: Wähle das Pixel aus, das du implementieren möchtest.

Schritt 2: Wähle den Tab „Einstellungen“ aus.


Schritt 3. Suche den Abschnitt zur Conversions API und klicke unter „Manuell einrichten“ auf den Link Zugriffsschlüssel erstellen. Befolge dann die eingeblendeten Anweisungen:

Hinweis: Der Link „Zugriffsschlüssel erstellen“ wird nur Nutzer'*innen angezeigt, die für Entwicklerrechte für das Unternehmen verfügen. Der Link wird anderen Nutzer*innen nicht angezeigt.


Sobald du deinen Zugriffsschlüssel hast, klicke in Events Manager auf dem Tab „Übersicht“ auf den Button Integrationen verwalten. Klicke auf dem Pop-up-Bildschirm auf den Button Verwalten neben Conversions API. Auf diese Weise werden automatisch eine Conversions API-App und ein Conversions API-Systemnutzer für dich erstellt. Es ist keine App-Review erforderlich und du musst keine Berechtigungen anfordern.



Mit deiner eigenen App

Wenn du bereits über deine eigene App und deinen eigenen Systemnutzer verfügst, kannst du einen Zugriffsschlüssel in Business Manager generieren. Hierzu gehst du folgendermaßen vor:

Schritt 1: Rufe deine Unternehmenseinstellungen auf.

Schritt 2: Weise deinem Systemnutzer ein Pixel zu (du hast hier auch die Möglichkeit, einen neuen Systemnutzer zu erstellen).

Schritt 3: Wähle den zugewiesenen Systemnutzer aus und klicke auf Schlüssel generieren.

Für deine App ist keine App-Review erforderlich. Du musst keine Berechtigungen anfordern.

Zugriffsschlüssel, die in Events Manager auf dem Tab mit den Conversions API-Einstellungen erstellt wurden, müssen nicht mehr die neueste Graph API-Version verwenden, die zum Zeitpunkt der Schlüsselerstellung verfügbar war. Ab v12.0 können neu erstellte Zugriffsschlüssel mit allen verfügbaren Graph API-Versionen verwendet werden.

Ressourcen