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

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

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

Благодаря возможности массовой загрузки, вы можете вносить определенные изменения, которые обычно не поддерживаются напрямую скриптами Google Ads, например, управлять кампаниями или загружать данные о конверсиях в офлайн-режиме.

Создание функции массовой загрузки из Google Диска

Простейший способ использовать функцию массовой загрузки — загрузить CSV-файл в Google Диск, а затем загрузить этот файл в Google Реклама с помощью скриптов Google Реклама:

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

Это создаст запись предварительного просмотра массовой загрузки в вашем аккаунте в разделе «Инструменты и настройки» > «Групповые действия» > «Загрузки» .

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

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

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

Создание пакетной загрузки с нуля.

Создать задание на массовую загрузку с нуля можно следующим образом:

// 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 Ads.

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

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