Business Management APIs

Erste Schritte

Erfahre, wie du Creative-Asset-Management implementieren kannst.

Creative-Asset-Management ist nur für bestimmte Partner verfügbar. Bitte setze dich mit deinem*deiner Meta-Partner*in in Verbindung, um mehr zu erfahren.

Voraussetzungen

Für diese API benötigst du Folgendes:

Berechtigungen

Nutzer*innen musst du bei der Anmeldung bei deiner App nach folgenden Berechtigungen fragen:

  • business_creative_management: Business Creatives-Ordner und Business Creatives verwalten. Erforderlich für alle Business Creative Asset Manager API-Endpunkte.
  • business_creative_insights: Auf Insights zu Business Creative-Assets zugreifen.
  • business_management: Unternehmensnutzer*innen verwalten und Anfragen für Partnerschaftsvereinbarungen zustimmen.

Einschränkungen

  • Der*die App-Nutzer*in (der Werbetreibende) muss Admin des Unternehmens sein, das durch die Business Manager-ID dargestellt wird.

Schritt 1: Erstelle einen Business Creatives-Ordner

Erstelle im Namen des Unternehmens des Werbetreibenden einen Business Creatives-Ordner, indem du eine POST-Anfrage an den {business-id}/creative_folders-Endpunkt stellst. In diesem Fall ist {business-id} die Unternehmens-ID des Werbetreibenden.

Für diese Handlung benötigst du die Berechtigung business_creative_management.

Beispielanfrage

curl -X POST \
  -F 'name={folder-name}' \
  -F 'access_token={access-token}' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/creative_folders

Beispielantwort

{ “id”: “{business-creative-folder-id}” }

Du kannst auch Unterordner erstellen.

Schritt 2: Füge Anzeigengestaltungen zu den Ordnern hinzu

Füge bestehende Creative Assets zu einem Ordner hinzu, indem du eine POST-Anfrage an {business-id}/images oder {business-id}/videos sendest. Für diese Handlung benötigst du die Berechtigung business_creative_management:

Bilder hinzufügen

Beispiel – So fügst du ein Bild hinzu:

curl -X POST \
  -F 'bytes={image-content-in-bytes-format}' \
  -F 'name={image-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  https://graph.facebook.com/{version}/{business-id}/images

Antwort

{
  "images":{
    "{image-name}":{
      "id":"{business-image-id}",
      "hash":"{hash}",
      "url":"{image-url}"
    }
  }
}

Videos hochladen

Lade ein Video in einer einzelnen Anfrage hoch, wenn es nur wenige Megabytes groß ist, oder lade es in Chunks hoch. Sende den API-Aufruf für den Video-Upload an graph-video.facebook.com anstelle von graph.facebook.com.

Beispiel: Sende eine POST-Anfrage an {business-id}/video und gib dabei den Namen des Videos, die Quelle sowie die ID des Business Creatives-Ordners an.

curl -X POST \
  -F 'name={video-name}' \
  -F 'source='@{video-path}'' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  https://graph-video.facebook.com/{version}/{business-id}/videos

Antwort

{ 
    "success": true, 
    "business_video_id": "{business-video-id}" 
}

Videos in Chunks hochladen

Sende bei größeren Videos eine start-Anfrage, eine oder mehrere transfer-Anfragen und eine finish-Anfrage.

Um eine start-Anfrage zu senden und eine Video-Upload-Sitzung zu erstellen, sende eine POST-Anfrage an /{business-id}/videos, setze das Feld upload_phase auf start und gib file_size in Bytes an.

curl -X POST \
  -F 'title={video-name}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'access_token={access-token}' \
  -F 'upload_phase=start' \
  -F 'file_size={video_file_size_in_bytes}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Beispielantwort

{
  "upload_session_id": "{session-id}",
  "business_video_id": "{business-video-id}",
  "video_id": "{video-id}",
  "start_offset": "0",
  "end_offset": "52428800"
}

Um [0, 52428800] von deinem Video hochzuladen, teile die Datei gemäß dem Start- und dem End-Offset in Chunks auf und sende diese Chunks dann mit transfer-Anfragen. Wir senden dir für jeden Chunk neue Offsets. Verwende diese neuen Offsets, um die einzelnen Chunks hochzuladen.

Beispiel: Ersten Chunk senden

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=transfer' \
  -F 'upload_session_id={session-id}' \
  -F 'start_offset=0' \
  -F 'video_file_chunk=@{binary-chunk-filename}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Wenn der Vorgang erfolgreich ist, senden wir dir die Offsets für den nächsten Chunk.

{
 "start_offset": "52428800",    //Start byte position of the next file chunk.
 "end_offset": "104857601"      //End byte position of the next file chunk.
}

Schneide den zweiten Chunk mit dem Bereich [52428800, 104857601] aus der Datei aus und sende ihn:

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=transfer' \
  -F 'start_offset=52428801' \
  -F 'upload_session_id={your-upload-sesson-id}' \
  -F 'video_file_chunk={binary-chunk-filename}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Sende alle weiteren Chunks, bis start_offset gleich end_offset ist:

{
  "start_offset": "152043520",
  "end_offset": "152043520"
}

Das bedeutet, dass du die ganze Datei hochgeladen hast. Jetzt postest du dieses Video und schließt die Upload-Sitzung.

curl -X POST \
  -F 'title={video-name}' \
  -F 'access_token={access-token}' \
  -F 'creative_folder_id={business-creative-folder-id}' \
  -F 'upload_phase=finish' \
  -F 'upload_session_id={session-id}' \
  https://graph-video.facebook.com/<API_VERSION>/<BUSINESS_ID>/videos

Wenn beim Hochladen Fehler auftreten, kannst du den Upload dieses Chunks wiederholen. In der Regel sind Fehler auf Probleme mit der Reaktion zurückzuführen. Lade den fehlgeschlagenen Chunk erneut hoch. Weitere Informationen zu Fehlern findest du hier:

Sobald du eine Anzeigengestaltung in einen Ordner hochlädst, können Werbetreibende mit Zugriff auf den Ordner Anzeigen erstellen: entweder im Werbeanzeigenmanager oder mit der Marketing API.

Alle hochgeladenen Anzeigengestaltungen werden in der Bedienoberfläche des Werbeanzeigenmanagers > Medienauswahl angezeigt. Du kannst sie in der Anzeigenerstellung und Anzeigenbearbeitung verwenden. Darüber hinaus sind die Order und Creative Assets im Medienbibliothekstool im Business Manager unter Business Manager > Medienbibliothek verfügbar.

Schritt 3: Deeplink-URL zu Assets und zum Erstellen von Anzeigen und Beiträgen

Um die Deeplink-URL für ein bestimmtes Asset zu erhalten, frage das Feld media_library_url des hochgeladenen Bild- oder Video-Assets ab:

curl -X GET \  
  -F 'access_token={partner-access-token}' \
https://graph.facebook.com/v<API_VERSION>/<asset_id>?fields=media_library_url

Um deinen Deeplink zur Erstellung einer Anzeige oder eines Seitenbeitrags zu erstellen, hänge am Ende des Links &action=CREATE_AD oder &action=CREATE_POST an:

https://business.facebook.com/asset_library/business_creatives/?object_id=<OBJECT_ID>&action=CREATE_AD