واجهة تحويل (CAPI) لإعلانات WhatsApp – تتبع أحداث CTWA | WOZTELL

واجهة API لعمليات التحويل في WhatsApp (إعلانات CTWA)

مقدمة

إعلان النقر إلى واتساب (CTWA) هو وسيلة شائعة لتوفير نقطة دخول مباشرة من الإعلان إلى محادثة واتساب. بدعم من مشغل الإعلانات وأحداث التحويل، يمكنك إنشاء تدفق تحويل كامل داخل مُنشئ الشات بوت.



إعداد إعلانات النقر إلى واتساب (CTWA)

لبدء الاستخدام، تحتاج إلى إعداد إعلان النقر إلى واتساب (CTWA) حتى يتمكن العملاء من الانتقال من التطبيق إلى رقم نشاطك التجاري على واتساب.

لإعداد CTWA من خلال مدير الإعلانات، يمكنك الرجوع إلى الدليل المقدم من Meta.



منح إذن الإعلانات

  1. لتمكين الميزات المتعلقة بإعلانات Click-to-WhatsApp و أحداث التحويل على WOZTELL، يُرجى منح إذن الإعلانات على صفحة النظام الأساسي لقناة WhatsApp Cloud.

ملاحظة

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



  1. في الخطوة الأولى من عملية تسجيل الدخول للأعمال، اختر حساب الأعمال الذي ترغب في ربطه بـ WOZTELL.
  1. اختر الصفحة التي سيتم ربطها.
  1. اختر حساب الإعلانات الذي سيتم ربطه.

Idea
ملاحظة:

تُعد مجموعة البيانات هذه ضرورية لتسجيل أحداث التحويل من خلال واجهة Conversions API. تقوم WOZTELL بإنشاء مجموعة البيانات تلقائيًا باستخدام معرف حساب WhatsApp Business الخاص بك (`waba_id`) وربطها بالصفحة المرتبطة. تمثل مجموعة البيانات هذه الوجهة التي تستقبل فيها Meta بيانات الأحداث لأغراض قياس الأداء.
  1. بالنسبة لـ Conversion API، ستقوم Meta بإنشاء مجموعة بيانات في إدارة الأحداث (Events Manager)، وتُسمى باسم الصفحة المرتبطة.

  1. اسمح لـ WOZTELL بالحصول على الأذونات التالية.
  1. تم الآن ربط WOZTELL بحساب نشاطك التجاري.
  1. انقر على "العودة إلى Woztell" لإغلاق النافذة المنبثقة.


الميزات

من خلال منح إذن الإعلانات، أصبح بإمكانك الآن الوصول إلى الميزات المرتبطة بـ CTWA وواجهة Conversions API.

معاينة إعلان CTWA

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

يمكن أيضًا عرض إعلان النقر إلى واتساب (CTWA) ضمن سلسلة الرسائل في صندوق الوارد.



مشغل الإعلانات

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

Idea
ملاحظة

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


إنشاء المشغل

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

إنشاء الرد

  1. لإدراج الرد، أنشئ عقدة عامة.
  1. أنشئ ردًا جديدًا.
  1. أضف رسالة الرد واحفظ العقدة.
  1. أخيرًا، تأكد من أنك تقوم بإعادة التوجيه من العقدة العامة إلى العقدة العامة التي تحتوي على الرد.


إرسال حدث التحويل

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

سيتم إرسال هذه الأحداث إلى Meta مع ربطها بإعلان CTWA معين.


Idea
ملاحظة:

لضمان إسناد التحويل بشكل صحيح إلى نقرة الإعلان الأصلية، يجب أن يتضمن حِمل الحدث الحقل "ctwa_clid" (معرف نقرة إعلان Click-to-WhatsApp). يتم التقاط هذا المعرف تلقائيًا بواسطة WOZTELL من كائن `referral` في webhook عندما يبدأ المستخدم محادثة عبر إعلان CTWA.
يجب عليك تخزين هذا المعرف وإرساله لاحقًا عندما يحدث تحويل (مثل إرسال نموذج اهتمام أو عملية شراء) داخل المحادثة.




  1. في حال كان لديك تدفق شات بوت لدخول المستخدمين عبر CTWA، يمكنك إنشاء عقدة جديدة لإرسال الحدث.
  1. أنشئ إجراءً جديدًا.
  1. حدد "إرسال حدث التحويل"، ثم اختر "معرف WABA" و"معرف حساب الإعلانات" و"معرف الإعلان".


{
data: [
{
event_name: "Purchase",
event_time: 1675999999,
action_source: "business_messaging",
messaging_channel: "whatsapp",
user_data: {
whatsapp_business_account_id: "<WABA_ID>",
ctwa_clid: "<CLICK_ID>"
},
custom_data: {
currency: "USD",
value: 123
}
}
],
partner_agent: "WOZTELL"
}
  1. ضمن "نوع الحدث"، إذا قمت باختيار "عملية شراء"، يرجى تحديد "العملة" و"القيمة".
  1. إذا اخترت حدث "عميل محتمل"، فلن تكون هناك حاجة إلى إدخال أي حقل إضافي.
  1. إذا لزم الأمر، يمكنك أيضًا إدخال معلومات إضافية ضمن "الإدخال الاختياري". يُرجى الرجوع إلى هذا الرابط للاطلاع على التفاصيل.
  1. بمجرد تنفيذ العقدة التي تحتوي على إجراء "إرسال حدث التحويل"، سيتم إرسال الحدث إلى Meta لتسجيل التحويل كمكتمل.

Warning
هام:

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

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

الآن، يمكنك إنشاء وإرسال حدث شراء أو حدث عميل محتمل لتسجيل التحويل كمكتمل. يمكن عرض الحدث في مدير الأحداث ضمن Facebook Business Manager.
بمجرد إرسال الحدث، يمكنك التحقق من صحته في Events Manager التابع لـ Meta من خلال تحديد مجموعة البيانات المرتبطة بحساب شركتك. هذا التأكيد يضمن أن Meta قد استلمت الحدث وقامت بمعالجته بشكل صحيح.

Idea
ملاحظات:

سيتم عرض بيانات الأحداث في مجموعة البيانات التي تم تكوينها في الخطوة 5 من إعداد أذونات الإعلانات.

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