Meta Conversions API (CAPI): en praktisk guide

Meta Conversions API (CAPI) lader din server sende events som Purchase direkte til Meta. Meta-pixelen sender de samme events fra shopperens browser. CAPI sender dem fra din server, så de stadig når frem, når en adblocker stopper pixelen, en cookie er væk, eller takkesiden aldrig indlæses.

Denne guide dækker, hvad et Conversions API-event indeholder, hvordan du kører det ved siden af pixelen med ét event_id, hvilke parametre Meta kræver og anbefaler, hvordan du tester med Test events, og de fejl, der opstår oftest.

Hvad er Meta Conversions API?

Conversions API er en del af Metas Graph API. Din server sender en HTTPS POST-forespørgsel til graph.facebook.com/VERSION/PIXEL_ID/events med et adgangstoken og en data-liste med op til 1,000 events. Hvert event beskriver én handling, for eksempel et køb, i tre dele: hvad der skete, hvem der gjorde det, og detaljerne.

Et forkortet Purchase-event ser sådan ud:

{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1792929600,
    "event_id": "order-1042",
    "action_source": "website",
    "event_source_url": "https://yourstore.com/checkouts/thank-you",
    "user_data": {
      "em": ["<SHA-256 of the normalized email>"],
      "ph": ["<SHA-256 of the normalized phone>"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; ...)",
      "fbp": "fb.1.1792928400000.1234567890",
      "fbc": "fb.1.1792928400000.AbCdEf123"
    },
    "custom_data": { "value": 74.00, "currency": "USD" }
  }]
}

Kontaktfelter som e-mail og telefon normaliseres og hashes med SHA-256, før de forlader din server. IP-adressen, user agent, fbp og fbc sendes, som de er.

Hvorfor køre Conversions API ved siden af pixelen?

Meta anbefaler at køre Conversions API sammen med pixelen og sende de samme events gennem begge. Hver side ser noget, den anden ikke ser, og sammen giver de Meta mere komplette data.

Prisen for at køre begge er, at Meta nu modtager to kopier af hvert event. Næste afsnit viser, hvordan Meta kun beholder én.

Hvordan fungerer deduplikering med ét event_id?

Meta behandler et browser-event og et server-event som det samme event, når to ting matcher: eventnavnet og event-id'et. I pixelen kommer id'et i indstillingen eventID. I Conversions API kommer den samme værdi i event_id.

fbq('track', 'Purchase', { value: 74.00, currency: 'USD' }, { eventID: 'order-1042' });

Meta deduplikerer kun et matchende par, når de to kopier ankommer inden for 48 timer af hinanden. Nogle få regler får det til at virke i praksis:

• Opret id'et én gang. Byg det ud fra noget, begge sider kender, for eksempel ordrenummeret, og giv det videre til både browseren og serveren. To systemer, der hver laver deres eget id, matcher ikke.
• Brug ét format. order-1042 og 1042 er forskellige id'er.
• Match eventnavnet præcist. Purchase og purchase er forskellige events.
• Send server-eventet hurtigt. Et server-event, der ankommer mere end 48 timer efter browser-eventet, bliver talt en gang til.

Meta beskriver også en anden metode, der parrer events via fbp eller external_id. Meta siger, at den generelt kun virker, når browser-eventet ankommer før server-eventet, så et fælles event_id er det mere pålidelige valg. Hvis Meta stadig rapporterer flere køb, end din shop havde, viser vores guide til dobbelte købsevents de almindelige årsager.

Hvilke parametre er påkrævet, og hvilke er anbefalede?

De påkrævede felter gør et event gyldigt. De anbefalede felter afgør, hvor mange af dine events Meta kan matche med en person, og kun matchede events kan bruges til attribution og annoncelevering.

Tre detaljer forårsager de fleste problemer:

