Custom Audiences für Interaktionen

Erstelle Zielgruppen auf Basis der Personen, die mit deinem Inhalt auf Facebook oder Instagram interagiert haben. Derzeit werden die Zielgruppentypen „Seite“, „Instagram-Business-Profil“, „Lead Ad“, „Instant Experience Ad“, „Shopping“ und „Augmented Reality" unterstützt.

In diesem Leitfaden wird die API am Beispiel von Zielgruppen für Seiten-Interaktionen beschrieben. Facebook aktualisiert deine Custom Audience für Seiten-Interaktionen dadurch, dass kontinuierlich Personen, die mit deiner Seite interagieren, hinzugefügt werden. Wenn du diese Zielgruppe erstellst, wird sie von Facebook automatisch mit einer Liste von Personen ausgefüllt, die innerhalb des angegebenen Kund*innen-Bindungszeitraums bereits mit deiner Seite interagiert haben.

Seit September 2018 unterstützen wir subtype für Custom Audiences für Websites, Apps, Engagement Custom Audiences und Zielgruppen aus Offline-Conversion-Daten. Die Ausnahme besteht darin, dass subtype für Custom Audiences für Interaktionen für Video unterstützt wird.
Wenn du Zielgruppen aus Europa erstellst oder Personen in Europa ansprichst, sieh dir unsere nicht versionierte Änderung vom 2. Dezember 2020 an.

Zielgruppe erstellen

Um eine Custom Audience für Interaktionen zu erstellen, muss dein Werbekonto die Nutzungsbedingungen für Custom Audiences im Werbeanzeigenmanager akzeptieren.

So erstellst du eine Zielgruppe mit Personen, die gemäß dem Event page_engaged mit deiner Seite interagiert haben:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Parameter

Name	Beschreibung
`name` String	Erforderlich. Name der Custom Audience.
`rule` JSON-Objekt	Erforderlich. Regeln zum Definieren der Zielgruppe. Hierbei gilt die gleiche Syntax wie für Webseiten-Custom Audiences.

Custom Audiences für Interaktionen sind eine bestimmte Form von Custom Audiences. Alle verfügbaren Felder findest du in der Referenz zu Custom Audience.

Hinweis: Für jedes Werbekonto können maximal 500 Custom Audiences für Interaktionen erstellt werden.

Interaktionsregeln

Du kannst festlegen, ob Facebook eine Person zur Custom Audience hinzufügt. Hierzu verwendest du Zielgruppenregeln.

Gib die Felder type und id in den event_sources der Regel an, um den type und die id des Interaktionsobjekts anzugeben. Im Feld id kann eine einzelne Objekt-ID oder ein Array von IDs desselben Typs angegeben werden.

Dies ist eine Liste der unterstützten Event-Quellen und entsprechenden Interaktionsobjekt-IDs:

page: ID der Facebook-Seite
lead: ID des Lead-Formulars
ig_lead_generation: ID des Lead-Formulars
canvas: Canvas-ID
ig_business: ID des Instagram Business-Profils
shopping_page: ID der Facebook-Shop-Seite
shopping_ig: ID deines Instagram-Shops
ar_experience: eine Instant Experience, die einen AR-Effekt verwendet
ar_effects: ein eigener Facebook- oder Instagram-Effekt. Dazu gehören keine Effekte, die in Werbeanzeigen verwendet werden.

Jede Regel besteht aus einer object_id und einem event_name.

Seiten

Lege object_id auf deine Seiten-ID fest. Verwende unter event_name eines der folgenden Interaktions-Events:

page_engaged: Personen, die deine Seite besucht oder mit Inhalten bzw. Anzeigen auf deiner Seite auf Facebook oder im Messenger interagiert haben. Dies ist der umfassendste Interaktionstyp, der alle anderen Arten von Interaktionen umfasst.
page_visited: Personen, die deine Seite besucht haben.
page_liked: Personen, denen deine Seite momentan gefällt. (Siehe Details zu Kund*innenbindung und Regeln im Zusammenhang mit „Gefällt mir“-Angaben für die Seite)
page_messaged: Personen, die eine Nachricht an deine Seite gesendet haben.
page_cta_clicked: Personen, die auf eine Call to Action-Schaltfläche auf deiner Seite geklickt haben; Beispiele hierfür sind „Kontakt“ oder „Jetzt einkaufen“.
page_or_post_save: Personen, die deine Seite oder einen deiner Seitenbeiträge gespeichert haben.
page_post_interaction: Personen, die mit einem deiner Seitenbeiträge interagiert haben. Zu den Interaktionen zählen Reaktionen (z. B „Gefällt mir“, „Love“, „Haha“, „Wow“, „Traurig“, „Wütend“), das Teilen von Inhalten, Kommentare, Link-Klicks oder Wischbewegungen in Carousel.

Lead Ads

Setze object_id auf FORM_ID und lege die rule so fest, dass eines der folgenden Lead Ad Events erfasst wird:

lead_generation_submitted: Alle Nutzer*innen, die das Formular ausgefüllt und eingereicht haben.
lead_generation_dropoff: Alle Personen, die das Formular geschlossen haben, ohne es einzureichen. Sie haben möglicherweise einige Felder ausgefüllt.
lead_generation_opened: Alle Personen, die das Formular zur Leadgenerierung geöffnet haben, egal ob sie es eingereicht haben oder nicht.

Instant Experiences

Lege object_id auf "CANVAS_ID" fest. Die rule sollte eines der folgenden Events erfassen:

instant_shopping_document_open
instant_shopping_document_pause
instant_shopping_document_resume
instant_shopping_document_close
instant_shopping_did_scroll
instant_shopping_element_click
instant_shopping_element_impression

Instagram Business-Profil

