ابزار ساخت کوئری گوگل ادز (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 ساخته شود، از قبل نحو صحیحی خواهد داشت، اما اگر با منبعی که پرسوجو میکنید آشنا هستید، اعتبارسنج پرسوجو راهی سریع برای وارد کردن یک پرسوجو و بررسی اعتبار آن ارائه میدهد. برای اطلاعات بیشتر در مورد این ابزار، به اعتبارسنج پرسوجو مراجعه کنید.