إسناد نقرات الإعلانات إلى واتساب #

إذا كنت تدير إعلانات Meta أو Google لصفحة على موقعك الإلكتروني، وكان لتلك الصفحة زر واتساب، يمكن لـ DM Champ إخبارك بنقرة الإعلان التي جاءت منها كل محادثة واتساب. ما عليك سوى لصق نص برمجي صغير على موقعك. عندما ينقر الزائر على زر واتساب الخاص بك، يتم تذكر النقرة ومطابقتها مع أول رسالة يرسلها إليك. يظهر بعد ذلك جهة الاتصال والحملة التي جاءت منها، وتنتقل بيانات النقرة مع جهة الاتصال إلى خطافات الويب (webhooks)، وواجهة برمجة التطبيقات (API)، وإذا أردت، تعود إلى Meta.

يعمل هذا مع أي صفحة تحتوي على زر واتساب: صفحة هبوط، أو صفحة حجز، أو صفحة أسعار، أو اختبار ينتهي بـ “أرسل إجاباتي على واتساب”.

هذه الصفحة مخصصة للإعلانات التي ترسل الأشخاص إلى موقعك الإلكتروني أولاً. إذا كانت إعلاناتك تفتح واتساب مباشرة (إعلانات “النقر إلى واتساب” من Meta)، فسيتم تغطية ذلك تلقائياً، بدون نص برمجي، في إسناد إعلانات النقر إلى واتساب.

الإعداد #

1. انتقل إلى الإعدادات ← تتبع نقرات الإعلانات (مجموعة عمليات التكامل).
2. انقر على تشغيل والحصول على النص البرمجي الخاص بي. سيحصل حسابك على مفتاح موقع خاص به ونص برمجي من سطر واحد.
3. انسخ النص البرمجي والصقه مباشرة قبل وسم الإغلاق </body> في كل صفحة تحتوي على زر واتساب:

<script src="https://api.dmchamp.com/v1/ad-visit/YOUR_SITE_KEY.js" async></script>

4. اختياري: تحت رقم واتساب، اكتب الرقم الذي ترتبط به أزرارك. سيتم تتبع الروابط التي تؤدي إلى ذلك الرقم فقط. اتركه فارغاً لتتبع كل رابط واتساب على الموقع.
5. اختر صياغة رقم الاستفسار (انظر أدناه) وانقر على حفظ. لا تحتاج إلى تغيير النص البرمجي على موقعك بعد تغيير الإعدادات.
6. اختبره: افتح صفحتك من رابط يحتوي على وسم حملة، على سبيل المثال https://yoursite.com/?utm_source=test&utm_campaign=setup-check، وانقر على زر واتساب الخاص بك وأرسل الرسالة. افتح جهة الاتصال تلك في الدردشات: ستظهر لوحة جهة الاتصال جاءت من نقرة إعلان مع الحملة.

مفتاح الموقع موجود بالفعل داخل النص البرمجي. إنه ليس كلمة مرور، لذا لا بأس بوجوده على صفحة عامة.

ما يفعله النص البرمجي #

