Tilføj hændelseskoder

Du befinder dig i et område, hvor du ikke kan bruge Pinterest-tagget endnu. Se, hvor Pinterest-tagget kan benyttes af Pinterest Business-konti.

Få mere at vide

Hændelseskoder giver dig mulighed for at måle dine Pinterest-annoncers effekt på bestemte handlinger på dit website. De er nødvendige for at køre kampagner, der automatisk optimeres til specifikke hændelser, f.eks. konverteringskampagner eller dynamisk retargeting-annoncer. Du skal også bruge hændelseskoder til at få adgang til konverteringsindsigt og deltage i programmet for verificerede butikker.

Når du har tilføjet basiskoden, kan du tilføje hændelseskoder for at spore en bestemt konvertering på dit website. Basiskoden skal anbringes på alle siderne på dit website, hvorimod hændelseskoder kun skal anbringes på de sider, hvor du vil spore bestemte konverteringer. Du skal bruge forskellige hændelseskoder for at køre forskellige annoncekampagner og få adgang til bestemte funktioner.

Typer af hændelseskoder

Nedenstående tabel viser de hændelser, du kan spore med Pinterest-tagget. Du kan bruge dem til at oprette målgrupper til målretning af annoncer, og du kan se relateret rapportering om betalt og organisk konvertering i Ads Manager. Bemærk, at rapportering ikke er tilgængelig for brugerdefinerede hændelser.

Hændelse	Formål
Checkout	Registrer de personer, der gennemfører transaktioner.
AddToCart	Registrer de personer, der lægger varer i indkøbskurven.
PageVisit	Registrer de personer, der ser primære sider, f.eks. produktsider og artikelsider.
Signup	Registrer de personer, der tilmelder sig dit produkt eller din tjenesteydelse.
WatchVideo	Registrer de personer, der ser videoer.
Lead	Registrer de personer, der viser interesse for dit produkt eller din tjenesteydelse.
Søg	Registrer de personer, der søger efter bestemte produkter eller butiksadresser på dit website.
ViewCategory	Registrer de personer, der ser kategorisider.
Custom	Registrer en brugerdefineret hændelse. Brug dette hændelsesnavn til at spore en bestemt hændelse, som du vil have med i din konverteringsrapportering.
[User-defined event]	Tilføj eventuelle ekstra hændelser, som du har defineret med henblik på målretning mod bestemte grupper. Unikke hændelser kan ikke bruges til konverteringsrapportering. Vær opmærksom på, at mellemrum fjernes fra brugerdefinerede hændelsesnavne, der overføres via tagget.

Påkrævede og anbefalede hændelser til annoncekampagner

Der er påkrævede og anbefalede hændelser, afhængigt af hvilken annoncekampagne du beslutter dig for at køre.

Kampagnetype	Påkrævede hændelser	Anbefalede hændelser	Påkrævede hændelsesdata	Anbefalede hændelsesdata
Brandbevidsthed	Ingen	PageVisit Checkout AddToCart Lead Signup	Ingen	Forbedret match
Katalogsalg	PageVisit AddToCart Checkout	Signup Lead	Produkt-id Ordre-id Value Valuta (påkrævet for addtocart og checkout)	Produktkategori Forbedret match
Overvejelse	Ingen	PageVisit Checkout AddToCart Lead Signup	Ingen	Forbedret match
Konverteringer	Mindst en af følgende: Signup Lead AddToCart Checkout	Produkt-id Ordre-id Value Forbedret match	Ingen	Produktkategori currency Forbedret match
Videovisninger	Ingen	Ingen	Ingen	Forbedret match

Påkrævede og anbefalede hændelser til funktioner

Der er påkrævede og anbefalede hændelser, afhængigt af hvilke funktioner du vil bruge.

Funktion	Påkrævede hændelser	Anbefalede hændelser	Påkrævede hændelsesdata	Anbefalede hændelsesdata
Konverteringsindsigt	PageVisit AddToCart Checkout	Ingen	currency	Ingen
Programmet for verificerede butikker	PageVisit AddToCart Checkout	Ingen	currency	Ingen
Dynamisk retargeting	PageVisit AddToCart Checkout	Ingen	Produkt-id Value currency	Ingen

Tilføj hændelseskoder på dit website

Hvis du har besluttet at installere manuelt, skal du selv tilføje hændelseskoder på dit website. Nedenstående trin er til folk, der bruger manuel opsætning.

Log på din Pinterest-virksomhedskonto fra din computer.

