Как отформатировать данные о продажах в магазине

Данные о продажах в магазине должны иметь верный формат и соответствовать правилам в отношении данных о клиентах. В этой статье рассказывается, как отформатировать файл с данными.

Содержание

• Как добавить данные о продажах в магазине
• Как отформатировать файл с данными
• Как отформатировать заголовки столбцов
• Требования к формату данных о пользовательских транзакциях

Подготовка

Файл с данными о продажах в магазине должен быть в формате Excel, CSV или Google Таблиц. При необходимости воспользуйтесь этими шаблонами:

• 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 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

Loyalty rate (коэффициент лояльности)

• Процент загружаемых продаж, которые вы можете связать с конкретными клиентами.
• Рекомендуем использовать значение по умолчанию – 1.

Transaction upload rate (доля загруженных транзакций)

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

Примеры:

• 0.5
• 0.2
• 0.8

Email (адрес электронной почты)

• Адреса электронной почты должны включать доменное имя (например, gmail.com или mail.ru).
• Между адресами электронной почты не должно быть пробелов.
• Не используйте заглавные буквы.
• Для каждого клиента можно указать до трех адресов электронной почты (в отдельных столбцах Email).

Примеры:

• [e-mail]
• [e-mail]

First name (имя)

• Не используйте заглавные буквы.
• Диакритические знаки допускаются.
• Удалите лишние пробелы между частями имени, а также до и после него.

Примеры:

• антон
• ольга
• анна-мария

Last name (фамилия)

• Не используйте заглавные буквы.
• Диакритические знаки допускаются.
• Удалите лишние пробелы между частями имени, а также до и после него.

Примеры:

• иванов
• о’нил
• салтыков-щедрин
• макдоннелл

City (город)

• Не используйте заглавные буквы.
• Диакритические знаки допускаются.

Примеры:

• санкт-петербург
• нижний новгород
• москва
• париж

State (штат/область)

• Не используйте заглавные буквы.
  • Исключение: двухбуквенные сокращения для названий штатов в США.

Примеры:

• CA
• калифорния
• саратовская область
• махараштра

Zip (почтовый индекс)

• Можно указывать почтовые индексы США и международные почтовые индексы.
• Для США:
  • Допускаются пятизначные почтовые индексы.
  • После пятизначного кода можно указать четырехзначный добавочный код, чтобы повысить коэффициент соответствия.
• Для остальных стран:
  • Не указывайте добавочные почтовые индексы.

Примеры:

• 94109
• 94109-1234
• W1J 0BH

Country (страна)

• Используйте двухбуквенные коды стран ISO.
• Указывайте код страны, даже если все ваши клиенты из одной страны.

Примеры:

• RU
• DE
• FR
• US
• JP

Phone number (номер телефона)

• Формат телефонных номеров должен соответствовать стандарту E.164 и начинаться с префикса "+", после которого указывается код страны и номер абонента (может содержать код зоны или населенного пункта).
• Для каждого клиента можно указать до трех телефонных номеров в отдельных столбцах Phone Number.

Примеры:

• [phone]
• [phone]

Conversion name (название конверсии)

• Название действия-конверсии, для которого вы импортируете данные.
• Это значение должно в точности соответствовать (включая использование заглавных букв) названию действия-конверсии, указанному в аккаунте Google Рекламы.

Примеры:

• Регистрации клиентов
• Покупки клиентов

Conversion Time (время конверсии)

• Используйте допустимый формат даты (см. таблицу ниже).
  • Чтобы указать часовой пояс конверсии, выберите любой из последних четырех вариантов.
  • Вместо "+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

Conversion value (ценность конверсии)

• Денежная сумма, в которой выражена ценность конверсии.
• Можно использовать только положительные числа.

Conversion currency (валюта конверсии)

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

Примеры:

• RUB
• USD
• EUR

Custom variable value (значение пользовательской переменной)

• Значения, связанные с пользовательской переменной, указаны в строке параметра.
• Значения переменной, указанные в файле загрузки, должны совпадать со значениями, заданными в аккаунте Google Рекламы.
• Используйте этот столбец, если вы настроили пользовательские переменные и указали пользовательскую переменную в параметрах.
• Используйте этот столбец, чтобы задать значения переменной, связанные с каждой транзакцией.
• Если вы загрузили транзакции, значения переменных в которых отличаются от заданных в аккаунте Google Рекламы, то связанные с такими транзакциями конверсии – продажи в магазине в отчетах будут помечены как "Без категории".

Примеры:

• Пользовательская переменная: "Тип клиента"
  • Значения переменной: "Новый" или "Постоянный"
• Пользовательская переменная: "Категория товаров"
• Значения переменной: "Куртки", "Обувь", "Спортивная одежда" или "Другое"

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

Ad User Data (Данные пользователей, взаимодействующих с объявлением)

• Содержит сигналы согласия пользователей из ЕЭЗ, необходимые для сбора данных.
• Требуется, если вы используете данные о продажах в магазинах вместе со списками электронных адресов.

Возможные значения:

• Предоставлено.
• Отклонено.
• Не указано.

Пример:

• Получено.
• Отклонено.

Персонализация рекламы

• Содержит сигналы согласия пользователей из ЕЭЗ, необходимые для персонализации рекламы.
• Требуется, если вы используете данные о продажах в магазинах вместе со списками электронных адресов.

Возможные значения:

• Предоставлено.
• Отклонено.
• Не указано.

Пример:

• Получено.
• Отклонено.

НА ГЛАВНУЮ СТРАНИЦУ ПРОДАЖ В МАГАЗИНЕ