Multi-Language Ads

Passe verschiedene Bereiche der Anzeigengestaltung, wie zum Beispiel das Bild, das Video, den Text und den Inhalt einer Werbeanzeige an, um verschiedene Sprachgruppen zu erreichen. Facebook optimiert deine Anzeige, damit den jeweiligen Nutzern die richtige Sprache angezeigt wird.

Auf diese Weise kannst du ganz einfach eine Werbeanzeige in mehreren Sprachen einrichten und einem Betrachter die jeweils relevanteste Sprachversion deiner Werbeanzeige ausliefern und gleichzeitig ein breites Targeting für die Werbeanzeige beibehalten. Dadurch erhältst du personalisierten Inhalt auf der Basis der von einem Betrachter genutzten Sprache, während du gleichzeitig kostengünstige Werbeanzeigen verwalten kannst.

Allgemeine Informationen du diesem Feature findest du im Hilfebereich für Werbung unter „Werbeanzeigen für eine mehrsprachige Zielgruppe schalten“. Siehe unterstützte Anzeigenkampagnenziele.

Multi-Language Ads ist eine unserer drei APIs, die Asset Customization-Regeln verwenden.

Los geht‘s

Bevor du beginnst, solltest du die Einschränkungen für dieses Produkt prüfen. Wenn dein Anwendungsfall unsere Voraussetzungen erfüllt, kannst du mit den folgenden Schritten fortfahren:

Wenn du nicht über die Ressourcen verfügst, um deine Anzeige manuell zu übersetzen, sieh dir unseren automatischen Übersetzungsdienst an.

Schritt 2: Stelle die Anzeigengestaltung über asset_feed_spec bereit

Anzeigengestaltungen für Multi-Language Ads werden mithilfe von asset_feed_specs angegeben. Bei einem Element-Feed handelt es sich um eine Sammlung verschiedener Anzeigenelemente, z. B. Bilder, Titel, Haupttexte usw. Du erstellst eine asset_feed_spec unter /adcreative.

Um eine asset_feed_spec zu erstellen, gibst du für jede einzelne Sprache ein Array von Elementen an. Füge ein Label zur Markierung jedes einzelnen Elements zur Identifizierung der Sprache des jeweiligen Elements hinzu. Facebook verwendet die Labels in asset_customization_rules, um Elemente nach Sprache zu gruppieren. Du solltest pro Elementtyp mindestens ein Element angeben.

Verfügbare Parameter

Folgende Parameter sind in asset_feed_spec anzugeben:

Eigenschaftsname Beschreibung

images

Typ: Array

Für das Anzeigenformat SINGLE_IMAGE erforderlich. Gib url oder hash an.

Bilder als url oder hash. Du solltest Bilder aus der Bildbibliothek des Werbekontos bereitstellen.


Gib dieses Feld als ein Array von {"url": "<IMAGE_URL>", "hash": "<IMAGE_HASH>", "url_tags": "<TAG>", "adlabels": [{name: "<LABEL>"}]} an.

videos

Typ: Array

Für das SINGLE_VIDEO-Anzeigenformat erforderlich.

Array von video_ids. Videos sollten in der Videobibliothek des Werbekontos enthalten sein.


Gib dieses Feld als ein Array von {"video_id": "<VIDEO_ID>","thumbnail_url": "{<THUMBNAIL_URL>}", "url_tags": "{<TAG>}", "adlabels": [{"name": "<LABEL>"}]} an.

bodies

Typ: Array

Erforderlich, aber url_tags sind optional.

Array mit Haupttexten, die die primäre Botschaft der Werbeanzeige enthalten.


