Annonceklik-attribuering for WhatsApp
Hvis du kører Meta- eller Google-annoncer til en side på dit eget website, og den side har en WhatsApp-knap, kan DM Champ fortælle dig, hvilket annonceklik hver WhatsApp-samtale kom fra. Du indsætter et lille script på dit website. Når en besøgende trykker på din WhatsApp-knap, huskes klikket og matches med den første besked, de sender til dig. Kontakten viser derefter den kampagne, den kom fra, og klikdataene følger med kontakten ind i webhooks, API’et og, hvis du ønsker det, tilbage til Meta.
Dette fungerer for enhver side med en WhatsApp-knap: en landingsside, en bookingside, en prisside eller en quiz, der slutter med “Send mine svar på WhatsApp”.
Denne side handler om annoncer, der sender folk til dit website først. Hvis dine annoncer åbner WhatsApp direkte (Metas “Click to WhatsApp”-annoncer), dækkes det automatisk, uden et script, i Click-to-WhatsApp annonceattribuering.
Opsætning
- Gå til Indstillinger → Annonceklik-sporing (Integrationsgruppen).
- Klik på Slå til og hent mit script. Din konto får sin egen nøgle og et script på én linje.
- Kopiér scriptet og indsæt det lige før det afsluttende
</body>-tag på hver side, der har en WhatsApp-knap:
<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>
- Valgfrit: under WhatsApp-nummer, indtast det nummer, dine knapper linker til. Kun links til det nummer spores derefter. Lad det stå tomt for at spore alle WhatsApp-links på websitet.
- Vælg ordlyden for forespørgselsnummeret (se nedenfor) og klik på Gem. Du behøver ikke at ændre scriptet på dit website efter en indstillingsændring.
- Test det: åbn din side fra et link med et kampagnetag på, for eksempel
https://yoursite.com/?utm_source=test&utm_campaign=setup-check, tryk på din egen WhatsApp-knap og send beskeden. Åbn den kontakt i Chats: kontaktpanelet viser Kom fra et annonceklik med kampagnen.
Websitenøglen er allerede inde i scriptet. Det er ikke en adgangskode, så det er fint at have den på en offentlig side.
Bureauer: hver klientkonto har sin egen nøgle og sit eget script, så hver klients website rapporterer til sin egen konto. Du kan skjule sektionen for en klient med menu-synlighed, ligesom enhver anden indstillingssektion.
Hvad scriptet gør
- Når siden indlæses, gemmer det annonceklik-id’er og kampagnetags (
utm_-parametrene) fra sidens adresse i browserfanens sessionslagring, så de stadig er der, hvis den besøgende kigger på en anden side først. Det sætter ingen cookies, indlæser intet andet og sender intet. - Når den besøgende trykker på et WhatsApp-link (
wa.me,api.whatsapp.com/sendellerwhatsapp://send), tilføjer det forespørgselsnummeret til beskeden, registrerer besøget og lader trykket fortsætte til WhatsApp som normalt.
Intet sendes til DM Champ før trykket.
Forespørgselsnummeret
Et kort nummer, ligesom den reference en butik eller klinik giver dig, tilføjes til den besøgendes WhatsApp-besked. Det er sådan, DM Champ ved præcis, hvilket annonceklik der hører til hvilken samtale. En besked ser sådan ud:
Hi, I would like to know more.
Enquiry no. 4827
- Ordlyd: “Forespørgselsnr.” er standarden. Du kan bruge enhver tekstlinje, der lyder naturlig for din virksomhed, såsom “Bookingref” eller “Ref”. Ingen cifre.
- Hvor: På sin egen sidste linje (standard) eller I slutningen af teksten. Indstillingssiden viser et live-eksempel.
- Længde: 4 cifre, eller 5 når dit site har meget travlt.
- Din AI-agent ser det aldrig og gentager det aldrig. Indbakken viser hele beskeden, inklusive nummeret.
Du kan slå forespørgselsnummeret fra. Matchning fungerer derefter kun på selve beskedteksten, hvilket betyder, at to besøgende, der sender nøjagtig den samme tekst (f.eks. de samme quizsvar), ikke kan skelnes fra hinanden, og nogle klik vil ikke blive matchet.
Din egen quiz- eller knapkode
Hvis din side selv opbygger WhatsApp-beskeden (en quiz, der indsætter svarene i teksten, eller din egen knapkode), skal du tilføje data-manual til script-tagget:
<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>
Med data-manual ændrer scriptet ikke længere WhatsApp-links af sig selv. Din egen kode kalder det lige før, WhatsApp åbnes, så hvert besøg registreres én gang:
window.ChatAttribution.text(finalText, number)returnerer din tekst med forespørgselsnummeret tilføjet og registrerer besøget. Brug den returnerede tekst i dit WhatsApp-link.window.ChatAttribution.link(finalText, number)gør det samme og returnerer et færdigtwa.me-link med den tekst. Udelad nummeret for at bruge det, der står under WhatsApp-nummer i indstillingerne.
<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>
Den else-gren sørger for, at knappen stadig virker, hvis scriptet ikke er indlæst, for eksempel hvis en browserudvidelse blokerer det. En tekst, der allerede indeholder et nummer, som scriptet har udstedt, ændres aldrig en anden gang.
Hvad der bliver registreret
Ved trykket indeholder besøgsregistreringen:
- annonce-klik-id’er i sidens adresse, såsom
fbclid(Meta) oggclid(Google) _fbc- og_fbp-cookies, hvis din egen Meta-pixel har sat dem på dit websted (scriptet læser dem, det sætter dem aldrig)- kampagnetags (
utm_source,utm_medium,utm_campaign,utm_content,utm_term) - landingssiden, siden den besøgende kom fra, browseren og beskedteksten
- IP-adressen og tidspunktet, tilføjet af DM Champ, når besøget ankommer
Besøgsregistreringer gemmes i 90 dage. Når et besøg matches, gemmes en kopi af dets klikdata på kontakten og bliver hos kontakten, indtil du sletter den.
Din privatlivspolitik: scriptet kører på dit websted, så dit websteds privatlivspolitik bør nævne det: hvad det registrerer (listen ovenfor), og at det gør det, når en besøgende trykker på en WhatsApp-knap.
Hvordan matchning fungerer
Når en kontakts første besked ankommer, leder DM Champ efter et besøg fra de 15 minutter før:
- Først via forespørgselsnummer. En besked, der indeholder et nummer, som scriptet har udstedt, matches med det besøg.
- Ellers via identisk tekst. En besked med nøjagtig samme tekst som et besøg matches med det. Når to forskellige besøgende sender den samme tekst inden for tidsvinduet, matches ingen af dem med vilje, så en kontakt aldrig fejlagtigt tilskrives den forkerte annonce.
En senere besked, der indeholder forespørgselsnummeret, matches også, så længe kontakten endnu ikke har et match.
Begrænsninger:
- Første match vinder. Når en kontakt har fået et match, bliver det aldrig overskrevet.
- Kun WhatsApp: WhatsApp Business API og WhatsApp Web-kanalerne.
- 15 minutter: En besøgende, der trykker på knappen, men sender beskeden meget senere, bliver ikke matchet.
- Kun fremadrettet: Kontakter fra før du installerede scriptet, har intet match.
Hvor du ser det
- Kontaktpanel: Kom fra et annonceklik med kampagnen eller kilden og datoen. Hold musen over for at se detaljerne.
- Webhooks:
contact.ad_attributioni agent-tag-webhooks og i enhver webhook-abonnementsbegivenhed, der indeholder en kontakt. - API:
ad_attributionpå kontaktlisten ogadAttributionpå en enkelt kontakt, i afsnittet Kontakter i API-referencen. - MCP-værktøjer: det samme objekt på hver kontakt, de returnerer.
Værdien er null, når kontakten ikke har noget match.
| Felt | Hvad det er |
|---|---|
visit_at |
Hvornår den besøgende trykkede på WhatsApp-knappen. |
matched_at |
Hvornår besøget blev matchet med kontakten. |
match_method |
reference (matchet via forespørgselsnummer) eller text (matchet via identisk beskedtekst). |
reference |
Forespørgselsnummeret, eller null når det var slået fra. |
fbc / fbp |
Meta-klikket og browser-cookies fra din egen Meta-pixel, hvis de findes. |
fbclid |
Meta-annonceklik-id’et fra sideadressen. |
gclid / gbraid / wbraid |
Google-annonceklik-id’erne fra sideadressen. |
utm_source / utm_medium / utm_campaign / utm_content / utm_term |
Kampagnetags fra sideadressen. |
landing_url |
Siden, den besøgende landede på. |
referrer |
Siden, den besøgende kom fra. |
client_ip |
Den besøgendes IP-adresse. |
user_agent |
Den besøgendes browser. |
site_key |
Webstedsnøglen for det script, der registrerede besøget. |
visit_id |
Id’et for besøgsregistreringen. |
Send resultater til Meta (valgfrit)
Du kan lade DM Champ rapportere resultater tilbage til din Meta-annoncekonto, så Meta lærer, hvilke annoncer der skaber reelle kundeemner og salg, og optimerer mod dem. Dette bruger dine egne Meta Conversions API-detaljer.
- I Meta Events Manager skal du finde dit pixel-id (også kaldet datasæt-id) under Datakilder og oprette et adgangstoken under Indstillinger, Conversions API, Generer adgangstoken.
- I Indstillinger → Sporing af annonceklik, under Send resultater til Meta (valgfrit), skal du indtaste Pixel- / datasæt-id og Adgangstoken. Mens du tester, kan du tilføje Testbegivenhedskode fra Metas faneblad Testbegivenheder; ryd den, når du er færdig. Klik på Gem Meta-detaljer.
- Åbn agenteditoren, gå til fanen Tags og åbn et tag. Under Send til Meta skal du vælge begivenheden: Lead, Kontakt, Booking, Køb eller et brugerdefineret navn. Tilføj eventuelt en værdi og en valuta.
Fra da af, hver gang det tag anvendes på en kontakt (af AI’en, manuelt, via API’et eller via en automatisering), sender DM Champ begivenheden til Meta med kontaktens gemte klikdata (fbc, fbp, IP-adresse, browser, landingsside) plus deres telefonnummer, e-mail og navn, hashet, så Meta kan linke det til annoncen. En kontakt uden et match sender stadig begivenheden, kun med det hashede telefonnummer, e-mail og navn.
- Ingen dobbeltoptælling: hver begivenhed har et fast id bestående af kontakt-id’et og tag-navnet. Hvis dit CRM sender den samme begivenhed til Meta med det samme id, beholder Meta kun én.
- Metas attributionsvindue: Meta krediterer kun en begivenhed til en annonce inden for sit attributionsvindue, som som standard er 7 dage efter klikket. En handel, der afsluttes uger senere, tæller ikke i sig selv, så send også en tidligere begivenhed, for eksempel et tag for den bookede eller betalte konsultation.
FAQ
Virker dette, hvis min annonce åbner WhatsApp direkte? Disse annoncer går ikke gennem dit websted, så scriptet kører aldrig. Meta sender annonceoplysningerne med den første besked i stedet, se Click-to-WhatsApp Ad Attribution.
Gør scriptet mit websted langsommere, eller sætter det cookies?
Det indlæses i baggrunden (async), sætter ingen cookies og indlæser intet andet. Det sender kun noget, når en besøgende trykker på en WhatsApp-knap.
Kan jeg spore Google Ads såvel som Meta-annoncer?
Ja. Google-klik-id’er (gclid, gbraid, wbraid) og alle kampagnetags registreres og vises på kontakten. Afsendelse af resultater tilbage er kun tilgængelig for Meta.
Hvorfor fik en kontakt ikke et match? De mest almindelige årsager: beskeden ankom mere end 15 minutter efter trykket, forespørgselsnummeret blev fjernet fra beskeden, forespørgselsnummeret er slået fra, og en anden besøgende sendte den samme tekst, eller siden har ikke scriptet.
Mit websted linker til to WhatsApp-numre. Kan jeg kun spore det ene? Ja. Indtast det nummer under WhatsApp-nummer i indstillingerne. Lad det stå tomt for at spore alle WhatsApp-links.
Kan jeg ændre ordlyden senere? Ja. Ændringer træder i kraft på din hjemmeside med det samme; du behøver ikke at indsætte scriptet igen.