Meta Conversions API (CAPI): praktični vodič

Meta Conversions API (CAPI) omogućuje vašem poslužitelju da događaje poput Purchase šalje izravno Meti. Meta piksel šalje iste događaje iz preglednika kupca. CAPI ih šalje s vašeg poslužitelja, pa i dalje stižu kada blokator oglasa zaustavi piksel, kolačić nestane ili se stranica zahvale nikad ne učita.

Ovaj vodič obrađuje što sadrži događaj Conversions API, kako ga pokrenuti uz piksel s jednim event_id, koje parametre Meta zahtijeva i preporučuje, kako testirati pomoću Test events te pogreške koje se najčešće pojavljuju.

Što je Meta Conversions API?

Conversions API dio je Metinog Graph API-ja. Vaš poslužitelj šalje HTTPS POST zahtjev na graph.facebook.com/VERSION/PIXEL_ID/events s pristupnim tokenom i popisom data s do 1,000 događaja. Svaki događaj opisuje jednu radnju, poput kupnje, u tri dijela: što se dogodilo, tko je to učinio i pojedinosti.

Skraćeni događaj Purchase izgleda ovako:

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

Kontaktna polja poput e-adrese i telefona normaliziraju se i hashiraju algoritmom SHA-256 prije nego što napuste vaš poslužitelj. IP adresa, user agent, fbp i fbc šalju se onakvi kakvi jesu.

Zašto Conversions API pokretati uz piksel?

Meta preporučuje pokretanje Conversions API uz piksel i slanje istih događaja putem oba. Svaka strana vidi nešto što druga ne vidi, a zajedno Meti daju potpunije podatke.

Cijena korištenja oba je to što Meta sada prima dvije kopije svakog događaja. Sljedeći odjeljak pokazuje kako Meta zadržava samo jednu.

Kako deduplikacija radi s jednim event_id?

Meta preglednički i poslužiteljski događaj smatra istim događajem kada se podudaraju dvije stvari: naziv događaja i ID događaja. U pikselu se ID upisuje u opciju eventID. U Conversions API ista vrijednost ide u event_id.

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

Meta deduplicira podudarni par samo ako obje kopije stignu unutar 48 sati jedna od druge. Nekoliko pravila omogućuje da to u praksi funkcionira:

• Izradite ID samo jednom. Složite ga iz nečega što znaju obje strane, poput broja narudžbe, i proslijedite ga pregledniku i poslužitelju. Dva sustava koja svaki izrađuju vlastiti ID neće se podudarati.
• Koristite jedan format. order-1042 i 1042 različiti su ID-ovi.
• Točno uskladite naziv događaja. Purchase i purchase su različiti događaji.
• Šaljite događaj s poslužitelja bez odgode. Događaj s poslužitelja koji stigne više od 48 sati nakon događaja iz preglednika broji se drugi put.

Meta opisuje i drugu metodu koja povezuje događaje po fbp ili external_id. Meta navodi da ona općenito radi samo kada događaj iz preglednika stigne prije događaja s poslužitelja, pa je zajednički event_id pouzdaniji izbor. Ako Meta i dalje prijavljuje više kupnji nego što ih je imala vaša trgovina, naš vodič o dvostrukim događajima kupnje navodi uobičajene uzroke.

Koji su parametri obavezni, a koji preporučeni?

Obavezna polja čine događaj valjanim. Preporučena polja određuju koliko vaših događaja Meta može povezati s osobom, a samo se povezani događaji mogu koristiti za atribuciju i isporuku oglasa.

Tri pojedinosti uzrokuju većinu problema:

• Normalizirajte prije hashiranja. Meta očekuje e-adresu bez razmaka na rubovima i malim slovima, a telefonske brojeve kao znamenke s pozivnim brojem države. Anna@Example.com i anna@example.com daju različite hasheve, a samo se drugi može podudariti.
• Ne hashirajte identifikatore preglednika. fbp, fbc, IP adresa i user agent šalju se kao obične vrijednosti.
• Zadržite ID klika točno onakav kakav je. Vrijednost fbc sastoji se od fb.1., vremena nastanka u milisekundama, točke i fbclid iz URL-a odredišne stranice. fbclid razlikuje velika i mala slova. Spremite ga kada posjetitelj stigne, jer ga pri naplati više nema u URL-u.