Klik øverst til venstre på siden

Klik på Konverteringer under Virksomhed.

Klik på Start.

Vælg kun Pinterest-tagget, og klik derefter på Fortsæt.

Klik på Spring over i nederste højre hjørne af skærmen.

Klik på Spring til manuel konfigurering.

Kopiér basiskoden, og klik på Fortsæt.

Vælg, om automatisk forbedret match skal aktiveres, og klik derefter på Fortsæt.

Klik på Kopiér kode under det grå felt ud for den hændelseskode, du vil tilføje.

Åbn koden til den side på dit website, hvor du vil spore hændelsen.

Indsæt hændelseskoden på den side, hvor hændelsen skal finde sted, og sørg for at erstatte eventuelle eksempelværdier med den relevante værdi for dit website. Det bevirker, at hændelsen bliver udløst, hver gang siden indlæses.

Klik på OK.

Bemærk, at hvis en hændelse først udløses, når nogen har foretaget en bestemt handling på siden, f.eks. klikket på en knap eller sendt en formular, skal du sørge for, at hændelseskoden kun afvikles som følge af denne handling. Dette kræver en forståelse af de eksisterende hændelsesbehandlere i din sides JavaScript-kode.

Tilføj hændelsesdata

Du kan give yderligere oplysninger om en hændelse ved at tilknytte et objekt, der indeholder hændelsesdata. Alle hændelsesdata kan bruges til målretning mod målgrupper, men det er kun hændelsesdata for value og order_quantity, der er tilgængelige for betalt og organisk konverteringsrapportering.

Hændelsesdata	Eksempel på værdi	Type
value	100,00	Tal (heltal eller flydende)
event_id	eventId0001	Streng (en id-streng, der entydigt identificerer hændelsen) Bemærk, id'et kan sendes under et af følgende feltnavne, hvor der er forskel på store og små bogstaver: eventID event_id eid
order_quantity	1	Heltal
order_id	1234Ordre-id	Streng (order_id bruges til rapportering af konverteringsanalyse)
product_name	Parker-støvler	line_items array, streng
product_id	1414	line_items array, streng
product_category	Sko	line_items array, streng
product_variant_id	1414-Rød	line_items array, streng
product_variant	Rød	line_items array, streng
product_price	99,99	Tal (heltal eller flydende komma), line_items array, streng
product_quantity	1	Heltal, line_items array, streng
product_brand	Parker	line_items array, streng
promo_code	WINTER10	Streng
property	Athleta	Streng
search_query	støvler	Streng
video_title	Gør dine Parker-støvler endnu smartere	Streng
lead_type	Nyhedsbrev	Streng
currency	USD	En af følgende: 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 eller ZAR. Bemærk: Når du angiver en valuta med din tagginghændelse, beregner vi valutakursen, så den svarer til din annoncørkontos valuta.

Inkluder hændelsesdata i IMG-tagget

IMG-tagget er et stykke kode inden i Pinterest-tagget, der fungerer som reserve, hvis folk har deaktiveret JavaScript i deres browser. Vi anbefaler, at du også inkluderer hændelsesdata i IMG-tagget, da det giver bedre muligheder for målretning. Du kan vælge kun at bruge IMG-tagget og ikke JavaScript-tagget, men du bliver nødt til at fjerne tags med <noscript> fra koden.

Herunder vises eksempler på hver hændelsestype, så du kan kopiere og indsætte dem direkte på dit website. Bemærk, at du skal erstatte eksempelværdier med en dynamisk variabel til dit website.

Checkout

 <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" />

Hændelsesdata: event_id, value, order_quantity og currency

Sørg for at indtaste den korrekte valutakode til dit website.

AddToCart

 <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" />

Hændelsesdata: value, order_quantity og currency.

Sørg for at indtaste den korrekte valutakode til dit website.

PageVisit

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=pagevisit&noscript=1" />

Hændelsesdata: ingen

Signup

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=signup&noscript=1" />

Hændelsesdata: ingen

WatchVideo

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=watchvideo&ed[video_title]=My+Product+Video+01&noscript=1" />

Hændelsesdata: video_title

Lead

 <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" />

Hændelsesdata: lead_type

Søg

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=search&ed[search_query]=horse&noscript=1" />

Hændelsesdata: search_query

ViewCategory

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=viewcategory&noscript=1" />

Hændelsesdata: ingen

Custom

