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

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

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

إنشاء تقرير

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

ملاحظة مهمة: لتجنُّب فقدان التغييرات، انقر على حفظ بعد إجراء أي تعديلات على تقرير، بما في ذلك الجداول.

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

---

المعلمات

تتيح لك المَعلمات تحديد طريقة تنفيذ تقرير معيّن. عند استخدام SQL لإنشاء تقرير (أو عند تعديل 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 لمطابقة المنطقة الزمنية المحدّدة في مهمة جديدة. من المهم أيضًا استخدام المنطقة الزمنية نفسها المستخدَمة في مصدر البيانات.
params	string مساحة الاسم لتسمية الجداول التي يتم تصديرها. استخدِم التنسيق التالي لإنشاء عنصر نائب في طلب البحث، ثمّ قدِّم اسم الجدول عند تشغيل التقرير: params.TABLE_NAME (لا تستخدِم علامة @ قبل الاسم كما هو الحال مع المَعلمات الأخرى). لمزيد من المعلومات والأمثلة حول استخدام هذه المَعلمة، راجِع تصدير جداول متعددة باستخدام طلب بحث واحد.

---

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

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

تجمع ملخّصات الصفوف المفلتَرة البيانات التي تمت فلترتها بسبب عمليات فحص الاختلافات. يتم جمع البيانات من الصفوف المفلترة وإضافتها إلى صف شامل. على الرغم من أنّه لا يمكن تحليل البيانات التي تمت فلترتها بشكل إضافي، إلا أنّها تقدّم ملخّصًا عن مقدار البيانات التي تمت فلترتها من النتائج. بالنسبة إلى طلبات البحث التي تستخدم وضع الخصوصية مع عمليات التحقّق من الاختلافات، تفعّل 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" أو "مركز البيانات".

معاينة

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

BigQuery

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

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

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