هدف گذاری کمپین

اسکریپت‌های گوگل ادز به شما امکان می‌دهند با تنظیمات هدف‌گذاری در سطح کمپین در حساب‌های خود کار کنید. پشتیبانی برای برنامه‌های تبلیغاتی، مکان‌های هدفمند و مستثنی، نزدیکی‌های هدفمند و پلتفرم‌ها در دسترس است. این راهنما نحوه کار با اهداف کمپین را نشان می‌دهد.

برنامه‌های تبلیغاتی

برنامه‌های تبلیغاتی به شما امکان می‌دهند زمان نمایش تبلیغات خود را کنترل کنید.

بازیابی

شما می‌توانید برنامه‌های تبلیغاتی یک کمپین را با استفاده از متد adSchedules از اهداف کمپین بازیابی کنید. قطعه کد زیر نحوه بازیابی لیست تمام معیارهای AdSchedule برای یک کمپین را نشان می‌دهد:

const campaign = AdsApp.campaigns()
    .withCondition("campaign.name = 'My campaign'")
    .get()
    .next();

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

به طور پیش‌فرض، یک کمپین همیشه در حال نمایش است، بنابراین اگر یک برنامه تبلیغاتی سفارشی برای کمپین خود تنظیم نکرده باشید، هیچ برنامه تبلیغاتی دریافت نخواهید کرد.

به‌روزرسانی

پس از بازیابی یک برنامه تبلیغاتی، می‌توانید ویژگی‌های آن را مستقیماً تغییر دهید؛ برای مثال، می‌توانید اصلاح‌کننده پیشنهاد قیمت یک برنامه تبلیغاتی را به صورت زیر به‌روزرسانی کنید:

adSchedule.setBidModifier(1.1);

ایجاد کردن

برای ایجاد یک برنامه تبلیغاتی جدید، می‌توانید از متد addAdSchedule از Campaign استفاده کنید. قطعه کد زیر یک برنامه تبلیغاتی سفارشی برای کمپین از ساعت ۷ صبح تا ۱۱ صبح در منطقه زمانی حساب، هر شنبه، با اصلاح‌کننده پیشنهاد ۱.۱ ایجاد می‌کند.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

برای جزئیات بیشتر در مورد مقادیر مجاز برای هر پارامتر و همچنین محدودیت‌های اضافی که باید هنگام ایجاد برنامه‌های تبلیغاتی در نظر داشته باشید، می‌توانید به مستندات ما مراجعه کنید.

حذف

شما می‌توانید یک برنامه تبلیغاتی را با استفاده از متد remove آن حذف کنید. برای تنظیم مجدد برنامه تبلیغاتی سفارشی یک کمپین، می‌توانید تمام برنامه‌های تبلیغاتی سفارشی آن را به شرح زیر حذف کنید:

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

مکان‌ها

همچنین می‌توانید با استفاده از اسکریپت‌های گوگل ادز، مکان‌ها را برای کمپین خود هدف قرار دهید یا آنها را حذف کنید.

بازیابی

شما می‌توانید لیست مکان‌های هدف را با استفاده از متد targetedLocations از اهداف کمپین بازیابی کنید. مکان‌های حذف‌شده را می‌توان با استفاده از متد excludedLocations بازیابی کرد. قطعه کد زیر تمام مکان‌های هدف را که ماه گذشته بیش از ۱۰۰ بازدید دریافت کرده‌اند، انتخاب می‌کند.

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

اگر کمپین خود را برای ارائه خدمات در همه کشورها و مناطق تنظیم کرده باشید، فهرستی خالی از مکان‌ها دریافت خواهید کرد.

به‌روزرسانی

پس از بازیابی یک مکان، می‌توانید ویژگی‌های آن را مستقیماً تغییر دهید. برای مثال، می‌توانید اصلاح‌کننده‌ی قیمت یک مکان را به صورت زیر به‌روزرسانی کنید:

location.setBidModifier(1.1);

ایجاد کردن

شما می‌توانید با استفاده از متد addLocation در یک کمپین، اهداف مکانی ایجاد کنید. به طور مشابه، می‌توانید با استفاده از متد excludeLocation ، یک مکان را از لیست حذف کنید. قطعه کد زیر، کمپینی را برای ایالات متحده با اصلاح‌کننده پیشنهاد قیمت ۱.۱۵ هدف قرار می‌دهد، در حالی که شهر نیویورک را حذف می‌کند.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

برای مشاهده‌ی لیست شناسه‌های مورد نیاز برای افزودن هدف‌گذاری مکانی، می‌توانید به مستندات هدف‌گذاری جغرافیایی API گوگل ادز مراجعه کنید. برای پیگیری عملکرد اهداف مکانی خود، می‌توانید در location_view Report resource جستجو کنید.

حذف

شما می‌توانید با استفاده از متد remove یک هدف مکانی را حذف کنید.

نزدیکی‌ها

شما می‌توانید با استفاده از اسکریپت‌های گوگل ادز، یک کمپین را در شعاع (مجاورت) اطراف یک مکان هدف قرار دهید.

بازیابی

شما می‌توانید لیست مکان‌های نزدیک هدف را با استفاده از متد targetedProximities روی اهداف کمپین بازیابی کنید. قطعه کد زیر تمام مکان‌های نزدیک هدف را که ماه گذشته بیش از ۱۰۰ بازدید داشته‌اند، انتخاب می‌کند.

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

ایجاد کردن

شما می‌توانید با استفاده از متد addProximity یک هدف مجاورتی برای یک کمپین ایجاد کنید. قطعه کد زیر یک کمپین را تا فاصله ۲۰ کیلومتری حول مختصات (۳۷.۴۲۳۰۲۱، -۱۲۲.۰۸۳۷۳۹) هدف قرار می‌دهد.

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

شما همچنین می‌توانید از این روش برای ایجاد هدف مجاورتی مشابه با یک اصلاح‌کننده پیشنهاد و آدرس استفاده کنید:

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

به خاطر داشته باشید که هیچ اعتبارسنجی برای بررسی اینکه آدرس واقعاً به عرض و طول جغرافیایی داده شده تعلق دارد یا خیر، وجود ندارد. این آدرس هیچ هدفی جز تغییر آنچه در رابط مدیریت کمپین نشان داده می‌شود، ندارد.

حذف

شما می‌توانید یک هدف مجاورتی را با استفاده از متد remove آن حذف کنید.

پلتفرم‌ها

شما می‌توانید فهرست پلتفرم‌هایی را که یک کمپین هدف قرار می‌دهد، با استفاده از روش platforms اهداف کمپین بازیابی کنید. از آنجایی که کمپین‌های گوگل ادز همه پلتفرم‌ها (دسکتاپ، موبایل و تبلت) را هدف قرار می‌دهند، نمی‌توانید معیار Platform را اضافه یا حذف کنید. رایج‌ترین کاربرد این معیار هدف‌گذاری، تنظیم تنظیم قیمت دستگاه کمپین شما است:

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

شناسه‌های پلتفرم در بین کمپین‌ها مشترک هستند و مقادیر از پیش تعریف‌شده‌ای دارند که در پیوست پلتفرم‌های API گوگل ادز مشخص شده است. این شناسه‌ها می‌توانند هنگام تجزیه گزارش‌ها مفید باشند. هنگام انتخاب مستقیم معیارها، می‌توانید از متدهای کمکی ارائه شده توسط PlatformSelector استفاده کنید.