Segment Asset Customization

Mit dieser Lösung kannst du Werbeanzeigen-Assets entsprechend geografischen Targeting-Typen anpassen. Informationen zum Anpassen von verschiedenen Platzierungen findest du unter Placement Asset Customization.

Die Segment Asset Customization ist eine von drei APIs, die Asset Customization-Regeln verwenden. Siehe Asset Customization-Regeln.

Mit der Einführung der Marketing API V8.0 sind alle Anwendungsfälle, die nicht mit Geolocation zusammenhängen, für Segment Asset Customization veraltet. Alle Targeting-Regeln müssen jetzt Geolocation-Informationen in „customization_spec“ enthalten. Eine Ausnahme gilt für die Standardregel, die keine Geolocation umfassen muss.

Erste Schritte

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:

Schritt 2: Anzeigengestaltung bereitstellen

Anpassungsoptionen

Die Werbeanzeige kann mit geografischen Standorten angepasst werden. Hierzu erstellst du eine Regel mit einer „customization_spec“. Der folgende Anpassungstyp wird unterstützt:

  • Geo-locations - Unterstützt countries, regions, cities, geo_markets, zips und location_types.

Das Format zum Festlegen einer „customization_spec“ ist dem Format für Core-Targeting ähnlich, siehe Targeting.

Asset Customization-Regeln

Mit Asset Customization-Regeln kannst du Assets gruppieren, die an einem bestimmten geografischen Standort zusammen angezeigt werden. Jede Regel hat eine customization_spec, mit der die geografischen Standorte der Personen definiert werden, die diese Assets bei Anzeigenauslieferung sehen.

Bei der Erstellung kannst du eine Priorität für die einzelnen Regeln festlegen. Andernfalls geben wir jeder Regel eine Nummer für die Priorität basierend auf ihrer Position in der Liste der bereitgestellten Regeln. So wird beispielsweise der ersten Regel in der Liste die Priorität 1 zugewiesen.

Du solltest eine Standardregel festlegen, um zu verhindern, dass an Personen, die keiner der Regeln entsprechen, eine zufällige Kombination von Assets ausgeliefert wird. So richtest du dies ein:

  • Erstelle eine leere customization_spec. Verwende am Ende der Regel öffnende und schließende geschweifte Klammern, also {}.
  • Weise der Regel die niedrigste Priorität zu. Dies ist die Gesamtzahl der Regeln, einschließlich der Standardregel. Wenn du 10 Regeln und eine Standardregel hast, muss die Priorität der Standardregel „11“ sein.

Die Standardregel weist Personen, die keiner der vorhergehenden Regeln entsprechen, ein Creative Asset zu.

In deinem Setup sollten Regeln, die keine Standardregel sind, einem hohen Prozentsatz deiner Targeting-Zielgruppe entsprechen.

Asset Feed Spec einrichten

Erstelle eine asset_feed_spec und füge die Anpassungsregeln zum Feld asset_customization_rules hinzu. Du kannst bis zu 50 Anpassungsregeln hinzufügen.

Für jede Regel musst du die customization_spec, die priority und die Asset-Label angeben. Die customization_specdarf nicht mehr als 50 Bedingungen für eine einzelne Regel haben.

Beispiel eines Asset-Feed-Setups:

