API управления Google Analytics обеспечивает программный доступ к функции импорта данных Google Analytics.
Введение
API управления позволяет загружать, просматривать, удалять и получать загруженные файлы, а также составлять списки наборов данных. Общий обзор преимуществ функции импорта данных см. в статье Справочного центра об импорте данных .
Два ресурса в Management API, которые позволяют импортировать данные:
- Ресурс пользовательского источника данных , называемый в веб-интерфейсе набором данных и выступающий в качестве контейнера для загруженных файлов. Коллекция пользовательских источников данных представляет все наборы данных, связанные с ресурсом Google Analytics.
- Ресурс Upload , представляющий загруженный файл. Коллекция ресурсов загрузки представляет все файлы, которые вы загрузили в набор данных.
Случаи использования
Функция импорта данных имеет три категории верхнего уровня, каждая из которых имеет свои варианты использования. Организация заключается в следующем:
Импорт данных хитов
Данные о возврате
Транзакции электронной торговли, которые были полностью или частично возмещены, можно загрузить в Google Analytics. Это упрощает автоматическую сверку данных в отчетах об электронной торговле Google Analytics с обработанными возвратами.
Чтобы узнать, как импортировать данные о возврате в Google Analytics, см. пример импорта данных о возврате .
Расширенный импорт данных
Данные пользователя
Вы можете загружать неличные пользовательские данные из внешних инструментов CRM и создавать аудитории ремаркетинга Google Рекламы для наиболее ценных сегментов пользователей.
Чтобы узнать, как импортировать пользовательские данные в Google Analytics для создания аудиторий ремаркетинга Google Рекламы, см.:
Данные кампании
Вы можете импортировать данные кампании в Google Analytics, чтобы настроить анализ эффективности кампании для вашего бизнеса.
Чтобы узнать, как импортировать данные кампании в Google Analytics, см. раздел Импорт данных кампании с помощью Management API .
Географические данные
Вы можете импортировать сопоставления географических идентификаторов с регионами, позволяя создавать отчеты по данным Google Analytics по настраиваемому региону. Например, в Соединенных Штатах вы можете работать в группах восточных, центральных и западных штатов; в Европе вы можете работать в группах северных, центральных и южных стран. При импорте данных вы можете использовать ga:regionId , ga:cityId , ga:countryIsoCode или ga:subContinentCode в качестве ключей. Идентификаторы городов и стран можно найти в таблице географического таргетинга. Код ISO страны и код субконтинента можно найти в таблицах ISO-3166-1 Alpha-2 и UN M.49 соответственно.
Дополнительную информацию об импорте географических данных см. в примере импорта географических данных .
Данные контента
Вы можете загрузить метаданные, связанные с контентом, такие как автор и тема, чтобы использовать Google Analytics для углубленного анализа статей, опубликованных на веб-сайте.
Чтобы узнать, как импортировать данные контента в Google Analytics, см. пример импорта данных контента .
Данные продукта
Импорт данных о продуктах в Google Analytics упрощает и сокращает объем данных электронной торговли, которые необходимо отправлять вместе с обращениями, такими как просмотры страниц и события. Один идентификатор продукта или номер SKU можно объединить с импортированными данными о продукте для заполнения параметров и показателей продукта в ваших отчетах.
Чтобы узнать, как импортировать данные о продуктах в Google Analytics, см. раздел Импорт данных о продуктах с помощью Management API .
Импорт сводных данных
Данные о затратах
Вы можете загружать данные о расходах для платных кампаний, не связанных с Google, и использовать платформу Google Analytics для анализа рентабельности инвестиций и сравнения эффективности кампаний для всех инвестиций в интернет-рекламу и маркетинг.
Чтобы узнать, как импортировать данные о расходах в Google Analytics, см. раздел «Импорт данных о расходах с помощью Management API» .
Концепции
Статус обработки
После загрузки файла статус загрузки будет PENDING пока загрузка не будет проверена и обработана. Если обработка прошла успешно, статус изменится на COMPLETED .
Если во время обработки произошла ошибка и загрузка не удалась, статус загрузки будет FAILED . Будет предоставлен список ошибок, который поможет вам определить проблемы с файлом. Ниже приведен пример ответа на загрузку, не прошедшую проверку:
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
Суммирование данных о затратах и перезапись
При создании пользовательского источника данных/набора данных для данных о расходах у вас есть возможность указать, как обрабатывать случаи, когда загруженный файл содержит строку данных с ключом (т. е. датой, источником, каналом), который соответствует существующей строке. Возможные варианты:
- суммирование (по умолчанию). Новые данные будут добавлены к любым предыдущим совпадающим данным, а показатели будут суммированы.
- перезаписать — новые данные перезапишут любые предыдущие соответствующие данные.
Чтобы узнать, какой тип был установлен для набора данных, используйте метод списка пользовательских источников данных, чтобы проверить, установлено ли для свойства importBehavior значение OVERWRITE или SUMMATION .
Суммирование на уровне строк данных о затратах и перезапись
У вас также есть возможность переопределить поведение набора данных для каждого загружаемого файла, включив столбец ga:importBehavior в заголовок. Для каждой строки вы можете установить значение ga:importBehavior на SUMMATION или OVERWRITE .
Например, следующий файл перезапишет все предыдущие данные о расходах для Facebook/cpc и Yahoo/cpc , но строка для Bing/cpc будет добавлена к любым существующим данным о расходах для этой конкретной даты и комбинации источника/канала .
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
Формат и ограничения
Чтобы данные можно было загрузить в Google Analytics, они должны быть в правильно отформатированном CSV-файле. В этом разделе описаны те ограничения, которым он должен соответствовать, прежде чем его можно будет считать допустимым для загрузки во все типы импорта данных.
Если какое-либо из приведенных ниже ограничений нарушено или возникла ошибка синтаксического анализа, запрос на загрузку завершится неудачно с сообщениями об ошибках . API сообщит до 10 ошибок в одном ответе, чтобы помочь пользователям сократить количество недействительных загрузок.
Ограничения файлов
- Кодировка: UTF-8
- Ограничение размера файла: 1 ГБ.
Ограничения заголовка
- Первая строка считается заголовком столбца и является обязательной. Он должен определить параметры и показатели, которые будет содержать конкретный столбец.
Ограничения строк
- Существует ограничение на размер строки в 1 МБ.
Форматирование ячеек
- Ячейки могут иметь максимальную длину 2048 символов.
- Ведущие и конечные пробелы ячейки будут удалены.
- Чтобы указать запятую внутри ячейки, значение ячейки должно быть заключено в двойные кавычки. Например,
source1,"medium,ether",group1,100. Второе значение ячейки — средний,эфир. - Чтобы указать двойные кавычки внутри ячейки, помимо начальных и конечных двойных кавычек, экранируйте двойную кавычку другой двойной кавычкой. Например,
source1,"medium""ether",group1,100— второе значение ячейки —medium"ether.