Hændelsestypen skal hedde custom – ellers rapporteres de konverteringer, der spores af tagget, ikke i Ads Manager.

 <img height="1" width="1" style="display:none;" alt="" src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=custom&noscript=1" />

Hændelsesdata: ingen

Overfør hændelsesdata for value (værdi) og order_quantity (mængde) dynamisk

Ordrens værdi og mængde (value og order_quantity) er de to typer hændelsesdata, der er tilgængelige i betalte og organiske konverteringsrapportering. Hvis du vil tilføje værdi og mængde, kan du tilbageføre dem dynamisk. En dynamisk værdi kan ændre sig afhængigt af den handling, der udføres på dit website. Hvis du vælger at tilbageføre value og order_quantity, vil det være unikt for dit website og den måde, du registrerer salg på. Normalt skifter værdien og mængden af produkterne i hver af de ordrer, der afgives på dit website.

<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>

Rapporteret værdi: Dynamisk beløb, der er dækket af den tilsvarende betaling

Rapporteret mængde: Dynamisk mængde, der er købt med den tilsvarende betaling

Bemærk, at opsætningen af dynamisk ordremængde og -værdi er unik for dit website.

Overfør en JavaScript-tilbagekaldsfunktion

Ud over hændelsesdata kan du overføre en JavaScript-tilbagekaldsfunktion som et valgfrit argument til funktionen pintrk(). Dette giver yderligere oplysninger, hvis noget er gået galt med dit tag, hvilket du kan kontrollere i dit udviklingsværktøj. Tilbagekaldsfunktionen afvikles, hver gang et hændelsessporingskald, funktionen pintrk(), udløses.

Følgende to argumenter kan overføres til tilbagekaldsfunktionen:

function(didInit, error) {}

didInit: Dette første argument modtager en boolesk værdi, som indstilles til sand, hvis hændelsessporingskaldet er opbygget korrekt, og falsk, hvis der registreres en fejl under dannelsen af hændelsessporingskaldet.

error: Dette andet argument modtager en streng, som beskriver fejlen, hvis didInit returnerer falsk. Hvis didInit er sand, er strengen udefineret.

<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>

Eksempler på hændelseskode

Ved konverteringssporing og -rapportering skal du angive en af de ni hændelsestyper i hændelseskoden. Du skal også erstatte YOUR_TAG_ID med dit konverteringstag-id til Pinterest. Husk, at du kan inkludere enhver kombination af hændelsesdata pr. hændelse ud over det, der er vist i eksemplerne nedenfor.

Dette afsnit indeholder et eksempel på alle hændelsestyper i et komplet format, som du kan kopiere og placere direkte på dit website. Alle eksempler har de hændelsesdata, der er nødvendige for at begynde at spore aktivitet på dit website. Bemærk, at du skal erstatte eksempelværdier med den relevante statiske værdi eller dynamiske variabel til dit website. Du vil f.eks. nok spore ordreværdi dynamisk, fordi værdien af de ordrer, der afgives på dit website, skifter, afhængigt af hvad, der købes. Derimod kan du godt tildele en statisk værdi til hændelsestypen lead_type, hvis den kun forekommer på en enkelt side.

Checkout

<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>

Hændelsesdata: value, order_quantity, currency og event_id.

Sørg for at indsætte den korrekte valutakode til dit website.

AddToCart

<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>

Hændelsesdata: value, order_quantity og currency.

Sørg for at indsætte den korrekte valutakode til dit website.

PageVisit

<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>

Signup

<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>

WatchVideo

<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>

Hændelsesdata:Video_title

Lead

<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>

Hændelsesdata: lead_type

Søg

<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>

Hændelsesdata: search_query

ViewCategory

<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>

User-defined events

<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>

Custom

Hændelsestypen skal hedde custom – ellers rapporteres de konverteringer, der spores af tagget, ikke i Ads Manager.

<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>

Eksempler på basiskode og hændelseskoder sammen

Her er nogle eksempler på basiskode kombineret med hændelseskode. Husk at kontrollere, at du har anbragt hændelseskoden efter basiskoden på dit website.

Eksemplet på konverteringstag-id: 123456789 (erstat det med dit konverteringtag-id til Pinterest)

Eksemplet på hændelseskode: 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>

Konverteringstag-id i eksemplet: 123456789 (erstat det med dit konverteringtag-id til Pinterest)

Eksempel på hændelseskoder: PageVisit og 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>

Hvad er næste skridt?

Verificer Pinterest-tagget, så du er sikker på, at det fungerer korrekt.

collection_fields