كتابة التقارير وتنفيذها

العبارة الرئيسية: يُطلق الآن على طلبات البحث اسم التقارير. وقد تظهر لك هذه العبارات مستخدمة بالتبادل في واجهة المستخدم وفي المستندات أثناء الانتقال إلى التقارير.

إنشاء تقرير

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

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

المَعلمات

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

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

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

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

إنشاء مَعلمة

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

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

في نص التقرير، استخدِم التنسيق العادي لمَعلمة SQL (لغة الاستعلام البنيوية)، وهو أن يسبق اسم المَعلمة مع @. في المثال التالي، يحتوي التقرير على معلَمة باسم @campaign_ids:

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

  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

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

إزالة مَعلمة

1. افتح التقرير الذي يحتوي على المَعلمة التي تريد حذفها.
2. افتح علامة التبويب الخصائص.
3. في بطاقة المَعلمات، انقر على حذف حذف بجانب المَعلمة التي تريد حذفها.
4. النقر على "حفظ"

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

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

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

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

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

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

تعديل تقرير

1. انتقِل إلى علامة التبويب طلبات البحث في Ads Data Hub.
2. انقر على اسم التقرير الذي تريد تعديله.
3. عدِّل التقرير.
4. انقر على حفظ.

تنفيذ تقرير

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

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

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

عرض النتائج

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

معاينة

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

BigQuery

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

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

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