• عند تحميل الصفحة، فإنه يحتفظ بمعرفات نقرات الإعلانات ووسوم الحملات (معلمات utm_) من عنوان الصفحة في تخزين جلسة علامة تبويب المتصفح، بحيث تظل موجودة إذا نظر الزائر إلى صفحة أخرى أولاً. إنه لا يضع أي ملف تعريف ارتباط (cookie)، ولا يحمل أي شيء آخر ولا يرسل أي شيء.
• عندما ينقر الزائر على رابط واتساب (wa.me أو api.whatsapp.com/send أو whatsapp://send)، فإنه يضيف رقم الاستفسار إلى الرسالة، ويسجل الزيارة ويسمح للنقرة بالاستمرار إلى واتساب كالمعتاد.

لا يتم إرسال أي شيء إلى DM Champ قبل النقر.

رقم الاستفسار #

يتم إضافة رقم قصير، مثل المرجع الذي يعطيك إياه متجر أو عيادة، إلى رسالة واتساب الخاصة بالزائر. بهذه الطريقة تعرف DM Champ بالضبط أي نقرة إعلان تنتمي إلى أي محادثة. تبدو الرسالة هكذا:

Hi, I would like to know more.
Enquiry no. 4827

• الصياغة: “رقم الاستفسار.” هو الافتراضي. يمكنك استخدام أي سطر نصي واحد يبدو طبيعياً لعملك، مثل “مرجع الحجز” أو “مرجع”. لا تستخدم أرقاماً.
• المكان: في سطر أخير خاص به (الافتراضي) أو في نهاية النص. تعرض صفحة الإعدادات معاينة مباشرة.
• الطول: 4 أرقام، أو 5 عندما يكون موقعك مزدحماً جداً.
• وكيل الذكاء الاصطناعي الخاص بك لا يراه أبداً ولا يكرره أبداً. يعرض صندوق الوارد الرسالة الكاملة، بما في ذلك الرقم.

يمكنك إيقاف تشغيل رقم الاستفسار. في هذه الحالة، سيعمل المطابقة فقط على نص الرسالة، لذا لا يمكن التمييز بين زائرين يرسلان نفس النص تماماً (على سبيل المثال، نفس إجابات الاختبار)، ولن تتم مطابقة بعض النقرات.

رمز الاختبار أو الزر الخاص بك #

إذا كانت صفحتك تنشئ رسالة WhatsApp بنفسها (اختبار يضع الإجابات في النص، أو رمز زر خاص بك)، أضف data-manual إلى وسم البرنامج النصي (script tag):

<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 دقيقة السابقة لها:

1. عن طريق رقم الاستفسار أولاً. تتم مطابقة الرسالة التي تحمل رقماً أصدره البرنامج النصي بتلك الزيارة.
2. بخلاف ذلك عن طريق نص متطابق. تتم مطابقة الرسالة التي تحتوي على نفس نص الزيارة تماماً بها. عندما يرسل زائران مختلفان نفس النص خلال الفترة الزمنية، لا تتم مطابقة أي منهما، وذلك عن قصد، حتى لا يتم نسب جهة اتصال إلى الإعلان الخطأ أبداً.

تتم أيضاً مطابقة الرسالة اللاحقة التي تحمل رقم الاستفسار، طالما أن جهة الاتصال ليس لديها مطابقة بعد.

القيود:

• يفوز المطابق الأول. بمجرد حصول جهة الاتصال على مطابقة، لا يتم استبدالها أبدًا.
• WhatsApp فقط: قنوات WhatsApp Business API و WhatsApp Web.
• 15 دقيقة: الزائر الذي ينقر على الزر ولكنه يرسل الرسالة بعد وقت طويل لا يتم مطابقته.
• للمستقبل فقط: جهات الاتصال التي تم إنشاؤها قبل تثبيت البرنامج النصي ليس لها مطابقة.

أين يمكنك رؤية ذلك #

• لوحة جهات الاتصال: جاء من نقرة إعلان مع الحملة أو المصدر والتاريخ. مرر مؤشر الماوس للحصول على التفاصيل.
• Webhooks: contact.ad_attribution في خطافات ويب علامات الوكيل وفي كل حدث اشتراك في خطاف ويب يحمل جهة اتصال.
• API: ad_attribution في قائمة جهات الاتصال و adAttribution في جهة اتصال واحدة، في قسم جهات الاتصال في مرجع API.
• أدوات MCP: نفس الكائن في كل جهة اتصال يتم إرجاعها.

تكون القيمة null عندما لا يكون لجهة الاتصال أي مطابقة.

إرسال النتائج إلى Meta (اختياري) #

يمكنك السماح لـ DM Champ بالإبلاغ عن النتائج إلى حساب إعلانات Meta الخاص بك، حتى تتعلم Meta أي الإعلانات تجلب عملاء محتملين ومبيعات حقيقية وتعمل على تحسينها. يستخدم هذا تفاصيل واجهة برمجة تطبيقات التحويلات (Conversions API) الخاصة بـ Meta.

1. في مدير أحداث Meta، ابحث عن معرف البكسل (يسمى أيضًا مجموعة البيانات) الخاص بك ضمن مصادر البيانات، وأنشئ رمز وصول ضمن الإعدادات، واجهة برمجة تطبيقات التحويلات، إنشاء رمز وصول.
2. في الإعدادات ← تتبع نقرات الإعلان، ضمن إرسال النتائج إلى Meta (اختياري)، أدخل معرف البكسل / مجموعة البيانات و رمز الوصول. أثناء الاختبار، يمكنك إضافة رمز حدث الاختبار من علامة تبويب أحداث الاختبار في Meta؛ امسحه عند الانتهاء. انقر فوق حفظ تفاصيل Meta.
3. افتح محرر الوكيل، وانتقل إلى علامة التبويب العلامات وافتح علامة. ضمن إرسال إلى Meta، اختر الحدث: عميل محتمل (Lead)، جهة اتصال (Contact)، جدولة (Schedule)، شراء (Purchase) أو اسم مخصص. أضف اختياريًا قيمة وعملة.

منذ ذلك الحين، كلما تم تطبيق تلك العلامة على جهة اتصال (بواسطة الذكاء الاصطناعي، أو يدويًا، أو من خلال API، أو بواسطة أتمتة)، يرسل DM Champ الحدث إلى Meta مع بيانات النقرة المخزنة لجهة الاتصال (fbc، fbp، عنوان IP، المتصفح، صفحة الوصول) بالإضافة إلى رقم الهاتف والبريد الإلكتروني والاسم، مشفرة، حتى تتمكن Meta من ربطها بالإعلان. جهة الاتصال التي ليس لها مطابقة ترسل الحدث أيضًا، مع رقم الهاتف والبريد الإلكتروني والاسم المشفر فقط.

• لا يوجد احتساب مزدوج: كل حدث له معرف ثابت يتكون من معرف جهة الاتصال واسم العلامة. إذا أرسل نظام CRM الخاص بك نفس الحدث إلى Meta بنفس المعرف، تحتفظ Meta بواحد فقط.
• نافذة الإسناد الخاصة بـ Meta: تنسب Meta الحدث إلى إعلان فقط داخل نافذة الإسناد الخاصة بها، والتي تكون 7 أيام بعد النقرة افتراضيًا. الصفقة التي تُغلق بعد أسابيع لن تُحتسب بمفردها، لذا أرسل أيضًا حدثًا مبكرًا، على سبيل المثال علامة للاستشارة المحجوزة أو المدفوعة.

الأسئلة الشائعة #

هل يعمل هذا إذا كان إعلاني يفتح WhatsApp مباشرة؟ تلك الإعلانات لا تمر عبر موقع الويب الخاص بك، لذا لا يعمل البرنامج النصي أبدًا. ترسل Meta تفاصيل الإعلان مع الرسالة الأولى بدلاً من ذلك، انظر إسناد إعلانات النقر للوصول إلى WhatsApp.

هل يبطئ البرنامج النصي موقع الويب الخاص بي أو يضع ملفات تعريف ارتباط؟ يتم تحميله في الخلفية (async)، ولا يضع أي ملف تعريف ارتباط ولا يحمل أي شيء آخر. هو يرسل شيئًا فقط عندما ينقر الزائر على زر WhatsApp.

هل يمكنني تتبع إعلانات Google بالإضافة إلى إعلانات Meta؟ نعم. يتم تسجيل معرفات نقرات Google (gclid، gbraid، wbraid) وأي علامات حملة وعرضها على جهة الاتصال. إرسال النتائج متاح لـ Meta فقط.

لماذا لم تحصل جهة الاتصال على مطابقة؟ الأسباب الأكثر شيوعًا: وصلت الرسالة بعد أكثر من 15 دقيقة من النقر، تمت إزالة رقم الاستفسار من الرسالة، رقم الاستفسار متوقف وزائر آخر أرسل نفس النص، أو الصفحة لا تحتوي على البرنامج النصي.

موقع الويب الخاص بي يرتبط برقمي WhatsApp. هل يمكنني تتبع رقم واحد فقط؟ نعم. اكتب ذلك الرقم ضمن رقم WhatsApp في الإعدادات. اتركه فارغًا لتتبع كل رابط WhatsApp.

هل يمكنني تغيير الصياغة لاحقاً؟ نعم. يتم تطبيق التغييرات على موقع الويب الخاص بك على الفور؛ ولست بحاجة إلى لصق البرنامج النصي مرة أخرى.