DM Champ Docs

Mainosklikkausten attribuutio WhatsAppille

Jos ohjaat Meta- tai Google-mainoksia omalla verkkosivustollasi olevalle sivulle, jolla on WhatsApp-painike, DM Champ 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.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>
  1. 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ä.
  2. Valitse tiedustelunumeron sanamuoto (katso alta) ja napsauta Tallenna. Sinun ei tarvitse muuttaa verkkosivustosi skriptiä asetusten muuttamisen jälkeen.
  3. 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.

Toimistot: jokaisella asiakastilillä on oma sivustoavain ja skripti, joten kunkin asiakkaan verkkosivusto raportoi omaan tiliinsä. Voit piilottaa asiakkaan osion valikon näkyvyysasetuksista, kuten minkä tahansa muun asetusosion.

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ä DM Champ-palveluun ennen napautusta.

Tiedustelunumero

Lyhyt numero, kuten kaupan tai klinikan antama viitenumero, lisätään kävijän WhatsApp-viestiin. Sen avulla DM Champ 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.dmchamp.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 DM Champ lisää vierailun saapuessa

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, DM Champ 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ä.

Rajoitukset:

  • Ensimmäinen osuma voittaa. Kun yhteystiedolla on osuma, sitä ei koskaan ylikirjoiteta.
  • Vain WhatsApp: WhatsApp Business API ja WhatsApp Web -kanavat.
  • 15 minuuttia: kävijää, joka napauttaa painiketta mutta lähettää viestin paljon myöhemmin, ei täsmäytetä.
  • Vain tästä eteenpäin: ennen skriptin asentamista tulleilla yhteystiedoilla ei ole osumaa.

Missä näet sen

  • Yhteystietopaneeli: Tuli mainosklikkauksesta kampanjan tai lähteen sekä päivämäärän kera. Vie hiiri päälle nähdäksesi tiedot.
  • Webhooks: contact.ad_attribution agenttitunnisteiden webhookeissa 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 yhteystiedossa, jonka ne palauttavat.

Arvo on null, kun yhteystiedolla ei ole osumaa.

Kenttä Mitä se tarkoittaa
visit_at Kun kävijä napautti WhatsApp-painiketta.
matched_at Kun vierailu täsmäytettiin yhteystietoon.
match_method reference (täsmäytetty kyselynumerolla) tai text (täsmäytetty identtisellä viestitekstillä).
reference Kyselynumero tai null, kun se oli pois päältä.
fbc / fbp Meta-klikkaus ja selainevästeet omasta Meta-pikselistäsi, jos ne ovat olemassa.
fbclid Meta-mainoksen klikkaustunniste sivun osoitteesta.
gclid / gbraid / wbraid Google-mainoksen klikkaustunnisteet sivun osoitteesta.
utm_source / utm_medium / utm_campaign / utm_content / utm_term Kampanjatunnisteet sivun osoitteesta.
landing_url Sivu, jolle kävijä saapui.
referrer Sivu, jolta kävijä tuli.
client_ip Kävijän IP-osoite.
user_agent Kävijän selain.
site_key Vierailun tallentaneen skriptin sivustoavain.
visit_id Vierailutietueen tunniste.

Lähetä tulokset Metaan (valinnainen)

Voit antaa DM Champ-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 (kutsutaan myös tietojoukoksi) tunnus kohdasta Tietolähteet ja luo pääsytunniste kohdassa Asetukset, Conversions API, Luo pääsytunniste.
  2. Kohdassa Asetukset → Mainosklikkausten seuranta, kohdassa Lähetä tulokset Metaan (valinnainen), syötä Pikselin / tietojoukon tunnus ja Pääsytunniste. Testauksen aikana voit lisätä Testitapahtumakoodin Metan Testitapahtumat-välilehdeltä; tyhjennä se, kun olet valmis. Napsauta Tallenna Meta-tiedot.
  3. Avaa agenttieditori, siirry Tunnisteet-välilehdelle ja avaa tunniste. Valitse kohdassa Lähetä Metaan tapahtuma: Liidi, Yhteystieto, Aika, Osto tai mukautettu nimi. Lisää halutessasi arvo ja valuutta.

Tästä eteenpäin aina, kun kyseinen tunniste lisätään yhteystietoon (tekoälyn, käsin, API:n tai automaation kautta), DM Champ lähettää tapahtuman Metaan yhteystiedon tallennetuilla klikkaustiedoilla (fbc, fbp, IP-osoite, selain, aloitussivu) sekä heidän puhelinnumerollaan, sähköpostillaan ja nimellään tiivistettynä, jotta Meta voi yhdistää sen mainokseen. Yhteystieto ilman osumaa lähettää silti tapahtuman, mutta vain tiivistetyllä puhelinnumerolla, sähköpostilla ja nimellä.

  • Ei kaksinkertaista laskentaa: jokaisella tapahtumalla on kiinteä tunniste, joka koostuu yhteystiedon tunnisteesta ja tunnisteen nimestä. Jos CRM-järjestelmäsi lähettää saman tapahtuman Metaan samalla tunnisteella, Meta säilyttää vain yhden.
  • Metan attribuutioikkuna: Meta hyvittää tapahtuman mainokselle vain attribuutioikkunansa sisällä, joka on oletuksena 7 päivää klikkauksesta. Kauppa, joka solmitaan viikkoja myöhemmin, ei lasketa sellaisenaan, joten lähetä myös aiempi tapahtuma, esimerkiksi tunniste varatusta tai maksetusta konsultaatiosta.

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.