Marketing API

Erstellen von Branded Content

Creator*innen, Prominente und Social Medienunternehmen können Branded Content auf Facebook teilen. Branded Content-Beiträge sind alle Inhalte, die für eine Gegenleistung einen Werbetreibenden oder Marketer präsentieren oder von diesem beeinflusst sind. Für die Nutzung dieser Beiträge musst du unsere Branded Content-Richtlinie und unsere Werberichtlinie einhalten. Außerdem musst du deinen Geschäftspartner mit dem Branded Content Tool oder der Marketing API in den Beiträgen markieren.

Die meisten Ersteller von Branded Content-Beiträgen haben bereits Zugriff auf das Branded Content Tool und besitzen verifizierte Seiten oder Profile. Wenn das Branded Content Tool auf deiner Seite nicht verfügbar ist, beantrage den Zugriff.

Du kannst Branded Content-Beiträge mit der Marketing API erstellen. Du kannst aber auch das Branded Content Tool im Werbeanzeigenmanager und die Mentions-App verwenden. Mehr dazu erfährst du im Hilfebereich für Werbung, Branded Content.

Übersicht

Erstelle Branded Content für verschiedene Beitragsformate, die im Hilfebereich für Werbung, Branded Content aufgelistet sind.

Dabei rufst du verschiedene Endpunkte pro Beitragsformat auf und nimmst sponsor_tags in den Beitrag auf. Ein Sponsoren-Tag verweist auf eine Facebook-Seite.

Wenn du direct_share_status zum Beitrag hinzufügst, kann dein Geschäftspartner deine Beiträge direkt bewerben. Lege direct_share_status = 1 fest, um einem Geschäftspartner die Berechtigung zum Bewerben deines Beitrags zu erteilen. Lege andernfalls direct_share_status = 0 fest.

Status-Update erstellen

Zunächst solltest du einen Beitrag im feed-Endpunkt einer Seite posten, um ein Status-Update zu erstellen. Die POST-Anfrage muss Werte für die Felder sponsor_id, share_status und message enthalten.

curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1"
  
  {"id":"ID"}

Fotos hinzufügen

Beim photos-Endpunkt einer Seite kannst du deinem Beitrag Fotos hinzufügen. Die POST-Anfrage muss Werte für die Felder sponsor_id, share_status und message enthalten.

Gib ein url-Feld an, um einen Link zu einem vorhandenen Foto zu erstellen. Du kannst das Foto auch als Anhang an den Beitrag hochladen. Siehe Hochladen von Fotos.

  curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1" 
  -F "url=https://xx.cdn.net/v/t31.0-8/13064650_505613696297499_6399089570275517473_o.jpg"
  
 {"id":"372501189608751_701886166670250"}

Video posten

Zum Posten eines Videos mit Branded Content musst du mehrere Schritte ausführen:

  • Gib über einen Aufruf an, dass du ein Video hochladen möchtest. Die API gibt eine Videoobjekt-ID zurück, mit der du das Video hochladen kannst.
  • Lade das Video hoch.
  • Schließe die Videoübertragung durch Festlegen des Teilen-Status ab. Gib außerdem sponsor_id für das Video an, um Branded Content zur Meldung hinzuzufügen.

Siehe Hochladen von Videos.

In diesem Beispiel wird eine Anfrage gestartet und das Video hochgeladen. Außerdem werden sponsor_id und direct_share_status festgelegt.

 curl -X POST "https://graph-video.facebook.com/VERSION/PAGE_ID/videos" 
  -F "access_token=$at" 
  -F "upload_phase=finish" 
  -F "upload_session_id=SESSION_ID" 
  -F "sponsor_id=ID" 
  **-F "direct_share_status=1"**

Wenn der Vorgang erfolgreich ist, wird Folgendes angezeigt:

{"success":true}

Live-Video

Zum Erstellen von Live-Videos mit Markeninhalten solltest du:

  • Ein Live-Videoobjekt erstellen
  • Das Live-Videoobjekt aktualisieren und sponsor_id hinzufügen
  • Deinen Video-Stream starten

Mehr über das Erstellen und Verwalten von Live-Video-Streams erfährst du in unserer Live Video API. Du kannst die Liste der Live-Videos für eine Seite abfragen und sponsor_id mit einer Video-ID aktualisieren. Alternativ dazu kannst du die ID, die beim ersten Erstellen des Live-Inhalts zurückgegeben wurde, verwenden.

Aktualisieren von Branded Content

Wir unterstützen keine Änderungen an gepostetem Content mit einer Marken-ID im Web oder auf Mobilgeräten. Du kannst aber die Marketing API verwenden, um einen Beitrag zu aktualisieren und einen Sponsor hinzuzufügen oder zu ändern. Du kannst den Sponsor ändern, indem du den Wert im Feld sponsor_id für ein Beitragsobjekt bearbeitest.

Um einen Sponsor zu einem Beitrag hinzuzufügen, tätige eine POST-Anfrage für einen Seitenbeitrag und gib eine sponsor_id an. Um den Sponsor für einen Beitrag zu ändern, übergib das neue sponsor_id-Feld.

Du kannst zulassen oder verhindern, dass ein Geschäftspartner einen Beitrag direkt bewirbt. Gib sponsor_id und deine Änderung bei direct_share_status an.

curl -X POST "https://graph.facebook.com/PAGE_POST_ID" 
  -F "access_token=TOKEN" 
  -F "direct_share_status=1"
  
 {"success":true}