Koliko se ta polja dobro podudaraju, mjeri Metin rezultat Event Match Quality. Naš vodič o Event Match Quality obrađuje svaki parametar, pravila hashiranja i rezultat kojem treba težiti.

Kako se događaji testiraju pomoću Test events?

Events Manager ima karticu Test events koja prikazuje događaje dok stižu. Koristite je prije nego što se oslonite na novu postavu.

1. Otvorite Test events

   U Events Manageru odaberite svoj skup podataka (piksel) i otvorite karticu Test events. Kopirajte testni kod koji prikazuje.

2. Dodajte kod svojim događajima s poslužitelja

   Pošaljite ga kao test_event_code u zahtjevu. U ROASaurusu ga zalijepite u polje Test event code Meta piksela.

3. Napravite probnu narudžbu

   Posjetite trgovinu, dodajte proizvod i platite, tako da piksel i poslužitelj oba pošalju Purchase.

4. Usporedite dvije kopije

   Obje kopije trebaju imati isti naziv događaja, ID događaja, vrijednost i valutu.

5. Provjerite podatke o kupcu

   Događaj s poslužitelja treba nositi hashiranu e-adresu i telefon, IP adresu, user agent i fbp, te fbc ako je posjet počeo klikom na oglas.

6. Uklonite testni kod

   Meta navodi da je polje samo za testiranje, pa ga uklonite prije nego što se oslonite na događaje.

Česte pogreške Conversions API-ja i kako ih ispraviti

Nakon nekoliko dana stvarnog prometa otvorite karticu Diagnostics u Events Manageru. Meta ondje navodi probleme s preporukama za njihovo rješavanje. Zatim usporedite dnevni broj događaja Purchase u Events Manageru s plaćenim narudžbama u vašoj trgovini za iste dane. Ako je Meta jasno viša, naša stranica pomoći o sprječavanju dvostrukog brojanja navodi postavke koje treba provjeriti.

Kako postaviti Conversions API s ROASaurusom

ROASaurus šalje događaje Conversions API iz podataka o narudžbama vaše trgovine, pa stranu poslužitelja ne morate graditi sami. U Tracking & platforms kliknite Connect with Facebook i odaberite svoj oglasni račun i piksel ili zalijepite ID piksela (skupa podataka) i token za Conversions API. Vodič za postavljanje Mete prolazi kroz obje opcije, a stranica Meta integracije navodi svako polje koje se šalje.

• Jedan ID na obje strane. Događaji iz preglednika i s poslužitelja dijele jedan ID događaja. Za kupnju je to order- iza kojeg slijedi ID narudžbe.
• Kratko zadržavanje prije kupnje. Purchase s poslužitelja kratko čeka nakon što narudžba stigne, kako bi se prvo mogao povezati događaj kupnje iz preglednika. Njegova IP adresa, user agent i URL stranice zatim odlaze s događajem s poslužitelja, zajedno s fbp i fbc spremljenima za posjetitelja.
• Podaci o kupcu iz narudžbe. E-adresa, telefon, ime i adresa normaliziraju se i hashiraju algoritmom SHA-256. ID kupca iz trgovine i ID posjetitelja ROASaurusa šalju se hashirani kao external_id.
• Događaji koje Meta ne može povezati preskaču se. Događaj bez fbc, fbp, e-adrese, telefona ili IP adrese ne šalje se.

Event log prikazuje svaku isporuku s poslužitelja sa zahtjevom i odgovorom Mete. Ako se vaše marže među proizvodima jako razlikuju, uz svaku kupnju možete poslati i vrijednost dobiti: naš vodič o Meta optimizaciji vrijednosti za dobit objašnjava kako. Za cijeli put podataka od klika do narudžbe pogledajte praćenje na strani poslužitelja.

Izvori

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

U ROASaurusu

• Integracija s Metom
• Pomoć: povezivanje platforme Meta
• Pomoć: sprječavanje dvostrukog brojanja
• Praćenje na strani poslužitelja

Nastavite čitati