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

إنشاء طلب بحث

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

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 المنطقة الزمنية لطلب البحث سيتم تجاهل مَعلمة محدّدة من المستخدِم بهذا الاسم واستبدالها بالقيم التي تم ضبطها في مربّع حوار مَهمّة جديدة. ملاحظة: لتجنُّب حدوث تناقضات عند استخدام المناطق الزمنية في طلب البحث، مثل الجمل WHERE، يمكنك استخدام time_zone لمطابقة المنطقة الزمنية التي تم ضبطها في وظيفة جديدة. من المهم أيضًا استخدام المنطقة الزمنية نفسها المستخدَمة في مصدر البيانات.

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

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

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

تعديل طلب بحث

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

تنفيذ طلب بحث

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

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

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

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

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

معاينة

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

BigQuery

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

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

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