برای اجرای اولین اسکریپت خود، این مراحل را دنبال کنید.
حسابهای کاربری گوگل ادز
- وارد حساب کاربری گوگل ادز خود شوید .
- از منوی ابزارها در نوار ناوبری سمت چپ، گزینه Bulk actions و سپس Scripts را انتخاب کنید. همچنین میتوانید با جستجوی عبارت "Scripts" در نوار جستجوی گوگل ادز به این صفحه بروید.
- آیکون + را فشار دهید
برای افزودن اسکریپت. میتوانید قالبهای اسکریپت را از منوی کشویی مرور کنید، اما برای این تمرین، «اسکریپت جدید» را انتخاب کنید. - شما میتوانید به صورت اختیاری نامی برای اسکریپت خود در فیلد متنی "نام اسکریپت" وارد کنید. این میتواند به شما کمک کند تا سازماندهی شده و عملکرد اسکریپت را به خاطر بسپارید.
کد زیر را کپی کرده و در قسمت ویرایشگر قرار دهید و جایگزین تابع اصلی (main) کنید:
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); } }وقتی از شما خواسته شد، روی «مجاز کردن» کلیک کنید تا اسکریپت بتواند از طرف شما به حساب کاربری دسترسی پیدا کند. این کار باید برای هر اسکریپت یک بار انجام شود.
برای اجرای اسکریپت در حالت پیشنمایش ، روی پیشنمایش کلیک کنید. نتایج در پنل تغییرات / گزارشها ظاهر میشوند. برای این مثال، باید نام کمپینهای خود را در گزارشها مشاهده کنید.
وقتی از نتایج پیشنمایش راضی بودید، روی «اجرا» کلیک کنید تا اسکریپت شما اجرا شود و صفحه تاریخچه اسکریپت باز شود. این صفحه اسکریپتهای اخیراً اجرا شده را به همراه اطلاعاتی در مورد وضعیت و نتایج آنها نمایش میدهد.
برای مشاهدهی جزئیات تغییرات و گزارشها، روی پیوندی که در ستون تغییرات مربوط به اسکریپتی است که اجرا کردهاید، کلیک کنید. باید همان خروجی گزارش را که قبلاً پیشنمایش شده بود، ببینید.
حسابهای مدیر
برای اجرای اسکریپتهای مدیریت تبلیغات، ابتدا باید یک حساب کاربری مدیریت تبلیغات گوگل داشته باشید.
- وارد حساب کاربری مدیریت تبلیغات گوگل خود شوید .
- از منوی ابزارها در نوار ناوبری سمت چپ، گزینه Bulk actions و سپس Scripts را انتخاب کنید. همچنین میتوانید با جستجوی عبارت "Scripts" در نوار جستجوی گوگل ادز به این صفحه بروید.
- آیکون + را فشار دهید برای افزودن اسکریپت. میتوانید قالبهای اسکریپت را از منوی کشویی مرور کنید، اما برای این تمرین، «اسکریپت جدید» را انتخاب کنید.
- شما میتوانید به صورت اختیاری نامی برای اسکریپت خود در فیلد متنی "نام اسکریپت" وارد کنید. این میتواند به شما کمک کند تا سازماندهی شده و عملکرد اسکریپت را به خاطر بسپارید.
کد زیر را کپی کرده و در قسمت ویرایشگر قرار دهید و جایگزین تابع اصلی (main) کنید:
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()}`); } }وقتی از شما خواسته شد، روی «مجاز کردن» کلیک کنید تا اسکریپت بتواند از طرف شما به حساب کاربری دسترسی پیدا کند. این کار باید برای هر اسکریپت یک بار انجام شود.
برای اجرای اسکریپت در حالت پیشنمایش ، روی پیشنمایش کلیک کنید. نتایج در پنل تغییرات / گزارشها ظاهر میشوند. برای این مثال، باید حسابهای فرزندان خود و معیارهای آنها را که در گزارشها نمایش داده شدهاند، ببینید.
وقتی از نتایج پیشنمایش راضی بودید، روی «اجرا» کلیک کنید تا اسکریپت شما اجرا شود و صفحه تاریخچه اسکریپت باز شود. این صفحه اسکریپتهای اخیراً اجرا شده را به همراه اطلاعاتی در مورد وضعیت و نتایج آنها نمایش میدهد.
برای مشاهدهی جزئیات تغییرات و گزارشها، روی پیوندی که در ستون تغییرات مربوط به اسکریپتی است که اجرا کردهاید، کلیک کنید. باید همان خروجی گزارش را که قبلاً پیشنمایش شده بود، ببینید.
برای مشاهدهی نمونههای بیشتر از اسکریپتها، به صفحهی نمونههای ما مراجعه کنید.