برای راه‌اندازی اولین اسکریپت خود، این مراحل را دنبال کنید.
حساب‌های Google Ads
- به سیستم حساب Google Ads خود وارد شوید.
- از منوِ «ابزارها» در پیمایش سمت راست، اقدام‌های انبوه و سپس دست‌نوشته‌ها را انتخاب کنید. همچنین می‌توانید با جستجوی «Scripts» (دست‌نویس‌ها) در نوار جستجوی Google Ads به این صفحه پیمایش کنید.
- روی نماد +
فشار دهید تا متنی اضافه کنید. می‌توانید الگوهای دستورات را از منوِ کرکره‌ای مرور کنید،
اما برای این تمرین، «دستور جدید» را انتخاب کنید. - درصورت تمایل می‌توانید نامی برای دستوراتتان در فیلد نوشتاری «نام دستورات» ارائه دهید. این کار می‌تواند به شما کمک کند سازمان‌دهی‌شده بمانید و به‌یاد داشته باشید که این دستورات چه کاری انجام می‌دهد.
کد زیر را کپی کنید و در قسمت ویرایشگر جای‌گذاری کنید و آن را جایگزین تابع اصلی کنید:
function main() { // Get the campaign names from all the campaigns const rows = AdsApp.search('SELECT campaign.name FROM campaign'); console.log('My campaigns:'); // Iterate through the campaigns and print the campaign names for (const row of rows) { console.log(row.campaign.name); } }وقتی از شما خواسته شد، روی مجاز کردن کلیک کنید تا اسکریپت بتواند ازطرف شما به حساب دسترسی پیدا کند. این کار باید یک‌بار برای هر دستور انجام شود.
روی پیش‌نمایش کلیک کنید تا دستورگان در حالت پیش‌نمایش اجرا شود. نتایج در پانل تغییرات / گزارش‌ها نشان داده می‌شود. برای این مثال، باید نام‌های پویش خود را در «گزارش‌ها» ببینید.
وقتی از نتایج پیش‌نمایش راضی بودید، روی اجرا کلیک کنید تا دستوراتتان اجرا شود و صفحه سابقه دستورات باز شود. این صفحه جدیدترین اسکریپت‌های اجراشده را به‌همراه اطلاعاتی درباره وضعیت و نتایج آن‌ها نمایش می‌دهد.
برای دریافت نمای دقیق تغییرات و گزارش‌ها، روی پیوند در ستون تغییرات که مربوط به اسکریپتی است که به‌تازگی اجرا کرده‌اید کلیک کنید. باید همان برونداد گزارش را که قبلاً پیش‌نمایش شده بود ببینید.
حساب‌های مدیر
برای اجرای دستورات Ads Manager، ابتدا باید حساب مدیر Google Ads داشته باشید.
- به سیستم حساب مدیر Google Ads خود وارد شوید.
- از منوِ «ابزارها» در پیمایش سمت راست، اقدام‌های انبوه و سپس دست‌نوشته‌ها را انتخاب کنید. همچنین می‌توانید با جستجوی «Scripts» (دست‌نویس‌ها) در نوار جستجوی Google Ads به این صفحه پیمایش کنید.
- روی نماد +
تک‌ضرب بزنید تا متن اضافه کنید. می‌توانید الگوهای دستورات را از منوِ کرکره‌ای مرور کنید،
اما برای این تمرین، «دستور جدید» را انتخاب کنید.
- درصورت تمایل می‌توانید نامی برای دستوراتتان در فیلد نوشتاری «نام دستورات» ارائه دهید. این کار می‌تواند به شما کمک کند سازمان‌دهی‌شده بمانید و به‌یاد داشته باشید که این دستورات چه کاری انجام می‌دهد.
کد زیر را کپی کنید و در قسمت ویرایشگر جای‌گذاری کنید و آن را جایگزین تابع اصلی کنید:
function main() { // Retrieve all children accounts. const accountIterator = AdsManagerApp.accounts().get(); // Iterate through the account list. for (const account of accountIterator) { // Get stats for the child account. const stats = account.getStatsFor("THIS_MONTH"); // And log it. console.log(`${account.getCustomerId()},${stats.getClicks()},` + `${stats.getImpressions()},${stats.getCost()}`); } }وقتی از شما خواسته شد، روی مجاز کردن کلیک کنید تا اسکریپت بتواند ازطرف شما به حساب دسترسی پیدا کند. این کار باید یک‌بار برای هر دستور انجام شود.
روی پیش‌نمایش کلیک کنید تا دستورگان در حالت پیش‌نمایش اجرا شود. نتایج در پانل تغییرات / گزارش‌ها نشان داده می‌شود. برای این مثال، باید حساب‌های فرزندتان و سنجه‌های آن‌ها را در «گزارش‌ها» ببینید.
وقتی از نتایج پیش‌نمایش راضی بودید، روی اجرا کلیک کنید تا دستوراتتان اجرا شود و صفحه سابقه دستورات باز شود. این صفحه جدیدترین اسکریپت‌های اجراشده را به‌همراه اطلاعاتی درباره وضعیت و نتایج آن‌ها نمایش می‌دهد.
برای دریافت نمای دقیق تغییرات و گزارش‌ها، روی پیوند در ستون تغییرات که مربوط به اسکریپتی است که به‌تازگی اجرا کرده‌اید کلیک کنید. باید همان برونداد گزارش را که قبلاً پیش‌نمایش شده بود ببینید.
برای دیدن قطعه‌های نمونه بیشتر از دستورات، صفحه نمونه‌های ما را بررسی کنید.