كيفية إرسال الأحداث إلى البكسل من البوت

لنقل الأحداث من سير عمل البوت، يجب أن يكون لديك حساب تجاري. يمكنك التسجيل هنا.

كيفية إنشاء بكسل جديد

اختر تحويلات API.

انتبه! إذا ظهرت النافذة التالية أثناء تكوين تحويلات API، فمن الأفضل مغادرة الإعدادات والبدء من جديد.

إذا ظهرت النافذة التالية أثناء تكوين تحويلات API، فمن الأفضل مغادرة الإعدادات والبدء من جديد.

اختر البكسل الذي تحتاجه.

قم بإنشاء رمز وصول واحفظه في مكان آمن.

كيفية نقل الأحداث إلى فيسبوك

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

الآن، سيكون هناك متغير _fbp مملوء تلقائيًا في بطاقة العميل الذي جاء من الصفحة المصغرة. يمكن نقل هذا المتغير إلى البكسل مع الحدث.

تحتاج إلى تكوين الإعدادات التالية في الكتلة التي تريد نقل الحدث من خلالها:

رابط الوظيفة:

https://store.mavibot.ai/function/fb_pixel

مثال على المعلمات:

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "دخل البوت",
  "event_source_url": "https://my_best_site.com",
  "action_source": "chat",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}"
}

المعلمات الإلزامية

pixel_id — معرف البكسل.

access_token — الرمز المميز للوصول إلى API.

event_name — اسم الحدث. يمكنك استخدام أسماء قياسية مثل Lead، PageView، Purchase، وما إلى ذلك (انظر المزيد هنا)، بالإضافة إلى أسماء خاصة بك، مثل دخل البوت.

event_source_url — النطاق المعتمد على فيسبوك.

fbp — معرف متصفح العميل.

المعلمات الاختيارية

action_source — (الافتراضي other) يسمح هذا الحقل بتحديد مكان حدوث التحويل بالضبط. تساعد المعلومات حول مكان حدوث الأحداث في ضمان عرض إعلاناتك للجمهور المناسب.

يمكنك تعيين القيم التالية في حقل action_source:

القيمة الوصف
email تم التحويل عبر البريد الإلكتروني
website تم التحويل على موقع
phone_call تم التحويل عبر الهاتف
chat تم التحويل عبر مراسلة أو رسائل نصية أو دردشة عبر الإنترنت
physical_store تم التحويل في متجر فعلي
system_generated حدث التحويل تلقائيًا، أي نتيجة لتجديد اشتراك شهري
business_messaging حدث التحويل في محادثة بعد أن نقر العميل على إعلان النقر إلى واتساب
other حدث التحويل بطريقة أخرى

كيفية اختبار الأحداث

لاختبار الأحداث، أضف معلمة test_event_code مع النص المخزن في علامة التبويب رسائل الاختبار إلى نص الطلب.

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "دخل البوت",
  "event_source_url": "https://my_best_site.com",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}",
  "test_event_code": "TEST11421"
}

انتبه! لا تنسَ حذف معلمة test_event_code من الطلب عند إطلاق النسخة الإنتاجية.

معلمات اختيارية إضافية

fn — الاسم الأول.

ln — اسم العائلة.

email — البريد الإلكتروني للعميل.

phone — رقم هاتف العميل.

fbc — معرف النقرة.

gender — جنس العميل (f — أنثى، m — ذكر).

country — البلد.

state — الولاية.

city — المدينة.

index — الرمز البريدي للعميل (ZIP code).

external_id — أي معرف فريد للعميل، مثل معرف المستخدم أو معرف ملفات تعريف الارتباط التابعة لجهات خارجية.

client_ip_address — عنوان IP الخاص بالعميل.

client_user_agent — وكيل مستخدم متصفح العميل.

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

مثال:

{
  "my_params": {
    "value1": "مرحبًا",
    "val2": "أهلاً"
  }
}

مثال كامل

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "دخل البوت",
  "event_source_url": "https://my_best_site.com",
  "email": "[email protected]",
  "phone": "1234567890",
  "currency": "USD",
  "value": "142.52",
  "test_event_code": "TEST11421",
  "external_id": "#{client_id}",
  "fn": "#{name}",
  "gender": "m",
  "post_index": "12345",
  "my_params": {
    "value1": "مرحبًا",
    "val2": "أهلاً"
  }
}