Gib dieses Feld als ein Array von {"text": "<BODY_TEXT>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]} an.

titles

Typ: Array

Erforderlich, aber url_tags sind optional.

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


Gib dieses Feld als ein Array von {"text": "<TITLE>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]} an.

descriptions

Typ: Array

Erforderlich, aber url_tags sind optional.

Array mit sekundärem Beschreibungstext (wird weniger prominent als Haupttexte und Titel angezeigt).


Gib dieses Feld als ein Array von {"text": "<DESCRIPTION>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]} an. Verwende einen leeren String mit einem einzelnen Leerzeichen für eine leere Beschreibung.

link_urls

Typ: Array

Erforderlich, aber display_url und deeplink_url sind optional.

Array mit Link-URLs.


Gib dieses Feld als ein Array von {"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"} an.

call_to_action_types

Typ: Array

Erforderlich.

Array von Call to Action-Typwerten.


Gib dieses Feld als ein Array unterstützter Call to Actions an: ["<CALL_TO_ACTION>"].

ad_formats

Erforderlich.

Array von Facebook Ad-Formaten, in denen du die Werbeanzeigen erstellen möchtest. Unterstützte Formate sind: SINGLE_IMAGE, SINGLE_VIDEO.


Gib dieses Feld als ein Array unterstützter Anzeigenformate an: ["{<AD_FORMAT>}"].

asset_customization_rules

Typ: siehe Tabelle unten unter Asset Customization-Regeln

Erforderlich.

Array von Asset Customization-Regeln.

Asset Customization-Regeln

Definiere die Elemente, die für Betrachter, die eine bestimmte Sprache sprechen, gemeinsam angezeigt werden. Jede Regel weist eine customization_spec auf, welche die Gebietsschemata von Personen definiert, die diese Elemente bei der Anzeigenauslieferung sehen.

Gib genau eine Standardregel an. Diese Regel muss die Elemente beinhalten, die Facebook anzeigt, wenn die bevorzugte Sprache eines Nutzers nicht mit einem der im Element-Feed angegebenen Gebietsschemata übereinstimmt. Dadurch wird eine zu geringe Auslieferung deiner Werbeanzeigen verhindert.

Eigenschaftsname Beschreibung

customization_spec

Typ: {"locales": [<LOCALE1>, <LOCALE2>]}

Erforderlich.

Definiere die Gebietsschemata, in denen die Elemente in dieser Regel ausgeliefert werden sollen. Die unterstützten Gebietsschemata findest du unter Verfügbare Sprachen.

image_label

Typ: {"name": "<LABEL>"}

Für das Anzeigenformat SINGLE_IMAGE erforderlich.

Beschriftung, die an eines der Bildelemente im Element-Feed angehängt ist.

video_label

Typ: {"name": "<LABEL>"}

Für das SINGLE_VIDEO-Anzeigenformat erforderlich.

Beschriftung, die an eines der Videoelemente im Element-Feed angehängt ist.

body_label

Typ: {"name": "<LABEL>"}

Erforderlich.

Label, das an eines der Textelemente im Element-Feed angehängt ist.

title_label

Typ: {"name": "<LABEL>"}

Erforderlich.

Label, das an eines der Titelelemente im Element-Feed angehängt ist.

description_label

Typ: {"name": "<LABEL>"}

Erforderlich.

Label, das an eines der Beschreibungselemente im Element-Feed angehängt ist.

link_url_label

Typ: {"name": "<LABEL>"}

Erforderlich.

Label, das an eines der link_url-Elemente im Element-Feed angehängt ist.

is_default

Typ: boolean

Erforderlich.

Boolesches Flag zur Identifizierung der Standardregel. Du solltest genau eine Regel mit der is_default-Kennzeichnung true festlegen.

Verfügbare Sprachen

Die von dir in customization_spec angegebenen Gebietsschemata müssen Gebietsschema-IDs sein, die in Anzeigen-Targeting unterstützt werden. Mehr dazu erfährst du unter Targeting und Platzierung, Gebietsschemata. Mit dem Endpunkt /search kannst du nach bestimmten Sprachen suchen. Verwende den Parameter q, um nach einem bestimmten Sprachnamen zu suchen. Lasse diesen Parameter leer, wenn du eine Liste aller unterstützten Sprachen anzeigen möchtest:

curl -G 
  -d "type=adlocale"
  -d "q=en"
  -d "limit=2"
  -d "access_token=<ACCESS_TOKEN>" 
  https://graph.facebook.com/<API_VERSION>/search

Wenn der Vorgang erfolgreich ist, wird eine Liste der Sprachen angezeigt:

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

Du solltest die Schlüssel in diesen Suchergebnissen als Gebietsschemata in deinen Asset Customization-Regeln verwenden. Weitere Informationen findest du unter Targeting-Suche.

Schritt 3: Erstelle Anzeigen mit Element-Feed-Spezifikationen

Du kannst einen Element-Feed mit dem Feld asset_feed_spec in POST ad_account_ID/adcreatives erstellen:

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }'
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "J45p3r5m4RK374VOc4DO2",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }'
  -F 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adcreatives

Wenn der Vorgang erfolgreich ist, erhältst du die ID für die Anzeigengestaltung:

{"id":"238474593777777"}

Wenn deine asset_feed_spec die Einschränkungen unten nicht erfüllt, wird ein Fehler angezeigt.

Um eine Anzeige mit dieser Anzeigengestaltungs-ID zu erstellen, rufe POST act_AD_ACCOUNT_ID/ads auf. Gib alternativ zur Anzeige verschiedener Sprachen in deiner Werbeanzeige die asset_feed_spec und object_story_spec im Parameter creative für die Anzeige an.

Zur Überprüfung der neuen asset_feed_spec rufst du GET für die Anzeigen-ID oder die Anzeigengestaltungs-ID auf:

curl -G
-d 'fields=object_story_spec,asset_feed_spec'
-d 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/API_VERSION/<CREATIVE_ID>

Optionaler Schritt 4: Zeige deine Werbeanzeige in der Vorschau an

Zeige die verschiedenen Sprachversionen deiner Anzeige mit dem Endpunkt generatepreview in der Vorschau an. Füge ein dynamic_asset_label-Feld mit einem adlabel in einer Regel hinzu, um eine bestimmte Sprachversion anzuzeigen.

So zeigst du z. B. die französische Version der obigen Anzeigengestaltung in der Vorschau an:

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Automatische Übersetzungen

Du kannst unseren automatischen Übersetzungsdienst nutzen, wenn du nicht die Ressourcen hast, um deine Anzeige manuell zu übersetzen. Mit dieser Funktion werden deine Standard-Anzeigentexte in zusätzliche Sprachen übersetzt, sodass du eine mehrsprachige Zielgruppe erreichen kannst.

Die Quelle für die automatische Übersetzung ist in den Textelementen zu finden, die durch die Asset Customization-Standardregel angegeben werden. Automatisch übersetzte Anzeigentexte sind als „Automatisch übersetzt“ gekennzeichnet.

Um eine automatisch übersetzte Version deines Anzeigentextes zu erstellen, füge autotranslate zu asset_feed_spec hinzu. Dann gib die Sprachen an, in die dein Text übersetzt werden soll. Siehe dieses Beispiel:

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }'
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }'
  -F 'access_token=<ACCESS_TOKEN>'
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives/?fields=asset_feed_spec

