انتقل إلى المحتوى
وثائق المطور أدلة كيفية الاستخدام الدعم طلب عرض توضيحي تسجيل الدخول
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

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

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

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

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

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

Anchor link to

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

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