انتبه! لا تنسَ حذف معلمة test_event_code من الطلب عند إطلاق النسخة الإنتاجية.

كيفية إضافة حساب إعلاني

أولاً، تحتاج إلى فتح الوصول إلى حسابك.

احفظ وانتقل إلى علامة التبويب الكائنات ذات الصلة ← إضافة كائنات.

ثم أضف حسابك الإعلاني.

تحويلات إعلانات النقر إلى واتساب

إضافة إلى توثيق دالة fb_pixel_event().

تقوم Meta* بتمييز كل نقرة من إعلان النقر إلى واتساب بمعرف نقرة ctwa_clid. يتم استلامه مع أول رسالة واتساب من العميل ويُستخدم لنسب التحويل من المحادثة إلى إعلان معين — على غرار كيفية نسب أحداث البكسل إلى نقرة على موقع ويب.

التوقيع

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

المعلمات الجديدة

المعلمة الوصف
ctwa_clid معرف النقرة لإعلان النقر إلى واتساب. إذا لم يتم توفير هذه المعلمة، يتم استخدام متغير العميل ctwa_clid، الذي يتم حفظه تلقائيًا بواسطة البوت. اختياري.
messaging_channel قناة المراسلة التي حدث فيها التحويل. الافتراضي هو whatsapp. اختياري.

قيمة جديدة لـ action_source

القيمة التالية متاحة لـ action_source:

القيمة الوصف
business_messaging حدث التحويل في محادثة بعد أن نقر العميل على إعلان النقر إلى واتساب.

يتم إرسال الحدث كتحويل مراسلة إذا تم استيفاء شرط واحد على الأقل من الشروط التالية:

  • تم توفير action_source="business_messaging"؛
  • تم توفير ctwa_clid؛
  • تم توفير messaging_channel.

في هذه الحالة، تتلقى Meta* مجموعة action_source + messaging_channel + ctwa_clid. بدون هذه المجموعة، لن يُنسب نقرة الإعلان إلى التحويل.

يجب عدم استخدام قيمة website لتحويلات المراسلة: سيصل الحدث إلى البكسل، لكنه لن يُنسب إلى الإعلان.

متغيرات العميل

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

المتغير الوصف
ctwa_clid معرف النقرة. يُضاف تلقائيًا إلى الحدث.
ctwa_clid_time الوقت الذي تم فيه استلام المعرف، بتنسيق وقت Unix. يمكن استخدامه لتحديد مقدار الوقت المنقضي منذ النقرة.
wa_ads_data بيانات الإعلان بتنسيق JSON: رابط الإعلان، معرف الإعلان (source_id)، العنوان، الوصف، نوع الإبداع، ورابط الإبداع.

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

يتم إضافة رقم هاتف العميل تلقائيًا إلى الحدث إذا لم يتم توفيره في data.

لا يتم استخدام معلمة event_source_url لتحويلات المراسلة.

القيود

يتم استلام معرف النقرة فقط مع أول رسالة من العميل بعد النقر على الزر في الإعلان. لا يتم تضمينه في الرسائل اللاحقة. لذلك، يمكن إرسال الحدث في أي نقطة أثناء المحادثة، ولكن فقط إذا كانت الرسالة الأولى نشأت من الإعلان.

توفر Meta ctwa_clid للنقرات من تطبيقي فيسبوك وإنستغرام على أندرويد وiOS.

لا يتم توفير المعرف عندما ينقر العميل من متصفح أو ينقر على منشور عادي بدلاً من زر الإعلان. لا يمكن نسب التحويلات من هذه التفاعلات إلى الإعلان.

إذا نقر العميل على إعلان آخر لاحقًا، يتم استبدال المتغيرات. يُنسب التحويل إلى أحدث إعلان جاء منه العميل.

إذا كان معرف النقرة مفقودًا من كل من معلمات الدالة ومتغيرات العميل، تُرجع الدالة الخطأ التالي ولا يتم إرسال الحدث:

لا يوجد متغير ctwa_clid في متغيرات العميل