curl \
-F 'object_story_spec={
       "page_id": "<YOUR_PAGE_ID>",
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>"
    }' \
-F 'asset_feed_spec={
 "images": [
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image1"}]}, 
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image2"}]}
 ], 
 "bodies": [
   {"text":"Motor City Mission Corps", "adlabels":[{"name":"body1"}]}
 ], 
 "titles": [
   {"text":"Link title 1 goes here", "adlabels":[{"name":"title1"}]}, 
   {"text":"Link title 2 goes here", "adlabels":[{"name":"title2"}]},
   {"text":"Link title 3 goes here", "adlabels":[{"name":"title3"}]}
 ], 
 "call_to_action_types":[
   "LEARN_MORE"
 ],
 "descriptions": [
   {"text":"Begin Your Adventure"}
 ], 
 "ad_formats": [
   "SINGLE_IMAGE"
 ], 
 "link_urls": [
   {"website_url":"https://www.example.com/"}
 ],
 "asset_customization_rules": [
   { 
     "customization_spec": {
        "geo_locations": {
          "countries": ["US"]
        }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title1"},
     "priority": 1
   },
   {
     "customization_spec": {
       "geo_locations": {
          "countries": ["GB"]
        }
     }, 
     "image_label": {"name": "image1"},
     "title_label": {"name": "title2"},
     "priority": 2
   },
   {
     "customization_spec": {
       "geo_locations": {
         "cities": [
           {"key": "2481714"},
           {"key": "2481868"}
         ]
       }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title3"},
     "priority": 4
   },
   {
     "customization_spec": {}, 
     "image_label": {"name":"image2"},
     "title_label": {"name":"title1"},
     "priority": 5
  }]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Hier findest du alle verfügbaren Optionen für Asset Feed Spec. Die nächsten Schritte findest du unter Asset Customization-Regeln.

Optionaler Schritt 3: Zeige deine Werbeanzeige in der Vorschau an

Mit dem Endpunkt /generatepreview kannst du die verschiedenen Targeting-Regelversionen deiner Werbeanzeige als Vorschau ansehen. Du kannst auch ein dynamic_asset_label-Feld mit der Prioritätsnummer der Regel hinzufügen, um eine bestimmte Sprachversion anzusehen.

So zeigst du zum Beispiel eine Regel mit Priorität 1 an:

curl -G --data-urlencode 
'creative={ 
  "object_story_spec": { 
    "page_id": "<PAGE_ID>" 
  },
  "asset_feed_spec": {
    ...
    "asset_customization_rules": [
      { 
        "customization_spec": { 
          "geo_locations": { 
          "countries": ["US"] 
          } 
        },
        "image_label": {
          "name": "image1"
        },
        "title_label": {
          "name": "title1"
        },
        "priority": 1
    },
    ...
    ]
  }
}' 
-d 'ad_format=DESKTOP_FEED_STANDARD' 
-d 'dynamic_asset_label=1'
-d 'access_token=<ACCESS_TOKEN>' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Einschränkungen

Spezielle Anzeigenkategorie – Werbetreibende, die für die USA targetierte Immobilien-, Stellenanzeigen- und Credit-Ads schalten, sind anderen Einschränkungen unterworfen. Diese Werbetreibenden unterliegen Einschränkungen für spezielle Anzeigenkategorien für asset_feed_spec. Hier erfährst du mehr über die Spezielle Anzeigenkategorie.

Kampagne, ZielvalidierungAPP_ENGAGEMENT wird nicht unterstützt.

Unterstützte Platzierungen – Alle Platzierungen werden unterstützt.

BuchungsartReichweite und Frequenz oder AUCTION.

Platzierungsanpassung – Wenn in einer der Regeln die Platzierungsanpassung verwendet wird, sollten alle Regeln eine Platzierungsanpassung umfassen.

Es gelten die gleichen Einschränkungen für asset_feed_spec wie für Asset-Feed-basierte Anzeigen ohne Anpassungsregeln. Dabei gelten die folgenden Ausnahmen:

  • Jedem Bild oder Video muss ein Label zugeordnet sein.
  • Pro asset_customization_rule darf nur ein Bild oder Video angezeigt werden.
  • Anzeigenformate: Es werden zwei ad_formats unterstützt: SINGLE_IMAGE und SINGLE_VIDEO. Pro Asset-Feed ist nur ein ad_format zulässig.
  • Du kannst in call_to_actions_types nur ein Objekt bereitstellen.
  • Für jede Platzierungseinstellung im Anzeigengruppen-Targeting musst du mindestens eine asset_customization_rule bereitstellen.