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

Скрипты 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.

Часовой пояс

По умолчанию записи времени в файле интерпретируются по часовому поясу America/Los_Angeles. Вы можете указать другой часовой пояс с помощью параметра timeZone. Укажите часовой пояс в формате базы данных TZ.

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

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

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

Проще всего получить шаблон таблицы для массовой загрузки в интерфейсе Google Рекламы.

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

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