نظرة عامة للمطورين

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

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

طريقتان للإرسال

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

ثلاثة مفاهيم قبل البداية

المصدر هو متجرك. كل حدث يتبع مصدرًا واحدًا، وتنشئ المصدر في فلوفاي قبل أن ترسل أي شيء.

مفتاح الكتابة يعرّف هذا المصدر. هو بيانات الاعتماد الوحيدة في العملية، تجده في صفحة المصدر داخل فلوفاي، ويُرسل مع كل طلب. ليس سرًّا في المتصفح — فهو يسمّي متجرك ولا يمنح صلاحية على بياناتك — لكن أبقِ نسخة الخادم بعيدة عن المستودعات العامة على أي حال.

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

إلى أين تذهب الأحداث

متجرك  →  edge.flofy.co  →  فلوفاي  →  ميتا / تيك توك / سناب شات

تُستقبل الأحداث على https://edge.flofy.co ويُرد عليها فورًا، قبل أي معالجة. الرد الناجح يعني أن الحدث وصل، لا أنه فُهم — افتح الأحداث المباشرة في صفحة المصدر داخل فلوفاي لترى ما وصل فعلًا.

أسماء الخصائص بصيغة snake_case

كل خاصية في هذه الصفحات بحروف صغيرة وشرطة سفلية: order_id وproduct_id وpayment_method. فلوفاي يقرأ order_id ولا يقرأ orderId، والطلب المُرسَل بالصيغة الثانية يصل بلا رقم طلب مرتبط به.

التالي

• تركيب المكتبة — وسم السكربت واستدعاء التحميل
• التتبّع — track وidentify وpage وبقية الدوال
• مرجع الأحداث — الأحداث الثلاثون وخصائص كل منها
• واجهة HTTP — إرسال الأحداث من خادم