أحداث التحويل

أحداث التحويل هي الأحداث التي تُحتسب كتحويلات لحملاتك. ويمكن لكل منها أيضًا تتبّع الإيرادات، التي يجمعها Pushwoosh بتنسيق موحد لاستخدامها في الإسناد والتحليلات والتقسيم.

ما هي أحداث التحويل

نادراً ما تأتي أحداث الإيرادات بشكل واحد. قد يقوم SDK الخاص بك بتشغيل حدث PW_InAppPurchase، وقد يرسل نظامك الخلفي حدثاً مخصصاً مثل OrderPlaced، وتقدم Stripe أو Shopify أحداث webhook الخاصة بها. بدون تنسيق مشترك، يعني استهداف الإيرادات أو الإبلاغ عنها كتابة منطق منفصل لكل مصدر.

يحل Pushwoosh هذه المشكلة باستخدام PW_Conversion، وهو حدث مدمج مع مجموعة ثابتة من الحقول:

• value: مبلغ المعاملة
• currency: رمز العملة ISO 4217
• transaction_id و product_id: معرفات اختيارية

يغطي PW_Conversion عمليات الشراء وتجديد الاشتراكات والمدفوعات من منصات الطرف الثالث، بغض النظر عن مصدر حدث المال الأصلي. بمجرد وصول الإيرادات كـ PW_Conversion، يقرأ كل من RFM segmentation و Customer Journeys ولوحات المعلومات و ManyMoney AI نفس البيانات المسواة، بغض النظر عن المصدر الذي أنتجها.

في هذه الصفحة، يُقصد بأحداث التحويل PW_Conversion بالإضافة إلى الأحداث الافتراضية والمخصصة التي تختار احتسابها كتحويلات.

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

يُحتسب كل حدث تحويل في علامة تبويب التحويلات ضمن Project overview، حيث ترى الحملات التي أدت إليه. ويُحتسب الحدث الذي تختاره بإحدى طريقتين:

• تحويل فقط: يحسب Pushwoosh عدد مرات وقوع الحدث بعد رسائلك، على سبيل المثال signup_completed أو trial_started.
• تحويل مع إيرادات: يقرأ Pushwoosh أيضًا السعر والعملة من سمات الحدث ويسجل المبلغ كـ PW_Conversion.

يظهر PW_Conversion دائمًا في القائمة ويتتبّع الإيرادات دائمًا. ولا يمكنك إزالته.

كيف تصل الإيرادات إلى Pushwoosh

تحصل على سجل PW_Conversion بإحدى ثلاث طرق:

• إرسالها مباشرة من الكود الخاص بك: يرسل تطبيقك أو نظامك الخلفي PW_Conversion بعد عملية الشراء.
• تتبّع الإيرادات لحدث موجود في Control Panel: وجّه Pushwoosh إلى سمتي السعر والعملة في حدث شراء ترسله بالفعل، وسيقوم بإنشاء سجلات PW_Conversion دون تغيير الكود الخاص بك. يمكنك تتبّع الإيرادات لأكثر من حدث واحد لكل تطبيق.
• إرسال السمتين __amount و__currency على أي حدث: عند وصول مثل هذا الحدث لأول مرة، يضيفه Pushwoosh إلى أحداث التحويل لديك مع تفعيل تتبّع الإيرادات مسبقًا، دون أي إعداد في Control Panel. راجع Automatic revenue mapping.

هام

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

حالات الاستخدام

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

• اعرف الحملات والـ journeys التي تؤدي إلى التحويلات ومقدار الإيرادات التي تحققها في علامة تبويب التحويلات ضمن Project overview.
• أنشئ شرائح RFM للمستخدمين ذوي القيمة العالية بناءً على مبلغ الإنفاق وحداثته، دون الحاجة إلى منطق إيرادات مخصص لكل حدث.
• عيّن PW_Conversion كـ هدف تحويل (Conversion Goal) في Customer Journey لترى أي التدفقات تؤدي بالفعل إلى عمليات شراء، وليس مجرد نقرات أو فتحات.
• اعرض الإيرادات في لوحات المعلومات والتقارير دون بناء منطق مخصص لكل حدث شراء.
• اجمع الإيرادات من أحداث الشراء في SDK و webhooks الدفع (Stripe، Shopify) في مجموعة بيانات واحدة بدلاً من تحليل كل مصدر على حدة.
• دع ManyMoney AI يستخدم بيانات المعاملات الحقيقية في توصياته وتحسينات حملاته.

سيناريوهات أمثلة

دمج التجديدات وطلبات المتجر

يرسل تطبيق اشتراك PW_Conversion بعد كل دفعة تجديد، ويتتبّع الإيرادات لحدث طلبات Shopify الخاص به لمبيعات البضائع لمرة واحدة. يتم الآن احتساب كلا مصدري الإيرادات ضمن نفس RFM segmentation، لذلك يصل أكبر المنفقين في التطبيق إلى شريحة Champions تلقائيًا. من هناك، يمكنك استهدافهم بعرض ولاء في Customer Journey.

توحيد الإنفاق عبر القنوات

يرسل تطبيق جوال PW_Conversion للمشتريات داخل التطبيق مباشرة من نظامه الخلفي، ويتتبّع بشكل منفصل الإيرادات لحدث webhook من Stripe للمشتريات التي تتم على موقعه الإلكتروني. نظرًا لأن Pushwoosh يعامل كليهما على أنهما نفس نوع حدث الإيرادات، يرى ManyMoney AI سجل إنفاق العميل الكامل، التطبيق والموقع الإلكتروني معًا، عندما يوصي بمن يجب استهدافه بعد ذلك.

معرفة أي journeys تؤدي إلى عمليات شراء

تستهدف journey المستخدمين الذين توقفوا عن استخدام الخدمة مؤخرًا بعرض لاستعادتهم. تم تعيين Conversion Goal الخاص بها على PW_Conversion. بعد انتهاء الـ journey، تُظهر إحصائيات الهدف عدد المستخدمين الذين أجروا عملية شراء، حتى تتمكن من رؤية أن الـ journey أدت إلى عمليات شراء حقيقية، وليس مجرد فتحات. لمعرفة مقدار الإيرادات التي يمثلها ذلك، تحقق من عرض إيرادات الشريحة أو لوحة المعلومات بشكل منفصل. يعرض Customer Journey عدد عمليات الشراء حسب الهدف، وليس إجماليًا بالدولار لكل journey.

كيفية إعداد أحداث التحويل

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

إرسال PW_Conversion من الكود الخاص بك

يناسب هذا المسار عندما يمكنك إضافة أو تغيير كود الحدث في تطبيقك أو نظامك الخلفي. بعد كل عملية شراء، أرسل PW_Conversion من خلال طريقة postEvent. تصل إيراداته إلى RFM segmentation والـ journeys ولوحات المعلومات دون أي إعداد في Control Panel. عند وجود PW_Conversion فقط، تعرض علامة التبويب التحويلات ضمن Project overview شريط اعرف أي الحملات تحقق التحويلات بدلاً من الإحصاءات. ولرؤية التحويلات في علامة التبويب هذه، اختر حدثًا آخر واحدًا على الأقل كما هو موضح أدناه.

مطلوب مساعدة المطور

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

أضف استدعاء postEvent في أي مكان تكتمل فيه عملية شراء في تطبيقك أو نظامك الخلفي.

مثال لـ JavaScript:

Pushwoosh.postEvent("PW_Conversion", {
    value: 49.99,
    currency: "USD",
    transaction_id: "ord_18274",
    product_id: "sku_premium_m"
});

بعد إعداد أحداث التحويل في Control Panel، تتوفر أيضًا أمثلة لـ JavaScript و Swift و Objective-C و Java ضمن عرض الكود في شريط تتبع أحداث التحويل في Audience > Events.

السمات لاستدعاء postEvent

يسرد الجدول التالي السمات التي يمكنك تمريرها عند إرسال PW_Conversion.

الحقل	النوع	مطلوب	الوصف
value	number	نعم	المبلغ النقدي للمعاملة.
currency	string (ISO 4217)	نعم	رمز عملة المعاملة، على سبيل المثال USD أو EUR.
transaction_id	string	لا	معرف فريد للمعاملة. يوصى به لحفظ السجلات الخاصة بك. يقوم Pushwoosh بتخزينه كما هو ولكنه لا يستخدمه لإلغاء تكرار الإيرادات من تلقاء نفسه.
product_id	string	لا	معرف المنتج أو الخطة المشتراة.

تنبيه

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

اختيار أحداث التحويل وتتبّع إيراداتها

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

ملاحظة

اختيار حدث كتحويل لا يغيره ولا يستبدله. يستمر في العمل تمامًا كما كان من قبل في التقسيم وسجل الأحداث ولوحات المعلومات. وعندما يتتبّع الحدث الإيرادات، ينشئ Pushwoosh منه بالإضافة إلى ذلك سجل PW_Conversion يُستخدم فقط لميزات الإيرادات.

1. اذهب إلى Audience > Events وانقر على إعداد الأحداث في شريط اعرف أي الحملات تحقق التحويلات. يمكنك أيضًا البدء من علامة التبويب التحويلات في Project overview.

   

2. في اختر أحداث التحويل، حدد حدثًا واحدًا على الأقل يُحتسب كتحويل وانقر على التالي.

   

   تظهر الأحداث التي تحمل بالفعل سعرًا وعملة أولاً، ويعرض عمود تم العثور على السعر والعملة أسماء هذه السمات. يبحث Pushwoosh عن مثل هذه الأحداث مرة واحدة يوميًا.

3. في قائمة أحداث التحويل، أعدّ الإيرادات للأحداث التي تحمل سعرًا. يظهر PW_Conversion أولاً مع شارة افتراضي ويتتبّع الإيرادات دائمًا. بالنسبة للأحداث التي عُثر فيها على السعر والعملة، يملأ Pushwoosh هذه السمات نيابةً عنك، ويتم حفظها مع القائمة. لا تحتاج إلى فتح مربع الحوار لها.

   

   لإعداد الإيرادات لأي حدث آخر، انقر على تتبّع الإيرادات (أو تعديل الإيرادات لتغييرها) واملأ مربع الحوار تتبّع الإيرادات للحدث:

   • في السعر، حدد السمة التي تخزن مبلغ المعاملة.
   • في العملة، حدد السمة التي تخزن رمز العملة.
   • اختياريًا، حدد سمتي معرّف المعاملة ومعرّف المنتج.
   

   انقر على تطبيق. تظل الأحداث التي لا تحمل إيرادات محتسبة كتحويلات.

4. انقر على حفظ.

لتغيير القائمة لاحقًا، انقر على أيقونة إعدادات أحداث التحويل (الترس) في شريط تتبع أحداث التحويل في Audience > Events. هناك يمكنك:

• إضافة حدث آخر باستخدام إضافة حدث.
• إيقاف تتبّع الإيرادات لحدث باستخدام إيقاف تتبّع الإيرادات… في قائمة إجراءات الحدث. ويظل محتسبًا كتحويل.
• إزالة حدث باستخدام إزالة الحدث… في قائمة إجراءات الحدث. ولن يُحتسب كتحويل بعد ذلك.

هام

لا تُنشئ التغييرات سجلات PW_Conversion للأحداث السابقة. عندما تضيف حدثًا، أو تغيّر سمات إيراداته، أو توقف تتبّع إيراداته، تعيد علامة التبويب التحويلات حساب هذا الحدث خلال آخر 10 أيام واليوم الحالي، فتتغير تحويلاته وإيراداته في تلك الفترة لتطابق الإعداد الجديد. إزالة حدث لا تغيّر الإحصائيات السابقة.

مراقبة أحداث التحويل

بمجرد اختيار حدث واحد على الأقل، يلخص شريط تتبع أحداث التحويل في Audience > Events نشاط التحويل للتطبيق المحدد:

• عدد أحداث التحويل التي تتتبّع الإيرادات، بما في ذلك PW_Conversion.
• عدد الأحداث التي تُحتسب كتحويلات فقط.
• عدد مرات تشغيل جميع أحداث التحويل في آخر 7 أيام.

من الشريط، يمكنك:

• النقر على أيقونة عرض الكود لفتح أمثلة تكامل PW_Conversion.
• النقر على أيقونة إعدادات أحداث التحويل لتعديل القائمة.
• النقر على لوحة معلومات التحويلات لمعرفة الحملات التي أدت إلى التحويلات في علامة تبويب التحويلات ضمن Project overview.