Mainosklikkausten attribuutio WhatsAppille #

Jos ohjaat Meta- tai Google-mainoksia omalla verkkosivustollasi olevalle sivulle, jolla on WhatsApp-painike, Your AI Connector voi kertoa, mistä mainosklikauksesta kukin WhatsApp-keskustelu on peräisin. Lisäät verkkosivustollesi pienen skriptin. Kun kävijä napauttaa WhatsApp-painikettasi, klikkaus tallennetaan ja yhdistetään ensimmäiseen viestiin, jonka hän lähettää sinulle. Yhteystiedossa näkyy sen jälkeen kampanja, josta se on peräisin, ja klikkaustiedot siirtyvät yhteystiedon mukana webhookeihin, API-rajapintaan ja halutessasi takaisin Metaan.

Tämä toimii millä tahansa sivulla, jossa on WhatsApp-painike: aloitussivulla, varaussivulla, hinnastosivulla tai kyselyssä, joka päättyy “Lähetä vastaukseni WhatsAppissa” -painikkeeseen.

Tämä sivu käsittelee mainoksia, jotka ohjaavat ihmiset ensin verkkosivustollesi. Jos mainoksesi avaavat WhatsAppin suoraan (Metan “Click to WhatsApp” -mainokset), se käsitellään automaattisesti ilman skriptiä kohdassa Click-to-WhatsApp-mainosten attribuutio.

Käyttöönotto #

1. Siirry kohtaan Asetukset → Mainosklikkausten seuranta (Integraatiot-ryhmä).
2. Napsauta Ota käyttöön ja hae skriptini. Tilisi saa oman sivustoavaimen ja yksirivisen skriptin.
3. Kopioi skripti ja liitä se juuri ennen sulkevaa </body>-tunnistetta jokaisella sivulla, jossa on WhatsApp-painike:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. Valinnainen: kirjoita WhatsApp-numero-kenttään numero, johon painikkeesi linkittävät. Tällöin seurataan vain kyseiseen numeroon johtavia linkkejä. Jätä kenttä tyhjäksi, jos haluat seurata kaikkia sivuston WhatsApp-linkkejä.
5. Valitse tiedustelunumeron sanamuoto (katso alta) ja napsauta Tallenna. Sinun ei tarvitse muuttaa verkkosivustosi skriptiä asetusten muuttamisen jälkeen.
6. Testaa se: avaa sivusi linkistä, jossa on kampanjatunniste, esimerkiksi https://yoursite.com/?utm_source=test&utm_campaign=setup-check, napauta omaa WhatsApp-painikettasi ja lähetä viesti. Avaa kyseinen yhteystieto Chats-näkymässä: yhteystietopaneelissa näkyy Peräisin mainosklikauksesta ja kampanjan nimi.

Sivustoavain on jo skriptin sisällä. Se ei ole salasana, joten se on turvallista pitää julkisella sivulla.

Mitä skripti tekee #

