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

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

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

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

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

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

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

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

1. اذهب إلى الجمهور ← الشرائح الخارجية.
2. انقر على إنشاء شريحة خارجية.

3. أدخل الاسم للشريحة (حتى 100 حرف).
4. اختر نوع قاعدة البيانات: PostgreSQL، MySQL، Google BigQuery، Microsoft SQL Server / Fabric، أو Google Analytics 4 audience.

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

PostgreSQL و MySQL

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

• المضيف و المنفذ: عنوان خادم قاعدة البيانات الخاص بك. يتطلب Pushwoosh مضيفًا يمكن الوصول إليه بشكل عام ويرفض العناوين الخاصة أو الداخلية أو عناوين الاسترجاع عند التحقق من الاتصال أو حفظ الشريحة.
• قاعدة البيانات: اسم قاعدة البيانات.
• المستخدم و كلمة المرور: بيانات اعتماد لحساب للقراءة فقط.
• وضع SSL (لـ PostgreSQL فقط، حيث أن اتصالات MySQL لا تستخدم TLS) يحدد كيفية تطبيق SSL/TLS، البروتوكول الذي يشفر الاتصال، على اتصال قاعدة البيانات الخاصة بك. اسأل مسؤول قاعدة البيانات لديك عن الوضع الذي يجب استخدامه:
  • معطّل: لا يوجد تشفير.
  • مطلوب: يشفر الاتصال، لكنه لا يتحقق من هوية خادم قاعدة البيانات.
  • التحقق من CA: يشفر الاتصال ويتحقق من أن شهادة الخادم قد صدرت من قبل هيئة شهادات موثوقة (CA).
  • تحقق كامل: نفس التحقق من CA، ويتحقق أيضًا من أن الشهادة تطابق اسم مضيف قاعدة البيانات الخاصة بك. الخيار الأقوى.
• لأي وضع غير معطّل، قدم شهادة CA تحت مصدر الشهادة (رفع ملفات أو لصق PEM)، بالإضافة إلى شهادة العميل و مفتاح العميل إذا كانت قاعدة بياناتك تتطلبها.

BigQuery

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

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

SQL Server / Fabric

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

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

Google Analytics 4 audience

تأخذ شريحة Google Analytics 4 audience مستخدميها من جمهور أنشأته في Google Analytics، لذا لا يوجد لها استعلام. املأ:

• معرّف موقع GA4: معرف موقع Google Analytics، ويظهر في Google Analytics ضمن Admin ← Property details.
• Service account JSON: مفتاح حساب خدمة لديه دور Viewer على هذا الموقع. امنح الدور في Google Analytics ضمن Admin ← Property access management، وفعّل Google Analytics Data API و Admin API في مشروع Google Cloud الخاص بحساب الخدمة.
• الجمهور: انقر على تحميل الجماهير، ثم اختر الجمهور. إذا كانت القائمة فارغة، فأنشئ جمهورًا في Google Analytics أولاً.

لمعرفة الإعداد من جانب Google Analytics، راجع تكامل Google Analytics. ثم انقر على التحقق من الاتصال. عندما ينجح التحقق، انقر على إنشاء.

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

لكل أنواع قواعد البيانات باستثناء Google Analytics 4 audience:

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

SELECT user_id FROM loyalty_members WHERE tier = 'gold'

ملاحظة

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

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

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

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

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

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

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

تتبع شريحة Google Analytics 4 audience القواعد نفسها، مع 24 ساعة و72 ساعة بدلاً من ساعة واحدة وثلاث ساعات. يحدّث Google Analytics عضوية الجمهور مرة واحدة يوميًا تقريبًا.

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

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

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

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

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

1. اذهب إلى الجمهور ← الشرائح ← إنشاء شريحة.
2. انقر على إضافة تصفية حسب: ← الشريحة.
3. حدد شريحتك الخارجية بالاسم.

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

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

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

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

في قائمة الشرائح الخارجية، يعرض كل صف:

• اسم الشريحة.
• الرمز: المعرف المستخدم للإشارة إلى الشريحة في استدعاءات API.
• نوع قاعدة البيانات.
• المضيف، أو الموقع في حالة Google Analytics 4 audience.
• الحالة، صالحة أو غير صالحة.

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