Conversions API لواتساب: كيف ترسل مبيعاتك إلى ميتا
دليل عملي لاستعمال Conversions API مع المبيعات التي تتم عبر واتساب: حدث Purchase، معرّف ctwa_clid، مجموعة البيانات، منع التكرار، الاختبار والأخطاء الشائعة.
بقلم فريق Waslaآخر تحديث: 5 دقائق قراءة
أهم النقاط
- تُخبر Conversions API ميتا بأن محادثة واتساب جاءت من إعلان قد انتهت بعملية شراء، مع مبلغها.
- في المراسلة، يُرسَل الحدث بقيمة action_source «business_messaging» وقيمة messaging_channel «whatsapp»، مع معرّف النقرة ctwa_clid.
- معرّف حدث ثابت (event_id) يمنع احتساب الصفقة نفسها مرتين عند إعادة الإرسال.
- اختبر الإرسال برمز الاختبار في مدير الأحداث قبل إرسال مبيعات حقيقية.
تطلق إعلانات Click-to-WhatsApp، ويُتمّ موظفو المبيعات صفقاتهم داخل المحادثات، ومع ذلك لا تعلم ميتا بشيء من ذلك. فبالنسبة للخوارزمية، المحادثة التي تنتهي بطلبية قيمتها 5 000 درهم تساوي المحادثة التي تتوقف بعد كلمة «شكراً». لذلك تعمل على جلب محادثات، لا زبائن.
تأتي Conversions API، المعروفة اختصاراً بـ CAPI، لتصحيح هذا الوضع. فهي تسمح لنظامك بأن يرسل مباشرة إلى ميتا، من خادم إلى خادم، الأحداث التي تهمك: زبون محتمل مؤهَّل، أو عملية شراء بمبلغها. يشرح هذا الدليل طريقة عملها مع واتساب، بلغة واضحة وبعيداً عن التعقيد التقني غير الضروري.
ماذا تفعل Conversions API باختصار
تربط حدثاً يقع عندك، وهو هنا صفقة تمت عبر واتساب، بالنقرة الإعلانية التي أدّت إليه. ومن جهة ميتا، تظهر الصفقة في مدير الأحداث وفي تقارير حملاتك، وتُستعمل إشارةً لتحسين توزيع الإعلانات.
وعلى خلاف البكسل المثبّت في موقع إلكتروني، لا تعتمد Conversions API على المتصفح ولا على ملفات تعريف الارتباط. إنها الطريقة الوحيدة لإبلاغ ميتا بعملية شراء تتم داخل محادثة، لأنه لا توجد صفحة تأكيد يمكن قياسها.
مكوّنات حدث الشراء عبر واتساب
عند إتمام صفقة داخل واتساب، يتضمن الحدث المُرسَل الحقول التالية:
| الحقل | القيمة | الدور |
|---|---|---|
| event_name | Purchase | نوع الحدث: عملية شراء |
| event_time | طابع زمني (Unix) | لحظة إتمام الصفقة |
| event_id | معرّف فريد | يمنع التكرار عند إعادة الإرسال |
| action_source | business_messaging | الحدث صادر عن تطبيق مراسلة |
| messaging_channel | القناة المعنية | |
| user_data.ctwa_clid | معرّف النقرة | يربط الصفقة بالإعلان الذي تم الضغط عليه |
| user_data.whatsapp_business_account_id | معرّف الحساب | يحدد حسابك على واتساب للأعمال |
| custom_data.value و currency | 1200 و MAD | المبلغ والعملة |
يُعدّ معرّف ctwa_clid حجر الأساس. فهو يصل مع الرسالة الأولى للزبون، داخل كائن referral، عندما يكون قد ضغط على إعلان. وإذا لم يُحفظ في تلك اللحظة، فلن يمكن ربط الصفقة بالإعلان أبداً.
مجموعة البيانات (Dataset): حيث تصل الأحداث
تُرسَل الأحداث إلى مجموعة بيانات، وهي ما يعادل البكسل بالنسبة للبيانات خارج المواقع. وفي حالة واتساب، تتيح ميتا استرجاع مجموعة البيانات المرتبطة بحسابك على واتساب للأعمال أو إنشاءها. ويتم ذلك مرة واحدة فقط، أثناء الإعداد.
خطوة بخطوة: من زر «تم البيع» إلى ميتا
- يضغط الزبون على إعلانك ويكتب رسالة. يُحفظ كائن referral ومعرّف ctwa_clid في المحادثة.
- تتقدم المحادثة، فيُتمّ موظف المبيعات الصفقة ويضغط على «تم البيع» مع المبلغ المحصَّل.
- ينشئ نظامك حدث Purchase بمعرّف فريد، ويضعه في قائمة انتظار للإرسال.
- يُرسَل الحدث تلقائياً إلى ميتا. وعند حدوث خطأ مؤقت، تُعاد المحاولة لاحقاً بمهلة تتزايد تدريجياً.
- تربط ميتا عملية الشراء بالنقرة، فتظهر في تقاريرك وتغذّي تحسين حملاتك.
لقائمة الانتظار أهمية كبيرة: فخوادم ميتا، مثل كل الخوادم، ترفض أحياناً بعض الطلبات. ومن دون قائمة انتظار وإعادة محاولة، تختفي مبيعات بصمت وتصبح أرقامك خاطئة دون أن ينتبه أحد.
تجنّب التكرار وأخطاء المبالغ
يجب ألا تُحتسب الصفقة إلا مرة واحدة. فإذا فشل الإرسال ثم أُعيد، تتعرّف ميتا على الحدث بفضل معرّف event_id ولا تحتسبه مرتين. استعمل دائماً معرّفاً ثابتاً، مثل معرّف الصفقة في قاعدة بياناتك، ولا تستعمل أبداً رقماً عشوائياً يتغير مع كل محاولة.
أما المبلغ، فأرسل القيمة المحصَّلة فعلاً، وبعملة حسابك الإعلاني. وإذا كنت تبيع باليورو لزبائن أوروبيين بينما حسابك بالدرهم، فحوّل المبلغ بسعر صرف يوم الصفقة وثبّت هذا السعر: هكذا تبقى تقاريرك متّسقة حتى لو تغيّر السعر لاحقاً.
أبعد من حدث الشراء
الشراء هو أقوى إشارة، لكنه يأتي متأخراً. لذلك يمكنك أيضاً إرسال مراحل وسيطة:
- LeadSubmitted، عندما يرسل زبون جاء من إعلان رسالته الأولى؛
- QualifiedLead، عندما تنتقل المحادثة إلى مرحلة التفاوض، أي أن للزبون مشروعاً حقيقياً؛
- Purchase، عندما تتم الصفقة.
تمنح هذه الأحداث الوسيطة ميتا إشارات أكثر وفي وقت أبكر، وهو ما يفيد خصوصاً الحملات ذات الميزانية الصغيرة التي لا تحقق إلا بضع مبيعات في الأسبوع.
الاختبار قبل الانتقال إلى الإرسال الحقيقي
يوفر مدير الأحداث رمز اختبار. وما دام هذا الرمز مرفقاً بالإرسال، تظهر الأحداث في تبويب الاختبار ولا تُحتسب في تقاريرك. سجّل صفقة تجريبية، وتأكد من وصول الحدث بالمبلغ والعملة الصحيحين، ثم احذف الرمز.
راقب أيضاً نسبة المشتريات التي تصل دون معرّف ctwa_clid. فإذا كانت مرتفعة، فإما أن الزبائن لا يأتون من إعلاناتك، وإما أن كائن referral لا يُحفظ مع الرسالة الأولى.
وبعد الانتقال إلى الإرسال الحقيقي، خصّص بضع دقائق كل أسبوع لمقارنة عدد المبيعات المسجّلة عندك بعدد أحداث الشراء التي تظهر في مدير الأحداث. أي فرق كبير بين الرقمين يعني أن بعض المبيعات لا تُرسَل، أو أن بعض الموظفين لا يسجّلون الصفقة داخل المحادثة، وهو ما يجب تصحيحه بسرعة قبل أن يؤثر على قراراتك الإعلانية.
ما يقوم به Wasla بدلاً منك
في Wasla، هذه الدورة كلها تلقائية: يُحفظ كائن referral ومعرّف ctwa_clid منذ الرسالة الأولى، وينشئ زر «تم البيع» حدث Purchase بمعرّف فريد، وتعيد قائمة الإرسال المحاولة عند حدوث خطأ، وتظهر حالات الفشل النهائي في إعداداتك. أما المبيعات التي لم تأتِ من إعلان، فلا تُرسَل حتى لا تُشوّش إشاراتك.
أسئلة شائعة
هل أحتاج إلى موقع إلكتروني لاستعمال Conversions API؟
لا. في مبيعات واتساب، يُرسَل الحدث من خادم إلى خادم مع معرّف ctwa_clid، ولا حاجة إلى بكسل ولا إلى موقع.
متى يجب إرسال الحدث بعد البيعة؟
في أقرب وقت ممكن. تقبل ميتا أحداثاً تُرسَل بعد أيام، لكن الإشارة السريعة أنفع بكثير لتحسين الحملات.
وإذا لم يأتِ الزبون من إعلان؟
من دون معرّف ctwa_clid، لا تستطيع ميتا ربط الصفقة بأي نقرة. والأفضل ألا تُرسَل كعملية شراء إعلانية: تبقى ضمن رقم معاملاتك، لا ضمن عائد الحملات.
هل تحترم Conversions API خصوصية الزبائن؟
في حالة واتساب، يحمل الحدث معرّف النقرة ومعرّف حسابك، لا اسم الزبون ولا رسائله. ومع ذلك، اذكر هذه المشاركة في سياسة الخصوصية الخاصة بك.