Die object_id sollte der "INSTAGRAM_BUSINESS_PROFILE_ID" entsprechen, und die rule sollte eines der folgenden Instagram Business-Profil-Events erfassen:

ig_business_profile_all: Personen, die dein Instagram-Business-Profil besucht oder mit Inhalten bzw. Anzeigen in deinem Instagram-Business-Profil interagiert haben. Dies ist der umfassendste Interaktionstyp, der alle anderen Arten von Interaktionen umfasst. Er ist eine Kombination aus ig_business_profile_engaged, ig_user_messaged_business und ig_user_messaged_business.
ig_business_profile_engaged: Personen, die mit deinem Instagram-Business-Profil oder mit Inhalten bzw. Anzeigen in deinem Instagram-Business-Profil interagiert haben.
ig_user_messaged_business: Personen, die eine Nachricht an dein Instagram-Business-Profil gesendet haben.
ig_business_profile_visit: Personen, die dein Instagram-Business-Profil besucht haben.
ig_business_profile_ad_saved: Personen, die organische Inhalte oder Anzeigen aus deinem Instagram-Business-Profil gespeichert haben.
ig_ad_like
ig_ad_comment
ig_ad_share
ig_ad_save
ig_ad_cta_click
ig_ad_carousel_swipe
ig_organic_like
ig_organic_comment
ig_organic_share
ig_organic_save
ig_organic_swipe
ig_organic_carousel_swipe

Der Typ „Instagram Media Creator“ wird derzeit für die Erstellung von Custom Audiences für Video-Interaktionen nicht unterstützt.

Shopping

Eine Regel für Shopping-Interaktionen sollte eines der folgenden Events erfassen:

VIEW_CONTENT: Personen, die sich die Detailseite deines Produkts angesehen haben. Diese Option ist weltweit verfügbar.
ADD_TO_CART: Personen, die dein Produkt in ihren Einkaufswagen gelegt haben. Diese Option ist nur für Unternehmen mit Kauffunktion und nur für Verbraucher in den USA verfügbar.
PURCHASE: Personen, die deine Produkte gekauft haben. Diese Option ist nur für Unternehmen mit Kauffunktion und nur für Verbraucher in den USA verfügbar.

So erstellst du eine Regel zum Hinzufügen von Personen, die sich dein Produkt angesehen haben:

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Die Parameter page_messaged und ig_user_messaged_business sind in Europa aufgrund neuer Datenschutzbestimmungen möglicherweise nicht verfügbar.

Augmented Reality

AR-Custom Audiences für Interaktionen können zwei Teile enthalten: ein AR-Erlebnis und einen AR-Effekt.

Lege für eine Custom Audience für Interaktionen mit AR-Erlebnis die object_id auf die Datencontainer-ID für AR-Werbeanzeigen fest verwende für das Feld event_name entweder ar_camera_open oder camera_cta_click.
Lege für eine Custom Audience für Interaktionen mit AR-Effekt die object_id auf die AR-Effekt-ID fest und verwende ar_effect_open für das Feld event_name.

Max. Kund*innenbindungstage

Aufgrund gesetzlicher Bestimmungen und aus Datenschutzgründen lassen wir für die verschiedenen Event-Quelltypen eine unterschiedliche maximale Kund*innenbindung in Tagen zu:

Werbeanzeigen zur Leadgenerierung: 90 Tage
Instagram Business-Profil: 730 Tage
Seite: 730 Tage
- Hinweis: Die Zielgruppe für „Gefällt mir“-Angaben für die Seite besitzt keine Kund*innenbindung.
Instant Experiences (früher als Canvas bezeichnet): 730 Tage
Shopping: 365 Tage. Die Daten sind seit April 2020 verfügbar.
Augmented Reality: 365 Tage

Interaktionsregeln mit Ausschlussabschnitt

Zielgruppenregeln für Interaktion sind mit Regeln für Webseiten-Custom Audiences kompatibel. Daher können sie mehrere Ein- und Ausschlussregeln haben. Nutzer, die mindestens einer dieser Regeln entsprechen, werden in die Zielgruppe aufgenommen.

Im folgenden Beispiel wird eine Zielgruppe erstellt, die Nutzer einschließt, die deine Seite besucht oder mit deiner Seite interagiert haben, aber Personen ausschließt, die auf den Call to Action geklickt haben:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Weitere Informationen findest du unter Custom Audiences über deine Webseite.

Mehrere Regeln

Interaktions-Zielgruppen können mehrere Regeln aufweisen. Nutzer, die mindestens eine dieser Regeln erfüllen, werden in die Zielgruppe aufgenommen. Beispiel für die Erstellung einer Zielgruppe, die Nutzer einschließt, die eine Nachricht an deine Seite gesendet oder auf den Call to Action geklickt haben:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Mehrere Seiten

Regeln sind nicht auf eine einzelne Seite beschränkt. Du kannst für jede Regel eine eigene Seite festlegen. Personen, die mit mindestens einer der Seiten interagiert haben, werden in die Zielgruppe aufgenommen.

Es folgt ein Beispiel für eine Zielgruppe mit allen Personen, die mindestens eine von drei Seiten besucht haben:

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Details zu Custom Audiences findest du in der Referenz zu Custom Audience.

Kund*innenbindung und Regeln für „Gefällt mir“-Angaben für die Seite

Die Zielgruppe für „Gefällt mir“-Angaben für die Seite besitzt keine Kund*innenbindung (retention_seconds=0). Außerdem können Regeln für „Gefällt mir“-Angaben für die Seite nicht mit anderen Seiten-Events kombiniert werden.

Es folgt ein Beispiel für das Erstellen einer Zielgruppe für „Gefällt mir“-Angaben für die Seite:

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences