إعداد بياناتك للاستيراد

This article applies to supported import sources that are part of an open beta and are subject to change.

الحفاظ على حداثة بياناتك

يجب التأكّد من إعادة تحميل بياناتك في مصدر الاستيراد قبل تنفيذ عملية استيراد يدوية أو مُجدوَلة حتى يتم استيراد هذه البيانات لاستخدامها في الوجهة أو حالة الاستخدام المقصودة. على سبيل المثال، إذا اخترت جدولاً زمنيًا يوميًا، عليك إعادة تحميل بياناتك بصفة يومية، وذلك قبل بدء عملية الربط المُجدوَلة.

إتاحة بياناتك

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

تتطلّب بعض مصادر الاستيراد أن يكون لديك بيانات اعتماد صحيحة لربط مصدر الاستيراد. للحصول على إرشادات محدّدة، يمكنك الاطّلاع على الدليل المحدّد لمصدر الاستيراد الذي تستخدِمه.

تنسيق البيانات

توضِّح لك الأقسام التالية كيفية تنسيق بياناتك بشكلٍ سليم لضمان استيرادها بدون خطأ.

لمحة عن تنسيقات الملفّات

إذا كنت بصدد تحميل ملفّ، مثل ملفّ CSV، يجب أن يحتوي السطر الأوّل من الملفّ على العناوين.

تأكَّد من أنّ الملفّ له امتداد، وذلك لأنّه يتمّ رفض الملفّات التي لا ليس لها امتدادات.

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

يمكن تحويل التواريخ والأوقات بتنسيقات مختلفة إلى طابع زمني منطقي، ويجب أن يستند ذلك إلى ستة نماذج باستخدام ثلاث مجموعات تنسيقات: DATE (التاريخ) وTIME (الوقت) وTIMEZONE (المنطقة الزمنية). ولا يمكن استخدام النوع DATETIME (التاريخ الوقت). يجب تحويل حقول DATETIME إلى النوع STRING في مصدر الاستيراد باستخدام التنسيقات المتوافقة الموضّحة في هذه المقالة.

في ما يلي أمثلة على الطوابع الزمنية بالتنسيقات المتوافقة:

• 2012-08-15T00:01:54Z (UTC ISO 8601 Standard)
• 2012-08-14T17:01:54-07:00 (ISO 8601 Standard with Offset)
• Aug 14, 2012 17:01:54
• 08/14/2012T5:01:54 PM
• 2012-08-14‎ 5:01:54 PM
• 08/14/2012‎ 17:01:54
• 2012-08-14‎ 17:01:54
• 08/14/2012‎ 17:01:54*123
• 2012-08-14T17:01:54-07
• 08/14/2012T17:01:54-0700
• 2012-08-14T17:01:54-070000
• 2012-08-14T17:01:54-07:00:00
• 2012-08-14T17:01:54 America/Los_Angeles
• Aug 14, 2012 17:01:54PST
• 2012-08-14‎ 17:01:54 PST
• 2012-08-14‎ 17:01:54 Pacific Standard Time
• 2012-08-14‎ 17:01:54 GMT-07:00
• 08/14/2012‎ 17:01:54 GMT-07:00:00
• July 17, 2025 17:01:54 PST
• ‎17 July 2025 17:01:54 GMT-07:00
• 17-Jul-2025T17:01:54-07:00

عند استيراد البيانات، تحوّل "إحصاءات Google" تلقائيًا تنسيقات التاريخ الشائعة المختلفة إلى معيار ISO 8601، أي ‎YYYY-MM-DD.

تتوفّر التنسيقات التالية لحقول التاريخ:

التنسيق	الوصف	مثال
YYYY-MM-DD	ISO 8601	2025-07-17
MM/DD/YYYY	تنسيق أمريكي	07/17/2025
MMM DD, YYYY	اسم شهر مختصر	يوليو 17، ‏2025
Month DD, YYYY	تنسيق طويل	يوليو 17، ‏2025
DD Month YYYY	صيغة أوروبية طويلة	‫17 يوليو 2025
DD-MMM-YYYY	تنسيق دولي شائع	‫17-يوليو-2025

إذا كانت بياناتك تحتوي على تاريخ غير واضح، مثل ‎01/02/2026، قد يتم اجتياز عملية التحقّق ومعالجته على أنّه 1 فبراير لأنّ تنسيق ‎MM/DD/YYYY متوافق، حتى إذا كنت تقصد 2 يناير. لضمان دقة البيانات، إذا حدّد النظام صفًا واحدًا باستخدام التنسيق ‎DD/MM/YYYY، سيتعذّر الاستيراد لمنع المعالجة غير الصحيحة.

لمحة عن تجزئة بيانات العملاء الخاصة

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

إذا كنت تفضّل تجزئة بيانات العملاء الخاصة بنفسك، راجِع مقالة تنسيق ملف بيانات العملاء للتأكُّد من تنسيقه بشكلٍ صحيح. وإذا حمَّلت ملفّ بيانات مجزّأة، يجب عدم تجزئة بيانات العملاء غير الخاصة. سيتم إرسال بياناتك المجزّأة إلى واجهة برمجة التطبيقات.

ملاحظة: إنّ عملية التجزئة الذكية تلقائية، ما يعني أنّك لن تحتاج إلى اختيار أيّ عنصر من قائمة "الإجراءات".

تحديد نطاق استيراد البيانات باستخدام الفلاتر

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

يمكنك تطبيق فلتر واحد يتضمّن ما يصل إلى 25 شرطًا لكلّ مصدر استيراد مرتبط.

إنشاء فلتر

لإنشاء فلاتر من أجل مصدر استيراد جديد، أضِفها أثناء مرحلة اختيار البيانات في عملية الإعداد:

1. من خطوة اختيار البيانات في عملية الإعداد، انقر على الفلتر لتوسيع هذا القسم.
2. اختَر الحقل الذي تريد استخدامه لفلترة بياناتك.
3. اختَر عامل تشغيل.
4. أدخِل قيمة.
5. اختياري: أنشئ شروطًا إضافية عن طريق النقر على و أو أو.
6. واصِل عملية الإعداد.

لإنشاء فلاتر وتعديلها لمصدر استيراد مرتبط حالي، اتّبِع الخطوات التالية:

1. انقر على اسم مصدر الاستيراد لتعديله.
2. ضمن الفلتر، انقر على تعديل.
3. أدخِل التغييرات التي تريدها، وانقر على حفظ.

عوامل التشغيل المتوافقة

• و
• أو
• لا يحتوي على (سلاسل أو عدد صحيح أو تاريخ أو وقت أو قيمة منطقية)
• يحتوي على (سلاسل أو عدد صحيح أو تاريخ أو وقت أو قيمة منطقية)
• أكبر من (عدد صحيح)
• يساوي (عدد صحيح أو سلسلة أو تاريخ)
• أصغر من (عدد صحيح) 
• قبل (تاريخ أو وقت)
• بعد (تاريخ أو وقت)
• لا يساوي
• تبدأ بـ
• تنتهي بـ
• لا يبدأ بـ
• لا ينتهي بـ

أنواع البيانات المتوافقة

• العملة
• التاريخ
• الوقت
• منطقي
• عدد صحيح
• قائمة منسدلة
• سلسلة