كتابة طلبات البحث وتشغيلها

إنشاء طلب بحث

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

المَعلمات

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

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

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

  • 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

المنطقة الزمنية لمهمة الاستعلام. سيتم تجاهل أي مَعلمة يحدّدها المستخدم بهذا الاسم واستبدالها بالقيم المحدّدة في مربّع الحوار مهمة جديدة.

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

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

تعديل طلب بحث

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

تنفيذ طلب بحث

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