Tracking- und Conversion-Spezifikationen

Mit Tracking-Spezifikationen protokollierst du Handlungen, die mit deinen Werbeanzeigen ausgeführt werden. Dieses Feature optimiert nicht die Auslieferung von Werbeanzeigen für eine Handlung und belastet dein Werbekonto nicht für diese Handlung.

In Marketing API v2.3 und früheren Versionen sind Conversion-SpezifikationenAnzeigen-Einstellungen für optimierte CPM. Sie optimieren die Anzeigenauslieferung für bestimmte Handlungen und zeigen diese Handlungen in Conversion-Berichten an. Ab v2.4 ist conversion_specs schreibgeschützt. Verwende das optimization_goal der Anzeigengruppe, um die Optimierung der Anzeigenauslieferung auszuwählen.

Tracking-Spezifikationen festlegen

Du kannst sie mit jeder Gebotsart und jeder Anzeigengestaltung verwenden. Zur Angabe von Tracking-Spezifikationen benötigst du ein zusätzliches Feld in einer Anzeige namens tracking_specs. Das Feld tracking_specs akzeptiert dieselben Argumente wie die Handlungsspezifikation. Informationen zum Erstellen einer Werbeanzeige findest du unter Anzeigenerstellung.

Standard-Tracking-Spezifikationen

Für die folgenden Werbeziele gelten die Standard-Tracking-Spezifikationen. Wenn du zur Standard-Spezifikation wechselst, wird diese an die vorhandene Spezifikation angehängt und überschreibt diese nicht.

Wenn dein Ziel NONE oder App Install/Engagement Ads lautet, werden die Standard-Tracking-Spezifikationen überschrieben. Wenn du die Standardeinstellungen verwenden möchtest, musst du diese zu deinen benutzerdefinierten Spezifikationen hinzufügen.

Du kannst sowohl Strings als auch Arrays in der Spezifikation nutzen, wie 'APPLICATION_ID' oder ['APPLICATION_ID'].

CPM bezieht sich auf billing_event=IMPRESSIONS, optimization_goal=IMPRESSIONS.
CPC bezieht sich auf billing_event=CLICKS, optimization_goal=CLICKS.
oCPM bezieht sich auf billing_event=IMPRESSIONS, optimization_goal mit Einstellung auf eine Handlung.
CPA bezieht sich sowohl auf billing_event als auch auf optimization_goal mit Einstellung auf eine Handlung.

