Konversio-API:t
Raportoi tavoitteet Metalle, LinkedInille, TikTokille ja Google Adsille palvelimeltamme selaimen sijaan — yhdistettynä vain verkoston itse asettamaan klikkaustunnisteeseen.
1. Miksi palvelinpuoli?
Selainpikselin on selvittävä kolmesta asiasta ennen konversion raportointia: mainosesto, seurannan esto ja välilehden sulkeminen ennen pikselin laukeamista. Palvelinkutsu selviää kaikista, koska se ei tapahdu selaimessa lainkaan.
MousePlayer tietää jo tavoitteen saavuttamisesta — sitä varten tavoitteet ovat. Konversio-API:t vain välittävät tiedon mainosverkostolle palvelimeltamme.
Tämä ei korvaa pikseliä. Säilytä se. Jokainen verkosto poistaa kahden reitin kaksoiskappaleet, ja lähetämme siihen tarvittavat tunnisteet.
2. Mitä lähetämme ja mitä emme koskaan
Kävijän yksilöi näissä kutsuissa vain verkoston itse asettama eväste tai klikkaustunniste. Mitään muuta henkilötietoa ei poistu palvelimelta.
| Verkosto | Käytetty tunniste | Lähde |
|---|---|---|
| Meta | _fbp, _fbc | Meta-pikselin asettamat ensimmäisen osapuolen evästeet |
li_fat_id | LinkedIn Insight Tagin asettama ensimmäisen osapuolen eväste | |
| TikTok | _ttp, ttclid | _ttp on eväste, ttclid tulee mainosklikkauksen URL-osoitteesta |
| Google Ads | gclid, wbraid, gbraid | Mainosklikkauksen URL-osoitteesta tai myöhemmin evästeestä _gcl_aw. |
| Microsoft Advertising | msclkid | Mainosklikkauksen URL-osoitteesta tai UET-tunnisteen kirjoittamasta evästeestä _uetmsclkid. |
Ei koskaan lähetetä: sähköpostia, puhelinnumeroa, nimeä tai IP-osoitetta — ei edes tiivisteenä. Ilman klikkaustunnistetta ei lähetetä mitään. Kohdistamaton konversio on vähemmän hyödyllinen kuin tarkka laskenta.
Vain suostumuksella
Jokainen kutsu on saman suostumusportin takana kuin itse tallennus. Ilman suostumusta istunto ei tuota konversioraporttia projektin kytkimen tilasta riippumatta.
3. Google Adsilla on kolme tunnistetta, ei yksi
Tämä yllättää, joten sanomme sen suoraan. Google käyttää tunnistetta gclid yksittäiselle mainosklikkaukselle. Kun Applen seurannanesto estää yksittäisen klikkauksen kohdistamisen, Google lähettää wbraid tai gbraid, jotka edustavat klikkausryhmää.
Kolme tunnistetta sulkevat toisensa pois — Google hylkää kaksi sisältävän konversion. Lähetämme täsmälleen yhden, ja gclid voittaa useamman ollessa saatavilla, koska se on tarkin.
Ne ovat URL-osoitteessa vain kerran
Tunniste näkyy osoitteessa vain mainosklikkauksen jälkeisellä ensimmäisellä sivulla. Google-tunniste tallentaa sen sitten evästeeseen _gcl_aw. Luemme evästeen varavaihtoehtona — ilman sitä käynnin kolmannen sivun konversio ei löytäisi tunnistetta.
4. Määritys
Meta, LinkedIn ja TikTok
Kaksi kenttää kullekin: pikselin tai konversiosäännön tunnus ja verkoston omassa käyttöliittymässä luotu käyttötunnus. Molemmat säilytetään AES-256-GCM-salattuina eikä niitä näytetä tallennuksen jälkeen uudelleen.
Google Ads tarvitsee kuusi
Google on poikkeus, ja syy kannattaa tuntea ennen aloittamista: toisin kuin kolme muuta, se ei anna yksinkertaista käyttötunnusta. Pääsy toimii OAuthilla ja päivitystunnuksella, ja Ads API vaatii lisäksi kehittäjätunnuksen.
| Kenttä | Mistä löytyy |
|---|---|
| Asiakastunnus | Google Adsin oikeasta yläkulmasta. Vain numerot ilman viivoja. |
| Konversiotoiminnon tunnus | Tavoitteet ja konversiot, sitten toiminto, johon tämä kirjataan. |
| Kehittäjätunnus | Google Ads -hallinnoijatilin API-keskus. |
| OAuth-asiakastunnus ja salaisuus | Google Cloud Console, Tunnistetiedot, OAuth-asiakas tyyppiä ”työpöytäsovellus”. |
| Päivitystunnus | Luo itse kerran laajuudelle adwords. |
LinkedInissä on kaksi reittiä, ja lyhyt riittää
Campaign Managerissa: Data, Signals Manager, Direct API, Luo käyttötunnus. Tämä on omia tietoja lähettävien mainostajien reitti — ei kehittäjäsovellusta tai arviointia. Tunnus ei vanhene, eikä Campaign Manager näytä sitä toiste, joten kopioi heti.
Toinen reitti, LinkedInin Developer Portalin kautta haettava kehittäjäsovellus, on useiden mainostajien puolesta lähettäville alustoille. Se vaatii yrityssivun varmistuksen ja hyväksytyn käyttötapauksen, eikä niitä tarvita tässä.
Microsoft Advertising on helppo
Google Adsin jälkeen odottaa samaa raskautta — OAuth, kehittäjätunnus, hyväksyntä. Tässä päinvastoin: kaksi kenttää. Selaimessa jo käytettävän UET-tunnisteen tunnus ja Microsoft Advertisingista sen kohdalta kopioitava tunnus: ”Käytä Conversions API:a”, ”Kopioi tunnus”. Mitään ei tarvitse hakea.
Käytä samaa tunnistetta kuin selaimessa. Sillä Microsoft tunnistaa palvelin- ja selaintapahtuman yhdeksi konversioksi kahden sijaan.
Kehittäjätunnus tarvitsee Googlen hyväksynnän (”Perustason käyttöoikeus”), ja se vie muutaman päivän. Tämä on ainoa vaihe, joka ei valmistu minuutissa, joten aloita siitä. Emme koskaan näe Google-salasanaa — vain päivitystunnuksen, jonka voi perua milloin tahansa.
5. Milloin konversio raportoidaan
Täsmälleen kerran tavoitetta ja istuntoa kohti. MousePlayer poistaa toistot ennen lähetystä, ja tietosisällössä on lisäksi tunnus, jolla verkosto voi tehdä saman puolellaan. Viisi tuotetta ostoskoriin lisäävä kävijä tuottaa yhden konversion, ei viittä.
Mitä mainostilillä näkyy
Konversio sisältää tavoitteen nimen, arvon ja valuutan, jos asetettu, sekä ajankohdan. Normaalisti se saapuu minuutissa.
Jos mitään ei saavu
- Ei klikkaustunnistetta. Kävijä ei saapunut verkoston mainoksesta tai tuli ennen pikselin evästettä. Mitään ei lähetetä — odotettua, ei virhe.
- Ei suostumusta. Suostumusportti oli ensin.
- Verkosto hyväksyi kutsun mutta hylkäsi konversion. Google, TikTok ja useat muut vastaavat HTTP 200 -tilalla ja virheellä vastaussisällössä. Luemme sisällön, emme vain tilaa, ja syy näkyy toimituslokissa.
Kaikki tässä mainitut tavaramerkit kuuluvat omistajilleen. MousePlayerilla ei ole liikesuhdetta näihin toimittajiin.