Массовая загрузка

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

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

С помощью массовой загрузки можно вносить изменения, которые не поддерживаются скриптами Google Рекламы, например управлять кампаниями или загружать офлайн-конверсии.

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

Самый простой способ использовать функцию массовой загрузки – загрузить CSV-файл на Google Диск, а затем загрузить этот файл в Google Рекламу с помощью скриптов Google Рекламы.

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

В аккаунте будет создан предварительный просмотр массовой загрузки. Чтобы найти его, нажмите Инструменты и настройки > Массовые действия > Загрузки.

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

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

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

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

Чтобы создать задание массовой загрузки с нуля, выполните следующие действия:

// 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 (например, 2,34 евро будет указано как 2340000).

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 Рекламы.

• Войдите в аккаунт Google Рекламы.
• Нажмите Инструменты и настройки > МАССОВЫЕ ДЕЙСТВИЯ > Загрузки.
• Нажмите кнопку +, чтобы начать новую загрузку.
• Откроется раздел с шаблонами.

Вы также можете скачать различные шаблоны из Справочного центра.