# 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](../get-started/creating-contacts.md), 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](webhooks.md)-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](webhooks.md#contact-tags-updated-webhook).) 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 - [Webhooks](webhooks.md) – katso koko hyötykuorma ja mitkä tapahtumat sisältävät `ad_referral`:n. - [Tunnisteiden käyttäminen yhteyshenkilöiden merkitsemiseen](../get-started/creating-tags.md) – määritä tunnisteet, jotka kantavat suppilovaiheitasi.