بدء استخدام واجهة مستخدم الويب في Ads Data Hub

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

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

إنشاء تقريرك باستخدام نموذج كتابة لغة الاستعلامات البنيوية (SQL) الخاصة بك

كتابة لغة الاستعلامات البنيوية (SQL) الخاصة بك

1. في Ads Data Hub، افتح صفحة التقارير.
2. انقر على + إنشاء تقرير.
3. انقر على SQL لفتح تقرير فارغ.

4. انسخ لغة الاستعلام البنيوية (SQL) التالية، ثم الصقها في محرِّر التقارير. يمكنك استبدال cm_dt_impressions بجدول من بيانات الإعلانات المرتبطة. على سبيل المثال، إذا ربطت حسابًا على "إعلانات Google"، استبدِل cm_dt_impressions بـ google_ads_impressions.

   SELECT COUNT(*) AS impressions FROM adh.cm_dt_impressions;
   

يُرجى العِلم أنّه لم يتم حفظ تقريرك في هذه المرحلة. ويمكنك حفظه بعد الاختبار في المرحلة التالية.

اختبار SQL باستخدام وضع الحماية

يجب اختبار طلبات البحث بتنسيق SQL باستخدام دور وضع الحماية قبل تشغيلها على بيانات الإنتاج. ويمكن أن يساعدك ذلك في العثور على المشاكل بشكلٍ أسرع.

1. انقر على تشغيل أثناء التواجد في عرض محرِّر SQL. يتم فتح لوحة مهمة جديدة. ملاحظة: تتوفّر لوحة مهمة جديدة عندما يكون محرِّر SQL مفتوحًا، وهي مفيدة لاختبار تقريرك وتكراره قبل تطبيق التغيُّرات. لا تساهم المهام التي يتمّ تشغيلها من هذه اللوحة في سجلّ تنفيذ تقريرك المحفوظ.
2. اختَر عميل Sandbox في ADH من القائمة المنسدلة بيانات الإعلانات من.
3. اختَر المشروع ومجموعة البيانات والجدول في BigQuery حيث يجب حفظ نتائج تقريرك.
4. سيتم تعديل النطاق الزمني تلقائيًا إلى "17 آب (أغسطس) - 18 أيلول (سبتمبر) 2018" ليعمل على مطابقة محتوى بيانات مساحة الاختبار.
5. انقر على تشغيل. سيتم عرض حالة المهمة وتفاصيلها أسفل محرِّر SQL.

6. بعد انتهاء تشغيل المهمة، افتح النتائج في BigQuery. من المفترض أن يظهر لك جدول يليه جدول آخر بالشكل التالي:

   الصف	مرات الظهور
   1	388204742

7. انقر على تم لمغادرة محرِّر SQL بعد أن تصبح راضيًا عن نتائج تقرير الاختبار. أنت جاهز لتشغيله استنادًا إلى بيانات حقيقية.

تشغيل استعلام SQL باستخدام بياناتك المرتبطة

بعد اختبار طلبات SQL باستخدام دور "مساحة المحاكاة"، تكون مستعدًا لتشغيلها على data حقيقية.

1. أدخِل اسمًا للتقرير.
2. اضبط الإدخال والإخراج للمهام التي يتم تنفيذها في هذا التقرير:
   1. اختَر مصدر بيانات في الحقل بيانات الإعلانات من. يجب أن يكون هذا هو رقم تعريف حساب Ads Data Hub المرتبط ببيانات الإعلانات التي تريد الاستعلام عنها.
   2. اختَر نطاقًا زمنيًا ومنطقة زمنية للتقرير. يجب أن تتطابق المنطقة الزمنية للتقرير مع المنطقة الزمنية لحساب الإعلانات المرتبط، مثل حساب "إعلانات Google".
   3. ضمن إعدادات التشويش في الخصوصية، ننصحك بضبط مفتاح التبديل على وضع "استخدام التشويش". مزيد من المعلومات حول ميزات الحفاظ على الخصوصية
   4. اترك ملخّص الصفوف التي تمّت فلترتها في الوضع التلقائي.
   5. اختَر المشروع ومجموعة البيانات والجدول في BigQuery حيث يجب حفظ نتائج التقارير.
3. انقر على حفظ.
4. انقر على تشغيل.

لمزيد من المعلومات عن الميزات المتقدّمة لإنشاء التقارير، مثل المَعلمات والجداول الزمنية، اطّلِع على المستندات المفصّلة في مقالة إنشاء التقارير وتنفيذها.