Marketing API

Erste Schritte mit generativen KI-Funktionen in Marketing API

API-Unterstützung für generative KI-Funktionen

Es ist Aufgabe von Werbetreibenden, Werbeanzeigen mit KI-generierten Inhalten vor der Veröffentlichung in der Vorschau anzusehen. Siehe Anleitung zur Vorschaukonfiguration.

Meta übernimmt keine Gewähr für die Vollständigkeit, Zuverlässigkeit und Richtigkeit der vorgeschlagenen generierten Texte oder Hintergründe oder erweiterten Bilder. Wenn du die Marketing API für den Zugriff auf unsere unten beschriebenen generativen KI-Funktionen verwendest, gelten zusätzlich zu den Plattform-Nutzungsbedingungen von Meta die Nutzungsbedingungen für die Anzeigengestaltung mit generativer KI.

In diesem Dokument wird dir gezeigt, wie du die generativen KI-Funktionen für Textgenerierung, Bilderweiterung und Hintergrundgenerierung für Anzeigen verwenden kannst.

Bevor du loslegst

Um deine Anzeigenkampagnen mit den generativen KI-Funktionen von Meta einzurichten, musst du die folgenden Schritte durchführen.

  1. Eine Kampagne erstellen
  2. Eine Anzeigengruppe erstellen
  3. Die Anzeige oder eine eigenständige Anzeigengestaltung erstellen
  4. Die Anzeigengestaltung in der Vorschau ansehen
  5. Die Anzeige aktivieren

Textgenerierung

Mithilfe von KI werden Textvariationen generiert, die von deinem ursprünglichen primären Text, deinen früheren Anzeigen oder Inhalten von deiner Unternehmensseite inspiriert sind, um die Vorschläge relevanter zu machen. Wenn du zu deiner Anzeige mehr Textoptionen hinzufügst, kannst du deine Anzeigengestaltung individueller gestalten und einem Abnutzungseffekt vorbeugen, was die Leistung steigern kann. Hier findest du weitere Informationen zu dieser Funktion.

Schritt 1: Der Verwendung von Textgenerierung bei der Anzeigenerstellung zustimmen

Du kannst eine Anzeige über den /ads-Endpunkt erstellen oder über den /adcreatives-Endpunkt eine eigenständige Anzeigengestaltung erstellen. Die Zustimmung zur Funktion bezieht sich nur auf die Anzeige oder Anzeigengestaltung, die in der aktuellen Anfrage erstellt wird. Bei beiden Ansätzen musst du der Verwendung der Textgenerierungsfunktion zustimmen, indem du Folgendes tust:

  1. Bereitstellung eines primären Texts im Feld message in der object_story_spec
  2. Zustimmung zur Verwendung von text_generation

Siehe Beispielanfragen unten:

Zustimmen über den /adcreatives-Endpunkt

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",  <--- Primary Text Here
      },
      "page_id": "<PAGE_ID>"
  }' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "text_generation": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Alternativ kannst du ein Anzeigenobjekt mit dem act_<AD_ACCOUNT_ID>/ads-Endpunkt erstellen:

Zustimmen über den /ads-Endpunkt

curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Text Gen Adgroup",
    "object_story_spec": {
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",  <--- Primary Text Here
      },
      "page_id": "<PAGE_ID>"
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "text_generation": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Schritt 2: Vorschau für Textgenerierung

Wenn eine Anzeige mit Zustimmung zur Verwendung von text_generation erstellt wird, wird die Funktion nur auf die aktuelle Anzeige angewendet und generierte primäre Texte werden in die Spezifikation der Anzeigengestaltung eingefügt. Wenn der Funktion über den Endpunkt /ads zugestimmt wurde, wird das Feld status in der Anzeigengruppe standardmäßig auf PAUSED gesetzt (siehe Dokumentation). Du kannst die generierten Vorschläge prüfen, bevor du den Status der Anzeige manuell auf ACTIVE setzt, damit sie ausgeliefert werden kann.

Die Spezifikation der Anzeigengestaltung mit generierten Vorschlägen kann in der Vorschau angesehen werden, indem du die asset_feed_spec über die Anzeigengestaltungs-ID oder die Anzeigen-ID liest. Unten findest du ein Beispiel für Anfrage und Antwort:

Frage zuerst die asset_feed_spec deiner eigenständigen Anzeigengestaltung ab, die du in Schritt 1 erstellt hast.

Anfrage

// request from creative
curl -X GET -G \
  -d 'fields=asset_feed_spec' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>
  
// request from ad
curl -X GET -G \
  -d 'fields=creative{asset_feed_spec,status}' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_ID>

Antwort