• Normalisér, før du hasher. Meta forventer e-mail uden mellemrum og med små bogstaver og telefonnumre som cifre med landekode. Anna@Example.com og anna@example.com giver forskellige hashes, og kun den anden kan matche.
• Hash ikke browseridentifikatorer. fbp, fbc, IP-adressen og user agent sendes som almindelige værdier.
• Behold klik-id'et præcis, som det er. Værdien fbc er fb.1., oprettelsestidspunktet i millisekunder, et punktum og fbclid fra landingssidens URL. fbclid skelner mellem store og små bogstaver. Gem det, når den besøgende lander, fordi det ikke længere står i URL'en ved checkout.

Hvor godt disse felter matcher, er det, Metas Event Match Quality-score måler. Vores guide til Event Match Quality dækker hver parameter, hashingreglerne og den score, du bør sigte efter.

Hvordan tester du events med Test events?

Events Manager har en fane Test events, der viser events, efterhånden som de ankommer. Brug den, før du stoler på en ny opsætning.

1. Åbn Test events

   Vælg dit dataset (pixel) i Events Manager, og åbn fanen Test events. Kopiér den testkode, den viser.

2. Føj koden til dine server-events

   Send den som test_event_code i forespørgslen. I ROASaurus indsætter du den i feltet Test event code på Meta-pixelen.

3. Læg en testordre

   Besøg shoppen, læg et produkt i kurven, og betal, så både pixelen og serveren sender et Purchase.

4. Sammenlign de to kopier

   Begge kopier skal vise samme eventnavn, event-id, værdi og valuta.

5. Tjek kundeoplysningerne

   Server-eventet skal bære hashet e-mail og telefon, IP-adressen, user agent og fbp, plus fbc, hvis besøget startede med et annonceklik.

6. Fjern testkoden

   Meta siger, at feltet kun er til test, så fjern det, før du stoler på eventsene.

Almindelige Conversions API-fejl og hvordan du løser dem

Efter nogle dages live trafik åbner du fanen Diagnostics i Events Manager. Meta viser dér problemer med anbefalinger til, hvordan du løser dem. Sammenlign derefter det daglige antal Purchase i Events Manager med de betalte ordrer i din shop for de samme dage. Hvis Meta ligger tydeligt højere, viser vores hjælpeside om at undgå dobbelttælling de indstillinger, du skal tjekke.

Sådan sætter du Conversions API op med ROASaurus

ROASaurus sender Conversions API-events fra din shops ordredata, så du ikke selv skal bygge serversiden. Klik på Connect with Facebook under Tracking & platforms, og vælg din annoncekonto og pixel, eller indsæt pixel-id'et (dataset-id'et) og et Conversions API-token. Meta-opsætningsguiden gennemgår begge muligheder, og Meta-integrationssiden viser alle felter, der sendes.

• Ét id på begge sider. Browser- og server-events deler ét event-id. For et køb er det order- efterfulgt af ordre-id'et.
• En kort pause før købet. Server-Purchase venter et kort øjeblik, efter ordren er kommet ind, så browserens købsevent kan blive koblet på først. Dens IP-adresse, user agent og side-URL går så ud med server-eventet sammen med de fbp og fbc, der er gemt for den besøgende.
• Kundeoplysninger fra ordren. E-mail, telefon, navn og adresse normaliseres og hashes med SHA-256. Shoppens kunde-id og ROASaurus' besøgs-id sendes hashet som external_id.
• Events, som Meta ikke kan matche, springes over. Et event uden fbc, fbp, e-mail, telefon eller IP-adresse sendes ikke.

Event log viser hver serverlevering med forespørgslen og Metas svar. Hvis dine marginer varierer meget mellem produkter, kan du også sende en overskudsværdi ved siden af hvert køb: Vores guide til Meta-værdioptimering til overskud forklarer, hvordan. For hele datastien fra klik til ordre, se server-side tracking.

Kilder

1. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
2. Meta for Developers: Server Event Parameters
3. Meta for Developers: Customer Information Parameters
4. Meta for Developers: Using the API - Conversions API
5. Meta for Developers: ClickID and the fbp and fbc Parameters

I ROASaurus

• Meta-integration
• Hjælp: forbind Meta
• Hjælp: forebyg dobbelttælling
• Server-side tracking

Læs videre