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

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

Общие требования к формату

  • Файл с данными о продажах в магазине должен быть в формате Excel, CSV или Google Таблиц. При необходимости воспользуйтесь этими шаблонами:
  • Чтобы защитить информацию о клиентах, необходимо хешировать их имена, адреса электронной почты и номера телефонов. Вы можете сделать это самостоятельно, или Google Реклама автоматически обработает данные с помощью алгоритма SHA-256, который является отраслевым стандартом одностороннего хеширования.
  • Также для успешной загрузки файла его размер не должен превышать установленное ограничение.
    • При однократной загрузке напрямую в аккаунт Google Рекламы: 50 МБ (или 100 000 строк).
    • При загрузке с помощью Google Ads API: 1 000 000 строк на одно задание загрузки. Используйте сервис OfflineUserDataJobService для создания задания и метод AddOfflineUserDataJobOperations для добавления транзакций пакетами по 10 000 строк. Чтобы ускорить процесс, можно создать сразу несколько заданий загрузки.
       
      Примечание. Если вы пользуетесь услугами партнера по обработке данных о продажах в магазине, узнайте у него об ограничениях на размеры файлов.

Требования к формату заголовков столбцов

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

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

Метаданные загрузки

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

Заголовок столбца в этой строке должен иметь следующий формат:

Parameters:TimeZone=<insert_TZ>;LoyaltyRate=<insert_rate>;TransactionUploadRate=<insert_rate>

В скобках необходимо указать значения соответствующих параметров.

Метаданные транзакций клиентов

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

  • Email (адрес электронной почты)
  • First Name (имя)
  • Last Name (фамилия)
  • City (город)
  • State (штат/область)
  • Zip (почтовый индекс)
  • Country (страна)
  • Phone Number (номер телефона)
  • Conversion Name (название конверсии, обязательно)
  • Conversion Time (время конверсии, обязательно)
  • Conversion Value (ценность конверсии, обязательно)
  • Conversion Currency (валюта конверсии, обязательно)
Для каждого клиента можно указать до 3 адресов электронной почты и 3 номеров телефонов, создав для дополнительных значений отдельные столбцы с таким же названием.

В следующем разделе рассказывается о требованиях к формату данных о транзакциях.

Требования к формату данных

Для успешного импорта в Google Рекламу данные о транзакциях клиентов должны иметь правильный формат. Некоторые сведения необходимо хешировать с помощью алгоритма SHA-256. К таким сведениям относятся следующие:

  • Адреса электронной почты клиентов
  • Номера телефонов клиентов
  • Имена и фамилии клиентов

Остальные сведения о транзакциях, такие как названия стран, почтовые индексы и атрибуты, хешировать не нужно.

Сначала скачайте шаблон в формате Excel, CSV или Google Таблиц и внесите в него данные о транзакциях клиентов. Если вы не можете хешировать данные о клиентах, используйте шаблон CSV. В этом случае Google Реклама автоматически выполнит хеширование при загрузке файла.

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

TimeZone (часовой пояс)

  • Этот параметр указывается в первой строке, если все конверсии осуществлялись в одном часовом поясе.
    • Если же часовой пояс различается, укажите его для каждой конверсии в столбце Conversion Time. См. инструкции и таблицу в разделе "Conversion Time (время конверсии)" этой статьи.
    • Если вы укажете часовой пояс и в первой строке, и в столбце Conversion Time, то второе из этих значений будет иметь приоритет. Значение, указанное в первой строке, будет использоваться только в случае, если в столбце Conversion Time часовой пояс не задан.
  • Чтобы избежать ошибок, связанных с переходами на летнее и зимнее время, выберите идентификатор нужного часового пояса из этого списка.
  • Укажите смещение относительно времени по Гринвичу в формате четырехзначного числа со знаком плюс или минус. Если смещения нет, укажите +0000.

Примеры:

  • America/New_York-0500
  • Europe/Berlin+0100

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

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

Примеры:

  • 0,5
  • 0,2
  • 0,8

TransactionUploadRate (частота загрузки транзакций)

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

Примеры:

  • 0,5
  • 0,2
  • 0,8

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

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

Примеры:

  • user1@gmail.com
  • user2@mail.ru

First Name (имя)

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

Примеры:

  • антон
  • ёлана
  • анна-мария

Last Name (фамилия)

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

Примеры:

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

City (город)

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

Примеры:

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

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

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

Примеры:

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

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

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

Примеры:

  • 94109
  • 94109-1234
  • W1J 0BH

Country (страна)

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

Примеры:

  • RU
  • DE
  • FR
  • US
  • JP

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

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

Примеры:

  • +12038271234
  • +442071838750

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

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

Примеры:

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

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

  • Используйте допустимый формат даты (см. таблицу ниже).
    • Если требуется указать часовой пояс конверсии, выберите любой из последних четырех вариантов.
    • Вместо "+з" укажите смещение относительно времени по Гринвичу (четырехзначное число со знаком плюса или минуса).
    • Вы также можете подставить вместо "зззз" идентификатор из этого списка.
Формат Пример
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
гггг-ММ-дд ЧЧ:мм:сс+з 2020-08-14 13:00:00+0500
гггг-MM-ддTЧЧ:мм:сс+з 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

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

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

Требуется помощь?

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