Marketing API

Asset Customization-Regeln

Anhand dieser Lösung kannst du bestimmen, welche Werbe-Assets deine Anzeigen enthalten sollen. Beim Erstellen einer Werbeanzeige kannst du basierend auf deinen personalisierten Asset-Regeln die Assets auswählen, die du anzeigen möchtest. Beispiele für Werbeelemente sind Bilder, Videos, Text und Inhalt einer Werbeanzeige.

Wir bieten dir drei APIs, die Asset Customization-Regeln verwenden:

Alle Werbeanzeigen mit asset_feed_spec müssen mindestens zwei Zielgruppen-Anpassungsregeln beinhalten. Wenn deine Werbeanzeige asset_feed_spec verwendet und nicht mindestens zwei Regeln beinhaltet, kannst du diese Anzeige nicht erstellen.

Erste Schritte

Schritt 1: Erstelle eine Anzeigenkampagne und eine Anzeigengruppe.

Du kannst eine standardmäßige Anzeigenkampagne für Asset Customization-Regeln erstellen, wobei es jedoch Einschränkungen gibt:

API Unterstützte Kampagnenziele

Segment Asset Customization

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Asset Customization für Platzierung

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LEAD_GENERATION, LINK_CLICKS, REACH, VIDEO_VIEWS.

Multi-Language Ads

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Verwende für die Anzeigengruppe den standardmäßigen Anzeigengruppen-Endpunkt und lege is_dynamic_creative auf false fest.

So erstellst du eine Anzeigengruppe in einer Kampagne, indem du optimization_goal auf conversions festlegst:

curl \
  -F 'status=PAUSED'
  -F 'name=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2019-04-02'
  -F 'end_time=2019-04-09'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Wenn du asset_feed_spec mit einer Anzeigengruppe verwendest, die für APP_INSTALLS optimiert ist, musst du die link_url angeben, wie z. B. http://www.abc.com. Die link_urlmuss mit der object_store_url in promoted_object übereinstimmen. Du solltest nur einen link_url-Parameter in asset_feed_spec angeben.

asset_feed_spec stellt die Anzeigengestaltung für Dynamic Creative, Asset Customization für Platzierung, Multi-Language Ads und Segment Asset Customization bereit. Das Format der Spezifikation unterscheidet sich je nach Lösung.

Schritt 2: Stelle die Anzeigengestaltung bereit.

Stelle deine Anzeigengestaltung über asset_feed_spec bereit. Bei einem Element-Feed handelt es sich um eine Sammlung verschiedener Anzeigenelemente, z. B. Bilder, Titel, Haupttexte usw. Du kannst für jeden Asset-Typ mehrere Creative Assets angeben.

Erstelle eine asset_feed_spec unter /adcreative. Um Anpassungsoptionen anzuwenden, lege asset_customization_rules in der asset_feed_spec fest.

Überprüfe die asset_feed_spec nach dem Setup:

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/<API_VERSION>/<AD_CREATIVE_ID>

Wenn du deine Werbeanzeige erstellst, stelle einen Verweis auf die Werbeanzeigen-ID bereit. Du kannst mehrere Anzeigen für eine Anzeigengruppe erstellen.

curl 
  -F 'name=Asset Custom Rule Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Nach der Erstellung: