إنشاء التقارير وتنفيذها

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يشرح لك هذا الدليل كيفية إنشاء التقارير وتنفيذها، بالإضافة إلى كيفية عرض نتائجك.

إنشاء تقرير

يمكن للمحلّلين والمستخدِمين المتميّزين إنشاء التقارير وتعديلها. مزيد من المعلومات عن التحكّم في الوصول في Ads Data Hub

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

المعلمات

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

في المثال التالي، يحتوي التقرير على مَعلمة تُسمى campaign_ids، التي تقبل array من int64 أرقام تعريف الحملات:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

أنواع المَعلمات

يُسمح بالأنواع التالية من المَعلمات:

• int64
• float64
• bool
• string
• date
• timestamp
• array (من أيّ من الأنواع المسموح بها)

إضافة مَعلمة إلى تقرير

1. افتح تقريرًا محفوظًا أو أنشئ تقريرًا جديدًا.
2. انقر على تعديل الطلب.
3. ضمن السمات، انقر على إضافة مَعلمة.
4. أدخِل اسمًا في حقل الاسم. ستستخدم هذا الاسم للإشارة إلى المَعلمة في نص التقرير.
5. استخدِم القائمة المنسدلة لاختيار نوع المَعلمة.
   • في حال اختيار نوع الصفيف، ستظهر قائمة منسدلة إضافية. اختَر نوع الصفيف في هذه القائمة المنسدلة.
6. في طلب البحث SQL، أضِف المَعلمة باستخدام تنسيق مَعلمة SQL العادي: @PARAMETER_NAME. اطّلِع على المثال التالي الذي يتّبع هذه الخطوات.
7. انقر على تم، ثم انقر على حفظ.

استخدام مَعلمة

1. افتح تقريرًا تم ضبط مَعلماته.
2. في لوحة الإعداد، أدخِل قيمًا لكل مَعلمة حدّدتها.
3. انقر على حفظ للحفاظ على قيم المَعلمات.

إزالة مَعلمة

1. افتح تقريرًا تم ضبط مَعلماته.
2. انقر على تعديل الطلب لفتح محرِّر لغة الاستعلامات البنيوية (SQL).
3. ضمن الخصائص، انقر على رمز الحذف حذف بجانب المَعلمة التي تريد حذفها.
4. انقر على تم، ثم انقر على حفظ.

المَعلمات المحجوزة

يسرد الجدول التالي المَعلمات المحجوزة من قِبل Ads Data Hub. يمكنك استخدام هذه المَعلمات في تقاريرك، ولكن لا يمكنك إنشاء مَعلمة بالاسم نفسه المستخدَم في مَعلمة محجوزة.

ملخّص الصفوف التي تمّت فلترتها

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

تعديل تقرير

1. في Ads Data Hub، افتح صفحة التقارير.
2. انقر على اسم التقرير الذي تريد تعديله.
3. أدخِل التغييرات على التقرير. على سبيل المثال، يمكنك تعديل لغة الاستعلامات البنيوية (SQL) أو إدارة قيم المَعلمات أو ضبط جدول زمني.
4. انقر على حفظ.

تنفيذ تقرير

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

1. في Ads Data Hub، افتح صفحة التقارير.
2. انقر على اسم التقرير الذي تريد تنفيذه.
3. انقر على تشغيل.

تنفيذ تقرير وفقًا لجدول زمني

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

لعرض المهام المُجدوَلة في صفحة الصفحة الرئيسية، اختَر أي شخص من قائمة فلاتر المالك.

الاطّلاع على النتائج

بعد انتهاء تنفيذ تقريرك، يمكنك معاينة النتائج في صفحة تفاصيله. للاطّلاع على النتائج في وقت لاحق، افتح التقرير من صفحة الصفحة الرئيسية. يمكنك أيضًا استكشاف البيانات في BigQuery أو "جداول بيانات Google" أو "مركز data Studio".

معاينة

انقر على معاينة ضمن المهمة المكتملة. ستظهر أوّل 20 نتيجة أسفل المهمة.

BigQuery

يتم تصدير النتائج تلقائيًا إلى BigQuery. انقر على عرض الجدول لفتح BigQuery في نافذة جديدة.

"جداول بيانات Google" و"مركز البيانات"

افتح القائمة المنسدلة استكشاف واختَر استكشاف باستخدام "جداول بيانات Google" أو استكشاف باستخدام "مركز البيانات" من الخيارات. يؤدي ذلك إلى فتح البيانات في نافذة جديدة.