APIs tal-konverżjonijiet

1. Għaliex fuq is-server?

Pixel irid jegħleb adblocker, prevenzjoni tat-traċċar u tab li tingħalaq qabel jaħdem. Sejħa tas-server tegħleb it-tlieta għax ma sseħħx fil-browser.

MousePlayer diġà jaf meta jintlaħaq għan. Il-Conversions APIs jgħaddu dak il-fatt lin-network mis-server tagħna.

Mhux sostitut għall-pixel. Żommuh. Networks ineħħu d-duplikati bejniethom; nibagħtu l-IDs meħtieġa.

2. X’nibagħtu u x’qatt ma nibagħtu

L-unika identifikazzjoni hija l- cookie jew ID tal-klikk issettjat min-network. Xejn ieħor dwar il-persuna ma jitlaq mis-server.

Network	ID użat	Minn fejn ġej
Meta	`_fbp`, `_fbc`	Cookies tal-ewwel parti mill-pixel Meta
LinkedIn	`li_fat_id`	Cookie tal-ewwel parti mil-LinkedIn Insight Tag
TikTok	`_ttp`, `ttclid`	`_ttp` cookie, `ttclid` mill-URL tal-klikk tar-reklam
Google Ads	`gclid`, `wbraid`, `gbraid`	Mill-URL tar-reklam, jew wara mill-cookie `_gcl_aw`
Microsoft Advertising	`msclkid`	Mill-URL tar-reklam, jew mill-cookie `_uetmsclkid` miktuba mit-tag UET

Qatt mibgħuta: email, telefon, isem jew IP — lanqas hashed. Bla ID tal-klikk ma jintbagħat xejn. Konverżjoni mhux attribwita tiswa inqas minn għadd preċiż.

Bil-kunsens biss

L-istess kontroll tal-kunsens bħar-reġistrazzjoni. Bla kunsens ebda rapport, ikun xi jkun is-swiċċ.

3. Google Ads għandu tliet IDs

Google juża gclid għal klikk waħda. Meta prevenzjoni Apple tagħmilha mhux attribwibbli, jibgħat wbraid jew gbraid , għal grupp ta’ klikks.

Esklussivi: Google jiċħad konverżjoni bi tnejn. Nibagħtu wieħed, u gclid jipprevali meta hemm aktar minn wieħed, għax l-aktar preċiż.

Fl-URL darba biss

L-ID jidher fl- ewwel paġna wara r-reklam. Google jaħżnu fil-cookie _gcl_aw . Naqrawha bħala alternattiva; inkella konverżjoni fit-tielet paġna ma ssibx ID.

4. Setup

Meta, LinkedIn u TikTok

Żewġ oqsma kull wieħed: ID tal-pixel jew regola u access token mill-interface tan-network. It-tnejn kriptati b’AES-256-GCM u qatt ma jerġgħu jidhru wara s-save.

Google Ads jeħtieġ sitta

Google ma jagħtix token sempliċi. OAuth b’refresh token, u Ads API jeħtieġ ukoll developer token.

Qasam	Fejn issibuh
Customer ID	Fuq il-lemin f’Google Ads. Ċifri bla sing.
ID tal-azzjoni tal-konverżjoni	Għanijiet u konverżjonijiet, imbagħad l-azzjoni mixtieqa.
Developer token	Kont manager Google Ads, API Center.
OAuth client ID u secret	Google Cloud Console, Kredenzjali, OAuth client "desktop app".
Refresh token	Tiġġenerawh darba għall-iskop `adwords`.

LinkedIn għandu żewġ toroq; agħżlu l-qasira

F’Campaign Manager: Data, Signals Manager, Direct API, Iġġeneraw access token. Għar-reklamaturi bid-data tagħhom: bla app tal-iżviluppatur jew reviżjoni. Ma jiskadix u ma jerġax jidher; ikkopjawh issa.

App mid-Developer Portal hija għal pjattaformi li jibagħtu għal diversi reklamaturi. Teħtieġ verifika tal-paġna tal-kumpanija u każ approvat; hawn m’għandkomx bżonnha.

Microsoft Advertising l-eħfef

Wara Google forsi tistennew OAuth, developer token u approvazzjoni. Minflok żewġ oqsma: ID UET tal-browser u token minn UET tag, "Use Conversions API", "Copy Token". Ebda applikazzjoni.

Użaw l- istess ID bħal fil-browser sabiex Microsoft jagħraf iż-żewġ avvenimenti bħala konverżjoni waħda.

Developer token jeħtieġ approvazzjoni Google ("Basic access"), ftit jiem. Ibdew bih għax ma jsirx f’minuta. Qatt ma naraw il-password Google — refresh token biss, revokabbli f’kull ħin.

5. Meta jintbagħat

Eżatt darba għal kull għan u sessjoni. MousePlayer ineħħi d-duplikati qabel jibgħat, u payload b’ID għan-network ukoll. Ħames oġġetti fil-basket jagħtu konverżjoni waħda, mhux ħamsa.

X’taraw fil-kont tar-reklami

Isem l-għan, valur u munita jekk issettjati, u ħin. Normalment jasal f’minuta.

Jekk ma jasal xejn

Ebda ID tal-klikk. Ma ġiex minn reklam tan-network jew qabel il-cookie. Mistenni, mhux żball.
Ebda kunsens. Il-kontroll jiġi l-ewwel.
In-network aċċetta t-talba iżda ċaħad il-konverżjoni. Google, TikTok u oħrajn jagħtu HTTP 200 b’żball fil-body. Naqraw il-body, mhux biss status, u r-raġuni fil-log.

Kif nistgħu ngħinu?