getPersonalRecommendations

احصل على توصيات شخصية للمستخدم.

الوصف

تُرجع هذه الطريقة توصيات منتجات شخصية للسياق الحالي - مستخدم مخول أو ضيف (يتم تحديده عبر رأس x-guest-id، انظر وضع الضيف). تستند التوصيات إلى نشاط المستخدم المتعقب. تُرجع وعدًا (Promise) يتم حله إلى كائن IProductsResponse - حاوية تحتوي على items (المنتجات)، total و totalFound - وليس مصفوفة عارية.

Blocks.getPersonalRecommendations(

marker*, langCode, signPrice, limit

);

مخطط المعلمات

المخطط

marker(required): string
علامة الكتلة
مثال: "personal_recommendations_block"

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

signPrice: string
علامة تخزين الطلب لتثبيت السعر. إذا تم تعيين المعامل، يتم تثبيت السعر لفترة معينة
انظر: تثبيت السعر

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

💲 signPrice يقفل السعر المعاد لفترة محدودة — قم بتعيينه إلى علامة تخزين الطلب الخاصة بك. انظر تثبيت السعر (signPrice).

أمثلة

مثال بسيط

const response = await Blocks.getPersonalRecommendations('personal_recommendations_block');

مثال مع السمات

const response = await Blocks.getPersonalRecommendations('personal_recommendations_block', 'en_US');

مثال مع الحد

const response = await Blocks.getPersonalRecommendations('personal_recommendations_block', 'en_US', undefined, 4);

🔢 limit يحدد عدد المنتجات التي يتم إرجاعها. إذا تم إغفاله، فإن إعداد الكمية الخاص بالكتلة من لوحة الإدارة يستمر في التطبيق. انظر تحديد عدد المنتجات (limit).

مثال على الاستجابة

{
  "items": [],
  "total": 0
}

مخطط الاستجابة

المخطط: IProductsResponse

total: number
إجمالي عدد المنتجات التي تم العثور عليها.
مثال: 100

items: IProductsEntity[]
مصفوفة من كائنات المنتجات.
مثال:

[
  {
    "id": 12345,
    "title": "Product 1"
  },
  {
    "id": 67890,
    "title": "Product 2"
  }
]

items.id: number
المعرف الفريد.
مثال: 12345

items.localizeInfos: ILocalizeInfo
اسم المنتجات، مع الأخذ في الاعتبار التوطين.
مثال:

{}

items.statusIdentifier: string | null
معرفات حالة صفحة المنتج (قد تكون null).
مثال: "in_stock"

items.statusLocalizeInfos: ILocalizeInfo
اسم الحالة المحلي للمنتج.
مثال:

{ "title": "Sale" }

items.attributeSetIdentifier: string | null
مجموعة معرفات السمات.
مثال: "set_12345"

items.position: number
رقم العنصر (لترتيب العناصر).
مثال: 1

items.price: number | null
قيمة سعر صفحة المنتج المأخوذة من الفهرس.
مثال: 150.00

items.additional: object
قيمة إضافية من الفهرس.
مثال:

{
  "prices": {
    "min": 5,
    "max": 150
  }
}

items.sku: string | null
SKU المنتج (وحدة حفظ المخزون)، قد تكون null.
مثال: "SKU_12345"

items.isSync: boolean
إشارة إلى فهرسة الصفحة.
مثال: true

items.attributeValues: IAttributeValues
مصفوفة من قيم السمات من الفهرس، ممثلة.
مثال:

[
  {
    "id": "color",
    "value": "red"
  }
]

items.categories: string[]
فئات المنتجات.
مثال:

[
  1,
  2,
  3
]

items.isVisible: boolean
علامة رؤية الصفحة.
مثال: true

items.moduleFormConfigs: Array<IFormConfig>
تكوينات نماذج الوحدة (اختياري).

items.rating: IRating
بيانات التقييم.

items.isPositionLocked: boolean
مؤشر قفل موضع الترتيب (اختياري).
مثال: false

items.relatedIds: number[]
معرفات صفحات المنتجات ذات الصلة.
مثال:

[
  12345,
  67890
]

items.paymentStages: unknown
بيانات مراحل الدفع (قد تكون null).
مثال: null

items.distance: number
مسافة الصلة في البحث الدلالي. تظهر فقط في نتائج البحث الدلالي.
مثال: 0.42

items.discountConfig: Record<string, unknown>
كائن تكوين الخصم.
مثال:

{}

items.templateIdentifier: string | null
معرف المستخدم للقالب المرتبط.
مثال: "template_12345"

items.shortDescTemplateIdentifier: string | null
معرف المستخدم للقالب المرتبط للوصف القصير.
مثال: "short_desc_template_12345"

items.signedPrice: string
السعر الموقّع للمنتج يتم الحصول عليه مع بيانات المنتج عند تعيين signPrice.
انظر: سعر المنتج الثابت
مثال: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

items.productPages: IProductPageRef[]
مصفوفة من مراجع صفحات المنتجات تربط المنتج بصفحاتها.
مثال:

[
  {
    "id": 16,
    "pageId": 4,
    "productId": 15,
    "positionId": 244,
    "categoryPath": "products"
  }
]

items.blocks: string[]
مصفوفة من معرفات الكتل.
مثال:

[
  "block_12345",
  "block_67890"
]

totalFound: number
عدد المنتجات المطابقة قبل تطبيق الحدود؛ يتم إرجاعه من نقاط نهاية منتجات الكتل (similarProducts، توصيات عربة التسوق/قائمة الرغبات، الطلبات المتكررة). اختياري.
مثال: 2

🔒 signedPrice هو الرمز الموقّع الذي يحمل السعر المقفل — قم بإعادته عند إنشاء طلب. انظر سعر المنتج الثابت (signedPrice).

---