Your AI Connector Docs

Click-to-WhatsApp-mainosattribuutio

Jos käytät Metan (Facebook/Instagram) “Click to WhatsApp” -mainoksia, Your AI Connector voi kertoa, mistä mainoksesta kukin WhatsApp-liidi on tullut — ja antaa sinulle Meta-klikkaustunnisteen, jota tarvitset todellisten konversioiden raportoimiseen takaisin Metalle. Tämän avulla mainoskampanjasi voivat optimoida todellisten myyntien ja varausten perusteella, eivät vain “keskustelun aloittaneiden” perusteella.

Ohjaatko mainoksia omalla verkkosivustollasi olevalle sivulle, jossa on WhatsApp-painike? Katso Mainosklikkausten attribuutio WhatsAppille.


Mitä tietoja tallennetaan

Kun joku napauttaa Click-to-WhatsApp-mainosta ja lähettää viestin yrityksellesi, Meta liittää piilotetut viittaustiedot kyseiseen ensimmäiseen viestiin. Your AI Connector lukee ne automaattisesti ja tallentaa ne yhteystietoon. Ei vaadi asennusta tai konfigurointia — se tapahtuu itsestään.

Tallennetut tiedot tallennetaan yhteystietoon muodossa ad_referral ja ne sisältävät:

Kenttä Kuvaus
ctwa_clid Metan klikkaustunniste. Tämä on arvo, jonka lähetät Metan Conversions API -rajapintaan, jotta voit kohdistaa jatkotoimenpiteen (konversion) tarkalleen oikeaan mainosklikkaukseen. Tyhjä orgaanisten julkaisujen viittauksille (katso alta).
source_id Sen mainoksen (tai julkaisun) tunnus, jota henkilö klikkasi.
source_type Joko ad (maksullinen Click-to-WhatsApp-mainos) tai post (orgaaninen Facebook/Instagram-julkaisu).
source_url Mainossisältöön liittyvä linkki.
headline Mainoksen otsikkoteksti.
body Mainoksen leipäteksti.
channel Kanava, jota kautta viittaus saapui: whatsapp, instagram tai messenger.
captured_at Aika, jolloin viittaus kirjattiin ensimmäisen kerran yhteystiedolle.

Näet sen ilman mitään asetuksia: yhteystiedon sivulla näkyy Tuli mainoksesta -merkintä nimen alla (vie hiiri sen päälle nähdäksesi mainoksen tiedot), se näkyy myös chatin vieressä olevassa yhteystietopaneelissa, ja yhteystiedon toimintaloki alkaa mainoksen klikkauksella. Voit lukea tiedon myös webhookien ja API:n kautta (katso alta). Se ei ole sarake Yhteystiedot-taulukossa.

Yksi asia, jota hyötykuorma ei kerro: mihin numeroosi keskustelu tuli. Siinä ei ole sivun tunnusta (page id) tai WhatsApp Business -tilin tunnusta. Yhdellä numerolla tällä ei ole merkitystä; jos käytät useita numeroita eri Facebook-sivuilla, sinun on määritettävä tämä omalla puolellasi.


Liidit, jotka saapuvat ilman puhelinnumeroa

Joidenkin mainoksen kautta viestivien henkilöiden puhelinnumero on piilotettu WhatsAppissa. Tällöin Meta luovuttaa numeron sijasta henkilölle yksityisen tunnisteen, ja yhteystieto luodaan tyhjällä puhelinkentällä. Tämä on odotettua. Vastaukset, tekoälyn vastaukset ja automaattiset jatkotoimenpiteet tavoittavat henkilön edelleen, koska Your AI Connector käyttää kyseistä tunnistetta heidän tavoittamiseensa.

Jätä tällaisen yhteystiedon puhelinkenttä tyhjäksi. Älä kirjoita siihen omaa yritysnumeroasi: viestiä ei voi lähettää numerosta itseensä, joten seuraava automaattinen jatkotoimenpide epäonnistuisi ja yhteystieto keskeytettäisiin. Your AI Connector estää nykyään oman yhdistetyn numerosi tallentamisen yhteystiedon puhelinnumeroksi. Jos henkilö jakaa numeronsa myöhemmin tai viestii sinulle uudelleen numeron ollessa näkyvissä, se täytetään automaattisesti.


