Omskakelings-API’s
Rapporteer u doelwitte vanaf ons bediener aan Meta, LinkedIn, TikTok en Google Ads eerder as uit die blaaier — slegs gekoppel deur die klikidentifiseerder wat die netwerk self gestel het.
1. Waarom enigsins die bedienerkant?
'n Blaaierpixel moet drie dinge oorleef voordat dit 'n omskakeling kan rapporteer: 'n advertensieblokker, 'n nasporingsvoorkomingsinstelling en 'n besoeker wat die oortjie sluit voordat die pixel aktiveer. 'n Bedienerkant-oproep oorleef al drie omdat dit glad nie in die blaaier plaasvind nie.
MousePlayer weet reeds wanneer een van u doelwitte bereik is — dit is waarvoor doelwitte is. Die omskakelings-API's stuur bloot dié feit vanaf ons bediener aan die advertensienetwerk deur.
Dit vervang nie u pixel nie. Behou dit. Elke netwerk dedupliseer die twee teen mekaar en ons stuur die nodige identifiseerders daarvoor.
2. Wat ons stuur — en nooit stuur nie
Die enigste besoekeridentifikasie in hierdie oproepe is die koekie of klikidentifiseerder wat die netwerk self gestel het. Niks anders oor die persoon verlaat ons bediener nie.
| Netwerk | Identifiseerder gebruik | Waar dit vandaan kom |
|---|---|---|
| Meta | _fbp, _fbc | Eersteparty-koekies deur die Meta-pixel gestel |
li_fat_id | Eersteparty-koekie deur die LinkedIn Insight Tag gestel | |
| TikTok | _ttp, ttclid | _ttp is 'n koekie, ttclid kom uit die advertensieklik-URL |
| Google Ads | gclid, wbraid, gbraid | Uit die advertensieklik-URL of die _gcl_aw koekie daarna |
| Microsoft Advertising | msclkid | Uit die advertensieklik-URL of die _uetmsclkid koekie wat die UET-etiket skryf |
Nooit gestuur nie: e-posadres, telefoonnommer, naam of IP-adres — nie eens as 'n hutswaarde nie. As 'n besoeker geen klikidentifiseerder het nie, word niks gestuur nie. 'n Ongerigte omskakeling is minder werd as 'n akkurate telling.
Slegs met toestemming
Elkeen van hierdie oproepe is agter dieselfde toestemmingshek as die opname self. 'n Sessie sonder toestemming lewer geen omskakelingsverslag nie, ongeag die skakelaar in u projekinstellings.
3. Google Ads het drie identifiseerders, nie een nie
Dit verras mense, dus stel ons dit duidelik. Google gebruik gclid vir 'n enkele advertensieklik. Wanneer Apple se nasporingsvoorkoming 'n enkele klik ontoerekenbaar maak, stuur Google wbraid of gbraid eerder, wat 'n groep klikke verteenwoordig.
Die drie sluit mekaar uit — Google weier 'n omskakeling met twee daarvan. Ons stuur presies een en gclid kry voorrang as meer as een bestaan, omdat dit die presiesste is.
Hulle is net een keer in die URL
Die identifiseerder verskyn net in die adres op die eerste bladsy ná die advertensieklik. Die Google-etiket stoor dit dan in die _gcl_aw koekie. Ons lees die koekie as rugsteun — daarsonder sou 'n omskakeling op die derde bladsy van die besoek geen identifiseerder vind nie.
4. Opstelling
Meta, LinkedIn en TikTok
Twee velde elk: die pixel- of omskakelingsreël-ID en 'n toegangstoken wat u in die netwerk se eie koppelvlak skep. Albei word AES-256-GCM-geënkripteer gestoor en ná stoor nooit weer gewys nie.
Google Ads benodig ses
Google is die uitsondering en die rede is nuttig om vooraf te weet: anders as die ander drie bied Google geen eenvoudige toegangstoken nie. Toegang loop deur OAuth met 'n verfristoken en die Ads API vereis boonop 'n ontwikkelaartoken.
| Veld | Waar om dit te vind |
|---|---|
| Klant-ID | Regs bo in Google Ads. Slegs syfers, sonder koppeltekens. |
| Omskakelingshandeling-ID | Goals and conversions, dan die handeling waaraan u dit wil toewys. |
| Ontwikkelaartoken | U Google Ads-bestuurderrekening, API Center. |
| OAuth-kliënt-ID en geheim | Google Cloud Console, Credentials, OAuth client van tipe “desktop app”. |
| Verfristoken | U genereer dit self een keer vir die omvang adwords. |
LinkedIn het twee roetes; kies die kort een
In Campaign Manager: Data, Signals Manager, Direct API, Generate access token. Dit is die roete vir adverteerders wat hul eie data stuur — geen ontwikkelaarsapp of hersiening nie. Die token verval nie en Campaign Manager sal dit nie weer wys nie; kopieer dit dus dadelik.
Die ander roete, 'n ontwikkelaarsapp deur LinkedIn se Developer Portal, bestaan vir platforms wat namens baie adverteerders stuur. Dit vereis maatskappybladsyverifikasie en 'n goedgekeurde gebruiksgeval; niks daarvan is hier nodig nie.
Microsoft Advertising is die maklike een
Ná Google Ads verwag u dieselfde las — OAuth, 'n ontwikkelaartoken en goedkeuring. Dit is die teenoorgestelde: twee velde. Die UET-etiket-ID wat u reeds in die blaaier gebruik en 'n token wat u uit Microsoft Advertising onder die UET-etiket, “Use Conversions API”, “Copy Token” kopieer. Niks om aansoek voor te doen nie.
Gebruik dieselfde etiket-ID as u blaaieretiket. Só herken Microsoft die bediener- en blaaiergebeurtenis as een omskakeling in plaas van twee.
Die ontwikkelaartoken vereis Google se goedkeuring (“Basic access”) en dit neem 'n paar dae. Dit is die een stap wat u nie binne 'n minuut kan voltooi nie, dus begin daarmee. Ons sien nooit u Google-wagwoord nie — net die verfristoken wat u enige tyd kan herroep.
5. Wanneer 'n omskakeling gerapporteer word
Presies een keer per doelwit per sessie. MousePlayer onderdruk herhalings voordat die oproep uitgaan en die data bevat ook 'n ID sodat die netwerk dit weer aan sy kant kan doen. 'n Besoeker wat vyf items by 'n mandjie voeg, skep een omskakeling, nie vyf nie.
Wat u in u advertensierekening sal sien
Die omskakeling bevat u doelwit se naam, die waarde en geldeenheid indien ingestel, en die tyd waarop dit gebeur het. Dit kom normaalweg binne 'n minuut aan.
As niks aankom nie
- Geen klikidentifiseerder nie. Die besoeker het nie deur dié netwerk se advertensie gekom nie of het aangekom voordat die pixel sy koekie gestel het. Niks word gestuur nie — dit word verwag en is nie 'n fout nie.
- Geen toestemming nie. Die hek het voorrang gekry.
- Die netwerk het die oproep aanvaar, maar die omskakeling geweier. Google, TikTok en verskeie ander antwoord met HTTP 200 en 'n fout binne die antwoordliggaam. Ons lees die liggaam, nie net die status nie, en die rede verskyn in die afleweringslogboek.
Alle handelsmerke wat hier genoem word, behoort aan hul onderskeie eienaars. MousePlayer het geen sakeverhouding met hierdie verskaffers nie.