Форматирование загружаемых файлов

Узнайте, как создавать и форматировать файлы CSV для импорта

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

Содержание

Общие положения

  1. Файлы данных должны загружаться в формате CSV.
  2. Заголовок CSV-файла должен точно соответствовать схеме целевого набора данных. Порядок столбцов должен соответствовать указанному в схеме, для всех названий столбцов необходимо использовать внутреннее название параметра или показателя ga., а не отображаемое имя (например, ga:source, а не Источник).
  3. Загруженные данные должны иметь правильный формат. Подробнее читайте ниже.

Создание файла для загрузки

Вы можете использовать любой подходящий метод создания загружаемого файла, однако проще всего это сделать с помощью текстового редактора или редактора таблиц. В любом случае вам понадобится схема набора данных, чтобы создать заголовок загружаемого файла.

Как получить схему

Вы можете скопировать или скачать схему, выбрав набор данных и нажав кнопку Получить схему.

Чтобы получить схему набора данных, выполните следующие действия:
  1. Войдите в аккаунт Google Analytics.
  2. Откройте вкладку Администратор и выберите ресурс, в который будут загружаться данные.
  3. В столбце РЕСУРС выберите ресурс, содержащий нужный набор данных.
  4. Нажмите Импорт данных.
  5. Нажмите на ссылку с названием целевого набора данных.
  6. Нажмите кнопку Получить схему в нижней части страницы). На экране появится диалоговое окно, приведенное ниже.

Как использовать текстовый редактор

Чтобы создать загружаемый файл с помощью текстового редактора, скопируйте и вставьте схему в первую строку нового файла. Затем можно добавить ниже собственные данные, по одной записи в строке.

Убедитесь, что ваш редактор создает простые текстовые файлы. При использовании редакторов форматированного текста, например Microsoft Word, необходимо сохранять файлы в обычном текстовом формате (TXT). Форматированный текст содержит множество дополнительных символов, которые могут вызвать ошибки импорта.

Как использовать таблицу

Чтобы использовать таблицу для загружаемых данных, получите схему набора данных, следуя приведенным выше инструкциям. Затем нажмите кнопку Загрузить шаблон схемы. Заголовки схемы будут сохранены на компьютере. Затем откройте схему в любом редакторе таблиц. Используя функцию импорта, добавьте в таблицу нужные данные. Подготовив файл к загрузке, сохраните или экспортируйте его в формате CSV.

Форматирование данных

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

Запятые

По определению, в файле CSV для обозначения начала новой ячейки используются запятые. Таким образом, лишняя запятая при импорте данных означает начало записи в новом столбце. В приведенном ниже примере показан пример правильного форматирования данных:

abc123,29.99,Синий,XXL 
def345,100,Красный,M
ghi678,1035.20,Зеленый,S

В этом случае при импорте данных рассматриваются четыре столбца с данными:

abc123 29.99 Синий XXL
def345 100 Красный M
ghi678 1035.20 Зеленый S

Что же произойдет, если мы добавим в данные лишнюю запятую? К примеру, вот так (лишняя запятая для разделения порядка стоимости):

ghi678,1,035.20,Зеленый,S

Теперь из-за наличия лишней запятой при импорте данных будут рассматриваться пять столбцов с данными:

abc123 29.99 Синий XXL
def345 100 Красный M
ghi678 1 035.20 Зеленый S

В результате мы увидим ошибку:

"Ошибка: количество столбцов не совпадает"

Кавычки

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

Пример

ghi678,"1,035.20",Зеленый,S

Значение "1,035.20" будет засчитано за одну ячейку (при импорте данных оно будет строкой).

Если вы исключаете ячейки при помощи кавычек, то не забывайте о количестве самих кавычек. Т. е. если в выбранной строке нечетное количество кавычек, то вы увидите следующую ошибку:

"Ошибка: неверный формат CSV в строке х"

Разрывы строки

Разрывы строки в CSV файле означают начало новой строки. При импорте данных нельзя использовать разрывы строк, даже если они заключены в кавычки. Лишние разрывы в строках приводят к ошибке в количестве столбцов. Появляется следующее сообщение об ошибке:

"Ошибка. Недопустимый формат CSV строки"

Дополнительная информация

Эта информация оказалась полезной?
Как можно улучшить эту статью?