Mitä yhteyttä tämä koskee

Tämä toimii vain virallisella WhatsApp API -yhteydellä. Meta toimittaa jäsennellyt viittaustiedot (mukaan lukien ctwa_clid) vain virallisen WhatsApp Business API:n kautta. Epävirallinen WhatsApp (web) -yhteys ei vastaanota niitä – kyseisessä yhteydessä ei ole saatavilla mainoksen klikkaustietoja sen toimintaperiaatteen vuoksi.

Joten jos suljetun silmukan mainosattribuutio on sinulle tärkeää, käytä Click-to-WhatsApp-kampanjoitasi numerolla, joka on yhdistetty virallisen WhatsApp API:n kautta.


Click-to-Instagram- ja Click-to-Messenger-mainokset

Mainokset, jotka avaavat Instagram DM-viestin tai Messenger-keskustelun, kirjataan samalla tavalla sille Facebook-sivulle ja Instagram-tilille, jotka yhdistit Instagram & Messenger -kortilla. Kun joku aloittaa keskustelun yhdestä näistä mainoksista, yhteystiedolle tallentuu ad_referral, jossa channel on instagram tai messenger, source_type on ad ja source_id on mainoksen tunnus. Tämän avulla näet kunkin yhteystiedon taustalla olevan mainoksen, joten voit laskea varauskohtaiset kustannukset mainoksittain.

Muutamia eroja WhatsAppiin verrattuna:

  • ctwa_clid ei ole olemassa; kyseinen kenttä on tyhjä. Meta antaa kyseisen klikkaustunnisteen vain WhatsAppille.
  • headline on mainoksen otsikko silloin, kun Meta lähettää sen, ja source_url on mainoksen kuva- tai videolinkki, jos sellainen on olemassa. body on tyhjä.
  • Jos yhteyshenkilö tuli alun perin yhden mainoksen kautta ja aloittaa myöhemmin keskustelun toisesta mainoksesta, ad_referral näyttää uudemman mainoksen.
  • Messenger-mainosten kautta tulleet yhteyshenkilöt sisältävät tiedon mainoksesta 14. lokakuuta 2026 alkaen. Sitä ennen Messenger-mainosten kautta tulleilla yhteyshenkilöillä ei ole ad_referral-tietoa, koska mainostietoja ei tuolloin tallennettu eikä niitä voi täydentää jälkikäteen.
  • Messenger-keskusteluja, jotka alkavat napauttamalla sivun Aloita-painiketta, ei tallenneta. Poista Aloita-painike sivultasi (Meta Business Suite, Saapuneet-asetukset), jotta ihmiset aloittavat keskustelun kirjoittamalla, jolloin mainos tallentuu heidän ensimmäisessä viestissään.

Ensimmäisen kosketuspisteen toiminta

Viittaus tallennetaan ensimmäisessä viestissä, jonka yhteystieto lähettää mainoksesta. Jos sama yhteystieto klikkaa myöhemmin toista mainosta ja kyseinen uudempi klikkaus sisältää klikkaustunnisteen, tallennettu ad_referral päivitetään, jotta klikkaustunniste pysyy ajantasaisena raportointia varten. Orgaaniset julkaisuviittaukset (joilla ei ole ctwa_clid-tunnusta) eivät koskaan korvaa aiemmin tallennettua maksullisen mainoksen klikkaustunnistetta.


Tietojen vieminen Meta- tai Google-mainoksiin

Your AI Connector kerää attribuutiodatan ja tuo sen näkyviin. Mainoksille, jotka ohjaavat ihmiset ensin omalle verkkosivustollesi, Your AI Connector voi lähettää tulokset Metalle puolestasi, kun tunniste on lisätty: katso Lähetä tulokset Metalle. Click-to-WhatsApp-mainosten kohdalla välität datan käyttämällä webhookeja ja automaatiotyökalua.

ad_referral-objekti sisältyy lähtevien webhook-tapahtumien contact-osioon (esimerkiksi uusi viesti, yhteystieto jatkettu, yhteystietotunnisteet päivitetty ja analytiikkatapahtumat, kuten varattu tapaaminen).

