Adapty: منح مستوى الوصول

يقوم قالب نقطة Adapty: منح مستوى الوصول بتفعيل مستوى وصول مدفوع في Adapty لفترة من الوقت بدون عملية شراء، بحيث يمكن للرحلة منح وصول premium كمكافأة أو تعويض.

تكوين النقطة

1. اسحب Adapty: منح مستوى الوصول من قسم التكاملات (Integrations) إلى لوحة العمل.
2. انقر نقرًا مزدوجًا على النقطة وأدخل اسم الخطوة (Step Name).
3. في مفتاح Adapty السري (Adapty secret key)، أدخل المفتاح السري للتطبيق من Adapty: إعدادات التطبيق (App settings) > عام (General). يتم تخزينه بشكل مقنّع، مثل رأس سري لـ webhook — مفتاح SDK العام لا يسمح بهذه الاستدعاء، لذا أبقه خارج هذا الحقل.

4. حدد المسافر بأحد هذه الحقول. اترك الحقل الآخر فارغًا. يتم حذف الحقل الفارغ من الطلب، ولا يتم إرساله فارغًا.

• معرف ملف تعريف Adapty (Adapty profile ID) (الافتراضي): احتفظ بـ {{tag:adapty_profile_id}}. يكتب تكامل Adapty → Pushwoosh هذا الوسم (Tag) عند تمكين التكامل. اترك معرف مستخدم العميل (Customer user ID) فارغًا.

• معرف مستخدم العميل (Customer user ID): املأ هذا الحقل إذا كان التطبيق يمرر User ID الخاص به إلى Adapty من خلال identify()، على سبيل المثال {{device:user_id}}. اترك معرف ملف تعريف Adapty (Adapty profile ID) فارغًا.

5. في مستوى الوصول (Access level)، أدخل معرف مستوى الوصول تمامًا كما هو مكتوب في صفحة مستويات الوصول (Access levels) في Adapty. القيمة الافتراضية هي premium.

6. في المنح لمدة (Grant for)، أدخل المدة التي يظل فيها الوصول مفعلًا، محسوبة من لحظة مرور المسافر بهذه الخطوة: رقم بالإضافة إلى وحدة، على سبيل المثال 30m أو 12h أو 7d. أدخل never للوصول الذي لا تنتهي صلاحيته. القيمة الافتراضية هي 7d.

7. انقر على حفظ (Save).

ملاحظة

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

الاستجابة

لا تقوم هذه النقطة بتعيين أي بيانات استجابة مرة أخرى إلى الرحلة. يؤدي الطلب الفاشل إلى إسقاط المسافر من الرحلة — راجع الأخطاء والطلبات الفاشلة (Errors and failed requests).

سيناريو مثال: مكافأة إحالة بوصول premium مؤقت

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

1. أضف عنصر الدخول المستند إلى مُشغِّل (Trigger-based entry) وقم بتعيينه ليتم تفعيله عند وقوع حدث ReferralCompleted.
2. أضف Adapty: منح مستوى الوصول مباشرة بعده. اترك معرف ملف تعريف Adapty (Adapty profile ID) على قيمته الافتراضية. قم بتعيين مستوى الوصول (Access level) إلى premium و المنح لمدة (Grant for) إلى 7d.
3. انقر على حفظ (Save).

بمجرد تشغيل هذا، يحصل كل مسافر يكمل إحالة على أسبوع من وصول premium في Adapty، بدون أي عملية شراء.