الشرائح الخارجية

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

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

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

إعداد اتصال يمس قاعدة بيانات الإنتاج الخاصة بك. قبل أن تبدأ، اطلب من المطور أو مسؤول قاعدة البيانات لديك:

• تحضير مستخدم للقراءة فقط (أو، بالنسبة لـ BigQuery، حساب خدمة للقراءة فقط)
• تأكيد الاستعلام الذي تخطط لاستخدامه
• إذا كانت قاعدة البيانات خلف جدار ناري، اسأل دعم Pushwoosh عن عناوين IP التي يجب السماح بها

إنشاء شريحة خارجية

تسمية الشريحة واختيار قاعدة البيانات

1. اذهب إلى Audience ← External Segments.
2. انقر على Create external segment.

3. أدخل Name للشريحة (حتى 100 حرف).
4. اختر Database type: PostgreSQL، MySQL، Google BigQuery، أو Microsoft SQL Server / Fabric.

ملء حقول الاتصال

PostgreSQL و MySQL

بالنسبة لـ PostgreSQL و MySQL، املأ:

• Host و Port: عنوان خادم قاعدة البيانات الخاص بك. يتطلب Pushwoosh مضيفًا يمكن الوصول إليه بشكل عام ويرفض العناوين الخاصة أو الداخلية أو عناوين الاسترجاع عند التحقق من الاتصال أو حفظ الشريحة.
• Database: اسم قاعدة البيانات.
• User و Password: بيانات اعتماد لحساب للقراءة فقط.
• SSL mode (لـ PostgreSQL فقط، حيث أن اتصالات MySQL لا تستخدم TLS) يحدد كيفية تطبيق SSL/TLS، البروتوكول الذي يشفر الاتصال، على اتصال قاعدة البيانات الخاصة بك. اسأل مسؤول قاعدة البيانات لديك عن الوضع الذي يجب استخدامه:
  • Disable: لا يوجد تشفير.
  • Require: يشفر الاتصال، لكنه لا يتحقق من هوية خادم قاعدة البيانات.
  • Verify CA: يشفر الاتصال ويتحقق من أن شهادة الخادم قد صدرت من قبل هيئة شهادات موثوقة (CA).
  • Verify full: نفس Verify CA، ويتحقق أيضًا من أن الشهادة تطابق اسم مضيف قاعدة البيانات الخاصة بك. الخيار الأقوى.
• لأي وضع غير Disable، قدم CA certificate تحت Certificate source (Upload files أو Paste PEM)، بالإضافة إلى Client certificate و Client key إذا كانت قاعدة بياناتك تتطلبها.

BigQuery

بالنسبة لـ Google BigQuery، املأ:

• Project ID: مشروع GCP الذي يحتوي على مجموعة البيانات الخاصة بك.
• Service account JSON: المفتاح لحساب خدمة مع وصول للقراءة في BigQuery.
• Location: منطقة مجموعة البيانات (على سبيل المثال، EU، US، أو europe-west3). اتركه فارغًا لتحديد الموقع تلقائيًا من مجموعة البيانات.

SQL Server / Fabric

بالنسبة لـ Microsoft SQL Server / Fabric، املأ:

• Host و Port: عنوان خادم قاعدة البيانات الخاص بك، أو نقطة نهاية تحليلات SQL الخاصة بـ Fabric. يتطلب Pushwoosh مضيفًا يمكن الوصول إليه بشكل عام ويرفض العناوين الخاصة أو الداخلية أو عناوين الاسترجاع عند التحقق من الاتصال أو حفظ الشريحة.
• Database: اسم قاعدة البيانات.
• User و Password: بيانات اعتماد لحساب للقراءة فقط.
• Microsoft Entra tenant ID: اختياري. اتركه فارغًا لتسجيل الدخول إلى SQL Server. بالنسبة لـ Microsoft Fabric، الذي لا تحتوي نقطة نهاية تحليلات SQL الخاصة به على تسجيلات دخول SQL، قم بتعيينه لتسجيل الدخول ككيان خدمة بدلاً من ذلك. أدخل معرف التطبيق (العميل) الخاص به كـ User وسر العميل الخاص به كـ Password.

