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.

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ä Mitä se tarkoittaa
ctwa_clid Meta-klikkaustunniste. Tämä on arvo, jonka lähetät Metan Conversions API:lle, jotta voit kohdistaa jatkokonversion tarkalleen oikeaan mainosklikkaukseen. Tyhjä orgaanisissa julkaisuviittauksissa (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 Mainoksen sisältöön liittyvä linkki.
headline Mainoksen otsikkoteksti.
body Mainoksen leipäteksti.
channel Kanava, jota kautta viittaus saapui (tällä hetkellä aina whatsapp).
captured_at Milloin viittaus tallennettiin ensimmäisen kerran yhteystietoon.

Näet tämän yhteyshenkilön pikakatselupaneelista, jos olet määrittänyt sille mukautetun kentän, tai voit lukea sen suoraan webhookien ja API:n kautta (katso alta) — sitä ei ole eroteltu omaksi nimettynä kentäkseen 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.

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.

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ää attribuutiotiedot ja tuo ne näkyviin, mutta se ei tällä hetkellä lähetä konversioita natiivisti Metalle tai Googlelle puolestasi. Lähetät tiedot eteenpäin 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-osoite asetetaan itse tunnisteeseen, agentin (tai kampanjan), johon yhteyshenkilö kuuluu, Tunnisteet-välilehdellä – ei asetuksissa. Jokainen tunniste saa oman URL-osoitteensa, ja ne voivat kaikki osoittaa samaan päätepisteeseen, jos haluat yhden paikan vastaanottaa 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 web-yhteys).
  • Ei vielä natiivia, yhdellä napsautuksella toimivaa Meta CAPI- tai Google Ads -integraatiota – välität tiedot Zapierin/Maken/Pabblyn kautta. Jos haluat natiivin integraation, ilmoita siitä tuelle osoitteessa hi@youraiconnector.com.
  • Attribuutio tallennetaan tästä hetkestä eteenpäin, heti kun tämä on käytössä. Sitä ei voi lisätä jälkikäteen keskusteluihin, jotka tapahtuivat aiemmin.

Seuraavat vaiheet