جاوااسکریپت Google Ads به شما امکان میدهد با بارگذاری دادهها در قالب CSV، تغییرات انبوه در حسابتان ایجاد کنید. میتوانید دادهها را از فایل CSV از Google Drive، صفحهگسترده Google، صفحهگسترده Microsoft Excel بارگذاری کنید یا درخواست بارگذاری انبوه را در زمان اجرا در اسکریپت خود بسازید. این راهنما توضیح میدهد چگونه از این ویژگی در اسکریپتهایتان استفاده کنید.
کاربرد
بااستفاده از بارگذاریهای انبوه، میتوانید انواع خاصی از تغییرات را ایجاد کنید که درغیراینصورت مستقیماً توسط اسکریپتهای Google Ads پشتیبانی نمیشوند، مانند مدیریت پویشها یا بارگذاری تبدیلهای آفلاین.
ایجاد بارگذاری انبوه از Google Drive
سادهترین راه برای استفاده از ویژگی بارگذاری انبوه، بارگذاری فایل CSV در Google Drive و بارگذاری آن فایل در Google Ads بااستفاده از جاوااسکریپت Google Ads است:
const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
.next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();
این کار یک ورودی پیشنمایش بارگذاری انبوه در حسابتان در بخش ابزارها و تنظیمات > اقدامات انبوه > بارگذاریها ایجاد میکند.
برای مشاهده تغییرات، روی پیوند پیشنمایش کلیک کنید.
برای اعمال تغییرات در حسابتان، روی دکمه اعمال تغییرات در صفحه جزئیات کلیک کنید. اگر فایل بارگذاریشده خطا دارد یا اگر نمیخواهید تغییرات را اعمال کنید، روی دکمه صرفنظر کردن از پیشنمایش کلیک کنید تا تغییرات لغو شود.
وقتی درستیسنجی کردید که اسکریپت شما بهدرستی کار میکند، میتوانید از مرحله پیشنمایش
رد شوید و تغییرات را مستقیماً از اسکریپت خود اعمال کنید. این کار را میتوان با فراخوانی روش apply() نمونه بارگذاری انبوه بهجای روش preview() انجام داد.
ایجاد بارگذاری انبوه از ابتدا
میتوانید کار بارگذاری انبوه را از ابتدا بهصورت زیر ایجاد کنید:
// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
"Campaign", "Budget", "Bid Strategy type", "Campaign type"
];
const upload = AdsApp.bulkUploads().newCsvUpload(columns);
// Call append once for each row you'd like to upload
upload.append({
"Campaign": "Test Campaign 1",
"Budget": 2.34,
"Bid Strategy type": "cpc",
"Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();
تنظیم واحد پولی
بهطور پیشفرض، مبالغ پولی در بارگذاریهای انبوه بهعنوان مبلغ واقعی ارز تفسیر میشوند. اگر ترجیح میدهید از میکرو استفاده کنید، میتوانید هنگام ایجاد کار بارگذاری، گزینه moneyInMicros را روی true تنظیم کنید (برای مثال، ۲٫۳۴ یورو بهصورت ۲۳۴۰۰۰۰ وارد میشود).
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{moneyInMicros: true});
تنظیم منطقه زبانی فایل
بهطور پیشفرض، محتوای فایل CSV در منطقه زبانی انگلیسی امریکایی (en_US) تفسیر میشود.
بااستفاده از گزینه fileLocale میتوانید منطقه زبانی دیگری را مشخص کنید:
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{fileLocale: "fr_FR"});
وقتی منطقهای را مشخص میکنید، میتوانید سرصفحههای ستون را به زبان منطقه en_US یا به زبان منطقهای که در ویژگی fileLocale مشخص میکنید ارائه دهید.
تنظیم منطقهٔ زمانی
بهطور پیشفرض، ورودیهای زمان در فایل در منطقه زمانی آمریکا/لسآنجلس تفسیر میشوند.
بااستفاده از گزینه timeZone میتوانید منطقه زمانی دیگری را مشخص کنید. منطقه زمانی را در
قالب پایگاه داده TZ
مشخص کنید.
const upload = AdsApp.bulkUploads().newCsvUpload(columns,
{timeZone: "America/New_York"});
تنظیم منطقه زمانی میتواند هنگام بارگذاری تبدیلهای آفلاین مفید باشد.
الگوهای صفحهگسترده برای بارگذاری انبوه
سادهترین راه برای دریافت الگوی صفحهگسترده برای بارگذاری انبوه، ازطریق رابط کاربری Google Ads است.
- به سیستم حساب Google Ads خود وارد شوید.
- به ابزارها و تنظیمات > اقدامات انبوه > بارگذاریها بروید.
- روی دکمه + کلیک کنید تا بارگذاری جدیدی را شروع کنید.
- سپس بخشی با الگوهای مختلف برای انتخاب ظاهر میشود.
همچنین میتوانید الگوهای مختلفی را از مرکز راهنمایی بارگیری کنید.