Dieses Dokument wurde aktualisiert.
Die Übersetzung ins Deutsche ist noch nicht fertig.
Englisch aktualisiert: 14.09.2023

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 Nutzer*innen erstellten Meldungen oder der Nutzer*inneninteraktionen 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 Nutzer*innen erstellten Meldungen oder der Nutzer*inneninteraktionen 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 Nutzer*innen erstellten Meldungen oder der Nutzer*inneninteraktionen 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 Nutzer*innen erstellten Meldungen oder der Nutzer*inneninteraktionen 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 Nutzer*innen erstellten Meldungen oder der Nutzer*inneninteraktionen 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 Nutzer*innen 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 Nutzer*innen 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 Nutzer*innen 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 Nutzer*innen 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="[
  {'action.type':'offsite_conversion','fb_pixel':1},
  {'action.type':'offsite_conversion','fb_pixel':2},
  {'action.type':'offsite_conversion','fb_pixel':3}
]"

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.