ייחוס לחיצות על מודעות עבור WhatsApp
אם אתם מריצים מודעות Meta או Google לדף באתר האינטרנט שלכם, ובדף זה יש כפתור WhatsApp, DM Champ יכול לומר לכם מאיזו לחיצה על מודעה הגיעה כל שיחת WhatsApp. אתם מדביקים סקריפט קטן אחד באתר שלכם. כאשר מבקר מקיש על כפתור ה-WhatsApp שלכם, הלחיצה נשמרת ומותאמת להודעה הראשונה שהוא שולח לכם. לאחר מכן, איש הקשר מציג את הקמפיין שממנו הגיע, ונתוני הלחיצה עוברים עם איש הקשר לתוך webhooks, ל-API, ואם תרצו, בחזרה ל-Meta.
זה עובד עבור כל דף עם כפתור WhatsApp: דף נחיתה, דף הזמנות, דף מחירים או שאלון שמסתיים ב-“שלח את התשובות שלי ב-WhatsApp”.
דף זה עוסק במודעות ששולחות אנשים לאתר האינטרנט שלכם תחילה. אם המודעות שלכם פותחות את WhatsApp ישירות (מודעות “Click to WhatsApp” של Meta), זה מכוסה באופן אוטומטי, ללא סקריפט, ב-ייחוס מודעות Click-to-WhatsApp.
הגדרה
- עברו אל הגדרות → מעקב אחר לחיצות על מודעות (קבוצת אינטגרציות).
- לחצו על הפעל וקבל את הסקריפט שלי. החשבון שלכם מקבל מפתח אתר משלו וסקריפט בשורה אחת.
- העתיקו את הסקריפט והדביקו אותו ממש לפני תגית ה- הסוגרת (
</body>) בכל דף שיש בו כפתור WhatsApp:
<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>
- אופציונלי: תחת מספר WhatsApp, הקלידו את המספר שאליו מקשרים הכפתורים שלכם. רק קישורים למספר זה ינוטרו לאחר מכן. השאירו ריק כדי לנטר כל קישור WhatsApp באתר.
- בחרו את הניסוח של מספר הפנייה (ראו להלן) ולחצו על שמור. אינכם צריכים לשנות את הסקריפט באתר שלכם לאחר שינוי הגדרות.
- בדקו זאת: פתחו את הדף שלכם מקישור עם תגית קמפיין עליו, לדוגמה
https://yoursite.com/?utm_source=test&utm_campaign=setup-check, הקישו על כפתור ה-WhatsApp שלכם ושלחו את ההודעה. פתחו את איש הקשר הזה ב-Chats: לוח איש הקשר מציג הגיע מלחיצה על מודעה עם הקמפיין.
מפתח האתר כבר נמצא בתוך הסקריפט. הוא אינו סיסמה, לכן הוא בטוח לשימוש בדף ציבורי.
סוכנויות: לכל חשבון לקוח יש מפתח אתר וסקריפט משלו, כך שאתר האינטרנט של כל לקוח מדווח לחשבון שלו. ניתן להסתיר את המקטע עבור לקוח באמצעות נראות תפריט, כמו כל מקטע הגדרות אחר.
מה הסקריפט עושה
- כאשר הדף נטען, הוא שומר את מזהי הלחיצה על המודעה ותגיות הקמפיין (פרמטרי ה-
utm_) מכתובת הדף באחסון הסשן של כרטיסיית הדפדפן, כך שהם עדיין שם אם המבקר צופה בדף אחר תחילה. הוא לא מגדיר עוגייה, לא טוען שום דבר אחר ולא שולח דבר. - כאשר המבקר מקיש על קישור WhatsApp (
wa.me,api.whatsapp.com/sendאוwhatsapp://send), הוא מוסיף את מספר הפנייה להודעה, מתעד את הביקור ומאפשר להקשה להמשיך ל-WhatsApp כרגיל.
שום דבר לא נשלח ל-DM Champ לפני ההקשה.
מספר הפנייה
מספר קצר, כמו האסמכתא שחנות או מרפאה נותנות לכם, מתווסף להודעת ה-WhatsApp של המבקר. כך DM Champ יודע בדיוק איזו לחיצה על מודעה שייכת לאיזו שיחה. הודעה נראית כך:
Hi, I would like to know more.
Enquiry no. 4827
- ניסוח: “Enquiry no.” הוא ברירת המחדל. ניתן להשתמש בכל שורת טקסט שנשמעת טבעית לעסק שלכם, כגון “Booking ref” או “Ref”. ללא ספרות.
- מיקום: בשורה נפרדת משלו (ברירת המחדל) או בסוף הטקסט. דף ההגדרות מציג תצוגה מקדימה חיה.
- אורך: 4 ספרות, או 5 כשהאתר שלכם עמוס מאוד.
- סוכן ה-AI שלכם לעולם לא רואה אותו ולעולם לא חוזר עליו. תיבת הדואר הנכנס מציגה את ההודעה המלאה, כולל המספר.
ניתן לכבות את מספר הפנייה. במקרה כזה, ההתאמה תתבצע על בסיס טקסט ההודעה בלבד, כך שלא ניתן יהיה להבדיל בין שני מבקרים ששלחו בדיוק את אותו הטקסט (למשל, אותן תשובות לחידון), וחלק מהלחיצות לא יותאמו.
קוד חידון או כפתור משלך
אם הדף שלך בונה את הודעת ה-WhatsApp בעצמו (חידון שמכניס את התשובות לתוך הטקסט, או קוד כפתור משלך), הוסף את data-manual לתגית ה-script:
<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" data-manual async></script>
עם data-manual, הסקריפט לא משנה יותר קישורי WhatsApp באופן עצמאי. הקוד שלך קורא לו ממש לפני פתיחת ה-WhatsApp, כך שכל ביקור מתועד פעם אחת:
window.ChatAttribution.text(finalText, number)מחזיר את הטקסט שלך בתוספת מספר הפנייה, ומתעד את הביקור. השתמש בטקסט המוחזר בקישור ה-WhatsApp שלך.window.ChatAttribution.link(finalText, number)מבצע פעולה דומה ומחזיר קישורwa.meמוכן עם הטקסט הזה. השאר את המספר ריק כדי להשתמש במספר המופיע תחת מספר WhatsApp בהגדרות.
<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 שומר על פעילות הכפתור גם אם הסקריפט לא נטען, למשל כאשר תוסף דפדפן חוסם אותו. טקסט שכבר מכיל מספר שהונפק על ידי הסקריפט לעולם לא ישונה פעם שנייה.
מה מתועד
ברגע הלחיצה, תיעוד הביקור כולל:
- מזהי לחיצות על מודעות בכתובת הדף, כגון
fbclid(Meta) ו-gclid(Google) - עוגיות
_fbcו-_fbp, אם הפיקסל של Meta שהטמעת הגדיר אותן באתר שלך (הסקריפט קורא אותן, הוא לעולם לא מגדיר אותן) - תגיות קמפיין (
utm_source,utm_medium,utm_campaign,utm_content,utm_term) - דף הנחיתה, הדף שממנו הגיע המבקר, הדפדפן וטקסט ההודעה
- כתובת ה-IP והזמן, שנוספים על ידי DM Champ כאשר הביקור מגיע
תיעודי ביקורים נשמרים למשך 90 יום. כאשר מתבצעת התאמה לביקור, עותק של נתוני הלחיצה שלו נשמר אצל איש הקשר ונשאר איתו עד למחיקתו.
הודעת הפרטיות שלך: הסקריפט פועל באתר האינטרנט שלך, לכן הודעת הפרטיות של האתר צריכה לציין זאת: מה הוא מתעד (הרשימה לעיל) ושהוא עושה זאת כאשר מבקר לוחץ על כפתור WhatsApp.
איך עובדת ההתאמה
כאשר מגיעה ההודעה הראשונה מאיש קשר, DM Champ מחפש ביקור מ-15 הדקות שקדמו לה:
- לפי מספר פנייה תחילה. הודעה הנושאת מספר שהונפק על ידי הסקריפט מותאמת לאותו ביקור.
- אחרת לפי טקסט זהה. הודעה עם טקסט זהה לחלוטין לביקור מסוים מותאמת אליו. כאשר שני מבקרים שונים שלחו את אותו טקסט בתוך חלון הזמן, אף אחד מהם לא מותאם, וזאת במכוון, כדי שאיש קשר לעולם לא ישויך למודעה הלא נכונה.
הודעה מאוחרת יותר הנושאת את מספר הפנייה תותאם גם היא, כל עוד לאיש הקשר עדיין אין התאמה.
מגבלות:
- התאמה ראשונה מנצחת. ברגע שלאיש קשר יש התאמה, היא לעולם לא נדרסת.
- WhatsApp בלבד: ערוצי ה-WhatsApp Business API ו-WhatsApp Web.
- 15 דקות: מבקר שלוחץ על הכפתור אך שולח את ההודעה זמן רב לאחר מכן לא יקבל התאמה.
- קדימה בלבד: לאנשי קשר שנוצרו לפני התקנת הסקריפט אין התאמה.
היכן ניתן לראות זאת
- לוח אנשי קשר: הגיע מלחיצה על מודעה עם הקמפיין או המקור והתאריך. רחפו מעל כדי לראות פרטים.
- Webhooks:
contact.ad_attributionב-webhooks של תגיות סוכן ובכל אירוע מנוי webhook שנושא איש קשר. - API:
ad_attributionברשימת אנשי הקשר ו-adAttributionעבור איש קשר בודד, בסעיף אנשי הקשר בתיעוד ה-API. - כלי MCP: אותו אובייקט בכל איש קשר שהם מחזירים.
הערך הוא null כאשר לאיש הקשר אין התאמה.
| שדה | מה זה |
|---|---|
visit_at |
מתי המבקר לחץ על כפתור ה-WhatsApp. |
matched_at |
מתי הביקור הותאם לאיש הקשר. |
match_method |
reference (הותאם לפי מספר פנייה) או text (הותאם לפי טקסט הודעה זהה). |
reference |
מספר הפנייה, או null כאשר האפשרות כבויה. |
fbc / fbp |
לחיצת ה-Meta ועוגיות הדפדפן מה-Meta pixel שלך, אם קיימים. |
fbclid |
מזהה לחיצת מודעת ה-Meta מכתובת הדף. |
gclid / gbraid / wbraid |
מזהי לחיצת מודעות Google מכתובת הדף. |
utm_source / utm_medium / utm_campaign / utm_content / utm_term |
תגיות הקמפיין מכתובת הדף. |
landing_url |
הדף שאליו הגיע המבקר. |
referrer |
הדף שממנו הגיע המבקר. |
client_ip |
כתובת ה-IP של המבקר. |
user_agent |
הדפדפן של המבקר. |
site_key |
מפתח האתר של הסקריפט שתיעד את הביקור. |
visit_id |
המזהה של רשומת הביקור. |
שליחת תוצאות ל-Meta (אופציונלי)
ניתן לאפשר ל-DM Champ לדווח על תוצאות בחזרה לחשבון מודעות ה-Meta שלך, כך ש-Meta תלמד אילו מודעות מביאות לידים ומכירות אמיתיים ותבצע אופטימיזציה עבורן. פעולה זו משתמשת בפרטי ה-Conversions API של Meta שלך.
- ב-Meta Events Manager, מצא את מזהה ה-pixel (נקרא גם dataset) שלך תחת מקורות נתונים, וצור אסימון גישה תחת הגדרות, Conversions API, צור אסימון גישה.
- ב-הגדרות ← מעקב אחר לחיצות על מודעות, תחת שליחת תוצאות ל-Meta (אופציונלי), הזן את מזהה ה-Pixel / dataset ואת אסימון הגישה. בזמן בדיקה ניתן להוסיף את קוד אירוע הבדיקה מהכרטיסייה ‘אירועי בדיקה’ של Meta; נקה אותו כשתסיים. לחץ על שמור פרטי Meta.
- פתח את עורך הסוכנים, עבור לכרטיסייה תגיות ופתח תגית. תחת שלח ל-Meta, בחר את האירוע: ליד, איש קשר, קביעת תור, רכישה או שם מותאם אישית. ניתן להוסיף ערך ומטבע באופן אופציונלי.
מרגע זה ואילך, בכל פעם שתגית זו מוחלת על איש קשר (על ידי ה-AI, ידנית, דרך ה-API או על ידי אוטומציה), DM Champ שולח את האירוע ל-Meta עם נתוני הלחיצה השמורים של איש הקשר (fbc, fbp, כתובת IP, דפדפן, דף נחיתה) בתוספת הטלפון, האימייל והשם שלהם, כשהם מוצפנים (hashed), כדי ש-Meta תוכל לקשר זאת למודעה. איש קשר ללא התאמה עדיין שולח את האירוע, עם הטלפון, האימייל והשם המוצפנים בלבד.
- ללא ספירה כפולה: לכל אירוע יש מזהה קבוע המורכב ממזהה איש הקשר ושם התגית. אם ה-CRM שלך שולח את אותו אירוע ל-Meta עם אותו מזהה, Meta שומרת רק אחד.
- חלון הייחוס של Meta: Meta מזכה אירוע למודעה רק בתוך חלון הייחוס שלה, שהוא 7 ימים לאחר הלחיצה כברירת מחדל. עסקה שנסגרת שבועות לאחר מכן לא תיספר בפני עצמה, לכן שלח גם אירוע מוקדם יותר, למשל תגית עבור התייעצות שהוזמנה או שולמה.
שאלות נפוצות
האם זה עובד אם המודעה שלי פותחת את WhatsApp ישירות? מודעות אלו אינן עוברות דרך האתר שלך, לכן הסקריפט לעולם לא מופעל. Meta שולחת את פרטי המודעה עם ההודעה הראשונה במקום זאת, ראה ייחוס מודעות Click-to-WhatsApp.
האם הסקריפט מאט את האתר שלי או מגדיר עוגיות?
הוא נטען ברקע (async), אינו מגדיר עוגיות ואינו טוען שום דבר אחר. הוא שולח משהו רק כאשר מבקר לוחץ על כפתור WhatsApp.
האם ניתן לעקוב אחר Google Ads בנוסף למודעות Meta?
כן. מזהי לחיצה של Google (gclid, gbraid, wbraid) וכל תגיות הקמפיין מתועדים ומוצגים על איש הקשר. שליחת תוצאות בחזרה זמינה עבור Meta בלבד.
מדוע איש קשר לא קיבל התאמה? הסיבות הנפוצות ביותר: ההודעה הגיעה יותר מ-15 דקות לאחר הלחיצה, מספר הפנייה הוסר מההודעה, מספר הפנייה כבוי ומבקר אחר שלח את אותו טקסט, או שהדף אינו מכיל את הסקריפט.
האתר שלי מקשר לשני מספרי WhatsApp. האם ניתן לעקוב רק אחרי אחד? כן. הקלד את המספר הזה תחת מספר WhatsApp בהגדרות. השאר ריק כדי לעקוב אחר כל קישור WhatsApp.
האם אוכל לשנות את הניסוח מאוחר יותר? כן. שינויים חלים על האתר שלך באופן מיידי; אין צורך להדביק את הסקריפט שוב.