Як форматувати дані продажів у магазинах

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

Зміст статті

• Як додавати дані продажів у магазинах
• Правила форматування файлу з даними продажів у магазинах
• Правила форматування заголовків стовпців
• Правила форматування даних про трансакції клієнтів

Як додавати дані продажів у магазинах

Використовуйте файл Excel, CSV або таблицю Google. Для зручності можна скористатися наведеними нижче шаблонами.

• Excel
• Файл CSV
• Google Таблиці

Правила форматування файлу з даними продажів у магазинах

• Щоб захистити інформацію про клієнтів, пов’язану з трансакціями (імена й прізвища, електронні адреси, номери телефонів), її потрібно прохешувати. Ви можете зробити це самостійно або просто завантажити дані в Google Ads, де вони пройдуть автоматичне хешування за алгоритмом SHA-256 (галузевий стандарт одностороннього хешування).
• Файл не має перевищувати обмеження щодо розміру, інакше він не завантажиться.
  • Для одноразового завантаження безпосередньо в обліковий запис Google Ads:
    • 150 МБ – лише для файлів CSV, завантажених у Google Ads вручну (приблизно 300 000 рядків із трансакціями);
    • 50 МБ – для всіх інших форматів, включно з файлами CSV, завантаженими за розкладом (приблизно 100 000 рядків із трансакціями).
  • Для завантаження через Google Ads API – до 1 000 000 рядків із трансакціями включно в одному завданні. Створюйте завдання за допомогою методу OfflineUserDataJobService, а щоб додати трансакції, використовуйте метод AddOfflineUserDataJobOperations. З міркувань уникнення проблем в обробці даних додавайте їх у завдання партіями по 10 000 рядків за раз. Паралельно можна створювати кілька завдань завантаження, щоб інформація швидше надходила на обробку.
    Примітка. Якщо ви користуєтеся послугами партнера з обробки даних про продажі в магазинах, уточніть у нього інформацію про ліміти завантаження.

Якщо у вас виникнуть технічні запитання щодо Google Ads API (наприклад, безпосередньо пов’язані із застосуванням API чи SDK або помилками, що виникають під час їх використання, тощо), дотримуйтеся вказівок із вирішення проблем, наведених на цій сторінці.

Якщо у вас виникнуть запитання щодо Google Ads API, які стосуються безпосередньо інтерфейсу Google Ads, натисніть "Зв’язатися з нами" внизу сторінки.

Правила форматування заголовків стовпців

Файл із даними продажів у магазинах має містити 2 рядки із заголовками: перший – для метаданих завантаження, другий – для назв стовпців з інформацією про трансакції клієнтів.

Примітка. Використовуйте лише англомовні заголовки стовпців. Вони мають повністю збігатися з наведеними тут. Решта даних може бути будь-якою мовою.

Метадані завантаження

Перший рядок призначено для метаданих завантаження.

Примітка. Якщо ви використовуєте функцію спеціальних змінних, заголовки стовпців у цьому рядку повинні мати такий формат:

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 (якщо використовуються дані про продажі в магазинах і списки електронних адрес для користувачів з ЄЕЗ)

У файлі для завантаження потрібно обов’язково вказати принаймні одну електронну адресу, номер телефону чи адресу. Для кожного клієнта можна вказувати по 3 електронні адреси й 3 номери телефонів. Щоб додати більше, створіть у файлі 3 стовпці Email (Електронна адреса) і 3 стовпці Phone Number (Номер телефону).

У наступному розділі пояснюється, як форматувати дані продажів у магазинах.

Правила форматування даних про трансакції клієнтів

Інформацію про трансакції клієнтів потрібно правильно відформатувати, інакше вона не завантажиться в Google Ads. Певні дані також потребують хешування за алгоритмом SHA-256. Зокрема, це:

• електронні адреси клієнтів;
• Номери телефонів клієнтів
• імена й прізвища клієнтів.

Інші дані про трансакції клієнтів (країни проживання, поштові індекси, атрибути тощо) не потребують хешування.

Завантажте собі шаблон Excel, CSV або Google Таблиць і внесіть у нього інформацію про трансакції клієнтів. Якщо ви не можете самостійно її прохешувати, скористайтеся шаблоном CSV. Коли ви його завантажите, Google Ads автоматично прохешує всі потрібні дані.

Нижче наведено вказівки з оформлення кожного стовпця шаблону. Щоб переглянути їх, розгорніть відповідний розділ. У жодному разі не змінюйте назви стовпців у шаблоні.

Time zone

• Якщо всі конверсії відбулися в одному часовому поясі, укажіть це значення в першому рядку.
  • Якщо конверсії зареєстровано в різних часових поясах, укажіть у стовпці Conversion Time (Час конверсії) часовий пояс кожної конверсії. Перегляньте вказівки й таблицю в розділі Conversion Time нижче.
  • Якщо вказати часовий пояс і в першому рядку, і в стовпці Conversion Time, значення в останньому матимуть вищий пріоритет. Якщо в певному рядку з часом конверсії не стоятиме часовий пояс, Google Ads візьме його значення з першого рядка.
• Щоб уникнути помилок, пов’язаних із переходом на літній час, використовуйте ідентифікатори часових поясів із цього списку.
• Щоб указати зміщення відносно часу за Гринвічем (GMT), спершу введіть символ "+" або "-", а потім – різницю у вигляді 4-значного числа. Для часового поясу GMT це значення матиме такий вигляд: "+0000".

Приклади

• Europe/Kyiv+0300
• Europe/Berlin+0100

Loyalty rate

• Відсоток продажів, згаданих у файлі, які можна зіставити з конкретними клієнтами.
• Рекомендуємо залишити значення "1".

Transaction upload rate

• Наразі значення коефіцієнта завантаження трансакцій не впливає на звіти про продажі в магазинах. Ми рекомендуємо завантажити дані про всі продажі, пов’язані з клієнтами, і встановити для коефіцієнта завантаження трансакцій значення 1.

Приклади

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

Email

• Указуйте доменне ім’я для всіх електронних адрес, як-от gmail.com або hotmail.co.jp.
• Вилучіть пробіли з електронних адрес.
• Використовуйте лише малі літери.
• Для кожного клієнта можна вказати по 3 електронні адреси в 3 окремих стовпцях Email.

Приклади

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

First name

• Використовуйте лише малі літери.
• Можна ставити наголоси.
• Вилучайте зайві пробіли між іменами й навколо них.

Приклади

• петро
• дарина
• анна-марія

Last name

• Використовуйте лише малі літери.
• Можна ставити наголоси.
• Вилучайте зайві пробіли між іменами й навколо них.

Приклади

• онищенко
• лук’яненко
• гулак-артемовський
• лісовська

City

• Використовуйте лише малі літери.
• Можна ставити наголоси.

Приклади

• львів
• київ
• кам’янець-подільський
• вінниця

State

• Використовуйте лише малі літери.
  • Винятки: 2-буквені скорочені назви штатів США.

Приклади

• CA
• каліфорнія
• нью-йорк
• махараштра

Zip

• Допускаються поштові індекси американського й міжнародного зразків.
• Для США:
  • допускаються 5-значні індекси;
  • також дозволяється вводити 4-значне розширення після 5-значного коду, що допоможе покращити коефіцієнт збігу.
• Для інших країн:
  • забороняється використовувати розширені поштові індекси.

Приклади

• 94109
• 94109-1234
• W1J 0BH

Country

• Використовуйте дволітерні коди ISO для назв країн.
• Вводьте код країни, навіть якщо всі дані ваших клієнтів з однієї країни.

Приклади

• US
• DE
• FR
• AU
• JP

Phone number

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

Приклади

• [phone]
• [phone]

Conversion name

• Назва імпортованої дії-конверсії.
• Має повністю збігатися з назвою дії-конверсії в обліковому записі Google Ads.

