لغة طلب البحث في "إعلانات شبكة البحث 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 وأكثر من 1,000 مرّة ظهور.
  • يحتوي كلّ 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
  • استبدِل RESOURCE أو FIELD بمورد (مثل customer أو campaign) أو حقل (مثل campaign.id أو metrics.impressions أو ad_group.id).

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

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

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