تقدم هذه المقالة بعض النصائح حول إنشاء وتنسيق الملفات التي تحمِّلها إلى Analytics. ويجب تنسيق هذه الملفات بشكلٍ صحيح، وإلا فقد تحدث أخطاء في التحميل.
في هذه المقالة:اعتبارات عامة
- يجب تحميل ملفات البيانات بتنسيق CSV (قيم مفصولة بعلامات الفاصلة).
- يجب أن يُطابق رأس ملف CSV مخطط مجموعة البيانات المستهدفة تمامًا. يجب أن يكون ترتيب الأعمدة متطابقًا مع نفس الترتيب المحدّد في المخطط، ويجب أن تستخدم جميع أسماء الأعمدة اسم مكوّن أو مقياس
ga.الداخلي، وليس الاسم المعروض. (على سبيل المثال،ga:source، وليسSource). - يجب أن يتم تنسيق البيانات المحمَّلة بشكلٍ صحيح. انظر أدناه لمزيد من التفاصيل.
إنشاء ملف التحميل
في حين أن لك مطلق الحرية في استخدام أي وسيلة ملائمة لك، فإن هناك طريقتين بسيطتين لإنشاء ملف تحميل: باستخدام محرر نصوص أو باستخدام أحد تطبيقات جداول البيانات. وبصرف النظر عن كيفية إنشاء الملف، ستحتاج إلى مخطط مجموعة البيانات لإنشاء رأس ملف التحميل.
الحصول على المخطط
يمكنك نسخ مخطط مجموعة بيانات أو تنزيله عن طريق تعديل مجموعة البيانات والنقر على الزر الحصول على المخطط.
كيفية الحصول على مخطط مجموعة البيانات:- سجّل الدخول إلى "إحصاءات Google".
- انقر على المسؤول، وانتقل إلى الموقع الذي تريد تحميل البيانات فيه.
- في عمود الموقع، حدّد الموقع الذي يحتوي على مجموعة البيانات التي ستحتفظ فيها ببياناتك.
- انقر على استيراد البيانات.
- انقر على رابط الاسم لمجموعة البيانات المستهدفة.
- انقر على الزر الحصول على المخطط (بالقرب من أسفل الصفحة). وسيؤدي هذا إلى عرض مربّع الحوار الموضّح أدناه.
استخدام محرر نصوص
لإنشاء ملف التحميل باستخدام محرر نصوص، انسخ المخطط وألصقه في السطر الأول من ملف جديد. ويمكنك بعدئذٍ إضافة بياناتك، بمعدل سجل واحد لكل صف، تحت هذا الرأس.تأكد من أن المحرر الذي تستخدمه قادر على إنشاء ملفات النصوص العادية. يجب عدم استخدام محررات النصوص الغنية، مثل Microsoft Word، إلا في حالة حفظ ملفاتك كنص (.txt) بوضوح. ويحتوي تنسيق النص المنسَّق على تنسيق إضافي وأحرف تحكم يُحتمل أن تتسبب في حدوث أخطاء استيراد.
استخدام جدول بيانات
لاستخدام جدول بيانات لبيانات التحميل، اتبع الخطوات المذكورة أعلاه للحصول على مخطط مجموعة البيانات. وبعد ذلك، انقر على الزر تنزيل نموذج المخطط. وسيؤدي هذا إلى وضع رؤوس المخطط في دليل التنزيلات. ويمكنك بعد ذلك فتح المخطط في جدول البيانات المفضل لك. استخدم وظيفة استيراد جدول البيانات لجلب البيانات التي تريد تحميلها. وعندما يكون ملفك جاهزًا للتحميل، استخدم وظيفة حفظ باسم أو تصدير من برنامج جداول البيانات واختر CSV كتنسيق للإخراج.
تنسيق ملف التحميل
تتوقع عملية استيراد البيانات أن يحتوي كل سطر في ملف التحميل على معلومات حول نتيجة واحدة. ويتم فصل المكوّنات والمقاييس الفردية - التي تشكّل تلك النتيجة - عن بعضها البعض بعلامات فاصلة. وينتهي كل سطر في الملف بفاصل أسطر. إذا كانت هناك علامات فاصلة ضمن البيانات الفعلية التي تريد تحميلها، يجب أن تحيط هذه البيانات بعلامات اقتباس. وربما يتمثل السبب الأكثر شيوعًا لأخطاء المحتوى في الاستخدام غير السليم لعلامات الفاصلة وعلامات الاقتباس وأحرف فواصل الأسطر في البيانات المحمَّلة؛ لذا يمكن أن يساعدك فهم كيفية تعامل عملية استيراد البيانات مع هذه العلامات في تجنب المتاعب التي قد تواجهها.
علامات الفاصلة
بحكم تعريفه، يستخدم ملف CSV علامات الفاصلة لبدء خلية جديدة. بعبارة أخرى، عند ملاحظة عملية استيراد البيانات لعلامة فاصلة لم يتم إلغاؤها، فإنها تفترض أنك تبدأ إدخال عمود جديد. ويوضح المثال التالي بيانات منسقة بشكل مناسب:
abc123,29.99,Blue,XXL def345,100,Red,M ghi678,1035.20,Green,S
في هذه الحالة، تلاحظ عملية استيراد البيانات أربعة أعمدة للبيانات:
| abc123 | 29.99 | أزرق | XXL |
| def345 | 100 | أحمر | متوسط |
| ghi678 | 1035.20 | أخضر | صغير |
ولكن، ماذا يحدث إذا أضفنا علامة فاصلة إضافية إلى البيانات، على سبيل المثال، عن طريق تنسيق العمود الرقمي كعملة، بواسطة إضافة علامة فاصلة لتمييز موضع الآلاف كما يلي؟
ghi678,1,035.20,أخضر,صغير
الآن، بسبب الفاصلة الإضافية، عندما تحاول تحميل هذا الملف، فستلاحظ عملية استيراد البيانات خمسة أعمدة، ويعمل ذلك على إنتاج جدول تحميل يشبه ما يلي:
| abc123 | 29.99 | أزرق | XXL | |
| def345 | 100 | أحمر | متوسط | |
| ghi678 | 1 | 035.20 | أخضر | صغير |
سينتج عن ذلك خطأ، مثل الخطأ التالي:
"خطأ: عدد الأعمدة لا يتطابق"
علامات الاقتباس
يمكن استخدام علامات الاقتباس المزدوجة "لإلغاء" قيمة إحدى الخلايا. في المعتاد، تحيط قيمة الخلية بعلامات اقتباس إذا كانت القيمة تحتوي على فاصلة. بخلاف ذلك، ستفسر عملية استيراد البيانات علامة الفاصلة كبداية لخلية جديدة (راجع ذلك أعلاه).
مثال:
ghi678,1,035.20,أخضر,صغير
يتم التعامل مع القيمة "1,035.20" كخلية واحدة (رغم أن عملية استيراد البيانات ستلاحظ ذلك كسلسلة وليست قيمة عملة).
عند إنهاء إحدى الخلايا بعلامات الاقتباس، يجب أن يكون عدد علامات الاقتباس عددًا مناسبًا. في حالة وجود عدد غير ملائم من علامات الاقتباس في صف محدد، ستفشل عملية الاستيراد مع ظهور رسالة تشبه الرسالة التالية:
"خطأ: تنسيق CSV غير صالح في الصف س."
فواصل الأسطر
يتم استخدام فواصل الأسطر في ملف CSV للإشارة إلى بداية صف جديد. لا يدعم استيراد البيانات فواصل الأسطر في الخلايا حتى في حالة إنهائها بعلامات اقتباس. سيتسبب السطر الزائد في أحد الصفوف في حدوث خطأ في عدد الأعمدة في هذا الصف أو في أحد الصفوف التي تليه، مما يعمل على ظهور رسالة خطأ تشبه الرسالة التالية:
"خطأ: تنسيق صف CSV غير صالح"