Tyypillinen suljetun silmukan asennus:

  1. Liidi klikkaa Click-to-WhatsApp-mainostasi ja lähettää sinulle viestin. Your AI Connector tallentaa ad_referral (mukaan lukien ctwa_clid) yhteystietoon.
  2. Kun liidi etenee — varaa puhelun, hänestä tulee asiakas tai hänet menetetään — merkitset kyseisen lopputuloksen (katso “Suppilovaiheen siirtäminen” alla).
  3. Webhook laukeaa automaatiotyökaluusi (Zapier, Make tai Pabbly) välittäen sekä lopputuloksen että yhteystiedon ctwa_clid.
  4. Automaatiotyökalusi kutsuu Metan Conversions API:a (käyttäen action_source = business_messaging ja ctwa_clid) tai Google Adsia (Offline Conversion Import / Enhanced Conversions for Leads) konversion raportoimiseksi.

Tällä tavoin Meta ja Google oppivat, mitkä mainokset tuottivat todellisia tuloksia, ja optimoivat niitä kohti.


Suppilovaiheen siirtäminen

Konversion raportoimiseksi tarvitset yleensä kaksi asiaa: klikkaustunnisteen (joka tallennetaan automaattisesti) ja tuloksen (jonka määrität itse). Luotettavin tapa liittää tulos on käyttää tunnisteita (tags), sillä tunnisteen lisääminen laukaisee contact_tags_updated-webhookin – ja kyseinen hyötykuorma sisältää yhteyshenkilön ad_referral-tiedot. (Tunnisteen poistaminen ei laukaise sitä; katso Yhteyshenkilön tunnisteet päivitetty.)

Voit lisätä tunnisteita automaattisesti:

  • Anna tekoälyagenttisi merkitä yhteystieto tunnisteella keskustelun aikana – määritä automaattiset tunnisteiden säännöt agentin asetuksista. Näin “yksi aloitussivu per mainos → yksi aloitusviesti → yksi tunniste” -malli toimii, jos haluat merkitä lähteen itse.
  • Tai lisää tunniste manuaalisesti Keskustelut- tai Yhteystiedot-sivulta.

Aina kun asiaankuuluva tunniste muuttuu, webhook laukeaa ja sisältää klikkaustunnisteen, joka on valmis välitettäväksi konversiona.

Webhook-URL määritetään itse tunnisteessa, sen tekoälyagentin muokkaimen Tunnisteet-välilehdellä, johon yhteyshenkilö on määritetty, ei asetuksissa. Jokainen tunniste saa oman URL-osoitteensa, ja ne voivat kaikki osoittaa samaan päätepisteeseen, jos haluat yhden paikan vastaanottavan kaiken.

Jo ohitetun klikkaustunnuksen lukeminen

ad_referral palautetaan myös API:n toimesta sekä GET /v1/contacts/{id}- (muodossa adReferral) että yhteyshenkilöluettelon päätepisteessä (muodossa ad_referral), joten jos vastaanottimesi oli alhaalla tai teet täsmäytystä jälkikäteen, voit lukea klikkaustunnuksen takaisin sen sijaan, että odottaisit seuraavaa webhookia. Yhteyshenkilöillä, jotka saapuivat ennen kuin klikkaustunnus tallennettiin heille, on tässä null – arvo voidaan kaapata vain itse saapuvasta viestistä, joten sitä ei voi täyttää takautuvasti.


Rajoitukset

  • Vain virallinen WhatsApp API -yhteys (ei epävirallinen selainyhteys).
  • Sisäänrakennettu Lähetä tulokset Metalle lähettää verkkosivuston skriptin tallentaman klikkausdatan; se ei lähetä Click-to-WhatsApp-mainosten ctwa_clid-tietoja. Niitä sekä Google Adsia varten välität datan Zapierin/Maken/Pabblyn kautta. Jos haluat natiivi-integraation, ilmoita siitä tuelle osoitteessa hi@youraiconnector.com.
  • Attribuutio kerätään tästä hetkestä eteenpäin, kun tämä on käytössä. Sitä ei voi lisätä jälkikäteen keskusteluihin, jotka tapahtuivat aiemmin.

Seuraavat vaiheet