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

استيراد جهات الاتصال

سجّل جهات الاتصال في البريد الإلكتروني (email)، والرسائل القصيرة (SMS)، وواتساب (WhatsApp)، وفايبر (Viber) من ملف CSV واحد. يمكن لعمود رقم هاتف واحد تسجيل جهة الاتصال في كل من SMS وWhatsApp، لذا لا تحتاج إلى ملف منفصل لكل قناة.

تجهيز ملف CSV الخاص بك

Anchor link to

تنسيق الملف

Anchor link to
  • يجب أن يحتوي الصف الأول على رؤوس أعمدة تصف البيانات في كل عمود.
  • يمثل كل صف لاحق جهة اتصال واحدة، مع قيم تتوافق مع الرؤوس.
  • يجب فصل القيم بفواصل.
  • احفظ الملف بترميز UTF-8 لضمان عرض الأحرف بشكل صحيح.
  • الحد الأقصى لحجم الملف هو 100 ميغابايت.

أعمدة جهات الاتصال

Anchor link to

قم بتضمين عمود واحد على الأقل من الأعمدة التالية، اعتمادًا على القنوات التي تريد تسجيل جهات الاتصال فيها:

  • البريد الإلكتروني (Email): عنوان البريد الإلكتروني للمستلم.
  • رقم الهاتف (للرسائل القصيرة وواتساب وفايبر): بالتنسيق الدولي، ويبدأ بـ + متبوعًا برمز البلد، على سبيل المثال +120XXXXX234. أدخل الرقم العادي بدون البادئة whatsapp: أو viber:. يضيف Pushwoosh البادئة عند ربط العمود بتلك القناة.

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

الأعمدة الاختيارية

Anchor link to
  • معرف المستخدم (User ID): معرف فريد للمستخدم (مثل الاسم أو البريد الإلكتروني). غير مطلوب، ولكن يوصى به حتى تشترك قنوات جهة الاتصال في ملف تعريف مستخدم واحد بدلاً من عدة ملفات.
  • يمكن ربط أي عمود آخر بـ Tag نظام للتجزئة والتخصيص، على سبيل المثال الموقع (Location)، تاريخ الميلاد (Birthday)، اللغة (Language)، أو نوع العميل (Customer type).

مثال على ملف CSV

Anchor link to
Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

تحميل وربط ملف CSV

Anchor link to

  1. اذهب إلى Audience → Import CSV → Import Contacts.

    مركز استيراد CSV في قسم الجمهور (Audience) يعرض بطاقة استيراد جهات الاتصال (Import Contacts) بجانب تحديث قيم الـ Tag، واستيراد مشتركي الإشعارات، واستيراد الأحداث، واستيراد فئات الاشتراك

  2. انقر على Upload CSV واختر ملفك. لاستبداله، انقر على Upload Another CSV.

  3. أدخل اسم شريحة (Segment name) لجهات الاتصال المستوردة.

  4. تحت Contact column in CSV، اختر عمودًا، وبجانبه، اختر القناة (Channel) التي يسجلها (Email، SMS، WhatsApp، أو Viber). انقر على + Add channel لربط عمود آخر، أو لربط نفس العمود بقناة إضافية.

  5. تحت UserId column in CSV، اختر العمود الذي يحتوي على معرفات المستخدمين الفريدة، إذا كان ملفك يحتوي على واحد.

  6. لتضمين بيانات إضافية للتجزئة، اختر اسم عمود (Column Name) من ملف CSV الخاص بك وقم بتعيين Tag له. انقر على + Add Column لربط المزيد من السمات.

    خطوة الربط في معالج استيراد جهات الاتصال مع عمود واحد مربوط بالبريد الإلكتروني، وعمود Mobile مربوط بالرسائل القصيرة وواتساب وفايبر، وعمود City مربوط بـ Tag

  7. انقر على Start Import.

بعد الاستيراد، تكون جهات الاتصال متاحة للحملات على القنوات التي قمت بربطها. تظهر كشريحة (segment) جديدة في قائمة الشرائح ويمكن الوصول إليها أيضًا عبر مستكشف المستخدم (User explorer).

تعرض شاشة الإكمال عددين:

  • Created: تسجيلات القنوات الجديدة على التطبيق.
  • Updated: تسجيلات القنوات التي كانت موجودة بالفعل، بما في ذلك عندما يُعاد تسجيل نفس العنوان أو الرقم تحت User ID مختلف أو على منصة جهاز مختلفة.

يحتسب كلا العددين تسجيلات القنوات، وليس جهات الاتصال أو صفوف CSV. جهة الاتصال المربوطة بقناتين، مثل SMS وWhatsApp، تضيف 2.

بالنسبة لجهة اتصال محدّثة، تتغير فقط الـ Tags المربوطة في الخطوة 6. تُستبدل قيمها بقيم CSV. أما الـ Tags الأخرى المعيّنة مسبقًا لجهة الاتصال فتبقى كما هي.

الصفوف التي تم تخطيها أثناء الاستيراد

Anchor link to

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

تجمع شاشة الإكمال الصفوف التي تم تخطيها حسب السبب:

  • عنوان البريد الإلكتروني غير صالح
  • عنوان بريد إلكتروني مؤقت
  • عنوان البريد الإلكتروني في قائمة الارتداد
  • رقم الهاتف غير صالح
  • لا يوجد عنوان جهة اتصال في الصف: كل عمود مربوط كان فارغًا

يمكن استيراد صف جزئيًا ولا يزال يظهر في هذا التفصيل. على سبيل المثال، يُستورد عمود الهاتف، لكن يتم تخطي عنوان البريد الإلكتروني في الصف نفسه لأنه مؤقت.

انقر على Download skipped rows للحصول على ملف CSV لتلك الصفوف فقط. يضيف الملف سبب التخطي كعمود إضافي حتى تتمكن من إصلاح الصفوف وإعادة تحميلها.

عناوين البريد الإلكتروني على نطاقات بلا خادم بريد

Anchor link to

بعد الاستيراد، يتحقق Pushwoosh في الخلفية من أن نطاق كل عنوان بريد إلكتروني مستورد يملك خادم بريد. إذا كان النطاق غير موجود أو لا يقبل البريد، يُلغى اشتراك العنوان في البريد الإلكتروني. إذا تعذّر التحقق من النطاق، على سبيل المثال لأن DNS لا يستجيب، يبقى العنوان مشتركًا.

لا يتحقق Pushwoosh مما إذا كان صندوق بريد معين موجودًا على نطاق يعمل.

الصفوف التي فشل الاستيراد في تسجيلها

Anchor link to

تجتاز بعض الصفوف فحوصات التخطي ومع ذلك تُرفض عندما يسجلها Pushwoosh. على سبيل المثال، يُرفض رقم هاتف بتنسيق صالح لقناة SMS إذا لم يكن رقم هاتف محمول. يحسب Pushwoosh صفوفًا كهذه على أنها Failed، بشكل منفصل عن Created أو Updated أو Skipped.

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