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

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

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

إنشاء تقرير

يمكن للمحلّلين والمستخدِمين المتميّزين إنشاء التقارير وتعديلها. مزيد من المعلومات عن التحكّم في الوصول في 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" المرتبط، مثل حساب "إعلانات Google". ملاحظة: لا يتم دعم النطاق الزمني المخصص لاختبار طلب البحث إلا عند تشغيل الاستعلام من شاشة محرر SQL.
   • اختياري: يمكنك تغيير إعدادات الخصوصية وضبط ملخّص الصفوف التي تمّت فلترتها.
   • اختَر المشروع ومجموعة البيانات والجدول في BigQuery حيث يجب حفظ نتائج التقارير.
8. اختياري: اضبط التقرير ليتم تنفيذه وفقًا لجدول زمني.
9. انقر على حفظ.

---

المعلمات

تتيح لك المَعلمات تحديد كيفية تنفيذ تقرير معيّن. عند استخدام لغة الاستعلامات البنيوية (SQL) لإنشاء تقرير (أو عند تعديل لغة الاستعلامات البنيوية من نموذج تقرير)، تسمح لك المَعلمات بإعادة استخدام رمز 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. يمكنك استخدام هذه المَعلمات في تقاريرك، ولكن لا يمكنك إنشاء مَعلمة بالاسم نفسه المستخدَم في مَعلمة محجوزة.

start_date	date تاريخ بدء (شامل) مهمة إعداد التقارير سيتم تجاهل أي مَعلمة من تحديد المستخدم تحمل هذا الاسم واستبدالها بالقيم المحدّدة في مربّع الحوار مهمة جديدة.
end_date	date تاريخ الانتهاء (شامل) لمهمة التقرير. سيتم تجاهل مَعلمة محدّدة من المستخدِم بهذا الاسم واستبدالها بالقيم التي تم ضبطها في مربّع حوار مَهمّة جديدة.
time_zone	string المنطقة الزمنية لمهمة إعداد التقارير سيتم تجاهل مَعلمة محدّدة من المستخدِم بهذا الاسم واستبدالها بالقيم التي تم ضبطها في مربّع حوار مَهمّة جديدة. ملاحظة: لمنع حدوث تناقضات عند استخدام المناطق الزمنية في تقريرك، مثل الجمل WHERE، يمكنك استخدام time_zone لمطابقة المنطقة الزمنية التي تم ضبطها في وظيفة جديدة. من المهم أيضًا استخدام المنطقة الزمنية نفسها المستخدَمة في مصدر البيانات.

---

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

ملاحظة: تكون ملخّصات الصفوف التي تمت فلترتها غير ضرورية عند استخدام وضع التشويش. تعرَّف على مزايا استخدام التشويش بدلاً من عمليات التحقّق من الاختلافات.

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

---

تعديل تقرير

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

---

تنفيذ تقرير

ملاحظة مهمة: يمكنك اختبار استعلامات SQL باستخدام مساحة العمل الاختبارية قبل تشغيلها على بيانات حقيقية. مزيد من المعلومات عن أفضل الممارسات لكتابة طلبات البحث في Ads Data Hub

قبل تنفيذ تقرير، تأكَّد من أنّك منحت حساب الخدمة 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" أو استكشاف باستخدام "مركز البيانات" من الخيارات. يؤدي ذلك إلى فتح البيانات في نافذة جديدة.