Meta Conversions API (CAPI): en praktisk guide

Metas Conversions API (CAPI) låter din server skicka händelser som Purchase direkt till Meta. Meta-pixeln skickar samma händelser från köparens webbläsare. CAPI skickar dem från din server, så de kommer ändå fram när en annonsblockerare stoppar pixeln, en cookie har försvunnit eller tacksidan aldrig laddas.

Den här guiden tar upp vad en händelse i Conversions API innehåller, hur du kör det vid sidan av pixeln med ett gemensamt event_id, vilka parametrar Meta kräver och rekommenderar, hur du testar med Test events och vilka fel som uppstår oftast.

Vad är Meta Conversions API?

Conversions API är en del av Metas Graph API. Din server skickar en HTTPS POST-förfrågan till graph.facebook.com/VERSION/PIXEL_ID/events med en åtkomsttoken och en data-lista med upp till 1,000 händelser. Varje händelse beskriver en handling, till exempel ett köp, i tre delar: vad som hände, vem som gjorde det och detaljerna.

En förkortad Purchase-händelse ser ut så här:

{
  "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" }
  }]
}

Kontaktfält som e-post och telefon normaliseras och hashas med SHA-256 innan de lämnar din server. IP-adressen, user agent, fbp och fbc skickas som de är.

Varför köra Conversions API vid sidan av pixeln?

Meta rekommenderar att du kör Conversions API vid sidan av pixeln och skickar samma händelser genom båda. Varje sida ser något som den andra inte ser, och tillsammans ger de Meta mer komplett data.

Priset för att köra båda är att Meta nu får två kopior av varje händelse. Nästa avsnitt visar hur Meta behåller bara en.

Hur fungerar deduplicering med ett event_id?

Meta behandlar en webbläsarhändelse och en serverhändelse som samma händelse när två saker stämmer: händelsenamnet och händelse-id:t. I pixeln anges id:t i alternativet eventID. I Conversions API anges samma värde i event_id.

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

Meta deduplicerar ett matchande par bara när de två kopiorna kommer in inom 48 timmar från varandra. Några regler får det att fungera i praktiken:

• Skapa id:t en gång. Bygg det av något som båda sidor känner till, till exempel ordernumret, och skicka det till både webbläsaren och servern. Två system som var och ett skapar sitt eget id kommer inte att matcha.
• Använd ett enda format. order-1042 och 1042 är olika id:n.
• Matcha händelsenamnet exakt. Purchase och purchase är olika händelser.
• Skicka serverhändelsen i tid. En serverhändelse som kommer in mer än 48 timmar efter webbläsarhändelsen räknas en andra gång.

Meta beskriver också en andra metod som parar ihop händelser via fbp eller external_id. Meta säger att den i allmänhet bara fungerar när webbläsarhändelsen kommer in före serverhändelsen, så ett gemensamt event_id är det mer tillförlitliga valet. Om Meta ändå rapporterar fler köp än din butik hade listar vår guide om dubbla köphändelser de vanliga orsakerna.

Vilka parametrar är obligatoriska, och vilka rekommenderas?

De obligatoriska fälten gör en händelse giltig. De rekommenderade fälten avgör hur många av dina händelser Meta kan matcha mot en person, och bara matchade händelser kan användas för attribution och annonsleverans.

Tre detaljer orsakar de flesta problemen:

• Normalisera innan du hashar. Meta förväntar sig e-post utan blanksteg i ändarna och med gemener, och telefonnummer som siffror med landskod. Anna@Example.com och anna@example.com ger olika hashar, och bara den andra kan matcha.
• Hasha inte webbläsaridentifierare. fbp, fbc, IP-adressen och user agent skickas som vanliga värden.
• Behåll klick-id:t exakt som det är. Värdet fbc består av fb.1., skapandetiden i millisekunder, en punkt och fbclid från landningssidans URL. fbclid är skiftlägeskänslig. Spara den när besökaren landar, eftersom den inte längre finns i URL:en i kassan.

Hur väl de här fälten matchar är vad Metas Event Match Quality-poäng mäter. Vår guide om Event Match Quality går igenom varje parameter, hashningsreglerna och vilken poäng du bör sikta på.

Hur testar du händelser med Test events?

Events Manager har en flik Test events som visar händelser när de kommer in. Använd den innan du litar på en ny uppsättning.

1. Öppna Test events

   Välj ditt dataset (pixel) i Events Manager och öppna fliken Test events. Kopiera testkoden som visas.

2. Lägg till koden i dina serverhändelser

   Skicka den som test_event_code i anropet. I ROASaurus klistrar du in den i fältet Test event code för Meta-pixeln.

3. Lägg en testorder

   Besök butiken, lägg en produkt i varukorgen och betala, så att både pixeln och servern skickar ett Purchase.

4. Jämför de två kopiorna

   Båda kopiorna ska visa samma händelsenamn, händelse-id, värde och valuta.

5. Kontrollera kundinformationen

   Serverhändelsen ska bära hashad e-post och telefon, IP-adressen, user agent och fbp, plus fbc om besöket började med ett annonsklick.

6. Ta bort testkoden

   Meta säger att fältet bara är till för test, så ta bort det innan du litar på händelserna.

Vanliga fel i Conversions API och hur du åtgärdar dem

Efter några dagars live-trafik öppnar du fliken Diagnostics i Events Manager. Meta listar problem där, med rekommendationer om hur du åtgärdar dem. Jämför sedan det dagliga antalet Purchase i Events Manager med de betalda ordrarna i din butik för samma dagar. Om Meta är klart högre listar vår hjälpsida om att förhindra dubbelräkning de inställningar som ska kontrolleras.

Så sätter du upp Conversions API med ROASaurus

ROASaurus skickar Conversions API-händelser från din butiks orderdata, så du slipper bygga serversidan själv. Klicka på Connect with Facebook i Tracking & platforms och välj ditt annonskonto och din pixel, eller klistra in pixelns (datasetets) id och en Conversions API-token. Uppsättningsguiden för Meta går igenom båda alternativen, och Metas integrationssida listar alla fält som skickas.

• Ett id på båda sidor. Webbläsar- och serverhändelser delar ett händelse-id. För ett köp är det order- följt av order-id:t.
• En kort väntan före köpet. Purchase från servern väntar en kort stund efter att ordern kommit in, så att webbläsarens köphändelse hinner kopplas ihop först. Dess IP-adress, user agent och sidans URL skickas sedan med serverhändelsen, tillsammans med den fbp och fbc som sparats för besökaren.
• Kundinformation från ordern. E-post, telefon, namn och adress normaliseras och hashas med SHA-256. Butikens kund-id och ROASaurus besökar-id skickas hashade som external_id.
• Händelser som Meta inte kan matcha hoppas över. En händelse utan fbc, fbp, e-post, telefon eller IP-adress skickas inte.

Event log visar varje serverleverans med anropet och Metas svar. Om dina marginaler skiljer sig mycket mellan produkter kan du också skicka ett vinstvärde vid sidan av varje köp: vår guide om Metas värdeoptimering för vinst förklarar hur. För hela dataflödet från klick till order, se server-side tracking.

Källor

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: anslut Meta
• Hjälp: förhindra dubbelräkning
• Server-side tracking

Läs vidare