Данные о продажах в магазине должны иметь верный формат и соответствовать правилам в отношении данных о клиентах. В этой статье рассказывается, как отформатировать файл с данными.
Содержание
- Как добавить данные о продажах в магазине
- Как отформатировать файл с данными
- Как отформатировать заголовки столбцов
- Требования к формату данных о пользовательских транзакциях
Подготовка
Файл с данными о продажах в магазине должен быть в формате Excel, CSV или Google Таблиц. При необходимости воспользуйтесь этими шаблонами:
Общие требования к формату
- Чтобы защитить информацию о клиентах, необходимо хешировать их имена, адреса электронной почты и номера телефонов. Вы можете сделать это самостоятельно или положиться на Google Рекламу и ее алгоритм SHA-256, который является отраслевым стандартом одностороннего хеширования.
- Размер файла не должен превышать установленное ограничение.
- При однократной загрузке напрямую в аккаунт Google Рекламы:
- 150 МБ: только для CSV-файлов, загруженных в Google Рекламу вручную (около 300 000 строк транзакций).
- 50 МБ: для всех других форматов, включая CSV-файлы, загруженные по расписанию (около 100 000 строк транзакций).
- При загрузке с помощью Google Ads API: 1 000 000 строк на одно задание загрузки. Используйте сервис OfflineUserDataJobService для создания задания и метод AddOfflineUserDataJobOperations для добавления транзакций пакетами по 10 000 строк. Чтобы ускорить процесс, можно создать сразу несколько заданий загрузки.
Примечание. Если вы пользуетесь услугами партнера по обработке данных о продажах в магазине, узнайте у него об ограничениях на размеры файлов.
- При однократной загрузке напрямую в аккаунт Google Рекламы:
Если у вас возникнут вопросы технического характера, связанные с Google Ads API (например, вопросы, непосредственно связанные с использованием API или SDK, ошибками, возникающими при их использовании, и т. д.), выполните инструкции, приведенные на странице технической поддержки API.
Если у вас есть вопросы по Google Ads API, связанные непосредственно с интерфейсом Google Рекламы, нажмите "Связаться с нами" в нижней части страницы.
Требования к формату заголовков столбцов
В файле с данными о продажах в магазине должно быть две строки заголовков: с метаданными загрузки и с названиями столбцов данных о транзакциях.
Метаданные загрузки
Первая строка должна содержать метаданные загрузки.
Примечание. Если вы настроили пользовательские переменные, заголовок столбца в этой строке должен выглядеть так:
Parameters:TimeZone=<insert_TZ>;LoyaltyRate=<insert_rate>;TransactionUploadRate=<insert_rate>;CustomVariable=<insert_name>
Обратите внимание, что пользовательская переменная должна быть активна.
Замените текст в треугольных скобках нужными значениями параметров.
- Для параметров LoyaltyRate и TransactionUploadRate следует указать значение 1.
Метаданные транзакций клиентов
Вторая строка должна содержать информацию, относящуюся к загружаемым данным о транзакциях клиентов (например, именам, электронным адресам и номерам телефонов). Ниже приведены заголовки столбцов, которые можно добавить во вторую строку.
- Email (адрес электронной почты)
- First Name
- Last Name (фамилия)
- City (город)
- State (штат/область)
- Zip (почтовый индекс)
- Country (страна)
- Phone Number (номер телефона)
- Conversion Name (название конверсии, обязательно)
- Conversion Time (время конверсии, обязательно)
- Conversion Value (ценность конверсии, обязательно)
- Conversion Currency (валюта конверсии, обязательно)
- Ad User Data (данные пользователей, взаимодействующих с объявлением; требуется, если данные о продажах в магазинах используются вместе со списками электронных адресов пользователей из ЕЭЗ)
- Ad Personalization (персонализация рекламы; требуется, если данные о продажах в магазинах используются вместе со списками электронных адресов пользователей из ЕЭЗ)
В следующем разделе приводятся требования к формату данных о продажах в магазине.
Требования к формату данных
Для успешного импорта в Google Рекламу данные о транзакциях клиентов должны иметь правильный формат. Некоторые сведения необходимо хешировать с помощью алгоритма SHA-256. К таким сведениям относятся следующие:
- адреса электронной почты клиентов;
- Номера телефонов клиентов.
- имена и фамилии клиентов.
Остальные сведения о транзакциях, такие как названия стран, почтовые индексы и атрибуты, хешировать не нужно.
Сначала скачайте шаблон в формате Excel, CSV или Google Таблиц и внесите в него данные о транзакциях клиентов. Если вы не можете хешировать данные о клиентах, используйте шаблон CSV. В этом случае Google Реклама автоматически выполнит хеширование при загрузке файла.
Чтобы посмотреть требования для каждого столбца, разверните разделы ниже. Названия столбцов должны в точности соответствовать указанным в шаблоне.
Time zone (часовой пояс)- Этот параметр указывается в первой строке, если все конверсии осуществлялись в одном часовом поясе.
- Если же часовые пояса различаются, укажите их для каждой конверсии в столбце Conversion Time согласно инструкции и таблице в разделе "Conversion Time (время конверсии)" этой статьи.
- Если вы укажете часовой пояс и в первой строке, и в столбце Conversion Time, то второе из этих значений будет иметь приоритет. Значение, указанное в первой строке, будет использоваться только в случае, если для конверсии не указан часовой пояс.
- Чтобы избежать ошибок, связанных с переходами на летнее и зимнее время, выберите идентификатор нужного часового пояса из этого списка.
- Укажите смещение относительно времени по Гринвичу в формате четырехзначного числа со знаком плюс или минус. Если смещения нет, укажите +0000.
Примеры:
- America/New_York-0500
- Europe/Berlin+0100
- Процент загружаемых продаж, которые вы можете связать с конкретными клиентами.
- Рекомендуем использовать значение по умолчанию – 1.
- В настоящее время доля загруженных транзакций не влияет на регистрацию продаж в магазинах. Рекомендуем загружать данные обо всех продажах, связанных с конкретными клиентами, и указывать для доли загруженных транзакций значение "1".
Примеры:
- 0.5
- 0.2
- 0.8
- Адреса электронной почты должны включать доменное имя (например, gmail.com или mail.ru).
- Между адресами электронной почты не должно быть пробелов.
- Не используйте заглавные буквы.
- Для каждого клиента можно указать до трех адресов электронной почты (в отдельных столбцах Email).
Примеры:
- Не используйте заглавные буквы.
- Диакритические знаки допускаются.
- Удалите лишние пробелы между частями имени, а также до и после него.
Примеры:
- антон
- ольга
- анна-мария
- Не используйте заглавные буквы.
- Диакритические знаки допускаются.
- Удалите лишние пробелы между частями имени, а также до и после него.
Примеры:
- иванов
- о’нил
- салтыков-щедрин
- макдоннелл
- Не используйте заглавные буквы.
- Диакритические знаки допускаются.
Примеры:
- санкт-петербург
- нижний новгород
- москва
- париж
- Не используйте заглавные буквы.
- Исключение: двухбуквенные сокращения для названий штатов в США.
Примеры:
- CA
- калифорния
- саратовская область
- махараштра
- Можно указывать почтовые индексы США и международные почтовые индексы.
- Для США:
- Допускаются пятизначные почтовые индексы.
- После пятизначного кода можно указать четырехзначный добавочный код, чтобы повысить коэффициент соответствия.
- Для остальных стран:
- Не указывайте добавочные почтовые индексы.
Примеры:
- 94109
- 94109-1234
- W1J 0BH
- Используйте двухбуквенные коды стран ISO.
- Указывайте код страны, даже если все ваши клиенты из одной страны.
Примеры:
- RU
- DE
- FR
- US
- JP
- Формат телефонных номеров должен соответствовать стандарту E.164 и начинаться с префикса "+", после которого указывается код страны и номер абонента (может содержать код зоны или населенного пункта).
- Для каждого клиента можно указать до трех телефонных номеров в отдельных столбцах Phone Number.
Примеры:
- +12038271234
- +442071838750
- Название действия-конверсии, для которого вы импортируете данные.
- Это значение должно в точности соответствовать (включая использование заглавных букв) названию действия-конверсии, указанному в аккаунте Google Рекламы.
Примеры:
- Регистрации клиентов
- Покупки клиентов
- Используйте допустимый формат даты (см. таблицу ниже).
- Чтобы указать часовой пояс конверсии, выберите любой из последних четырех вариантов.
- Вместо "+z" укажите смещение относительно времени по Гринвичу (четырехзначное число со знаком плюса или минуса).
- Вы также можете подставить вместо "зззз" идентификатор часового пояса.
Формат | Пример |
MM/дд/гггг чч:мм:сс aa | 08/14/2020 5:01:54 PM |
MMM дд,гггг чч:мм:сс aa | Авг 14, 2020 5:01:54 PM |
MM/дд/гггг ЧЧ:мм:сс | 08/14/2020 17:01:54 |
гггг-ММ-дд ЧЧ:мм:сс | 2020-08-14 13:00:00 |
гггг-MM-ддTЧЧ:мм:сс | 2020-08-14T13:00:00 |
гггг-ММ-дд ЧЧ:мм:сс+z | 2020-08-14 13:00:00+0500 |
гггг-MM-ддTЧЧ:мм:сс+z | 2020-08-14T13:00:00-0100 |
гггг-ММ-дд ЧЧ:мм:сс зззз | 2020-08-14 13:00:00 Europe/Moscow |
гггг-ММ-ддTЧЧ:мм:сс зззз | 2020-08-14T13:00:00 Europe/Moscow |
- Денежная сумма, в которой выражена ценность конверсии.
- Можно использовать только положительные числа.
- Валюта, в которой указана ценность конверсии.
- Используйте этот столбец, если вы указываете ценность конверсии в разных валютах или работаете с клиентскими аккаунтами, в которых используются разные платежные валюты.
- Используйте трехзначные коды валют по стандарту ISO 4217.
Примеры:
- RUB
- USD
- EUR
- Значения, связанные с пользовательской переменной, указаны в строке параметра.
- Значения переменной, указанные в файле загрузки, должны совпадать со значениями, заданными в аккаунте Google Рекламы.
- Используйте этот столбец, если вы настроили пользовательские переменные и указали пользовательскую переменную в параметрах.
- Используйте этот столбец, чтобы задать значения переменной, связанные с каждой транзакцией.
- Если вы загрузили транзакции, значения переменных в которых отличаются от заданных в аккаунте Google Рекламы, то связанные с такими транзакциями конверсии – продажи в магазине в отчетах будут помечены как "Без категории".
Примеры:
- Пользовательская переменная: "Тип клиента"
- Значения переменной: "Новый" или "Постоянный"
- Пользовательская переменная: "Категория товаров"
- Значения переменной: "Куртки", "Обувь", "Спортивная одежда" или "Другое"
- Содержит сигналы согласия пользователей из ЕЭЗ, необходимые для сбора данных.
- Требуется, если вы используете данные о продажах в магазинах вместе со списками электронных адресов.
Возможные значения:
- Предоставлено.
- Отклонено.
- Не указано.
Пример:
- Получено.
- Отклонено.
- Содержит сигналы согласия пользователей из ЕЭЗ, необходимые для персонализации рекламы.
- Требуется, если вы используете данные о продажах в магазинах вместе со списками электронных адресов.
Возможные значения:
- Предоставлено.
- Отклонено.
- Не указано.
Пример:
- Получено.
- Отклонено.