{
  "asset_feed_spec": {
    "bodies": [
      {
        "text": "Buy some cool LED TV at cheap price"
      },
      {
        "text": "Get your dream LED TV at an unbeatable price! Buy now and save big!"
      },
      {
        "text": "Get the best LED TV deals! 📺 Save money and upgrade your entertainment."
      },
      {
        "text": "Get an LED TV at a low cost! Cheap, high-quality options are available."
      },
      {
        "text": "Get LED TVs at affordable prices  ✨  !"
      }
    ],
    "optimization_type": "DEGREES_OF_FREEDOM"
  },
  "id": "<CREATIVE_ID>"
}

Nachdem du die Vorschläge geprüft hast und diese für die Veröffentlichung geeignet erscheinen, gehe bitte weiter zu Schritt 3, um die Anzeige auf ACTIVE zu setzen. Wenn keiner der generierten Vorschläge akzeptabel ist, erstelle eine neue Anzeige oder Anzeigengestaltung, ohne der Textgenerierung zuzustimmen.

Anzeigengestaltung ohne Zustimmung zur Textgenerierung erstellen

curl -X POST \
  -F 'name=Text Gen Creative' \
  -F 'object_story_spec={
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "<PRIMARY_TEXT_HERE>",
      },
      "page_id": "<PAGE_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Schritt 3: Den Anzeigengruppenstatus auf ACTIVE festlegen

Nachdem du die generierten Textvorschläge verifiziert hast, kannst du den status der Anzeige auf ACTIVE festlegen. Dieser Schritt muss in beiden Fällen durchgeführt werden:

  1. Wenn über den Endpunkt /ads für eine Anzeige der Funktion zugestimmt wurde.
  2. Wenn die Anzeige die erste ist, die eine bestehende Anzeigengestaltung mit Zustimmung zur Textgenerierung verwendet.

Anfrage

curl \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_ID>

Bilderweiterung

Erweitere automatisch dein Bild, sodass es in mehr Platzierungen passt.

Ab dem 16. September 2024 ist das Feature „Bilderweiterung“ im Rahmen der Standardoptimierung enthalten. Daher solltest du dich beim Erstellen einer Werbeanzeige oder Anzeigengestaltung, für die der Bilderweiterung zugestimmt wurde, unter Standardoptimierung für die Advantage+-Anzeigengestaltung darüber informieren, wie du standard_enhancements als Feld innerhalb der creative_features_spec festlegst.

Schritt 1: Eine Anzeige oder Anzeigengestaltung erstellen, für die der Bilderweiterung zugestimmt wurde

Du kannst eine Anzeige über den /ads-Endpunkt erstellen oder über den /adcreatives-Endpunkt eine eigenständige Anzeigengestaltung erstellen. Bei beiden Ansätzen stimmst du der Verwendung der Bilderweiterungsfunktion in der Spezifikation der Anzeigengestaltung zu (siehe Beispiele unten).

Anfrage

// creative example
curl -X POST \
  -F 'name=Image Expansion Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_uncrop": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Image Expansion Adgroup",
    "object_story_spec": {
      "link_data": {
         "image_hash": "<IMAGE_HASH>", 
         "link": "<URL>", 
         "message": "You got this.",
      },
      "page_id": "<PAGE_ID>"
    },
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_uncrop": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Schritt 2: Vorschau für Bilderweiterung

Diese Funktion wird für Platzierungen in INSTAGRAM_STANDARD, FACEBOOK_REELS_MOBILE, INSTAGRAM_REELS, MOBILE_FEED_STANDARD, INSTGRAM_STORY unterstützt. Um eine Vorschau für diese Platzierungen anzusehen, sende eine GET-Anfrage an den /<AD_ID>/previews-Endpunkt.

Wenn keines der generierten Bilder akzeptabel ist, erstelle die Anzeige oder Anzeigengestaltung bitte neu, ohne der Bilderweiterung zuzustimmen:

  • Lege die creative_feature auf image_uncrop fest.
  • Fordere die Vorschau erneut an, wenn der status als pending angezeigt wird.

Hinweis: Wenn kein transformation_spec-Node angezeigt wird, bedeutet das, dass die Bilderweiterung für die Anzeigengestaltung nicht verfügbar ist.

Anfrage

INSTAGRAM_STANDARD

curl -X GET -G \
  -d 'ad_format=INSTAGRAM_STANDARD' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

Antwort

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_uncrop": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible"
          }
        ]
      }
    }
  ]
}

(Optional) Direkte Vorschau ohne Anzeigenerstellung

Du kannst auch mit dem act_<AD_ACCOUNT_ID>/generatepreviews-Endpunkt eine Vorschau anfordern, ohne tatsächlich eine Anzeige zu erstellen.

Anfrage

FACEBOOK_REELS_MOBILE

