Zurück zu den Neuigkeiten für Entwickler

Sandbox-Funktion der Marketing API ist jetzt wieder verfügbar

21. Juni 2023VonHasmita Nair

Wir freuen uns, mitteilen zu können, dass wir wieder Sandbox-Werbekonten für die Marketing API bereitstellen. Entwickler*innen können somit die Kompatibilität ihrer APIs mit der Marketing API testen.

Was ist ein Marketing API-Sandbox-Werbekonto?

Das Marketing API-Sandbox-Werbekonto ist ein Test-Werbekonto, das mit einer App verknüpft ist und über developer.facebook.com konfiguriert wird, um API-Zugriff auf eine Teilmenge von Marketing APIs zu ermöglichen. Mit dem API-Sandbox-Konto können Entwickler*innen Marketing APIs auf ihren Seiten und Assets zum Testen aufrufen, ohne die Werbeanzeigen tatsächlich auszuliefern. Entwickler*innen müssen keine Finanzierungsquelle für Werbekonten einrichten, da Meta die erstellten Werbeanzeigen nicht ausliefert und Impressionen oder Ausgaben nicht gesammelt werden.

Wie erstelle ich ein Marketing API-Sandbox-Werbekonto?

Um ein Marketing API-Sandbox-Werbekonto zu erstellen, müssen Nutzer*innen zunächst das Marketing API-Produkt auf ihrem App-Dashboard aktivieren und dann ein Sandbox-Werbekonto erstellen und es damit verknüpfen. Nutzer*innen können das Sandbox-Werbekonto außerdem konfigurieren, indem sie es mit Business Managers verknüpfen, die Nutzungsbedingungen akzeptieren usw. Wenn die Konfiguration abgeschlossen ist, können Nutzer*innen den Nutzer-Zugriffsschlüssel generieren oder den Systemnutzer-Zugriffsschlüssel verwenden, um die Graph API für Testzwecke abzufragen.

Nutzungserlebnis für Endnutzer*innen

  1. Entwickler*innen können ihr App-Dashboard aufrufen und das Marketing API-Produkt auf https://developers.facebook.com/ hinzufügen.
    • Klicke auf das Dropdown-Menü „Meine Apps“.
    • Wähle eine App aus, auf das du Administrator- oder Entwicklungszugriff hast.
  2. Füge das Marketing API-Produkt hinzu, falls du noch keinen bestehenden Zugriff auf das Produkt hast.
    • Navigiere auf dem App-Dashboard zum Bereich "Ein Produkt hinzufügen" und richte die Marketing API ein.
  3. Wenn du auf „Marketing API > Tools“ klickst, gelangst du zur Kontoverwaltungskarte des Werbekontos.
  4. Wenn dies das erste Mal ist, dass du ein Sandbox-Werbekonto erstellst, wird dir die Option zur Erstellung angezeigt. Beachte, dass du nur ein Sandbox-Konto pro App haben kannst.
  5. Anschließend kannst du dieses Sandbox-Werbekonto mit jeder Seite verknüpfen, auf die du Administratorzugriff hast.
  6. Für die grundlegenden Funktionen kannst du jetzt die Nutzer-Zugriffsschlüssel generieren, die über Werbekonto- und Seitenzugriff verfügen, und mit diesem Zugriffsschlüssel mit dem Testen von Marketing API-Aufrufen beginnen.
  7. Wenn du vorhast, Funktionen wie Instant Experience und die Katalogverwaltung zu verwenden, raten wir dringend zur Verwendung eines Systemnutzer-Zugriffsschlüssels anstelle eines Nutzer-Zugriffsschlüssels. Um den Zugriffsschlüssel für den Systemnutzer zu erhalten, klickst du auf den Button „Mit Unternehmen verbinden“ und verwendest den Business Manager, um den Zugriffsschlüssel abzurufen.

Einschränkungen

  • Sandbox-Werbekonten können nicht direkt im Werbeanzeigenmanager verwaltet werden. Sie können nur über Ads API-Aufrufe betrieben werden.
  • Die Insights API wird derzeit nicht unterstützt, da Änderungen in der Sandbox-Umgebung nicht live geschaltet und nicht ausgeliefert werden. Es werden also keine Ausgaben, Klicks oder Impressionen generiert und es gibt somit keine auszuwertenden Einblicke.
  • Wenn deine App derzeit für den Zugriff auf bestimmte experimentelle APIs zugelassen ist, kannst du diese APIs auch im Sandbox-Modus aufrufen.
  • Du kannst unabhängig von der Zugriffsstufe in der sich deine App befindet, pro App nur ein Sandbox-Werbekonto erstellen.

Ressourcen: