كيفية إعداد توصيات المنتجات في البريد الإلكتروني

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

نصيحة

هل ترسل بالفعل PW_AbandonedCart و PW_OrderCreated من أجل استرداد سلة التسوق المهجورة؟ استمر في القراءة. تحتاج الأكثر مبيعًا إلى حقل إضافي واحد في PW_OrderCreated لا يغطيه دليل سلة التسوق المهجورة.

قبل أن تبدأ

تأكد من أن كتالوج حسابك يحتوي على منتجات. انتقل إلى المحتوى ← كتالوج المنتجات وقم بتوصيل موجز، أو استيراد ملف CSV، أو إضافة منتجات يدويًا. تعرف على كيفية ملء الكتالوج الخاص بك.

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

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

الحسابات الجديدة ترى الكتالوج العادي أولاً

تحتاج كل استراتيجية أدناه إلى تراكم السجل قبل أن تتمكن من ترتيب أي شيء. حتى ذلك الحين، تعرض الكتلة الكتالوج العادي بدلاً من ذلك. راجع الملاحظة تحت الحصول على المنتجات الموصى بها.

ما هي الاستراتيجيات التي تحتاج إلى أحداث

ثلاث من الاستراتيجيات الست ترتب المنتجات من الأحداث التي ترسلها؛ الثلاث الأخرى ترتب مباشرة من الكتالوج الخاص بك ولا تحتاج إلى أي شيء منك.

الاستراتيجية	هل تحتاج إلى أحداث؟	مصدر البيانات
عادت إلى المخزون	لا	تغييرات مخزون الكتالوج
انخفاض السعر	لا	تغييرات أسعار الكتالوج
الوصول الجديد	لا	تاريخ “الإضافة” في الكتالوج
الأكثر مبيعًا (7/30 يومًا)	نعم	PW_OrderCreated / PW_OrderUpdated مع items
بناءً على ما شاهدوه	نعم	أي حدث يحمل معرف منتج
تم شراؤها معًا	نعم	أي حدث يحمل معرف منتج أو items الطلب، بالإضافة إلى علامة جهاز

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

الأكثر مبيعًا: أضف العناصر إلى أحداث طلبك

ترتب الأكثر مبيعًا (7 أيام) والأكثر مبيعًا (30 يومًا) المنتجات حسب عدد الوحدات المباعة في تلك الفترة. تقرأ مصفوفة items في PW_OrderCreated وPW_OrderUpdated، وتحديدًا productId وquantity لكل عنصر.

إذا كنت ترسل بالفعل PW_OrderCreated لـ مسح علامات سلة التسوق المهجورة، فإن هذا الاستدعاء الأدنى (فقط orderId) لا يزال يمسح السلة، لكنه لا يعطي الأكثر مبيعًا شيئًا لعده. أضف بنود الطلب إلى نفس الاستدعاء:

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "PW_OrderCreated",
    "attributes": {
      "orderId": "ORDER-10293",
      "items": [
        {
          "productId": "SKU-4821",
          "quantity": 1
        },
        {
          "productId": "SKU-5190",
          "quantity": 2
        }
      ]
    },
    "userId": "shopper@example.com"
  }
}

يجب أن يتطابق productId مع المعرف الذي يستخدمه كتالوج المنتجات الخاص بك لهذا العنصر، حتى يتمكن الأكثر مبيعًا من البحث عن المنتج لعرضه. يتم تجاهل حقول العناصر الإضافية (السعر، الاسم، وما إلى ذلك) لهذه الاستراتيجية. فقط productId وquantity يتم احتسابهما في الترتيب. يحتاج الحدث أيضًا إلى orderId، لأن الطلب الذي لا يحتوي عليه لا يُحتسب.

عندما يتغير طلب، أرسل PW_OrderUpdated بنفس orderId وitems. لكل منتج في الحدث، تحل قيمة quantity الجديدة محل القيمة السابقة بدلًا من إضافتها إليها. يمكن أن تنخفض كمية المنتج بهذه الطريقة إلى وحدة واحدة، ولكن ليس إلى الصفر:

• قيمة quantity تساوي 0 أو أقل: يُحتسب المنتج كوحدة واحدة مبيعة.
• منتج غير مدرج في items: يحتفظ المنتج بالكمية من آخر حدث تضمّنه.

على سبيل المثال، يطلب عميل وحدتين من منتج ثم يعيدهما كلتيهما. إذا أرسلت PW_OrderUpdated مع تعيين quantity لهذا المنتج إلى 0، فإن الأكثر مبيعًا يحتسب له وحدة واحدة بدلًا من 2. وإذا حذفت المنتج من items، فسيظل يُحتسب 2. لا يوجد حدث يزيل منتجًا مُرتجعًا أو ملغى من الأكثر مبيعًا. يتوقف احتسابه فقط عندما يخرج الطلب من نافذة الـ 7 أو 30 يومًا.

نصيحة

