زبان جستجوی تبلیغات گوگل

Google Ads Query Language می‌تواند از Google Ads API درخواست کند

استفاده از منابع و ویژگی‌ها، بخش‌ها و معیارهای مرتبط با آنها

GoogleAdsService Search یا SearchStream

نتیجه جستجوی GoogleAdsService فهرستی از نمونه‌های GoogleAdsRow است که هر GoogleAdsRow یک منبع را نشان می‌دهد. اگر ویژگی یا معیاری درخواست شود، ردیف شامل آن فیلدها نیز می شود. اگر هر بخش درخواست شود، پاسخ همچنین یک ردیف اضافی برای هر بخش منبع-بخش نشان می دهد.

فراداده در مورد زمینه ها و منابع موجود در

GoogleAdsFieldService

این سرویس فهرستی از فیلدهای قابل استعلام را با مشخصاتی در مورد سازگاری و نوع آنها ارائه می دهد.

نتیجه جستجوی GoogleAdsFieldService فهرستی از نمونه‌های GoogleAdsField است که هر GoogleAdsField حاوی جزئیات مربوط به فیلد درخواستی است.

پرس و جو برای ویژگی های یک منبع

در زیر یک جستجوی اساسی برای ویژگی های منبع کمپین وجود دارد که نحوه بازگرداندن شناسه، نام و وضعیت کمپین را نشان می دهد:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

این پرس و جو بر اساس شناسه کمپین مرتب می شود. هر GoogleAdsRow حاصل، یک شیء campaign پر شده با فیلدهای انتخاب شده (از جمله resource_name آن کمپین داده شده) را نشان می دهد.

برای اطلاع از اینکه چه فیلدهای دیگری برای سؤالات کمپین موجود است، به مستندات مرجع 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 نمایش داشته اند، در حالی که با شناسه کمپین مرتب می شوند. هر GoogleAdsRow به دست آمده دارای یک فیلد metrics است که با معیارهای انتخاب شده پر شده است.

برای فهرستی از معیارهای قابل پرس و جو، به مستندات Metrics مراجعه کنید.

پرس و جو برای بخش ها

در کنار ویژگی های انتخاب شده برای یک منبع داده شده، می توانید برای بخش های مرتبط نیز پرس و جو کنید:

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 نمایش داشته اند فیلتر می کند. با این حال، این پرس و جو داده ها را بر اساس تاریخ تقسیم بندی می کند. این منجر به هر یک از GoogleAdsRow می‌شود که چندین کمپین و Segment تاریخ را نشان می‌دهد. مهم است که توجه داشته باشید که تقسیم بندی معیارهای انتخاب شده را تقسیم می کند و بر اساس هر بخش در بند SELECT گروه بندی می شود.

برای فهرستی از بخش‌های قابل پرس‌وجو، به مستندات Segments مراجعه کنید.

پرس و جو برای ویژگی های یک منبع مرتبط

در یک پرس و جو برای یک منبع معین، ممکن است بتوانید در صورت وجود، به منابع مرتبط دیگر بپیوندید. این منابع مرتبط با عنوان «منابع نسبت داده شده» شناخته می شوند. شما می توانید با انتخاب یک ویژگی در پرس و جو خود، به طور ضمنی به منابع نسبت داده شده بپیوندید.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

این پرس و جو نه تنها ویژگی های کمپین را انتخاب می کند، بلکه ویژگی های مرتبط را از هر کمپین انتخاب شده نیز می کشد. هر GoogleAdsRow حاصل، یک شیء campaign را نشان می‌دهد که با ویژگی‌های کمپین انتخابی و همچنین ویژگی استراتژی مناقصه انتخاب شده bidding_strategy.name پر شده است.

برای اطلاع از منابع منتسب برای پرسش‌های کمپین، به مستندات مرجع Campaign مراجعه کنید.

جهش بر اساس نتایج پرس و جو

هنگام پرس و جو برای یک منبع معین، می توانید فوراً آن نتایج برگشتی را به عنوان اشیا بگیرید، آنها را اصلاح کنید و به متد mutate در سرویس آن منبع بازگردانید. در زیر یک نمونه گردش کار آمده است:

1. برای همه کمپین‌هایی که در حال حاضر PAUSED و تعداد نمایش‌هایشان بیشتر از 1000 است، یک پرس‌وجو اجرا کنید.
2. شی Campaign را از فیلد campaign هر GoogleAdsRow در پاسخ دریافت کنید.
3. وضعیت هر کمپین را از PAUSED به ENABLED تغییر دهید.
4. با کمپین های تغییر یافته تماس بگیرید تا CampaignService.MutateCampaigns را به روز کنید.

فراداده میدانی

پرس و جوهای ارسال شده به GoogleAdsFieldService برای بازیابی فراداده فیلد است. از این اطلاعات می توان برای درک چگونگی استفاده از فیلدها با هم در یک پرس و جو استفاده کرد. از آنجایی که داده‌ها از API در دسترس هستند و ابرداده‌های لازم برای اعتبارسنجی یا ساخت پرس و جو را فراهم می‌کنند، این به توسعه‌دهندگان اجازه می‌دهد تا این کار را به صورت برنامه‌ریزی انجام دهند. در اینجا یک پرس و جو معمولی برای ابرداده وجود دارد:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

می‌توانید <INSERT_RESOURCE_OR_FIELD> را در این عبارت با منبع (مانند customer یا campaign ) یا فیلد (مانند campaign.id ، metrics.impressions ، یا ad_group.id ) جایگزین کنید.

برای فهرستی از فیلدهای قابل پرس و جو، به اسناد GoogleAdsField مراجعه کنید.

نمونه های کد

کتابخانه های سرویس گیرنده نمونه هایی از استفاده از زبان جستجوی Google Ads در GoogleAdsService دارند. پوشه عملیات پایه دارای نمونه هایی مانند GetCampaigns ، GetKeywords و SearchForGoogleAdsFields است. پوشه گزارش یک مثال GetKeywordStats دارد.