Eventcodes ermöglichen dir, die Effektivität deiner Anzeigen auf Pinterest im Hinblick auf bestimmte Aktionen auf deiner Webseite zu messen. Außerdem sind sie für die Lancierung von Kampagnen erforderlich, die automatisch für bestimmte Events optimiert werden, z. B. Conversion-Kampagnen oder Anzeigen für dynamisches Retargeting. Außerdem benötigst du Eventcodes, um
Nach dem
Die folgende Tabelle zeigt die Events, die du mit dem Pinterest Tag nachverfolgen kannst. Du kannst sie verwenden, um
Event | Ziel |
---|---|
Checkout | Verfolge, wer Transaktionen abschließt. |
AddToCart | Verfolge, wer Artikel in den Warenkorb legt. |
Pagevisit | Verfolge, wer sich primäre Seiten wie Produkt- und Artikelseiten ansieht. |
Signup | Verfolge, wer sich für dein Produkt oder deinen Service registriert. |
WatchVideo | Verfolge, wer sich Videos ansieht. |
Lead | Verfolge, wer sich für dein Produkt oder deinen Service interessiert. |
Suche | Verfolge, wer auf deiner Webseite nach bestimmten Produkten oder Läden sucht. |
ViewCategory | Verfolge, wer sich Kategorieseiten ansieht. |
Custom | Verfolge ein benutzerdefiniertes Event. Verwende diesen Event-Namen, um ein bestimmtes Event zu verfolgen, das du in deinen Conversion-Bericht aufnehmen möchtest. |
[User-defined event] | Füge alle weiteren Events hinzu, die du für das Zielgruppen-Targeting definiert hast. Für Conversion-Berichte stehen keine eindeutigen Events zur Verfügung. Denk daran, dass Leerzeichen aus durch das Tag übergebenen Namen benutzerdefinierter Events entfernt werden. |
Es gibt erforderliche und empfohlene Events je nachdem, welche Anzeigenkampagne du schalten möchtest.
Kampagnenziel | Erforderliche Events | Empfohlene Events | Erforderliche Eventdaten | Empfohlene Eventdaten |
---|---|---|---|---|
Brand Awareness | Keine |
|
Keine | Enhanced Match |
Katalogverkäufe |
|
|
|
|
Markenpräferenz | Keine |
|
Keine | Enhanced Match |
Conversions |
Mindestens eines der folgenden: |
|
Keine |
|
Videoaufrufe | Keine | Keine | Keine | Enhanced Match |
Es gibt erforderliche und empfohlene Events, je nachdem, welche Funktionen du verwenden möchtest.
Funktion | Erforderliche Events | Empfohlene Events | Erforderliche Eventdaten | Empfohlene Eventdaten |
---|---|---|---|---|
Conversion-Insights |
|
Keine | currency | Keine |
Verifizierte-Händler-Programm (VMP) |
|
Keine | currency | Keine |
Dynamisches Retargeting |
|
Keine |
|
Keine |
Wenn du die manuelle Einrichtung gewählt hast, musst du die Eventcodes deiner Webseite selbst hinzufügen. Die folgenden Schritte gelten für diejenigen, die die Option zur manuellen Einrichtung verwenden.
Hinweis: Wird ein Event erst ausgelöst, nachdem jemand eine bestimmte Aktion auf der Seite ausgeführt hat, z. B. Klicken auf einen Button oder Absenden eines Formulars, musst du dafür sorgen, dass der Eventcode nur als Ergebnis der Aktion ausgeführt wird. Dazu musst du die vorhandenen Event-Handler im JavaScript-Code deiner Seite verstehen.
Du kannst zusätzliche Informationen zu einem Event bereitstellen, indem du ein Objekt anhängst, das Eventdaten enthält. Alle Eventdaten stehen nur für das Zielgruppen-Targeting zur Verfügung, für Berichte zu Paid und organischen Conversions sind es dagegen nur „value“ und „order_quantity“.
Eventdaten | Beispielwert | Typ |
---|---|---|
value | 100,00 | Zahl (Ganz- oder Gleitkommazahl) |
event_id | eventId0001 |
String (ein ID-String, der das Event eindeutig identifiziert) Hinweis: Diese ID kann unter jedem der folgenden Feldnamen gesendet werden; bei allen wird die Groß- und Kleinschreibung berücksichtigt: |
order_quantity | 1 | Ganzzahl |
order_id | 1234OrderID | String (order_id ist erforderlich für Conversion Analysis Reporting) |
product_name | Parker-Stiefel | Array vom Typ „line_items“, Zeichenfolge |
product_id | 1414 | Array vom Typ „line_items“, Zeichenfolge |
product_category | Schuhe | Array vom Typ „line_items“, Zeichenfolge |
product_variant_id | 1414-Rot | Array vom Typ „line_items“, Zeichenfolge |
product_variant | Rot | Array vom Typ „line_items“, Zeichenfolge |
product_price | 99,99 | Zahl (Ganz- oder Gleitkommazahl), Array vom Typ „line_items“, Zeichenfolge |
product_quantity | 1 | Ganzzahl, Array vom Typ „line_items“, Zeichenfolge |
product_brand | Parker | Array vom Typ „line_items“, Zeichenfolge |
promo_code | WINTER10 | Zeichenfolge |
property | Athleta | Zeichenfolge |
search_query | Stiefel | Zeichenfolge |
video_title | So stylst du deine Parker-Stiefel | Zeichenfolge |
lead_type | Newsletter | Zeichenfolge |
currency | USD |
Eine der folgenden: AED, AMD, ARS, AUD, AZN, BAM, BGN, BHD, BMD, BND, BOB, BRL, BSD, CAD, CHF, CLP, CNY, COP, CRC, CZK, DKK, DOP, EGP, EUR, FJD, GBP, GEL, GIP, HKD, HNL, HRK, HUF, IDR, ILS, INR, ISK, JMD, JPY, KGS, KRW, KWD, KZT, MAD, MDL, MOP, MXN, MYR, NOK, NZD, OMR, PAB, PEN, PHP, PKR, PLN, QAR, RON, RSD, RUB, SAR, SEK, SGD, THB, TRY, TWD, UAH, USD, UYU, VND oder ZAR. Hinweis: Wenn du eine Währung mit dem Tag-Event angibst, berechnen wir den Wechselkurs so, dass er mit der Währung des Werbekundenkontos übereinstimmt. |
Das IMG-Tag ist ein Codeschnipsel innerhalb des Pinterest-Tags und dient als Absicherung, falls Nutzer*innen JavaScript im Browser deaktiviert haben. Wir empfehlen, auch in das IMG-Tag Eventdaten einzubinden, da dies ein besseres Nutzer-Targeting ermöglicht. Du kannst auch nur das IMG-Tag verwenden und das JavaScript-Tag weglassen, aber dann musst du aus dem Code die
Im Folgenden findest du Beispiele für jeden Eventtyp, die du kopieren und direkt auf deiner Webseite einfügen kannst. Achte darauf, die Beispielwerte durch eine
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout&ed[event_id]=YOUR_EVENT_ID&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Eventdaten: „event_id“, „value“, „order_quantity“ und „currency“
Achte darauf, den richtigen Währungscode für deine Webseite einzugeben.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=AddToCart&ed[value]=10.00&ed[order_quantity]=2&noscript=1" />
Eventdaten: „value“, „order_quantity“ und „currency“
Achte darauf, den richtigen
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />
Eventdaten: Keine
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />
Eventdaten: Keine
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=Mein+Produktvideo+01&noscript=1" />
Eventdaten: video_title
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=lead&ed[lead_type]=Newsletter&noscript=1" />
Eventdaten: lead_type
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=Pferd&noscript=1" />
Eventdaten: search_query
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />
Eventdaten: Keine
Der Name des Event-Typs muss „custom“ sein, andernfalls werden die vom Tag nachverfolgten Conversions nicht in Ads Manager angezeigt.
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />
Eventdaten: Keine
„value“ und „order_quantity“ sind zwei Eventdatenpunkte, die in der Berichterstattung für Paid und organische Conversions zur Verfügung stehen. Wenn du Wert und Menge hinzufügen möchtest, kannst du diese Werte dynamisch zurückgeben. Ein dynamischer Wert kann sich abhängig von der Aktion auf deiner Webseite ändern. Wenn du „value“ und „order_quantity“ zurückgeben möchtest, ist dies spezifisch für deine Webseite und die Erfassung deiner Verkäufe. In der Regel unterscheiden sich Wert und Menge der Produkte bei jeder Bestellung auf deiner Webseite.
<script>
pintrk('track', 'checkout', {
value: {{Enhanced Transaction Revenue}},
order_quantity: {{item.quantity}}
});
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=checkout&ed[value]={{Enhanced Transaction Revenue}}&ed[order_quantity]={{item.quantity}}&noscript=1" />
</noscript>
Gemeldeter Wert: Dynamischer Kaufbetrag beim entsprechenden Checkout
Gemeldete Menge: Dynamische Einkaufsmenge beim entsprechenden Checkout
Hinweis: Die Einrichtung der dynamischen Bestellmenge und des Bestellwerts ist für deine Webseite eindeutig.
Neben Eventdaten kannst du eine JavaScript-Rückruffunktion als optionales Argument an die Funktion „pintrk()“ übergeben. Dies generiert zusätzliche Informationen für den Fall, dass mit deinem Tag etwas schiefgeht, das du in deinem Entwickler-Tool überprüfen kannst. Diese Rückruffunktion wird jedes Mal ausgeführt, wenn ein Aufruf der Event-Nachverfolgung, d. h. die Funktion „pintrk()“, ausgelöst wird.
Die Rückruffunktion nimmt die beiden folgenden Argumente auf:
function(didInit, error) {}
didInit: Dieses erste Argument erhält einen booleschen Wert. Dieser ist auf „true“ gesetzt, wenn der Aufruf der Event-Nachverfolgung erfolgreich aufgebaut wurde, und auf „false“, wenn beim Aufruf der Event-Nachverfolgung ein Fehler erkannt wurde.
error: Dieses zweite Argument erhält eine Zeichenfolge, die den Fehler beschreibt, wenn für „didInit“ „false“ zurückgegeben wird. Wenn „true“ für „didInit“ zurückgegeben wird, ist diese Zeichenfolge nicht definiert.
<script>
pintrk('track', 'checkout', {
value: 10.00,
order_quantity: 2,
currency: 'USD',
event_id: 'eventId0001',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_price: 5.00,
product_quantity: 1
},
{
product_name: 'Parker Sandals'
product_id: 'ABC',
product_price: 5.00,
product_quantity: 1
}
]
}, function(didInit, error) { if (!didInit) { console.log(error); }
});
</script>
Für Conversion Tracking und Berichterstellung musst du im Eventcode einen der neun Event-Typen angeben. Außerdem musst du „YOUR_TAG_ID“ durch deine Pinterest-Conversion-Tag-ID ersetzen. Beachte, dass du außer den Daten in den folgenden Beispielen jede beliebige Kombination von Eventdaten pro Event angeben kannst.
Dieser Abschnitt enthält ein Beispiel für jeden Eventtyp in einem vollständigen, kopierbaren Format, das du direkt auf deiner Webseite platzieren kannst. Jedes Beispiel enthält die erforderlichen Eventdaten, um die Nachverfolgung von Aktivitäten auf deiner Webseite zu beginnen. Achte darauf, die Beispielwerte durch den entsprechenden statischen Wert bzw. die entsprechende dynamische Variable für deine Webseite zu ersetzen. Beispielsweise möchtest du wahrscheinlich den Bestellwert dynamisch nachverfolgen, da der Wert jeder Bestellung auf deiner Webseite variiert und davon abhängt, was jemand kauft. Dem Eventtyp „lead_type“ dagegen kannst du einen statischen Wert zuweisen, wenn er nur auf einer bestimmten Seite platziert wird.
<script>
pintrk('track', 'checkout', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Eventdaten: „value“, „order_quantity“, „currency“ und „event_id“.
Achte darauf, den richtigen Währungscode für deine Webseite einzugeben.
<script>
pintrk('track', 'addtocart', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Eventdaten: „value“, „order_quantity“ und „currency“
Achte darauf, den richtigen Währungscode für deine Webseite einzugeben.
<script>
pintrk('track', 'pagevisit', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
<script>
pintrk('track', 'signup', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
<script>
pintrk('track', 'watchvideo', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Eventdaten: „video_title“
<script>
pintrk('track', 'lead', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Eventdaten: lead_type
<script>
pintrk('track', 'search', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Eventdaten: search_query
<script>
pintrk('track', 'viewcategory', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
<script>
pintrk('track', 'user_defined_event_name', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Der Name des Eventtyps muss „custom“ sein, andernfalls werden die vom Tag nachverfolgten Conversions nicht im Ads Manager angezeigt.
<script>
pintrk('track', 'custom', {
event_id: 'eventId0001',
value: 100,
order_quantity: 1,
currency: 'USD',
order_id: 'X-15148',
promo_code: 'WINTER10',
property: 'Athleta',
search_query: 'boots',
video_title: 'How to style your Parker Boots',
lead_type: 'Newsletter',
line_items: [
{
product_name: 'Parker Boots',
product_id: '1414',
product_category: 'Shoes',
product_variant_id: '1414-Red',
product_variant: 'Red',
product_price: 99.99,
product_quantity: 1,
product_brand: 'Parker'
}
]
});
</script>
Hier findest du einige Bespiele für Base Codes in Kombination mit Eventcodes. Achte immer darauf, Eventcodes nach dem Base Code auf deiner Webseite zu platzieren.
Beispiel-Conversion-Tag-ID: 123456789 (durch eigene Pinterest-Conversion-Tag-ID ersetzen)
Beispiel-Eventcode: PageVisit
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
</noscript>
</head>
Beispiel-Conversion-Tag-ID: 123456789 (durch eigene Pinterest-Conversion-Tag-ID ersetzen)
Beispiel-Eventcodes: PageVisit und AddToCart
<head>
<script type="text/javascript">
!function(e){if(!window.pintrk){window.pintrk=function(){window.pintrk.queue.push(
Array.prototype.slice.call(arguments))};var
n=window.pintrk;n.queue=[],n.version="3.0";var
t=document.createElement("script");t.async=!0,t.src=e;var
r=document.getElementsByTagName("script")[0];r.parentNode.insertBefore(t,r)}}
("https://s.pinimg.com/ct/core.js"); pintrk('load', '123456789'); pintrk('page');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&noscript=1" />
</noscript>
<script>
pintrk('track', 'pagevisit');
pintrk('track', 'addtocart');
</script>
<noscript>
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=pagevisit&noscript=1" />
<img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=123456789&event=addtocart&noscript=1" />
</noscript>
</head>