انتقل إلى المحتوى

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

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

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

Anchor link to

قواعد تنسيق CSV

Anchor link to

الهيكل العام

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

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

Anchor link to

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

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

يتم تجاهل رقم الهاتف الذي ليس بتنسيق دولي صالح لتلك القناة أثناء الاستيراد بدلاً من التسبب في فشل الصف بأكمله.

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

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، واستيراد مشتركي الإشعارات، واستيراد الأحداث، واستيراد فئات الاشتراك

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

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

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

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

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

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

  1. انقر على Start Import لبدء معالجة الملف.

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

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

Anchor link to

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

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

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

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

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

Anchor link to

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

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