Die automatisch übersetzten Texte können mit einem Aufruf an das asset_feed_spec-Feld in der Anzeigengestaltung geprüft werden.

Änderungen an den automatisch übersetzten Texten in der Spezifikation werden verworfen, wenn die gleiche Sprache im Feld autotranslate angegeben ist. Diese Änderungen werden durch neue Übersetzungen aus dem Standard-Anzeigentext ersetzt. Wenn die Änderungen unbedingt notwendig sind, entferne die Sprache aus dem Feld autotranslate.

link_urls

Du kannst der automatisch übersetzten Anzeigenversion eine eigene Link-URL hinzufügen.

Füge dazu dem Feld link_urls eine language-specific-URL sowie ein adlabel hinzu und füge in asset_customization_rules eine neue Regel mit den entsprechenden Gebietsschemacodes und einem link_url_label für diese Sprache hinzu.

Einschränkungen

Nachfolgend findest du die Einschränkungen und Begrenzungen für deinen Element-Feed.

Anzeigenformate

  • Nur ein Anzeigenformat pro asset_feed_spec
  • Beim Format SINGLE_IMAGE musst du mindestens ein Bild angeben.
  • Beim Format SINGLE_VIDEO musst du mindestens ein Video angeben.

Elemente, allgemein

  • Du kannst für jeden Elementtyp außer call_to_action_types maximal 49 Elemente angeben.
  • Du musst für alle Ziele mindestens ein call_to_action_type-Element angeben.