Ziel	Anzeigengestaltung, Gebotsart	Tracking-Spezifikation	Beschreibung
CANVAS_APP_ ENGAGEMENT	Canvas App Engagement Ads mit `optimization_goal= APP_INSTALLS`	[{'action.type': 'app_engagement', 'application': 'APPLICATION_ID'}, {'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}]	Mehr dazu erfährst du in den Meta-Spezifikationen für „app_engagement“ und „post_engagement“.
CANVAS_APP_ INSTALLS	Canvas App Install Ads, bei denen die Optimierung nicht auf `optimization_goal= APP_INSTALLS` gesetzt ist	[{'action.type': 'app_engagement', 'application': 'APPLICATION_ID'}, {'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}]	Mehr dazu erfährst du in den Meta-Spezifikationen für „app_engagement“ und „post_engagement“.
CONVERSIONS	Page Post Link- und Photo Ads, bei denen `promoted_object` auf eine Pixel-ID gesetzt und `optimization_goal= OFFSITE_CONVERSIONS` festgelegt ist	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}, {'action.type':'like', 'page':PAGE_ID}	Spezifikationen für Beitragsinteraktionen, „Gefällt mir“-Angaben auf der Seite. Anzahl der Link-Klicks auf den jeweiligen Seitenbeitrag, wenn es nur einen Link gibt, Anzahl der Interaktionen mit dem Beitrag und Anzahl der von Nutzerinnen erstellten Meldungen oder der Nutzerinneninteraktionen mit einer Seite
CONVERSIONS	Page Post Link- und Photo Ads, bei denen die Optimierung nicht auf `optimization_goal= OFFSITE_CONVERSIONS` gesetzt ist	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}, {'action.type':'like', 'page':PAGE_ID}	Spezifikationen für Conversions, Beitragsinteraktionen, „Gefällt mir“-Angaben auf der Seite. Anzahl der Link-Klicks auf den jeweiligen Seitenbeitrag, wenn es nur einen Link gibt, Anzahl der Interaktionen mit dem Beitrag und Anzahl der von Nutzerinnen erstellten Meldungen oder der Nutzerinneninteraktionen mit einer Seite
CONVERSIONS	Domain Ads, bei denen `promoted_object` auf eine Pixel-ID gesetzt und `optimization_goal= OFFSITE_CONVERSIONS` festgelegt ist	{'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Spezifikationen für „Gefällt mir“-Angaben auf der Seite, Link-Klicks. Anzahl der Link-Klicks auf den jeweiligen Seitenbeitrag, wenn es nur einen Link gibt, Anzahl der Interaktionen mit dem Beitrag und Anzahl der von Nutzerinnen erstellten Meldungen oder der Nutzerinneninteraktionen mit einer Seite
CONVERSIONS	Domain Ads, bei denen die Optimierung nicht auf `optimization_goal= OFFSITE_CONVERSIONS` gesetzt ist	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Spezifikationen für Conversions, „Gefällt mir“-Angaben auf der Seite, Link-Klicks. Anzahl der Link-Klicks auf den jeweiligen Seitenbeitrag, wenn es nur einen Link gibt, Anzahl der Interaktionen mit dem Beitrag und Anzahl der von Nutzerinnen erstellten Meldungen oder der Nutzerinneninteraktionen mit einer Seite
EVENT_RESPONSES	Event Ads, bei denen die Optimierung nicht auf `optimization_goal= EVENT_RESPONSES` gesetzt ist	[{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}, {'action.type':'rsvp' , 'response':'maybe', 'event':'EVENT_ID'}, [{'action.type':'rsvp' , 'response':'no', 'event':'EVENT_ID'}]	Anzahl der Zu-/Absagen (Ja, Vielleicht, Nein) auf eine Veranstaltung.
EVENT_RESPONSES	Event Ads mit `optimization_goal= EVENT_RESPONSES`	leer (Conversion-Spezifikation deckt die verfolgten Handlungen ab)	Anzahl der Zu-/Absagen (Ja, Vielleicht, Nein) auf eine Veranstaltung.
LINK_CLICKS	Page Post Link- und Photo Ads mit jeder Gebotsoption	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}	Beitragsinteraktionen. Gibt an, wie oft auf einen externen URL-Link, einen Link mit einer bestimmten URL-Domain, einen externen Link auf einer Seite und einen externen Link in einem Beitrag geklickt wurde.
LINK_CLICKS	Domain Ads mit `optimization_goal= LINK_CLICKS`	{'action.type':'like', 'page':PAGE_ID}]	„Gefällt mir“-Angaben auf der Seite. Gibt an, wie oft auf einen externen URL-Link, einen Link mit einer bestimmten URL-Domain, einen externen Link auf einer Seite und einen externen Link in einem Beitrag geklickt wurde.
LINK_CLICKS	Domain Ads, bei denen die Optimierung nicht auf `optimization_goal= LINK_CLICKS` gesetzt ist	{'action.type': 'link_click', 'object':'URL'}, {'action.type':'like', 'page':PAGE_ID}	Website-Klicks, „Gefällt mir“-Angaben auf der Seite. Gibt an, wie oft auf einen externen URL-Link, einen Link mit einer bestimmten URL-Domain, einen externen Link auf einer Seite und einen externen Link in einem Beitrag geklickt wurde.
MOBILE_APP_ ENGAGEMENT	Mobile App Engagement Ads mit jeder Gebotsoption	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'} Für App Engagement Ads musst du explizit eine Tracking-Spezifikation mit der Facebook-App-ID angeben: [{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type': 'app_custom_event', 'application':APP_ID}]	Mehr dazu erfährst du in den Meta-Spezifikationen für „post_engagement“. Gibt außerdem an, wie oft ein App Event stattfindet.
MOBILE_APP_ INSTALLS	Mobile App Install Ads mit jeder Gebotsoption	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'} Für App Install Ads musst du explizit eine Tracking-Spezifikation mit der Facebook-App-ID angeben: [{'action.type': 'app_custom_event', 'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]	Mehr dazu erfährst du in den Meta-Spezifikationen für „post_engagement“. Gibt außerdem an, wie oft Nutzer*innen die App über eine Mobile App Install Ad installieren, wenn es eine iOS-/Android-Version gibt, und wie oft ein App Event stattfindet.
NONE	Jede Anzeigenart	Mehr dazu erfährst du in den Standard-Tracking-Spezifikationen nach Anzeigenart.
PAGE_LIKES	Page Like Ads oder Page Post Ads mit jeder Gebotsoption	{'action.type': 'page_engagement', 'page':'PAGE_ID'}	Mehr dazu erfährst du in den Meta-Spezifikationen für Seiteninteraktion.
POST_ENGAGEMENT	Page Post Ads, bei denen die Optimierung nicht auf `optimization_goal= POST_ENGAGEMENT` gesetzt ist	{'action.type': 'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}	Mehr dazu erfährst du in den Meta-Spezifikationen für Interaktion mit Seitenbeiträgen.
POST_ENGAGEMENT	Page Post Ads mit `optimization_goal= POST_ENGAGEMENT`	leer	Mehr dazu erfährst du in den Meta-Spezifikationen für Interaktion mit Seitenbeiträgen.
POST_ENGAGEMENT (Testphase)	beliebige	{'action.type': 'dwell', 'post':'POST_ID', 'page':'PAGE_ID'}	Ein kleiner Anteil dieser Art von Werbeanzeigen hat den Tracking-Typ `dwell` und konzentriert sich auf Nutzer*innen, die mindestens eine Minute mit den Werbeanzeigen verbringen.
PRODUCT_ CATALOG_SALES	Dynamic Product Ads	{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}	Anzahl der Link-Klicks auf den jeweiligen Seitenbeitrag, wenn es nur einen Link gibt, Anzahl der Interaktionen mit dem Beitrag, Anzahl der von Nutzerinnen erstellten Meldungen oder der Nutzerinneninteraktionen mit einer Seite. Du kannst eine andere Produktpalette als diejenige im hervorgehobenen Objekt angeben. Der Standard ist jedoch immer die angegebene Produktpalette im hervorgehobenen Objekt.

Meta-Spezifikationen

Du kannst mit nur einer Spezifikation mehrere Arten von Handlungen für ein einzelnes Objekt angeben.

Objekt	Conversion-Spezifikation	Beschreibung
App	{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}	Gibt an, wie oft Nutzer*innen Meldungen mit `app_story` erstellen oder über „app_use“, „app_install“ oder „credit_spent“ mit Inhalt interagieren.
Seite	{"action.type":["page_engagement"], "page":["PAGE_ID"]}	Gibt an, wie oft Nutzerinnen eine der folgenden Handlungen im Kontext der angegebenen Seite ausführen: Ort hinzufügen, kommentieren, abonnieren, mit „Gefällt mir” markieren, Beitrag auf Seite mit „Gefällt mir” markieren, erwähnen, Beitrag auf Seite posten, einen Beitrag teilen, eine Frage beantworten. Gibt außerdem an, wie oft Nutzerinnen eine der folgenden Handlungen im Kontext der angegebenen Seite ausführen: auf einen Link klicken, ein Foto ansehen, ein natives FB-Video abspielen.
Seitenbeitrag	{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}	Gibt an, wie oft Nutzerinnen eine der folgenden Handlungen im Kontext des angegebenen Beitrags ausführen: kommentieren, Frage abonnieren, mit „Gefällt mir” markieren, teilen, Frage beantworten. Gibt außerdem an, wie oft Nutzerinnen eine der folgenden Handlungen ausführen: auf einen Link klicken, Seite mit „Gefällt mir” markieren, Foto ansehen, auf Facebook gehostetes Video oder YouTube-Inline-Video abspielen. Verwende für nicht eingebettete Videos „link_click“.

Benutzerdefinierte Tracking-Spezifikationen

Verwende das Handlungsspezifikations-Framework, um deine eigenen Tracking-Spezifikationen zu definieren. Mehr dazu erfährst du unter Handlungsspezifikationen, Referenz.

Handlung (Objektarten)	Beschreibung, Tracking-Spezifikationsdetails	Tracking- und Conversion-Spezifikation
app_custom_event (App)	Custom Event für eine App. Anzahl der Custom Events für eine mobile App.	{'action.type': 'app_custom_event', 'application':APP_ID}
app_install (App)	Installation einer App. Anzahl der Installationen für Canvas oder mobile App	[{'action.type':'app_install', 'application':APP_ID}, {'action.type': 'mobile_app_install', 'application':APP_ID}]
app_use (App)	Gibt an, wie oft die App verwendet wurde.	{'action.type':'app_use', 'application':APP_ID}
checkin (Ort)	Einen Ort hinzufügen. Anzahl der „Ich bin hier“-Angaben für den Ort oder untergeordnete Orte dieser Seite.	{'action.type':'checkin', 'page': PAGE_ID}, {'action.type':'checkin', 'page.parent:PAGE_ID}
comment (Beitrag)	Einen Beitrag kommentieren. Anzahl der Kommentare zu allen oder einem bestimmten Seitenbeitrag.	{'action.type':'comment', 'post.wall':PAGE_ID}, {'action.type':'comment', 'post':POST_ID, 'post.wall':PAGE_ID}
credit_spend (App)	Instanzen von verwendetem Guthaben in einer App.	'action.type':'credit_spent', 'application':APP_ID}
follow (Frage)	Ein Objekt abonnieren. Anzahl der Antworten oder Abonnements einer Frage.	{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}
leadgen_quality_conversion (Pixel)	Abwärts-Funnel-Lead-Conversion-Events (CRM)	{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}
like (Seite, Beitrag)	Objekt mit „Gefällt mir“ markieren. Anzahl der „Gefällt mir“-Angaben für eine Seite oder einen Beitrag.	{'action.type':'like', 'page':PAGE_ID}, {'action.type':'like', 'post.wall':PAGE_ID}, {'action.type':'like', 'post':POST_ID, 'post.wall':PAGE_ID}
link_click (Seite, Beitrag, URL, URL-Domain)	Auf einen Link klicken. Gibt an, wie oft auf einen externen URL-Link, einen Link mit einer bestimmten URL-Domain, einen externen Link auf einer Seite und einen externen Link in einem Beitrag geklickt wurde.	{'action.type':['link_click'], 'object':['URL']}, {'action.type':['link_click'], 'object.domain': ['URL_DOMAIN']}, {'action.type':['link_click'], 'post.wall':['PAGE_ID']}, {'action.type':['link_click'], 'post':['POST_ID'], 'post.wall':['PAGE_ID']}
mention (Seite)	Seite erwähnen. Anzahl der Erwähnungen einer Seite.	{'action.type':'mention', 'object':PAGE_ID'}
offsite_conversion (Pixel)	Anzahl der Offsite Conversions und erzielter Umsatz.	{'action.type': 'offsite_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}
photo_view (Seite)	Foto ansehen. Anzahl der Fotoaufrufe, „video_plays“ oder „link_clicks“ der Fotos/Videos/link-shares für alle oder bestimmte Beiträge auf einer Seite.	{'action.type':'photo_view', 'post.wall':PAGE_ID} {'action.type':'photo_view', 'post':POST_ID, 'post.wall':PAGE_ID}
post (Beitrag)	Meldung teilen. Anzahl der Nutzer*innenbeiträge auf einer Seite.	{'action.type':'post', 'post.wall':PAGE_ID}
receive_offer (Angebot)	Angebot beanspruchen. Anzahl der Personen, die ein bestimmtes Angebot beansprucht haben.	{'action.type':'receive_offer', 'offer':OFFER_ID}
rsvp (Veranstaltung)	Veranstaltungszu-/-absagen. Anzahl der Zu-/Absagen (Ja und Vielleicht) auf eine Veranstaltung. Gültige Werte sind `yes`, `maybe` und `no`.	{'action.type':'rsvp', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'yes', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'no', 'event': EVENT_ID}, {'action.type':'rsvp', 'response':'maybe', 'event': EVENT_ID}
tab_view (Seite)	Seiten-Tab ansehen. Anzahl der Aufrufe eines bestimmten Seiten-Tabs. Wenn du alle Tab-Aufrufe sehen möchtest, gib einfach die Seite an.	{'action.type':'tab_view', 'page.tab.name': 'PAGE_TAB_NAME', 'page':PAGE_ID}, {'action.type':'tab_view', 'page':PAGE_ID}
video_play (Beitrag)	Ein Video ansehen. Anzahl der Videowiedergaben für alle oder einen bestimmten Videobeitrag auf einer Seite.	{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID, 'post.wall':PAGE_ID}

Beispiele

Pixel Tracking

Verfolge die Performance verschiedener Pixel in einer Werbeanzeige, indem du das Tracking Pixel im Feld tracking_specs der Anzeige angibst Beispiel: Beispiel:

tracking_specs="[
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:1&#125;,
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:2&#125;,
  &#123;&#039;action.type&#039;:&#039;offsite_conversion&#039;,&#039;fb_pixel&#039;:3&#125;
]"

So verfolgst du die Performance der Pixel „1“, „2“ und „3“. Wenn du nur für Pixel „1“ optimieren möchtest, definiere das promoted_object der übergeordneten Anzeigengruppe. Das ist bei der Optimierung für CHECKOUT nützlich, wenn du auch REGISTRATION und ADD_TO_CART verfolgen möchtest.

Pixel, die durch Angabe der Pixel-ID im promoted_object optimiert werden, werden automatisch verfolgt. Du musst also nicht dasselbe Pixel in tracking_specs angeben.

Conversion-Spezifikationen verwenden

conversion_specs ist ein Feld für eine Werbeanzeige. Es entspricht dem Format {'action.type':'{ACTION}', ... }, wobei jede Handlung für ein Objekt gilt. Hier siehst du Beispiele für Conversion-Spezifikationen für verschiedene Anzeigenarten:

Anzeigenart	Conversion-Spezifikation
Domain Ad mit sozialem Kontext	{'action.type':'link_click', 'object':'URL'}
Page Like Ad	{'action.type':'like', 'page':PAGE_ID}
Page Post Link Ad	{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}
Alle anderen Page Post Ads	{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}
Event Ad	{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}
Offer Ad	{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}
Mobile App Install Ad	Nicht zutreffend. Diese Werbeanzeige kann nicht mit dem Ziel NONE erstellt werden.
Mobile App Engagement Ads	Nicht zutreffend. Nur die Gebotsarten CPC und CPM werden unterstützt.
Canvas App Install Ad	Nicht zutreffend. Diese Werbeanzeige kann nicht mit dem Ziel NONE erstellt werden.
Canvas App Engagement Ad	Nicht zutreffend. Diese Werbeanzeige kann nicht mit dem Ziel NONE erstellt werden.

Einige Conversion-Spezifikationen enthalten mehrere Handlungen, die für ein einzelnes Objekt gelten. Diese werden als Meta-Spezifikationen bezeichnet. Unten findest du Beispiele dafür:

Objekt	Conversion-Spezifikation	Beschreibung
Seite	{"action.type":["page_engagement"], "page":["PAGE_ID"]}	Gibt an, wie oft jemand die folgenden Handlungen auf einer bestimmten Seite ausführt: Ort hinzufügen, kommentieren, abonnieren, mit „Gefällt mir” markieren, Seitenbeitrag mit „Gefällt mir” markieren, erwähnen, Beitrag auf Seite posten, Beitrag teilen, Frage beantworten. Gibt außerdem an, wie oft jemand die folgenden Handlungen auf einer bestimmten Seite ausführt: Foto ansehen, natives Facebook-Video abspielen.
Seitenbeitrag	{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}	Gibt an, wie oft jemand eine der folgenden Handlungen mit einem bestimmten Beitrag ausführt: kommentieren, Frage abonnieren, mit „Gefällt mir” markieren, teilen, Angebot beanspruchen, Frage beantworten. Gibt außerdem an, wie oft jemand die folgenden Handlungen ausführt: auf Link klicken, Seite mit „Gefällt mir” markieren, Foto ansehen, auf Facebook gehostetes Video oder YouTube-Inline-Video abspielen. Verwende für nicht eingebettete Videos `link_click`.
App	{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}	Gibt an, wie oft jemand eine `app_story` erstellt oder über `app_use`, `app_install` oder `credit_spent` mit Inhalt interagiert hat.