لغة طلب البحث في "إعلانات شبكة البحث 360"

تسمح لك لغة طلب البحث في "إعلانات شبكة البحث 360" بإنشاء طلبات بحث لاسترداد بيانات إعداد التقارير والبيانات الوصفية للموارد باستخدام Search Ads 360 Reporting API

البحث في الخدمات

يمكنك استخدام لغة طلب البحث في "إعلانات شبكة البحث 360" لطلب بحث عن واجهة برمجة التطبيقات باستخدام:

SearchAds360Service

استخدم هذه الخدمة للاستعلام عن الموارد والسمات والشرائح المرتبطة بها والمقاييس. هناك طريقتان، هما Search وSearchStream.

تعرض طلبات البحث SearchAds360Service قائمة بمثيلات SearchAds360Row:

  • يمثل كل صف موردًا.
  • تتضمّن الصفوف السمات وحقول المقاييس إذا لزم الأمر.
  • في حال طلب شرائح، يتم تضمين صفوف إضافية لكل منها صف موارد الشرائح.

راجع إنشاء تقارير بحث لـ مزيد من المعلومات.

SearchAds360FieldService

يمكنك استخدام هذه الخدمة لطلب بيانات وصفية عن الحقول والموارد المتاحة. توفر الخدمة كتالوج الحقول التي يمكن الاستعلام عنها مع تفاصيل حول والتوافق والنوع.

تعرض الدالة SearchAds360FieldService قائمة SearchAds360Field. المثال:

  • يحتوي كل حقل على تفاصيل حول الحقل المطلوب.

راجع استرداد البيانات الوصفية للموارد لمزيد من المعلومات.

أمثلة طلبات البحث الأساسية

تقدم الأقسام التالية أمثلة استعلام أساسية يمكنك تكييفها لإنشاء استعلاماتك الخاصة.

طلب بحث عن سمات مورد

هذا استعلام أساسي لسمات مورد campaign الذي يعرض رقم تعريف الحملة واسمها وحالتها:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • تمثّل كل SearchAds360Row المعروضة كائن campaign.
  • تتم تعبئة الصفوف بالحقول المحدّدة (بما في ذلك قيم resource_name).
  • يرتب طلبات البحث حسب رقم تعريف الحملة.

عرض campaign للحصول على الحقول الأخرى المتاحة التي يمكنك استخدامها في استعلاماتك.

طلب بحث عن المقاييس

هذا طلب بحث أساسي للمقاييس المرتبطة بسمات campaign المصدر:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • يعرض طلب البحث الحملات بالحالة PAUSED وأكثر من 1000 مرات الظهور.
  • تحتوي كل SearchAds360Row المعروضة على حقل metrics معبأ المقاييس المحددة.
  • يرتب طلبات البحث حسب رقم تعريف الحملة.

الاطّلاع على metrics لمعرفة أنشطة أخرى المقاييس المتاحة التي يمكنك استخدامها في استعلاماتك.

طلب بحث للشرائح

هذا استعلام أساسي للشرائح المرتبطة بسمات campaign المصدر:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • يعرض طلب البحث الحملات بالحالة PAUSED وأكثر من 1000 مرات الظهور.
  • ويقسم البيانات حسب التاريخ.
  • كنتيجة للتقسيم، تمثل كل SearchAds360Row صفًا من الحملة وشريحة التاريخ.
  • يرتب طلبات البحث حسب رقم تعريف الحملة.

يمكنك الانتقال إلى segments للاطّلاع على قائمة بالشرائح التي يمكنك استخدامها في طلبات البحث والتصنيف للحصول على المزيد معلومات حول تقسيم تقاريرك.

هذا استعلام أساسي في مورد campaign الذي يضم سمات مورد bidding_strategy، إذا كان متاحًا. هذا النوع من الموارد ذات الصلة المعروف باسم المورد المنسوبة.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • يختار طلب البحث سمات الحملات والسمات ذات الصلة من كل تم اختيار حملة.
  • تمثّل كل SearchAds360Row المعروضة عنصر campaign تمت تعبئته. باستخدام سمات الحملات المحدّدة، واستراتيجية عروض الأسعار المحدّدة bidding_strategy.name.

الاطّلاع على campaign لمعرفة الموارد المنسوبة المتاحة لطلبات البحث في الحملات.

طلب بحث عن البيانات الوصفية للحقل

يمكنك استخدام SearchAds360FieldService. لاسترداد بيانات التعريف للحقل.

هذا استعلام أساسي لبيانات التعريف للحقل:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • استبدل المورد أو الحقل بأي من الموارد (مثل، customer أو campaign) أو حقل (مثل campaign.id، metrics.impressions أو ad_group.id).

يمكنك الاطّلاع على مقالة استرداد البيانات الوصفية للموارد لمزيد من المعلومات حول استرداد الحقل. بيانات التعريف.

مزيد من المعلومات

اطّلِع على مزيد من المعلومات عن كيفية إنشاء طلبات البحث في Search Ads 360 Reporting API: