هدف‌یابی پویش

جاوااسکریپت Google Ads به شما امکان می‌دهد با تنظیمات هدف‌یابی در سطح پویش در حساب‌هایتان کار کنید. پشتیبانی برای زمان‌بندی آگهی، مکان‌های هدف‌یابی‌شده و مستثنی‌شده، مجاورت‌های هدف‌یابی‌شده، و پلاتفرم‌ها دردسترس است. این راهنما نحوه کار با هدف‌های پویش را نشان می‌دهد.

زمان‌بندی‌های آگهی

زمان‌بندی آگهی به شما امکان می‌دهد زمان اجرای آگهی‌هایتان را کنترل کنید.

بازیابی

می‌توانید زمان‌بندی‌های آگهی پویش را بااستفاده از روش 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();
}

مکان‌ها

همچنین می‌توانید بااستفاده از جاوااسکریپت Google Ads، مکان‌ها را برای پویش خود هدف‌یابی یا مستثنا کنید.

بازیابی

می‌توانید فهرست مکان‌های موردهدف را بااستفاده از روش 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

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

برداشتن

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

مجاورت‌ها

بااستفاده از جاوااسکریپت Google Ads می‌توانید پویشی را برای شعاعی (مجاورت) در اطراف مکانی هدف‌یابی کنید.

بازیابی

می‌توانید فهرست مجاورت‌های هدف‌یابی‌شده را بااستفاده از روش targetedProximities در هدف‌های پویش بازیابی کنید. تکه‌کد زیر همه مجاورت‌های هدف‌یابی‌شده‌ای را که ماه گذشته بیش‌از ۱۰۰ ظهور دریافت کرده‌اند انتخاب می‌کند.

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

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

ایجاد کردن

می‌توانید بااستفاده از روش addProximity یک هدف نزدیک برای پویش ایجاد کنید. تکه‌کد زیر پویشی را در ۲۰ کیلومتری اطراف مختصات (37.423021, -122.083739) هدف‌یابی می‌کند.

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 هدف‌های پویش بازیابی کنید. ازآنجایی‌که پویش‌های Google Ads همه پلاتفرم‌ها (رایانه، تلفن همراه، و رایانه لوحی) را هدف قرار می‌دهند، نمی‌توانید معیار Platform را اضافه یا حذف کنید. رایج‌ترین کاربرد این معیار هدف‌یابی، تنظیم تعدیل قیمت پیشنهادی دستگاه پویش شما است:

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

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