curl -X GET -G \
  -d 'ad_format=FACEBOOK_REELS_MOBILE' \
  -d 'creative_feature=image_uncrop' \
  -d 'creative={
       "object_story_spec": {
         "page_id": "<PAGE_ID>",
          "link_data": {
            "image_hash": "<IMAGE_HASH>",
            "link": "<WEBSITE_LINK>"
          }
        }
     }'
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/generatepreviews

Hintergrundgenerierung

Wir erstellen verschiedene Hintergründe für geeignete Produktbilder und liefern die Version aus, auf die deine Zielgruppe am ehesten reagieren wird. Die Hintergründe wurden ausgehend von deinem Originalinhalt erstellt.

Schritt 1: Eine Anzeige oder Anzeigengestaltung erstellen, für die der Hintergrundgenerierung zugestimmt wurde

Hintergrundgenerierung kann derzeit nur mit dynamischen Produktanzeigen oder Advantage+ Catalog Ads in Mobile Feed verwendet werden.

Du kannst eine Anzeige über den /ads-Endpunkt erstellen oder über den /adcreatives-Endpunkt eine eigenständige Anzeigengestaltung erstellen. Bei beiden Ansätzen stimmst du der Verwendung der Hintergrundgenerierungsfunktion in der Spezifikation der Anzeigengestaltung zu (siehe Beispiele unten).

Anfrage

// creative example
  curl -X POST \
  -F 'name=Background Gen Creative' \
  -F 'degrees_of_freedom_spec={
    "creative_features_spec": {
      "image_background_gen": {
        "enroll_status": "OPT_IN"
      }
    }
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>'
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

// ad example
curl \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={
    "name": "Background Gen Adgroup",
    "object_story_spec": {
      "page_id": "<PAGE_ID>",
      "template_data": {
        "description": "Description {{product.description}} ",
        "link": "https://www.example.com/",
        "message": "Test {{product.name | titleize}} ",
        "name": "Headline {{product.price}}"
      }
    },
    "product_set_id": "<PRODUCT_SET_ID>",
    "degrees_of_freedom_spec": {
      "creative_features_spec": {
        "image_background_gen": {
          "enroll_status": "OPT_IN"
        }
      }
    }
  }' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Schritt 2: Vorschau für Hintergrundgenerierung

Wenn der Funktion zugestimmt wurde, erstellen wir verschiedene Hintergründe für geeignete Produktbilder und liefern die Version aus, auf die deine Zielgruppe am ehesten reagieren wird. Die Zustimmung zur Funktion gilt nur für die Anzeige, die in der aktuellen Anfrage erstellt wird. Diese Hintergründe werden auf der Grundlage deines Originalinhalts erstellt und enthalten verschiedene Farben oder Muster für geeignete Produktbilder. Je nach Katalogberechtigung wird eine statische oder eine Live-Vorschau des generierten Hintergrunds angezeigt.

Wenn keiner der generierten Hintergründe akzeptabel ist, erstelle die Anzeige oder Anzeigengestaltung bitte neu, ohne der Hintergrundgenerierung zuzustimmen.

  • Die Vorschau wird derzeit nur für die Platzierung MOBILE_FEED_STANDARD unterstützt.
  • Lege die creative_feature auf image_background_gen fest.
  • Wenn die Live-Vorschau für deine Katalogprodukte nicht fertig ist, wird eine Bestandsvorschau angezeigt, deren status auf PENDING festgelegt ist.

Anfrage

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=/<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>/previews

Antwort

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

(Optional) Direkte Vorschau ohne Anzeigenerstellung

Du kannst auch mit dem /<AD_CREATIVE_ID>/previews-Endpunkt eine Vorschau der Anzeigengestaltung anfordern, ohne tatsächlich eine Anzeige zu erstellen.

Anfrage

MOBILE_FEED_STANDARD

curl -X GET -G \
  -d 'ad_format=MOBILE_FEED_STANDARD' \
  -d 'creative_feature=image_background_gen' \
  -d 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v19.0/<AD_CREATIVE_ID>/generatepreviews

Antwort

{
  "data": [
    {
      "body": "<iframe src='<PREVIEW_URL>'></iframe>",
      "transformation_spec": {
        "image_background_gen": [
          {
            "body": "<iframe src='<PREVIEW_URL>'></iframe>",
            "status": "eligible" // or one of "pending", "ineligible"
          }
        ]
      }
    }
  ]
}

Über KI-Transparenz

Anzeigenbilder, die mit bestimmten generativen KI-Features von Meta für die Anzeigengestaltung erstellt oder in erheblichem Umfang bearbeitet wurden, die in unseren Marketing-Tools verfügbar sind, können im Menü mit den drei Punkten KI-Info enthalten oder neben dem Hinweis „Gesponsert“ ein KI-Info-Label anzeigen. Hier erfährst du mehr über die Transparenz rund um generative KI für Werbeanzeigen.

Mehr erfahren