• Kun sivu latautuu, se säilyttää mainosklikkausten tunnisteet ja kampanjatunnisteet (osoitteen utm_-parametrit) selaimen välilehden istuntotallennustilassa, jotta ne ovat tallella, vaikka kävijä katsoisi ensin toista sivua. Se ei aseta evästeitä, lataa mitään muuta eikä lähetä mitään.
• Kun kävijä napauttaa WhatsApp-linkkiä (wa.me, api.whatsapp.com/send tai whatsapp://send), se lisää tiedustelunumeron viestiin, tallentaa käynnin ja antaa napautuksen jatkua WhatsAppiin normaalisti.

Mitään ei lähetetä Your AI Connector-palveluun ennen napautusta.

Tiedustelunumero #

Lyhyt numero, kuten kaupan tai klinikan antama viitenumero, lisätään kävijän WhatsApp-viestiin. Sen avulla Your AI Connector tietää tarkalleen, mikä mainosklikkaus kuuluu mihinkin keskusteluun. Viesti näyttää tältä:

Hi, I would like to know more.
Enquiry no. 4827

• Sanamuoto: “Tiedustelunro” on oletusarvo. Voit käyttää mitä tahansa yksirivistä tekstiä, joka kuulostaa luonnolliselta yrityksellesi, kuten “Varausviite” tai “Viite”. Ei numeroita.
• Sijainti: Omalla viimeisellä rivillään (oletus) tai Tekstin lopussa. Asetussivu näyttää reaaliaikaisen esikatselun.
• Pituus: 4 numeroa tai 5, jos sivustollasi on paljon liikennettä.
• Tekoälyagenttisi ei koskaan näe sitä eikä koskaan toista sitä. Saapuneet-kansiossa näkyy koko viesti numero mukaan lukien.

Voit kytkeä kyselynumeron pois päältä. Tällöin täsmäytys toimii vain viestin tekstin perusteella, joten kahta vierailijaa, jotka lähettävät täsmälleen saman tekstin (esimerkiksi samat tietovisan vastaukset), ei voida erottaa toisistaan, eikä kaikkia klikkauksia voida täsmäyttää.

Oma tietovisa- tai painikekoodisi #

Jos sivusi muodostaa WhatsApp-viestin itse (tietovisa, joka lisää vastaukset tekstiin, tai oma painikekoodisi), lisää data-manual script-tunnisteeseen:

<script src="https://api.youraiconnector.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>

Kun käytössä on data-manual, skripti ei enää muuta WhatsApp-linkkejä itsestään. Oma koodisi kutsuu sitä juuri ennen WhatsAppin avaamista, joten jokainen vierailu kirjataan kerran:

• window.ChatAttribution.text(finalText, number) palauttaa tekstisi lisättynä kyselynumerolla ja kirjaa vierailun. Käytä palautettua tekstiä WhatsApp-linkissäsi.
• window.ChatAttribution.link(finalText, number) tekee saman ja palauttaa valmiin wa.me-linkin kyseisellä tekstillä. Jätä numero pois, jos haluat käyttää asetuksissa kohdassa WhatsApp-numero määritettyä numeroa.

<script>
  function sendAnswers(answers) {
    var text = "Hi, my answers: " + answers.join(", ");
    if (window.ChatAttribution) {
      window.location.href = window.ChatAttribution.link(text, "+15551234567");
    } else {
      window.location.href = "https://wa.me/15551234567?text=" + encodeURIComponent(text);
    }
  }
</script>

else-haara pitää painikkeen toiminnassa, vaikka skripti ei olisi latautunut, esimerkiksi jos selainlaajennus estää sen. Tekstiä, joka sisältää jo skriptin antaman numeron, ei koskaan muuteta toista kertaa.

Mitä kirjataan #

Napautushetkellä vierailutieto sisältää:

• mainosklikkausten tunnisteet sivun osoitteessa, kuten fbclid (Meta) ja gclid (Google)
• _fbc- ja _fbp-evästeet, jos oma Meta-pikselisi on asettanut ne sivustollasi (skripti lukee ne, se ei koskaan aseta niitä)
• kampanjatunnisteet (utm_source, utm_medium, utm_campaign, utm_content, utm_term)
• aloitussivun, sivun jolta vierailija tuli, selaimen ja viestin tekstin
• IP-osoitteen ja ajan, jotka Your AI Connector lisää vierailun saapuessa

Kun käynti täsmäytetään, Your AI Connector selvittää kyseisestä datasta myös karkeasti, missä kävijä oli (kaupunki ja maa, arvioitu IP-osoitteen perusteella) ja mitä laitetta hän käytti (puhelin, tabletti tai tietokone, käyttöjärjestelmä ja selain, esimerkiksi Instagramin sovelluksen sisäinen selain). Sijainti jää tyhjäksi, kun sitä ei voida selvittää, mikä on yleistä mobiiliverkoissa.

Vierailutietoja säilytetään 90 päivää. Kun vierailu täsmäytetään, kopio sen klikkaustiedoista tallennetaan yhteystietoon ja se säilyy yhteystiedon mukana, kunnes poistat sen.

Tietosuojaseloste: skripti toimii verkkosivustollasi, joten sivustosi tietosuojaselosteessa tulisi mainita se: mitä se kirjaa (yllä oleva luettelo) ja että se tekee niin, kun vierailija napauttaa WhatsApp-painiketta.

Miten täsmäytys toimii #

Kun yhteystiedon ensimmäinen viesti saapuu, Your AI Connector etsii vierailua, joka on tapahtunut 15 minuutin sisällä sitä ennen:

1. Ensin kyselynumeron perusteella. Viesti, joka sisältää skriptin antaman numeron, täsmäytetään kyseiseen vierailuun.
2. Muussa tapauksessa identtisen tekstin perusteella. Viesti, jossa on täsmälleen sama teksti kuin vierailussa, täsmäytetään siihen. Kun kaksi eri vierailijaa lähettää saman tekstin kyseisen aikaikkunan sisällä, kumpaakaan ei täsmäytetä tarkoituksella, jotta yhteystietoa ei koskaan liitetä väärään mainokseen.

Myöhempi viesti, joka sisältää kyselynumeron, täsmäytetään myös, kunhan yhteystiedolla ei ole vielä täsmäytystä.

Kun yhteyshenkilö, jolla on jo vastaavuus, palaa toisen mainoksen kautta ja lähettää viestin, joka sisältää uudemman tiedustelunumeron, kyseinen klikkaus säilytetään yhteyshenkilön uusimpana klikkauksena. Ensimmäinen vastaavuus pysyy ennallaan.

• Ensimmäinen klikkaus, raportointia varten: yhteyshenkilö näyttää edelleen, mistä liidi alun perin tuli. Se ei koskaan muutu.
• Viimeisin klikkaus, Metaa varten: Metalle lähetetyt tapahtumat käyttävät uusinta klikkausta, koska Meta hyvittää mainoksen, joka toi henkilön takaisin, ja vain sen attribuutioikkunan sisällä. Vanhan klikkauksen raportointi hyvittäisi väärää mainosta tai ei mitään.
• Viimeisin klikkaus otetaan vain tiedustelunumerosta, ei koskaan pelkästä vastaavasta tekstistä, eikä vanhempi vierailu koskaan korvaa uudempaa.

Rajoitukset:

• Ensimmäistä vastaavuutta ei koskaan ylikirjoiteta. Uudemmat klikkaukset menevät viimeisimpään klikkaukseen.
• Vain WhatsApp: WhatsApp Business API ja WhatsApp Web -kanavat.
• 15 minuuttia: vierailijaa, joka napauttaa painiketta mutta lähettää viestin paljon myöhemmin, ei yhdistetä.
• Vain tästä eteenpäin: ennen skriptin asentamista tulleilla yhteyshenkilöillä ei ole vastaavuutta.

Missä näet sen #

• Yhteystietopaneeli: Tuli mainosklikkauksesta kampanjan tai lähteen sekä ensimmäisen klikkauksen päivämäärän kera. Vie hiiri tiedon päälle nähdäksesi yksityiskohdat: kampanja, Mainos (utm_content) ja Mainosjoukko (utm_term), arvioitu Sijainti ja Laite, kukin vain silloin kun se on tiedossa, sekä sama viimeisimmän klikkauksen osalta, jos sellainen on olemassa. Kampanjatunnisteita, joita ei koskaan täytetty (mainoksen esikatselun napautus lähettää tunnistemallin nimien sijaan), ei näytetä. Käynti lasketaan mainosklikkaukseksi vain, kun sivu avattiin mainoslinkistä (Meta- tai Google-klikkaustunniste tai kampanjatunnisteet). Jokainen, joka päätyi sivulle muuta kautta, esimerkiksi Google-hausta, kirjoittamalla osoitteen tai klikkaamalla sivustosi kautta, näyttää Tuli verkkosivustoltasi ja tiedon siitä, mistä he tulivat, kuten Google-haku, tai Verkkosivukäynti, ei viittaajaa, kun selain ei ilmoittanut sitä.
• Yhteystietosivu: sama rivi näkyy yhteystiedon nimen alla kohdassa Yhteystiedot, joten näet sen heti, myös puhelimellasi. Vie hiiri tai napauta sitä nähdäksesi yksityiskohdat.
• Aktiviteetti: yhteystiedon aikajana alkaa kohdalla Napautti WhatsApp-painikettasi mainoksen jälkeen (tai verkkosivustollasi) klikkaushetkellä, ennen ensimmäistä viestiä. Keskustelun yhteystietopaneeli näyttää saman rivin kohdassa Aktiviteetti.
• Webhookit: contact.ad_attribution kohdassa agentin tunnisteen webhookit ja jokaisessa webhook-tilaustapahtumassa, joka sisältää yhteystiedon.
• API: ad_attribution yhteystietoluettelossa ja adAttribution yksittäisessä yhteystiedossa, API-viitteen Yhteystiedot-osiossa.
• MCP-työkalut: sama objekti jokaisessa palautetussa yhteystiedossa.

Arvo on null, kun yhteyshenkilöllä ei ole vastaavuutta. Alla olevat kentät kuvaavat ensimmäistä klikkausta. Kun myöhempi klikkaus on yhdistetty, latest sisältää sen samoilla kentillä; se puuttuu siihen asti.

Lähetä tulokset Metaan (valinnainen) #

Voit antaa Your AI Connector-palvelun raportoida tulokset takaisin Meta-mainostilillesi, jotta Meta oppii, mitkä mainokset tuovat todellisia liidejä ja myyntiä, ja optimoi niiden mukaan. Tämä käyttää omia Meta Conversions API -tietojasi.

1. Etsi Meta Events Managerissa pikselisi (tunnetaan myös nimellä tietojoukko) tunnus kohdasta Data sources ja luo käyttöoikeustunnus kohdasta Settings, Conversions API, Generate access token.
2. Syötä kohdassa Settings → Ad click tracking ja alakohdassa Send results to Meta (optional) Pixel / dataset ID ja Access token. Napsauta Save Meta details.
3. Valinnainen: tarkista yhteys. Avaa pikselisi Meta Events Managerissa ja siirry Test events -välilehdelle, kopioi siellä näkyvä testikoodi, liitä se kohtaan Send a test event ja napsauta Send test event. Painikkeen alapuolella oleva rivi ilmoittaa “Meta received 1 test event” (tarkista tämä Metan Test events -osiosta) tai näyttää Metan syyn hylkäämiselle, kuten väärän tunnuksen. Koodia käytetään vain kyseiseen testiin, eikä sitä tallenneta.
4. Avaa agenttieditori, siirry Tags-välilehdelle ja avaa tunniste. Valitse kohdassa Send to Meta tapahtuma: Lead, Contact, Schedule, Purchase tai mukautettu nimi. Lisää halutessasi arvo ja valuutta.

Siitä eteenpäin, aina kun kyseinen tunniste lisätään yhteyshenkilöön (tekoälyn, käsin, API:n tai automaation kautta), Your AI Connector lähettää tapahtuman Metalle yhteyshenkilön uusimmilla klikkaustiedoilla (fbc, fbp, IP-osoite, selain, aloitussivu, viimeisimmästä klikkauksesta, jos sellainen on, muuten ensimmäisestä) sekä heidän puhelinnumeronsa, sähköpostinsa ja nimensä tiivistettynä (hashed), jotta Meta voi yhdistää sen mainokseen. Yhteyshenkilö ilman vastaavuutta lähettää silti tapahtuman, vain tiivistetyllä puhelinnumerolla, sähköpostilla ja nimellä.

• Live-tapahtumat lasketaan aina: testitapahtumakoodia ei koskaan tallenneta Metan tietojesi yhteyteen, joten tunnisteidesi ja automaatioidesi lähettämät tapahtumat menevät aina Metan todelliseen dataasi, eivät koskaan Test events -välilehdelle.
• Ei kaksinkertaista laskentaa: jokaisella tapahtumalla on kiinteä tunnus, joka muodostuu yhteystiedon tunnuksesta ja tunnisteen nimestä. Jos CRM-järjestelmäsi lähettää saman tapahtuman Metalle samalla tunnuksella, Meta säilyttää vain yhden.
• Metan attribuutioikkuna: Meta hyvittää tapahtuman mainokselle vain sen attribuutioikkunan sisällä, joka on oletuksena 7 päivää klikkauksesta. Kauppa, joka sulkeutuu viikkoja myöhemmin, ei näy sellaisenaan, joten lähetä myös aiempi tapahtuma, esimerkiksi tunniste varatusta tai maksetusta konsultaatiosta.

Lähetä konversioita automaatioista #

Tunniste lähettää tapahtumansa, kun tunniste lisätään. Kun tulos tapahtuu muualla, kuten kaupan sulkeutuessa CRM-järjestelmässäsi tai konsultaation varautuessa, käytä automaatiossa Lähetä konversio Metaan -toimintoa. Se raportoi yhden tapahtuman Meta-tietojoukkoosi Conversions API:n kautta, jotta Meta optimoi mainoksesi todellisten tulosten, ei vain viestien perusteella.

Se käyttää samoja Meta-tietoja kuin tunnisteet: Pikselin / tietojoukon tunnus ja Käyttöoikeustunniste kohdassa Asetukset → Mainosklikkausten seuranta. Ilman näitä vaihe epäonnistuu virheellä “Metaa ei ole yhdistetty”.

Kentät

Täytä vähintään yksi kentistä Yhteystieto, Sähköposti tai Puhelin. Henkilön ei tarvitse olla yhteystieto: HubSpot-kauppa, joka saavuttaa tilan Closed Won, voi lähettää Purchase-tapahtuman kaupan arvolla ja ostajan sähköpostilla.

Kun valitset Yhteystiedon, käytetään heidän puhelinnumeroaan, sähköpostiaan ja nimeään. Jos he tulivat mainosklikkauksesta, jonka skripti tunnisti, myös klikkaustiedot välitetään, mikä auttaa Metaa yhdistämään tapahtuman mainokseen. Sähköposti, puhelinnumero ja nimet tiivistetään (hash) ennen lähettämistä. Klikkaustunnus, IP-osoite ja selain lähetetään Metan vaatimusten mukaisesti.

Tapahtuman tunnus ja tuplalaskenta

Meta laskee saman tapahtuman nimen ja saman Tapahtuman tunnuksen omaavat tapahtumat vain kerran. Käytä kiinteää tunnusta, kuten kaupan tunnusta, kun toinen työkalu raportoi saman konversion tai kun automaatio saattaa suorittua sille kahdesti. Jätä se tyhjäksi, niin uusi tunnus luodaan jokaisella suorituskerralla, jolloin jokainen suoritus lasketaan.

Miten se eroaa tunnisteiden tapahtumista

Tunnisteen Lähetä Metaan -tapahtuma lähetetään kerran yhteystietoa kohden kyseiselle tunnisteelle (enintään kerran 30 päivässä). Tämä toiminto lähettää tiedot joka kerta, kun se suoritetaan. Tapahtuman tunnus estää konversion laskemisen kahdesti.

Esimerkki: suljettu kauppa ja varattu konsultaatio

1. Käynnistä automaatio, joka suoritetaan, kun kauppa on voitettu: Sovellustapahtuma-käynnistin CRM-järjestelmäsi kauppatapahtumalle, jossa on Ehto, jotta vain voitetut kaupat etenevät. HubSpot lähettää kauppavaihetapahtumia vain kehittäjäsovelluksille, joten käytä HubSpotin kohdalla Aikataulu-käynnistintä, HubSpot-hakua edellisen suorituksen jälkeen “Closed Won” -tilaan päätyneille kaupoille sekä Silmukkaa niiden läpikäymiseen.
2. Lisää Lähetä konversio Metaan. Aseta Tapahtuman nimi muotoon Purchase, Arvo kaupan summaksi (lisää se +-painikkeella) ja Valuutta omaksi valuutaksesi. Lisää ostajan sähköpostiosoite kohtaan Sähköposti ja kaupan tunniste kohtaan Tapahtuman ID, jotta samaa kauppaa ei lasketa kahdesti.
3. Varausneuvottelua varten käynnistä toinen automaatio Aika varattu -käynnistimellä ja lisää Lähetä konversio Metaan, jossa Tapahtuman nimi on Schedule ja käynnistimen yhteystieto on kohdassa Yhteystieto. Voit halutessasi lisätä toisen Lähetä konversio Metaan -vaiheen, joka lähettää Purchase-tapahtuman kiinteällä arvolla, kuten neuvottelun hinnalla.

Voit myös lähettää konversion API:n kautta käyttämällä POST https://api.youraiconnector.com/v1/ad-attribution/meta-event. Se käyttää samoja kenttiä snake case -muodossa: event_name, value, currency, contact_id, email, phone, first_name, last_name, external_id, event_id, event_time, event_source_url ja test_event_code.

Usein kysytyt kysymykset #

Toimiiko tämä, jos mainokseni avaa WhatsAppin suoraan? Nämä mainokset eivät kulje verkkosivustosi kautta, joten skripti ei koskaan suoritu. Meta lähettää mainostiedot ensimmäisen viestin mukana, katso Click-to-WhatsApp-mainosten attribuutio.

Hidastaako skripti verkkosivustoani tai asettaako se evästeitä? Se latautuu taustalla (async), ei aseta evästeitä eikä lataa mitään muuta. Se lähettää tietoja vain, kun kävijä napauttaa WhatsApp-painiketta.

Voinko seurata Google Adsia sekä Meta-mainoksia? Kyllä. Googlen klikkaustunnisteet (gclid, gbraid, wbraid) ja kaikki kampanjatunnisteet tallennetaan ja näytetään yhteystiedossa. Tulosten lähettäminen takaisin on käytettävissä vain Metalle.

Miksi yhteystieto ei saanut osumaa? Yleisimmät syyt: viesti saapui yli 15 minuuttia napautuksen jälkeen, kyselynumero poistettiin viestistä, kyselynumero on pois päältä ja toinen kävijä lähetti saman tekstin, tai sivulla ei ole skriptiä.

Verkkosivustoni linkittää kahteen WhatsApp-numeroon. Voinko seurata vain yhtä? Kyllä. Kirjoita kyseinen numero asetusten kohtaan WhatsApp-numero. Jätä se tyhjäksi seurataksesi jokaista WhatsApp-linkkiä.

Voinko muuttaa sanamuotoja myöhemmin? Kyllä. Muutokset tulevat voimaan verkkosivustollasi välittömästi; sinun ei tarvitse liittää skriptiä uudelleen.