هذه مستندات قديمة وقد لا تكون كاملة. للاطّلاع على أحدث المستندات، يُرجى الرجوع إلى موقع الجهات التسويقية إذا كنت جهة تسويقية. إذا كنت شريك قياس، يُرجى الرجوع إلى الموقع الإلكتروني شركاء القياس.

كتابة طلبات البحث وتنفيذها

إنشاء طلب بحث

انتقِل إلى علامة التبويب طلبات البحث في Ads Data Hub.
انقر على + إنشاء طلب بحث. سيتم فتح صفحة نماذج طلبات البحث عن التحليل.
اختياري: يمكنك معاينة نموذج SQL بالنقر على توسيع.
اختَر النموذج الذي تريد استخدامه من خلال النقر على استخدام النموذج، أو انقر على فارغ للبدء من البداية.
أدخِل اسمًا للتقرير.
اكتب طلب البحث أو عدِّله باستخدام لغة SQL المتوافقة مع BigQuery. يمكنك العثور على الجداول والحقول المتاحة وإدراجها في SQL من علامة التبويب جداول Google.
اختياري: اضبط المَعلمات.
اختياري: اضبط ملخّص الصفوف التي تمّت فلترتها.
انقر على حفظ.

المعلمات

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

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

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

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

إنشاء مَعلمة

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

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

في نص طلب البحث، استخدِم تنسيق مَعلمات 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

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

إزالة مَعلمة

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

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

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

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

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

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

تعديل طلب بحث

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

تنفيذ طلب بحث

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

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

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

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

معاينة

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

BigQuery

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

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

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