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

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

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

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

الإعداد #

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

<script src="https://api.youraiconnector.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)، فإنه يضيف رقم الاستفسار إلى الرسالة، ويسجل الزيارة ويسمح للنقرة بالاستمرار إلى واتساب كالمعتاد.

لا يتم إرسال أي شيء إلى Your AI Connector قبل النقر.

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

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

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

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

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

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

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

<script src="https://api.youraiconnector.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 والوقت، اللذان يضيفهما Your AI Connector عند وصول الزيارة

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

يتم الاحتفاظ بسجلات الزيارات لمدة 90 يوماً. عند مطابقة زيارة، يتم تخزين نسخة من بيانات النقرة الخاصة بها على جهة الاتصال وتبقى مع جهة الاتصال حتى تقوم بحذفها.

إشعار الخصوصية الخاص بك: يعمل البرنامج النصي على موقع الويب الخاص بك، لذا يجب أن يذكره إشعار الخصوصية الخاص بموقعك: ما يسجله (القائمة أعلاه) وأنه يقوم بذلك عندما ينقر الزائر على زر WhatsApp.

كيف تعمل المطابقة #

عند وصول أول رسالة من جهة اتصال، يبحث Your AI Connector عن زيارة من الـ 15 دقيقة السابقة لها:

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

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

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

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

القيود:

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

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

• لوحة جهة الاتصال: جاء من نقرة إعلان مع الحملة أو المصدر وتاريخ النقرة الأولى. مرر مؤشر الماوس للحصول على التفاصيل: الحملة، والإعلان (utm_content)، ومجموعة الإعلانات (utm_term)، والموقع التقريبي، والجهاز، كل منها يظهر فقط عند معرفته، بالإضافة إلى نفس التفاصيل للنقرة الأخيرة عند وجودها. يتم استبعاد وسوم الحملة التي لم يتم ملؤها (نقرة معاينة الإعلان ترسل قالب الوسم بدلاً من الأسماء). تُحتسب الزيارة كنقرة إعلان فقط عندما تم فتح الصفحة من رابط إعلان (معرف نقرة Meta أو Google، أو وسوم الحملة). أي شخص وصل إلى الصفحة بطريقة أخرى، على سبيل المثال من بحث Google، أو عن طريق كتابة عنوانك أو بالنقر عبر موقعك، يظهر جاء من موقعك الإلكتروني مع توضيح المكان الذي جاء منه، مثل بحث Google، أو زيارة موقع إلكتروني، لم يتم تسجيل مصدر الإحالة عندما لا يحدد المتصفح ذلك.
• صفحة جهة الاتصال: يظهر نفس السطر تحت اسم جهة الاتصال في جهات الاتصال، بحيث تراه مباشرة، حتى على هاتفك. مرر مؤشر الماوس أو اضغط عليه للحصول على التفاصيل.
• النشاط: يبدأ المخطط الزمني لجهة الاتصال بـ ضغط على زر واتساب الخاص بك بعد إعلان (أو على موقعك الإلكتروني) في وقت النقرة، قبل رسالتهم الأولى. تعرض لوحة جهة الاتصال في الدردشة نفس السطر تحت النشاط.
• خطافات الويب (Webhooks): contact.ad_attribution في خطافات ويب وسوم الوكيل وفي كل حدث اشتراك في خطاف ويب يحمل جهة اتصال.
• واجهة برمجة التطبيقات (API): ad_attribution في قائمة جهات الاتصال وadAttribution في جهة اتصال واحدة، في قسم جهات الاتصال من مرجع واجهة برمجة التطبيقات.
• أدوات MCP: نفس الكائن على كل جهة اتصال يتم إرجاعها.

تكون القيمة null عندما لا يكون لدى جهة الاتصال أي مطابقة. تصف الحقول أدناه النقرة الأولى. عندما تتم مطابقة نقرة لاحقة، يحتفظ latest بها مع نفس الحقول؛ وتكون غائبة حتى ذلك الحين.

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

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

1. في مدير أحداث Meta (Meta Events Manager)، اعثر على معرف البكسل (يُسمى أيضاً مجموعة البيانات) الخاص بك ضمن مصادر البيانات، وأنشئ رمز وصول ضمن الإعدادات، Conversions API، إنشاء رمز وصول (Generate access token).
2. في الإعدادات ← تتبع نقرات الإعلانات (Settings → Ad click tracking)، ضمن إرسال النتائج إلى Meta (اختياري) (Send results to Meta (optional))، أدخل معرف البكسل / مجموعة البيانات (Pixel / dataset ID) و رمز الوصول (Access token). انقر على حفظ تفاصيل Meta (Save Meta details).
3. اختياري: تحقق من الاتصال. في مدير أحداث Meta، افتح البكسل الخاص بك وانتقل إلى علامة التبويب اختبار الأحداث (Test events)، وانسخ رمز الاختبار المعروض هناك، والصقه ضمن إرسال حدث اختبار (Send a test event) وانقر على إرسال حدث اختبار (Send test event). يظهر السطر الموجود أسفل الزر “تلقى Meta حدث اختبار واحد” (ابحث عنه ضمن اختبار الأحداث في Meta)، أو يظهر سبب رفض Meta له، على سبيل المثال رمز خاطئ. يُستخدم الرمز لهذا الاختبار فقط ولا يتم حفظه أبداً.
4. افتح محرر الوكيل (agent editor)، وانتقل إلى علامة التبويب العلامات (Tags) وافتح علامة. ضمن إرسال إلى Meta (Send to Meta)، اختر الحدث: عميل محتمل (Lead)، اتصال (Contact)، جدولة (Schedule)، شراء (Purchase) أو اسماً مخصصاً. أضف قيمة وعملة اختيارياً.

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

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