Textelemente

  • Du musst für jede Sprachversion im Element-Feed mindestens ein Textelement wie title, Text, description und link_urls angeben.
  • Alle Textelemente sollten das Feld adlabels aufweisen.
  • Maximale Länge: 255 Zeichen für Titel, 4.096 Zeichen für Text und 10.000 Zeichen für Beschreibung.

Bild- und Videoelemente

  • Empfohlene Bildgrößen für einzelne Platzierungen und Ziele findest du im Leitfaden für Werbeanzeigen.
  • Du kannst maximal ein Bild- oder Videoelement ohne ein adlabel verwenden. Wir verwenden dieses Bild oder Video für alle Sprachversionen.
  • Wenn du zusätzliche Bilder oder Videos angibst, musst du adlabels einschließen und diese Labels in deiner Asset Customization-Regel angeben.

Link-URL-Elemente

  • Wenn du url_tags angibst, hängen wir diese als Parameter für jedes Element in der Anzeige an die link_url an.
  • Wenn du das Ziel APP_INSTALLS verwendest, sollte deine link_url mit der promoted_object.object_store_url der Anzeigengruppe übereinstimmen.

Asset Customization-Regeln

  • Du solltest für jede Sprachvariante in asset_feed_spec eine Asset Customization-Regel angeben.
  • Du solltest eine Standardregel angeben. Dies ist eine Asset CustomizationRegel, bei der is_default auf true festgelegt ist. Diese dient als Sicherheitsregel und ermöglicht es, dass Anzeigen auch dann eingeblendet werden, wenn das Gebietsschema einer Person mit keiner der Sprachen in asset_feed_spec übereinstimmt.

Platzierungen

  • Multi-Language Ads unterstützt alle Platzierungen.

Verfügbare Ziele und Zieltypen

  • LINK_CLICKS – Website und Apps, kein Messenger
  • APP_INSTALLS – Desktop- oder mobile Apps
  • CONVERSIONS – Website und Apps, kein Messenger
  • REACH – Alle Zieltypen
  • BRAND_AWARENESS – Alle Zieltypen
  • VIDEO_VIEWS – Alle Zieltypen

Unterstützte Buchungsarten

Unterstützte Sprachrichtungen

Die folgenden Übersetzungsrichtungen werden unterstützt. Verwende den entsprechenden Dialektcode im Feld autotranslate:

AusgangsspracheZielsprache der ÜbersetzungDialektcode

Englisch

Spanisch

es_XX

Englisch

Französisch

fr_XX

Englisch

Deutsch

de_DE

Englisch

Portugiesisch

pt_XX

Englisch

Italienisch

it_IT

Englisch

Arabisch

ar_AR

Englisch

Niederländisch

nl_XX

Englisch

Malaiisch

ms_MY

Englisch

Schwedisch

sv_SE

Englisch

Indonesisch

id_ID

Englisch

Polnisch

pl_PL

Englisch

Hindi

hi_IN

Englisch

Dänisch

da_DK

Englisch

Türkisch

tr_TR

Englisch

Tagalog

tl_XX

Englisch

Rumänisch

ro_RO

Deutsch

Englisch

en_XX

Arabisch

Englisch

en_XX

Hebräisch

Englisch

en_XX

Spanisch

Englisch

en_XX

Japanisch

Englisch

en_XX

Norwegisch

Englisch

en_XX

Französisch

Englisch

en_XX

Niederländisch

Englisch

en_XX

Schwedisch

Englisch

en_XX