Marketing API

Optionen für Asset-Feed-Spezifikationen

Du kannst die folgenden Optionen in deiner asset_feed_spec verwenden. Weitere Referenzen findest du unter Asset-Feed-Spezifikationen für Werbeanzeigen.

Eigenschaftsname Beschreibung

images

Typ: Array mit Liste

Für die Formate SINGLE_IMAGE und CAROUSEL_IMAGE erforderlich

Array von qualifizierten Bildern. Die Bilder in diesem Array sollten in der Bildbibliothek des Werbekontos enthalten sein


Gib dieses Feld als Array mit einer Liste an, die {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"} enthält. Entweder url oder hash ist erforderlich.

videos

Typ: Array mit Liste

Für das SINGLE_VIDEO-Format erforderlich

Array von video_ids. Die in diesem Array angegebenen video_ids sollten zum Werbekonto gehören.


Gib dieses Feld als Array mit einer Liste an, die {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"} enthält.

carousels
Typ: Array mit Liste

Optional.
Array von child_attachments zusammen mit den booleschen Werten für multi_share_end_card und multi_share_optimized sowie adlabels. Die in diesem Array bereitgestellten child_attachments sollten zum Werbekonto gehören.



Gib child_attachments als ein Array mit einer Liste an, die {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}} enthält. Entweder image_label oder video_label ist erforderlich.

bodies

Typ: Array mit Liste

Optional.

Array von Haupttexten. Die Hauptnachricht oder der Text der Werbeanzeige.


Gib dieses Feld als ein Array mit Liste von {"text": "{BODY_TEXT}", "url_tags": "{TAG}"} an.

call_to_action_types

Typ: Array mit Liste

Erforderlich für alle Ziele außer OUTCOME_AWARENESS.

Array von Call to Action-Typwerten.


Gib dieses Feld als ein Array mit Liste von {"{CALL_TO_ACTION}"} an. Du kannst bis zu fünf Werte angeben.

titles

Typ: Array mit Liste

Optional.

Array von Titeln. Ein Titel ist eine kurze Überschrift in der Werbeanzeige (wird im Allgemeinen neben einem Link, Bild oder Video angezeigt).


Gib dieses Feld als ein Array mit Liste von {"text": "{TITLE}", "url_tags": "{TAG}"} an.

descriptions

Typ: Array mit Liste

Optional.

Array mit sekundärem Beschreibungstext (wird weniger prominent als Haupttexte und Titel angezeigt). Wird im Allgemeinen neben einem Link, Bild oder Video angezeigt. Wenn du hier nichts angibst, liest Facebook den von dir angegebenen Link aus, um ihn zu generieren. Verwende einen leeren String mit einem einzelnen Leerzeichen für eine leere Beschreibung, wenn du den ausgelesenen Text nicht verwenden möchtest.


Gib dieses Feld als ein Array mit Liste von {"text": "{DESCRIPTION}", "url_tags": "{TAG}"} an.

link_urls

Typ: Array mit Liste

Erforderlich.

Array mit Link-URLs.


Gib dieses Feld als ein Array mit Liste von {"website_url": "{URL}"} an.

ad_formats

Typ: Array von Strings

Erforderlich.

Array von Facebook-Anzeigenformaten zum Erstellen der Werbeanzeigen. Unterstützte Formate: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, AUTOMATIC_FORMAT.


Gib dieses Feld als ein Array von ["{AD_FORMAT}"]-Strings an.

optimization_type

Typ: String

Optional.

Im Asset-Feed verwendeter Optimierungstyp. Mögliche Werte sind ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT und REGULAR.

message_extensions

Typ: Array von Strings

Optional.
Im Asset-Feed verwendeter Nachrichtenerweiterungstyp.


Möglicher Wert: whatsapp

onsite_destinations
Typ: Array mit Liste

Erforderlich für Shops Ads. Gültig für Static Ads im SINGLE_IMAGE-, SINGLE_VIDEO- oder CAROUSEL-Format.
Gib dieses Feld als ein Array mit Liste an, die einen der folgenden Werte enthält, um die Ziel-Landingpage für deinen Onsite-Shop anzugeben.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
Typ: Boolescher Wert

Erforderlich für Shops Ads. Gültig für Advantage+ Catalog Ads.
Gib dieses Feld zur Shop-Optimierung an. Beinhaltet sowohl den Shop-Optimierungstyp reasons_to_shop als auch automated_product_tags.
Mögliche Werte: true, false

reasons_to_shop
Typ: Boolescher Wert

Erforderlich für Shops Ads. Gültig für Advantage+ Catalog Ads.
Gib dieses Feld zur Shop-Optimierung an. Hebt automatisch Produktinformationen aus deinem Shop hervor, wie „Kostenloser Versand“, „Topaktuell“ oder „Geringer Bestand“.
Mögliche Werte: true, false

Einschränkungen für Asset-Feed-Spezifikationen

Anzeigenformate

  • Unterstützte ad_formats: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO und AUTOMATIC_FORMAT.
  • Pro Asset-Feed ist nur ein ad_format zulässig.
  • ad_format zählt als ein Asset in einem Asset-Feed.

Anzahl der Assets:

  • Maximal 30 Assets. Du hast beispielsweise 28 Assets mit 10 images, 5 bodies, 5 titles, 5 description, 1 ad_format, 1 link_url und 1 call_to_action_types.
  • Gesamtanzahl der Bilder: <= 10
  • Gesamtanzahl der Videos: <= 10 Wenn du Instagram als deine Platzierung verwendest, sind nur quadratische Videos oder Videos im Querformat zulässig.
  • Gesamtanzahl der Haupttexte: <= 5
  • Gesamtzahl der Calls to Action: <= 5
  • Gesamtzahl der Titel: <= 5
  • Gesamtzahl der Links: <= 5
  • Gesamtzahl der Beschreibungen: <= 5

Bildanforderungen:

  • Empfohlenes Bildformat: 1,9:1
  • Empfohlene Bildgröße: 1.200 x 628 Pixel
  • Beim Format CAROUSEL_IMAGE musst du mindestens zwei Bilder angeben.
  • Wenn du Instagram als deine Platzierung verwendest, verwende quadratische Bilder für eine bessere Performance.

Textanforderungen:

  • Titel- und Beschreibungstext: maximal 255 Zeichen
  • Haupttext: maximal 1024 Zeichen
  • Wenn du keine Beschreibung angibst, lesen wir den bereitgestellten Link aus, um die Beschreibung abzurufen.
  • Titel sind im CAROUSEL_IMAGE-Format optional.

url_tags sind optional und nur für images, videos, bodies, descriptions und titles verfügbar. Facebook hängt url_tags als Parameter für jedes Asset in einer Anzeige an die Link-URL an.

Eine gültige Einrichtung einer Asset-Feed-Kombination für das SINGLE_IMAGE Format sieht beispielsweise folgendermaßen aus:

  • 5 images
  • 3 bodies
  • 3 titles
  • 3 descriptions
  • 1 Format: SINGLE_IMAGE
  • 2 link_urls
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

Deeplinks verwenden

Du kannst Deeplinks in Asset-Feed-Spezifikationen für Kampagnen mit den folgenden Zielen verwenden:

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

Füge eine deeplink_url in link_urls hinzu, wenn du deine asset_feed_spec erstellst.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Website-Werbeanzeigen, die zu WhatsApp weiterleiten

Du kannst Werbeanzeigen erstellen, die Personen zu deiner Website weiterleiten. Dort wird unten auf dem Bildschirm ein WhatsApp-Button angezeigt, damit sie dich umgehend kontaktieren können. Damit hilfst du Besucher*innen deiner Website, sich mit dir auf WhatsApp in Verbindung zu setzen.

Füge message_extensions hinzu, wenn du deine asset_feed_spec erstellst.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives