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

Скрипты 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();

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

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

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

Убедившись, что ваш скрипт работает правильно, вы можете пропустить этап предварительного просмотра и применить изменения непосредственно из вашего скрипта. Это можно сделать, вызвав метод 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 .

Установить часовой пояс

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

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

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

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

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

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

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