Пакетная загрузка

C помощью скриптов AdWords можно вносить массовые изменения в аккаунт, загружая данные в формате CSV. Для этого можно использовать файлы CSV на Google Диске, таблицы Google, таблицы Microsoft Excel или создать запрос на массовую загрузку в скрипте во время выполнения. В этом руководстве описывается, как использовать данную функцию в скриптах.

Преимущества

Массовая загрузка дает следующие преимущества:

  • Возможность использовать новые функции, которых ещё нет в скриптах AdWords.
  • Более простое преобразование отчетов и изменение объектов.
  • Менее строгие ограничения – как количественные, так и временные. Ограничения для массовой загрузки не связаны с запускающим ее скриптом.

Какие операции поддерживаются?

Скрипты AdWords в настоящее время поддерживают следующие операции для массовой загрузки:

  • Управление кампаниями. При помощи массовой загрузки можно создавать, изменять и удалять кампании, группы объявлений, ключевые слова и текстовые объявления. Также можно изменять существующие объявления, группы товаров и критерии на уровне группы объявлений.
  • Офлайн-конверсии. При помощи массовой загрузки можно добавлять в аккаунт информацию об онлайн-конверсиях.

Использование

Как создать массовую загрузку с Google Диска

Самый простой способ использования функции массовой загрузки предполагает добавление файла CSV на Google Диск и последующую загрузку его в AdWords при помощи скрипта. Вот пример такого кода:

var file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
var upload = AdWordsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

Этот скрипт создает предварительный просмотр массовой загрузки в аккаунте. Чтобы просмотреть результаты, войдите в аккаунт AdWords и на панели слева выберите Массовые операции > Массовая загрузка.

Чтобы просмотреть изменения, нажмите на ссылку Просмотр.

Чтобы изменения вступили в силу, нажмите кнопку Применить изменения на странице предварительного просмотра. Если в загруженном файле есть ошибки или вы передумали вносить изменения, нажмите кнопку Отменить просмотр.

Убедившись, что скрипт работает правильно, вы можете применять изменения прямо в скрипте, минуя этап просмотра. Для этого вместо метода preview() нужно вызвать метод apply() экземпляра массовой загрузки.

Как создать массовую загрузку из отчета

Массовую загрузку также можно создать на основе отчета AdWords. Ниже приведен код, который приостанавливает все кампании, расходы в которых превысили 1000 долларов в текущем месяце.

// Run a report to fetch all campaigns that spent more than $1000
// last month.
var query = 'SELECT CampaignId,CampaignName,CampaignStatus,Amount' +
    'FROM CAMPAIGN_PERFORMANCE_REPORT' +
    'WHERE Amount > 1000000000' +
    'DURING THIS_MONTH';
var report = AdWordsApp.report(query);

// Create an upload with the report columns.
var upload = AdWordsApp.bulkUploads().newCsvUpload([
    report.getColumnHeader('CampaignId').getBulkUploadColumnName(),
    report.getColumnHeader('CampaignName').getBulkUploadColumnName(),
    report.getColumnHeader('CampaignStatus').getBulkUploadColumnName()]);
upload.forCampaignManagement();

var rows = report.rows();
while (rows.hasNext()) {
  var row = rows.next();
  // Pause the campaigns.
  row.CampaignStatus = 'paused';

  // Convert the report row into an upload row.
  upload.append(row.formatForUpload());
}

// Use upload.apply() to make changes without previewing.
upload.preview();

Как создать массовую загрузку "с нуля"

Ниже приведен пример кода, который создает задание на массовую загрузку без использования таблиц и файлов с данными.

var columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns);

upload.append({
   'Campaign': 'Test Campaign 1',
   'Budget': 2340000,
   'Bid Strategy type': 'cpc',
   'Campaign type': 'Search Only'
});
upload.forCampaignManagement();
upload.preview();

Как задать денежную единицу

По умолчанию денежные суммы в массовой загрузке указываются в единицах "микро". Если вы хотите использовать реальные денежные суммы, присвойте свойству moneyInMicros значение false:

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: false});

Как задать региональные настройки для файла

По умолчанию считается, что файл CSV содержит данные на американском варианте английского языка (en_US). Чтобы задать другие региональные настройки, используйте свойство fileLocale, как указано ниже.

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

Если вы задали региональные настройки, заголовки столбцов можно указывать либо на английском (en_US), либо на языке, выбранном с помощью свойства fileLocale.

Часовой пояс

По умолчанию время, указанное в файле, интерпретируется как тихоокеанское стандартное (PST). Чтобы установить другой часовой пояс, используйте свойство timeZone, как показано ниже.

var upload = AdWordsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "-0800"});

Выбор часового пояса удобно использовать при загрузке офлайн-конверсий.

Шаблоны таблиц для массовой загрузки

Найти шаблон таблицы для массовой загрузки можно в интерфейсе AdWords. Для этого выполните следующие действия:

  • Войдите в аккаунт AdWords на странице https://adwords.google.com.
  • Выберите кампанию.
  • Откройте вкладку Ключевые слова, Объявления, Группы объявлений или Кампании (в зависимости от того, какие изменения нужно внести).
  • Нажмите кнопку "Загрузить отчет".
  • Выберите формат таблицы и нажмите кнопку Сохранить в файл.

Чтобы программно извлечь эти столбцы, используйте метод AdWordsApp.reports(), как показано ниже.

var report = AdWordsApp.report("SELECT CampaignName, CampaignStatus " +
    "FROM CAMPAIGN_PERFORMANCE_REPORT " +
    "DURING TODAY");
Logger.log("%s, %s",
    report.getColumnHeader("CampaignName").getBulkUploadColumnName(),
    report.getColumnHeader("CampaignStatus").getBulkUploadColumnName()
);

Подробнее об объектах массовой загрузки можно узнать здесь.

Фрагменты кода

Дополнительные примеры кода, в котором используется эта функция, можно найти здесь.

Оставить отзыв о...

Текущей странице
Скрипты AdWords
Скрипты AdWords