تسمح لك لغة طلبات البحث في "إعلانات شبكة البحث 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وأكثر من 1,000 مرّة ظهور. - وتقسّم البيانات حسب التاريخ.
- نتيجةً للتقسيم، يمثّل كلّ
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: