Search Ads 360 Query Language

زبان پرس‌وجوی Search Ads 360 به شما امکان می‌دهد تا با استفاده از API گزارش‌دهی Search Ads 360، پرس‌وجوهای جستجو را برای بازیابی داده‌های گزارش‌دهی و فراداده‌های منابع ایجاد کنید.

خدمات جستجو

شما می‌توانید از زبان جستجوی تبلیغات جستجو ۳۶۰ برای جستجوی API با استفاده از موارد زیر استفاده کنید:

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 و بیش از ۱۰۰۰ بازدید را برمی‌گرداند.

• هر 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 و بیش از ۱۰۰۰ بازدید را برمی‌گرداند.

• داده‌ها را بر اساس تاریخ تقسیم‌بندی می‌کند.

• در نتیجه‌ی این تقسیم‌بندی، هر 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 OR FIELD را با یک منبع (مانند customer یا campaign ) یا یک فیلد (مانند campaign.id ، metrics.impressions یا ad_group.id ) جایگزین کنید.

نکته: این‌ها هیچ عبارت FROM در یک پرس‌وجو برای متادیتای فیلد ندارند.

برای اطلاعات بیشتر در مورد بازیابی فراداده‌های فیلد ، به بازیابی فراداده‌های منبع مراجعه کنید.

بیشتر بدانید

درباره نحوه ساخت کوئری‌ها در API گزارش‌دهی تبلیغات جستجو ۳۶۰ بیشتر بدانید:

• ساختار و بندهای پرس و جو
• محدوده‌های تاریخ
• صفر معیار
• نمونه سوالات
• دستور زبان پرس و جو