ابزار ساخت کوئری گوگل ادز (Google Ads Query Builder) ابزاری تعاملی است که برای کمک به شما در ساخت و اعتبارسنجی کوئریها با استفاده از زبان کوئری گوگل ادز (GAQL) طراحی شده است. چه در GAQL تازهکار باشید و چه یک کاربر باتجربه، این ابزار میتواند فرآیند دریافت دادههای دقیق مورد نیاز شما را از API گوگل ادز ساده کند.
مزایا
- سهولت استفاده: فرآیند نوشتن کوئریهای GAQL را بدون نیاز به آشنایی با سینتکس خاص و فیلدهای موجود، ساده میکند.
- قابلیت کشف: به کاوش و یافتن منابع، فیلدها، بخشها و معیارهای موجود در مدل داده API گوگل ادز کمک میکند.
- کاهش خطاها: با ارائه یک رابط کاربری ساختاریافته و منوهای کشویی از گزینههای معتبر، به جلوگیری از خطاهای نحوی و غلطهای املایی کمک میکند و اعتبار پرسوجوی تولید شده را تضمین میکند.
- ساخت سریعتر کوئری: با خودکارسازی تولید رشتههای کوئری، فرآیند توسعه را سرعت میبخشد.
- اعتبارسنجی: این ابزار با API Explorer و Query Validator مرتبط است تا قبل از اجرا، پرسوجوها را با قوانین API مطابقت دهد.
چگونه کار میکند؟
ابزار ساخت کوئری گوگل ادز (Google Ads Query Builder) یک رابط کاربری کاربرپسند برای جمعآوری بصری کوئریهای GAQL ارائه میدهد. روند کار به صورت زیر است:
- انتخاب منبع: با انتخاب منبع اصلی از تب Reference برای نسخهای که میخواهید جستجو کنید، شروع کنید. این منبع در عبارت
FROMقرار میگیرد. منابع، موجودیتهایی را در Google Ads نشان میدهند، مانندcampaign،ad_groupیاkeyword_view. سازنده تمام منابع موجود را فهرست میکند. - انتخاب فیلدها: پس از انتخاب یک منبع، ابزار تمام فیلدهای قابل انتخاب، از جمله ویژگیها، بخشها و معیارهای مربوط به آن منبع و منابع نسبت داده شده (به طور ضمنی قابل اتصال) آن را نمایش میدهد. میتوانید کادرها را علامت بزنید تا فیلدها را در عبارت
SELECTخود بگنجانید. همزمان با انتخاب شما، ابزار به صورت پویا رشته پرس و جوی GAQL مربوطه را تولید میکند، هرگونه خطا را نمایش میدهد و ترکیبهای فیلد ناسازگار را فیلتر میکند. - اعمال فیلترها: شرطهای بند
WHEREرا برای فیلتر کردن نتایج اضافه کنید. سازنده به شما در انتخاب فیلدها، عملگرها و مقادیر کمک میکند و از نحو صحیح اطمینان حاصل میکند. - نتایج مرتبسازی: با استفاده از دستور
ORDER BYترتیب مرتبسازی را مشخص کنید. - تعیین محدودیتها: یک عبارت
LIMITاضافه کنید تا تعداد نتایج برگشتی را کنترل کنید. - اعتبارسنجی: این ابزار ذاتاً شما را به سمت ترکیبهای معتبر فیلد راهنمایی میکند و همچنین به API Explorer پیوند میدهد تا بتوانید پرسوجوی خود را در برابر دادههای حساب کاربری خود آزمایش کنید. همچنین یک اعتبارسنج پرسوجوی جداگانه وجود دارد که میتوانید پرسوجوهای GAQL نوشته شده دستی را در آن جایگذاری و بررسی کنید.
- خروجی گرفتن: وقتی از جستجوی خود راضی بودید، رشته GAQL تست شده و از نظر نحوی صحیح خود را کپی کرده و در درخواستهای کلاینت
GoogleAdsService.SearchیاSearchStreamخود قرار دهید.
سازنده تضمین میکند که فیلدها، بخشها و معیارهای انتخابشده سازگار هستند و میتوانند با ارجاع به فرادادههای اساسی API تبلیغات گوگل، در یک پرسوجوی واحد با هم استفاده شوند.
شروع کنید
دو راه برای دسترسی به Query Builder وجود دارد: از طریق یک صفحه خاص در اسناد مرجع گزارشدهی، یا از صفحه نمای کلی Query Builder کاوش کنید.
از اسناد مرجع گزارشدهی
- با اسناد مرجع گزارشدهی شروع کنید و یک منبع خاص را برای شروع در لیست همه منابع انتخاب کنید. روش دیگر، حرکت مستقیم به منبع از پنل ناوبری سمت چپ است.
- روی «به من کمک کن تا یک پرسوجو بسازم» کلیک کنید، که شما را به سازنده پرسوجو برای آن منبع خاص میبرد.
از صفحه مرور کلی Query Builder
به بخش Query Builder در اسناد مرجع گزارشدهی بروید و منبعی را که میخواهید بررسی کنید، انتخاب کنید.
ادغام با ابزارهای دیگر
ابزار Query Builder با سایر ابزارهای موجود در جعبه ابزار توسعهدهندگان API گوگل ادز یکپارچه شده است. میتوانید یک کوئری ساخته شده در Query Builder را دریافت کرده و آن را در API Explorer آزمایش کنید یا آن را با اعتبارسنج کوئری اعتبارسنجی کنید.
کاوشگر API
پس از ساخت کوئری، روی گزینه «در API اکسپلورر امتحان کنید» کلیک کنید تا کوئری شما در API اکسپلورر باز شود. کوئری شما به طور خودکار در بدنه درخواست قرار میگیرد و سپس میتوانید با اجرای آن روی دادههای حساب کاربری خود، کوئری خود را آزمایش کنید. برای اطلاعات بیشتر در مورد این ابزار، به API اکسپلورر مراجعه کنید.
اعتبارسنج پرسوجو
وقتی روی Enter یا ویرایش یک پرسوجو کلیک میکنید، اعتبارسنج پرسوجو باز میشود. از اعتبارسنج پرسوجو برای اعتبارسنجی نحو پرسوجوی خود استفاده کنید. هر پرسوجویی که کاملاً از طریق Query Builder ساخته شده باشد، از قبل نحو صحیحی دارد، اما اگر با منبعی که پرسوجو میکنید آشنا هستید، اعتبارسنج پرسوجو راهی سریع برای وارد کردن یک پرسوجو و بررسی اعتبار آن ارائه میدهد. برای اطلاعات بیشتر در مورد این ابزار، به اعتبارسنج پرسوجو مراجعه کنید.