Magefan 2 надсилає дані про події конверсій вашого магазину — перегляди сторінок, перегляди товарів, додавання до кошика, початок оформлення замовлення, покупки, реєстрації та ліди — до OpenAI Ads Manager, щоб ви могли вимірювати, як люди взаємодіють з вашим магазином одразу після натискання на ваші оголошення ChatGPT. Він підтримує як OpenAI Pixel на стороні браузера, так і API конверсій на стороні сервера (CAPI).
У цьому Документація ви дізнаєтеся, як налаштувати ідентифікатор пікселя реклами OpenAI Ads та ключ API конверсій у OpenAI Ads Manager, налаштувати з’єднання між вашим магазином Magento та обліковим записом OpenAI Ads, а також перевірити, чи все працює, перш ніж запускати будь-які оголошення.
Встановлення та оновлення
Перейдіть до свого облікового запису Magefan та Документація з керування модулі Magefan , щоб дізнатися, як встановити модуль відстеження конверсій OpenAI Ads.
Типи відстеження реклами OpenAI
Модуль Magefan Open AI Ads дозволяє налаштувати як веб-відстеження (Pixel), так і відстеження на стороні сервера (Conversions API). Хоча ви можете використовувати їх окремо, рекомендується використовувати обидва варіанти для точнішого відстеження даних, коли люди відхиляють файли cookie або використовують блокувальники реклами.
- OpenAI Ads Pixel — модуль вставляє піксель безпосередньо в код вашого веб-сайту. Якщо хтось відхиляє файли cookie або використовує блокувальники реклами під час відвідування вашого магазину, піксель не надсилатиме жодних даних до OpenAI Ads Manager, щоб дотримуватися правил конфіденційності даних. Для Pixel вам не потрібно створювати жодних подій в OpenAI Ads Manager, модуль створює та надсилає їх автоматично.
- OpenAI Ads Conversion API — модуль відстежує дії користувачів у вашому магазині та надсилає їх через сервер на сервер OpenAI Ads Manager. Це зменшує неточність даних і гарантує, що ви отримуватимете лише точні звіти про дії користувачів у вашому магазині. Для серверного Conversion API вам потрібно створювати події в OpenAI Ads Manager.
Примітка: Модуль OpenAI Ads працює з вбудованою дедуплікацією подій, тому воно відстежує лише ті події, які не відстежувалися пікселем, якщо ви використовуєте і піксель, і Conversion API.
Налаштування OpenAI Pixel та Conversions API
Перед налаштуванням модуль Magefan OpenAI Ads вам знадобиться ідентифікатор пікселя OpenAI та ключ Conversions API. Обидва створюються з OpenAI Ads Manager.
OpenAI Ads Pixel
Увійдіть у OpenAI Ads Manager , якщо у вас вже є обліковий запис, і відкрийте Інструменти > Вкладка «Конверсії . Потім створіть нове джерело даних.
Все, що вам потрібно зробити, це надати йому назву.
Потім скопіюйте ідентифікатор пікселя та збережіть його на потім. Цей ідентифікатор ідентифікує ваш магазин в OpenAI та використовується як пікселем браузера, так і API конверсій.
Примітка: OpenAI запропонує вам створити події конверсії, щоб розпочати відстеження, але вам це не потрібно, оскільки модуль Magefan OpenAI Ads вже відстежує та надсилає події пікселів до менеджера реклами.
Ви завжди знайдете всі свої ідентифікатори пікселів у розділі Інструменти > Вкладка «Конверсії.
OpenAI Ads Conversion API
Примітка: вам потрібно налаштувати джерело даних , до якого API конверсії надсилатиме дані, перш ніж налаштувати ключ конверсії.
. Щойно ви перейдете на вкладку Інструменти > Вкладка «Конверсії , натисніть на значок ключа у верхньому лівому меню.
Тут зберігаються всі ваші ключі конверсії. Натисніть Створити новий ключ та надайте йому назву.
. Система згенерує ключ для вас, тому Скопіюйте або Завантажте його на потім. Цей ключ автентифікує запити між серверами, які модуль надсилає щоразу, коли ввімкнено API конверсій.
Важливо: ключ конверсії в OpenAI Ads генерується лише один раз, тому, якщо ви просто скопіювали його, а потім втратили, вам потрібно створити новий ключ.
Якщо ви хочете використовувати API конверсій OpenAI, вам також потрібно налаштувати події в обліковому записі OpenAI Ads Manager. Просто виберіть джерело даних , до якої має бути присвоєна подія, встановіть Базову подію та Назву конверсії.
. Ось список подій, які відстежує Magefan OpenAI Ads Модуль :
- Перегляд сторінки (page_viewed)
- Перегляд товару (contents_viewed)
- Додати до кошика (items_added)
- Перегляд оформлення замовлення (checkout_started)
- Сторінка успішного оформлення замовлення (order_created)
- Реєстрацію завершено (registration_completed)
- Лід створено (lead_created)
- Перегляд списку товарів (view_item_list)
Скопіюйте всі події у вашому обліковому записі OpenAI Ads під час налаштування ключа Conversion API або пізніше, натиснувши Інструменти > Конверсія > Створити (меню) > Подія конверсії.
Усі події конверсії, що відстежуються пікселем та API конверсії, зберігаються на вкладці Інструменти > Конверсія > Події конверсії .
Після завершення налаштування пікселя конверсії та API реклами OpenAI ви можете підключити його до панелі адміністратора.
Загальні налаштування
Перейдіть до розділу Магазини > Конфігурація > Модулі Magefan > Реклама OpenAI , щоб увімкнути та налаштувати модуль.
Загальні
- Ідентифікатор пікселя OpenAI — ідентифікатор пікселя, який ви згенерували на вкладці Конверсії в менеджері реклами OpenAI. Це потрібно як для пікселя браузера, так і для API конверсій, оскільки обидва канали звітують про один і той самий піксель.
- Події — список дій у магазині Magento, які відстежує модуль , кожна з яких відповідає відповідній стандартній події OpenAI.
Примітка: піксель відстежує та автоматично надсилає їх до OpenAI Ads Manager.
API конверсій
API конверсій надсилає події безпосередньо з вашого сервера до OpenAI, незалежно від браузера відвідувача.
- Увімкнути API конверсій — вмикає або вимикає відстеження подій на стороні сервера, на додаток до пікселя OpenAI браузера.
- Маркер доступу — ключ API конверсій, який ви згенерували на вкладці Конверсії в OpenAI Ads Manager.
Порада професіонала: рекомендується використовувати Pixel та API конверсій разом, а не один чи інший. Модуль надсилає один і той самий ідентифікатор події через обидва канали, щоб OpenAI міг дедуплікувати їх та уникнути подвійного підрахунку однієї події.
Зіставлення атрибутів продукту
Зіставлення продуктів забезпечує правильну ідентифікацію продуктів.
- Ідентифікатор продукту — визначає атрибут продукту, який надсилається до OpenAI для ідентифікації кожного продукту в події.
Примітка: використовуйте ідентифікатор, який відповідає тому, як налаштовано ваш каталог продуктів у вашій стрічці продуктів ChatGPT або інтеграції каталогу, якщо ви її використовуєте.
Події
Розділ подій дозволяє вам зберегти невелике корисне навантаження подій для категорій з дуже великою кількістю продуктів.
- Максимальна кількість елементів у списку елементів перегляду — обмежує кількість товарів, включених до однієї події view_item_list. Встановіть значення 0 або залиште порожнім, якщо обмеження не вказано.
Оптимізація швидкості завантаження сторінки
Тут ви вибираєте, як завантажувати скрипт пікселя OpenAI, щоб уникнути затримок завантаження.
- Увімкнути відкладене завантаження скрипта — якщо ввімкнено, JavaScript пікселя реклами OpenAI завантажується лише після першого кліку, прокручування або дотику відвідувача, а не під час початкового завантаження сторінки. Це покращує швидкість завантаження сторінки вашого магазину та показники Core Web Vitals.
GDPR/CCPA/LGPD
Цей розділ дозволяє відстежувати дані для реклами OpenAI відповідно до правил конфіденційності даних.
- Захист даних клієнта — якщо ввімкнено, дані не надсилаються до OpenAI Ads, доки клієнт не надасть згоду.
- Завантажити скрипт Pixel перед згодою — визначає, чи дозволено завантажувати сам скрипт Pixel до надання згоди.
Тестування подій
Перш ніж увімкнути будь-яку кампанію, перевірте, як запускаються події, безпосередньо в OpenAI Ads Manager.
Перейдіть до розділу Інструменти > Конверсії > Потік подій та натисніть Розпочати опитування. Потім перейдіть на свій веб-сайт і пройдіть всю воронку продажів, від перегляду сторінки до покупки або реєстрації.
Події браузера мають з’явитися через кілька секунд, тоді як завантаження подій сервера може зайняти трохи більше часу.
Кожна подія реєструється з деякими даними, натисніть на подію, щоб побачити її та перевірити, як працює дедуплікація, якщо ви використовуєте як піксель, так і API конверсій. У рекламі OpenAI не повинно відстежуватися однакове замовлення Потік подій.
Примітка: якщо ви бачите очевидні дублікати для однієї й тієї ж події або замовлення, перевірте, чи обидва канали надсилають події для одного й того ж пікселя.
Відстеження кількох магазинів
Якщо у вас є кілька магазинів, ви можете налаштувати кілька джерел даних для кожного представлення магазину в Менеджері реклами OpenAI. Потім призначте унікальні ідентифікатори пікселів для кожного представлення магазину.
Важливо: кілька представлень магазинів можуть використовувати один і той самий API конверсій для відстеження на стороні сервера. Але вам потрібно створити події конверсії для кожного перегляду магазину та призначити їх різним джерелам даних (ідентифікаторам пікселів).
Підтримайте