إدخال الاستعلام

1. أدخل Query. يجب أن يُرجع عمودًا واحدًا باسم user_id، مع صف واحد لكل مستخدم تريد إضافته إلى الشريحة. على سبيل المثال:

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

ملاحظة

يجب أن تتطابق قيم user_id مع معرفات مستخدمي Pushwoosh التي قمت بتعيينها لمستخدميك (نفس المعرف المستخدم بواسطة إنشاء شرائح حسب User ID). الاستعلام الذي يُرجع معرفات لا يتعرف عليها Pushwoosh لن يطابق أي أجهزة.

2. انقر على Check connection لتأكيد أن Pushwoosh يمكنه الوصول إلى قاعدة البيانات (ينتهي الوقت بعد 30 ثانية).
3. انقر على Check query لتأكيد أن الاستعلام يعمل ويُرجع العمود الصحيح (ينتهي الوقت أيضًا بعد 30 ثانية).

التحقق والإنشاء

عندما ينجح كلا التحققين، انقر على Create. يحفظ Pushwoosh الشريحة ويضيفها إلى قائمة External Segments على الفور.

كيف تبقى الشريحة محدّثة

لا يقوم Pushwoosh بتشغيل استعلامك وفقًا لجدول زمني ثابت. بدلاً من ذلك، يقوم بتحديث الشريحة بناءً على مدى حداثة آخر استخدام لها:

• إذا كانت بيانات الشريحة عمرها أقل من ساعة، يستخدم Pushwoosh البيانات الحالية كما هي.
• إذا كانت أقدم من ساعة، يستمر Pushwoosh في استخدام البيانات الحالية بينما يتم تحديثها في الخلفية.
• إذا كانت أقدم من ثلاث ساعات، ينتظر Pushwoosh تحديثًا جديدًا قبل استخدام الشريحة.

من الناحية العملية، هذا يعني أن الشريحة التي تستخدمها بانتظام (على سبيل المثال، في Journey متكرر) تبقى محدّثة، بينما قد تستغرق الشريحة التي نادرًا ما تلمسها لحظة للتحديث في المرة الأولى التي تستخدمها فيها مرة أخرى.

إذا فشل التحديث (على سبيل المثال، أصبحت قاعدة البيانات غير قابلة للوصول أو بدأ الاستعلام في إظهار أخطاء)، يسجل Pushwoosh الخطأ، لكن حالة الشريحة في قائمة External Segments لا تتغير من تلقاء نفسها. بعد إصلاح المشكلة من جانبك، افتح الشريحة وانقر على Check connection لتأكيد الإصلاح. يتم مسح الخطأ تلقائيًا في المرة التالية التي يتم فيها تحديث بيانات الشريحة بنجاح.

استخدام شريحة خارجية

بمجرد إنشائها، تظهر الشريحة الخارجية تلقائيًا في Audience ← Segments تحت نفس الاسم، جاهزة للاستخدام مثل أي شريحة أخرى، على سبيل المثال كجمهور لحملة أو Journey.

لدمجها مع شروط أخرى، أضفها كمرشح:

1. اذهب إلى Audience ← Segments ← Create Segment.
2. انقر على Add filter by ← Segment.
3. حدد شريحتك الخارجية بالاسم.

نفس مرشح Segment متاح في المرشحات المركبة وعندما تختار الجمهور في الدخول القائم على الجمهور. لمزيد من المعلومات حول دمج الشرائح، راجع إنشاء شرائح حسب الشرائح الموجودة.

التحقق من عدد الأشخاص في الشريحة

لا تعرض قائمة External Segments عدد الأعضاء. افتح غلاف الشريحة في Audience ← Segments (راجع استخدام شريحة خارجية) واحسب حجمها هناك.

إدارة الشرائح الخارجية

في قائمة External Segments، يعرض كل صف اسم الشريحة، وCode (المعرف المستخدم للإشارة إلى الشريحة في استدعاءات API)، ونوع قاعدة البيانات، والمضيف، والحالة (valid أو invalid).

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