В этом руководстве описано, как настроить таблицу Google Sheets для автоматического получения данных из автоматизированных процессов Vista Social. После завершения сбора данных результаты будут отправлены непосредственно в вашу электронную таблицу в режиме реального времени.
Если вы ищете дополнительные варианты мест доставки результатов вашей автоматизации, ознакомьтесь с нашим руководством по сбору данных с помощью автоматизации DM .
Обзор
Автоматизация Vista Social позволяет отправлять собранные данные на любую конечную точку REST API. Создав простой скрипт Google Apps Script, вы можете превратить любую таблицу Google Sheets в хранилище данных, которое автоматически организует входящие данные в строки и столбцы.
Чего вы добьетесь:
- Создайте таблицу Google Sheets для хранения данных вашей автоматизации.
- Настройте скрипт Google Apps для получения данных.
- Подключите его к Vista Social в качестве места сбора данных.
Необходимое время: 10-15 минут
Уровень подготовки: Начинающий (опыт программирования не требуется)
Шаг 1: Создайте свою таблицу Google Sheets.
- Перейдите в Google Таблицы и создайте новую электронную таблицу.
- Присвойте своей электронной таблице описательное имя (например, «Данные о потенциальных клиентах Vista Social» или «Результаты автоматизации»).
- Оставьте лист пустым (скрипт автоматически создаст заголовки столбцов на основе отправленных вами данных).
Шаг 2: Откройте редактор Apps Script.
- В таблице Google Sheets нажмите «Расширения» в верхнем меню.
- Выберите Apps Script. Откроется новая вкладка браузера с редактором Apps Script.
- Удалите весь существующий код в редакторе.
Шаг 3: Добавьте код скрипта
Скопируйте и вставьте следующий код в редактор Apps Script:
function doPost(e) { var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var data = JSON.parse(e.postData.contents); // Flatten nested objects to dot notation var flatData = flattenObject(data); var lastCol = sheet.getLastColumn(); var headers = []; // Only try to read headers if there are columns if (lastCol > 0) { headers = sheet.getRange(1, 1, 1, lastCol).getValues()[0]; } // If sheet is empty, create headers from the incoming data if (headers.filter(String).length === 0) { headers = Object.keys(flatData); sheet.getRange(1, 1, 1, headers.length).setValues([headers]); } // Build row based on existing headers var row = headers.map(function(header) { return flatData[header] !== undefined ? flatData[header] : ''; }); // Check for new fields not in headers yet Object.keys(flatData).forEach(function(key) { if (headers.indexOf(key) === -1) { headers.push(key); row.push(flatData[key]); // Add new header sheet.getRange(1, headers.length).setValue(key); } }); sheet.appendRow(row); return ContentService.createTextOutput(JSON.stringify({status: 'success', fields: Object.keys(flatData)})) .setMimeType(ContentService.MimeType.JSON); } function flattenObject(obj, prefix) { prefix = prefix || ''; var result = {}; Object.keys(obj).forEach(function(key) { var fullKey = prefix ? prefix + '.' + key : key; if (typeof obj[key] === 'object' && obj[key] !== null && !Array.isArray(obj[key])) { // Recursively flatten nested objects var nested = flattenObject(obj[key], fullKey); Object.keys(nested).forEach(function(nestedKey) { result[nestedKey] = nested[nestedKey]; }); } else if (Array.isArray(obj[key])) { // Convert arrays to JSON string result[fullKey] = JSON.stringify(obj[key]); } else { result[fullKey] = obj[key]; } }); return result; }
Шаг 4: Развертывание в качестве веб-приложения
- Нажмите кнопку «Развернуть» в правом верхнем углу.
- Выберите «Новое развертывание»
- Нажмите на значок шестеренки рядом с кнопкой «Выберите тип» и выберите «Веб-приложение».
- Настройте параметры развертывания:
- Описание: Введите что-нибудь вроде "Vista Social Data Receiver"
- Выполнить от имени: Выберите меня
- Кто имеет доступ: Выберите «Любой»
- Нажмите «Развернуть» .
- Если появится запрос, нажмите «Авторизовать доступ» и следуйте инструкциям для предоставления разрешений.
- Скопируйте URL-адрес веб-приложения. Он понадобится вам для Vista Social.
Важно: URL-адрес будет выглядеть примерно так:
https://script.google.com/macros/s/AKfycb.../exec
Шаг 5: Подключитесь к Vista Social
- В Vista Social перейдите к настройкам автоматизации.
- Настройте место сбора данных.
- Выберите REST API в качестве типа назначения. Вставьте URL-адрес Google Apps Script, скопированный на шаге 4.
- Сохраните свою автоматизацию
Как это работает
Когда ваша система автоматизации Vista Social запускается и собирает данные, она отправляет эти данные на URL-адрес вашего скрипта Google Apps Script. Затем скрипт:
- Создает заголовки автоматически . Скрипт автоматически создаст заголовки столбцов на основе отправленных вами данных. Шаг 2: Откройте редактор Apps Script. В вашей таблице Google Sheets нажмите «Расширения» в верхнем меню. Выберите Apps Script. Откроется новая вкладка браузера с редактором Apps Script. Удалите весь существующий код в редакторе. Шаг 3: Добавьте код скрипта. Скопируйте и вставьте следующий код в редактор Apps Script: function doPost(e) { var sheet = SpreadsheetApp. При первом поступлении данных скрипт создаст заголовки столбцов на основе имен полей в ваших данных.
- Обрабатывает вложенные данные — Если ваши данные имеют вложенную структуру (например,
user.nameилиcontact.email), скрипт преобразует их в плоскую структуру с помощью точечной нотации для получения понятных заголовков столбцов. - Динамическое добавление новых столбцов . Скрипт автоматически создаст заголовки столбцов на основе отправленных вами данных. Шаг 2: Откройте редактор Apps Script. В вашей таблице Google Sheets нажмите «Расширения» в верхнем меню. Выберите Apps Script. Откроется новая вкладка браузера с редактором Apps Script. Удалите весь существующий код в редакторе. Шаг 3: Добавьте код скрипта. Скопируйте и вставьте следующий код в редактор Apps Script: function doPost(e) { var sheet = SpreadsheetApp. Если будущие данные будут содержать новые поля, скрипт автоматически добавит новые столбцы.
- Добавляет каждую запись в качестве новой строки — Каждый запуск автоматизации добавляет новую строку в вашу таблицу.
Обновление вашего скрипта
Обновлять скрипт необязательно, но если вы хотите это сделать, вы, безусловно, можете это сделать и дополнительно настроить его поведение!
Нужна дополнительная помощь?
Если у вас возникнут вопросы или потребуется дополнительная помощь, не стесняйтесь обращаться к нам. контакт Наша замечательная команда поддержки. Мы здесь, чтобы помочь вам! 💙
Рекомендуемая литература:
Сбор данных с помощью автоматизации управления данными
Зарегистрируйтесь прямо сейчас и попробуйте Vista Social бесплатно в течение 14 дней!