Приклади

• SS_customer_signups
• SS_customer_purchases

Conversion Time

• Використовуйте підтримуваний формат дат (дивіться таблицю нижче).
  • Якщо хочете вказати час конверсії разом із часовим поясом, використовуйте один із 4 останніх форматів у таблиці.
  • Замініть "+z" на величину зміщення відносно часу за Гринвічем (GMT): введіть символ "+" або "-", а потім – різницю у вигляді 4-значного числа.
  • Замість "zzzz" можна вказати ідентифікатор часового поясу.

Формат	Приклади
ММ/дд/рррр гг:хх:сс aa	"08/14/2020 5:01:54 PM"
МММ дд,рррр гг:хх:сс aa	"Aug 14, 2020 5:01:54 PM"
ММ/дд/рррр ГГ:хх:сс	"08/14/2020 17:01:54"
рррр-ММ-дд ГГ:хх:сс	"2020-08-14 13:00:00"
рррр-ММ-ддЧГГ:хх:сс	"2020-08-14T13:00:00"
рррр-ММ-дд ГГ:хх:сс+z	"2020-08-14 13:00:00+0500"
рррр-ММ-ддTГГ:хх:сс+z	"2020-08-14T13:00:00-0100"
рррр-ММ-дд ГГ:хх:сс zzzz	"2020-08-14 13:00:00 America/Los_Angeles"
рррр-ММ-ддTГГ:хх:сс zzzz	"2020-08-14T13:00:00 America/Los_Angeles"

Conversion value

• Числове значення цінності конверсії.
• Може бути лише додатним числом.

Conversion currency

• Валюта, у якій указано цінність конверсії (стовпець Conversion Value).
• Застосовуйте цей стовпець, якщо цінність конверсій указано в різних валютах або ви працюєте з кількома обліковими записами клієнтів, де використовуються різні валюти.
• Указуйте тризначні коди за стандартом ISO 4217.

Приклади

• USD
• JPY
• EUR

Custom variable value

• Значення, пов’язані з користувацькою змінною, яку вказано в рядку параметрів.
• Значення змінних у завантажених даних повинні відповідати значенням, які вказано у вашому обліковому записі Google Ads.
• Використовуйте цей стовпець, якщо ви застосовуєте спеціальні змінні й указали змінну в параметрах.
• У цьому стовпці вказуються значення змінних, пов’язаних із кожною трансакцією.
• Якщо дані трансакції завантажено зі значенням змінної, яке не відповідає вказаному в обліковому записі Google Ads, продажі в магазині, пов’язані з такою трансакцією, реєструються зі значенням змінної "Без категорії".

Приклади

• Спеціальна змінна: "Тип клієнта"
  • Значення змінної: "Новий", "Повторні відвідування"
• Спеціальна змінна: "Категорія товару"
• Значення змінної: "Куртки", "Взуття", "Спортивний одяг" або "Інше"

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

Ad User Data

• Передавайте сигнали про згоду для користувачів із ЄЕЗ, щоб вимірювати ефективність реклами.
• Потрібний, якщо використовується зіставлення списків електронних адрес із даними про продажі в магазинах.

Можливі значення:

• Надано. Згоду на використання даних надано.
• Заборонено. Згоду на використання даних заборонено.
• Не вказано. Статус згоди не вказано.

Приклади

• Надано
• Заборонено

Ad Personalization

• Передавайте сигнали про згоду для користувачів із ЄЕЗ, щоб персоналізувати рекламу.
• Потрібний, якщо використовується зіставлення списків електронних адрес із даними про продажі в магазинах.

Можливі значення:

• Надано. Згоду на використання даних надано.
• Заборонено. Згоду на використання даних заборонено.
• Не вказано. Статус згоди не вказано.

Приклади

• Надано
• Заборонено

НА ГОЛОВНУ СТОРІНКУ ПРО ПРОДАЖІ В МАГАЗИНАХ