إذا كنت تستخدم تكامل Shopify، فإن كل طلب مدفوع يصل كحدث PW_OrderCreated مع معرف طلب Shopify في orderId وitems تحمل productId وquantity، لذا تُحتسب الطلبات المدفوعة ضمن الأكثر مبيعًا دون الحاجة إلى إضافة أي شيء من جانبك. إن productId هو معرف منتج Shopify، وهو نفس المعرف الذي يستخدمه الكتالوج الخاص بك عند استيراده من Shopify. ومع ذلك، لا يرسل التكامل PW_OrderUpdated، لذا فإن الأكثر مبيعًا يحتسب الكميات من الطلب الأصلي ولا يعكس التعديلات اللاحقة أو المبالغ المستردة أو الإلغاءات.

أرسل الكمية كرقم

استخدم رقم JSON حقيقي لـ quantity، وليس سلسلة نصية مقتبسة. يخزن Pushwoosh كل قيمة سمة فقط في النوع الذي تم إعلانه أو استنتاجه به لأول مرة؛ يتم إسقاط القيمة غير المتطابقة بصمت، ولا يزال postEvent يعيد النجاح. راجع استخدم أنواع السمات الصحيحة لنفس التحذير بشأن PW_AbandonedCart.

ملاحظة

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

بناءً على ما شاهدوه وتم شراؤها معًا: تتبع نشاط المنتج

تعتمد كلتا الاستراتيجيتين على نفس الإشارة: الأحداث التي تحمل معرف منتج. لا تحتاج إلى اسم حدث مخصص “تم عرض المنتج” — أي حدث مخصص يتم إرساله عبر postEvent يتم احتسابه، طالما أن attributes الخاصة به تتضمن أحد هذه المفاتيح:

• منتج واحد، كسمة على المستوى الأعلى: product_id، productId، productid، item_id، أو sku.
• منتجات متعددة، كمصفوفة products حيث يحتوي كل عنصر على product_id، productId، id، أو sku.

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

{
  "request": {
    "hwid": "8f65b16df378e7a6bece9614e1530fb2",
    "application": "XXXXX-XXXXX",
    "event": "ProductViewed",
    "attributes": {
      "product_id": "SKU-4821",
      "category": "Audio"
    },
    "userId": "shopper@example.com"
  }
}

ترتب بناءً على ما شاهدوه المنتجات التي تفاعل معها كل متسوق مؤخرًا — لا يلزم إعداد إضافي بمجرد تدفق الأحداث المذكورة أعلاه.

نصيحة

إذا كنت تستخدم تكامل Shopify، فإن تضمين سمة واجهة المتجر يرسل بالفعل PW_ProductViewed مع productId في كل عرض لصفحة المنتج — لا يوجد شيء لإضافته من جانبك، طالما أن مفتاح Push Init Embed قيد التشغيل (يكون مغلقًا افتراضيًا). راجع أحداث تصفح واجهة المتجر.

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

على الرغم من الاسم، لا يُشترط الشراء. تُحتسب المشاهدات وأحداث السلة والطلبات جميعها. تقرأ الاستراتيجية:

• كل حدث يحمل معرف منتج، باستخدام المفاتيح المذكورة أعلاه.
• مصفوفة items في PW_OrderCreated وPW_OrderUpdated. لا تتم قراءة items في الأحداث الأخرى، بما في ذلك PW_AbandonedCart.

يشكّل منتجان زوجًا عندما يرسل المستخدم نفسه أحداثًا لكليهما خلال آخر 30 يومًا. يمكن أن تكون الأحداث منفصلة، لذا لا يلزم أن يكون المنتجان في الطلب نفسه. تُحتسب الأزواج داخل تطبيق واحد، لذا لا يُحتسب النشاط في التطبيقات الأخرى في حسابك. يُعاد حساب الترتيب مرة واحدة يوميًا، لذا تؤثر الأحداث الجديدة عليه بدءًا من اليوم التالي.

تحتاج تم شراؤها معًا إلى شيء آخر: علامة المنتج، وهي علامة جهاز تحمل معرف المنتج الذي تُنشأ التوصيات من أجله. قم بتعيين اسم الحقل عند تكوين الاستراتيجية في كتلة المنتجات (على سبيل المثال PW_LastViewedProductID)، ثم حافظ على تحديث هذه العلامة على كل جهاز. على سبيل المثال، قم بتعيينها إلى معرف المنتج كلما شاهد المتسوق منتجًا. بدون تعيين العلامة على مستلم، تعود الكتلة إلى الكتالوج العادي بالنسبة له.

قواعد اسم العلامة

يقبل اسم العلامة فقط الحروف والأرقام والشرطات السفلية والمسافات، حيث يجب أن يكون قابلاً للعنونة في Liquid. راجع تحتاج “تم شراؤها معًا” إلى علامة منتج.

تأكد من وصول أحداثك

قبل إضافة الكتلة، تحقق من أن Pushwoosh يتلقى بالفعل الأحداث المذكورة أعلاه: انتقل إلى الجمهور ← الأحداث، افتح الحدث الذي أرسلته (PW_OrderCreated أو الحدث المخصص الذي يحمل معرف منتج)، وتأكد من ظهور الزيارات الأخيرة. راجع إحصائيات الأحداث.

ملاحظة

يمكن أن تعني كتلة المنتجات الفارغة إما “لم تصل الأحداث أبدًا” أو “لم يتراكم سجل كافٍ بعد” (راجع الملاحظة أعلاه). تستبعد إحصائيات الأحداث السبب الأول قبل أن تلاحق الثاني.

أضف الكتلة إلى بريدك الإلكتروني

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