إرسال التحويلات من الأتمتة #

ترسل العلامة (Tag) حدثها عند تطبيقها. عندما تقع النتيجة في مكان آخر، مثل إغلاق صفقة في نظام إدارة علاقات العملاء (CRM) الخاص بك أو حجز استشارة، استخدم إجراء إرسال التحويل إلى Meta في الأتمتة. يقوم هذا الإجراء بإبلاغ Meta بحدث واحد إلى مجموعة بياناتك (Dataset) عبر واجهة برمجة تطبيقات التحويلات (Conversions API)، بحيث تعمل Meta على تحسين إعلاناتك بناءً على النتائج الحقيقية وليس فقط على الرسائل.

يستخدم هذا الإجراء نفس تفاصيل Meta الخاصة بالعلامات: معرف البكسل / مجموعة البيانات (Pixel / dataset ID) و رمز الوصول (Access token) الموجودين تحت الإعدادات ← تتبع نقرات الإعلان. بدون هذه التفاصيل، ستفشل الخطوة مع ظهور رسالة “Meta غير متصل”.

الحقول

املأ واحداً على الأقل من جهة الاتصال أو البريد الإلكتروني أو الهاتف. لا يشترط أن يكون الشخص جهة اتصال: يمكن لصفقة HubSpot التي تصل إلى حالة “مغلقة ومربوحة” (Closed Won) إرسال حدث Purchase مع قيمة الصفقة والبريد الإلكتروني للمشتري.

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

معرف الحدث (Event ID) وتكرار الاحتساب

تحتسب Meta الأحداث التي لها نفس اسم الحدث ونفس معرف الحدث مرة واحدة فقط. استخدم معرفاً ثابتاً، مثل معرف الصفقة، عندما تقوم أداة أخرى بالإبلاغ عن نفس التحويل، أو عندما قد تعمل الأتمتة مرتين لنفس الحدث. اتركه فارغاً وسيتم إنشاء معرف جديد في كل تشغيل، مما يعني احتساب كل تشغيل على حدة.

كيف يختلف عن أحداث العلامات

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

مثال: صفقة مغلقة واستشارة محجوزة

1. ابدأ أتمتة تعمل عند الفوز بصفقة: مشغل حدث تطبيق (App event) على حدث الصفقات في نظام إدارة علاقات العملاء (CRM) الخاص بك، مع شرط (Condition) لضمان استمرار الصفقات التي تم الفوز بها فقط. يرسل HubSpot أحداث مراحل الصفقات إلى تطبيقات المطورين فقط، لذا بالنسبة لـ HubSpot استخدم مشغل جدولة (Schedule) مع بحث في HubSpot عن الصفقات التي وصلت إلى حالة “مغلقة ومربوحة” (Closed Won) منذ آخر تشغيل، وقم بعمل حلقة تكرار (Loop) عليها.
2. أضف إرسال التحويل إلى Meta (Send conversion to Meta). اضبط اسم الحدث (Event name) على شراء (Purchase)، والقيمة (Value) على مبلغ الصفقة (أدرجه باستخدام زر +)، والعملة (Currency) على عملتك. ضع البريد الإلكتروني للمشتري في البريد الإلكتروني (Email) ومعرف الصفقة في معرف الحدث (Event ID)، حتى لا يتم احتساب نفس الصفقة مرتين.
3. بالنسبة لاستشارة محجوزة، ابدأ أتمتة ثانية باستخدام مشغل حجز موعد (Appointment booked) وأضف إرسال التحويل إلى Meta مع ضبط اسم الحدث على جدولة (Schedule) وجهة الاتصال من المشغل في جهة الاتصال (Contact). إذا أردت، أضف خطوة ثانية لـ إرسال التحويل إلى Meta ترسل شراء بقيمة ثابتة، مثل سعر الاستشارة.

يمكنك أيضاً إرسال تحويل عبر واجهة برمجة التطبيقات (API) باستخدام POST https://api.youraiconnector.com/v1/ad-attribution/meta-event. وهي تأخذ نفس الحقول بتنسيق snake case: event_name، value، currency، contact_id، email، phone، first_name، last_name، external_id، event_id، event_time، event_source_url و test_event_code.

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

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

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

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

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

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

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