Проследяване на конверсии в Lightspeed за онлайн магазини с eCom

Проследяването на конверсии в Lightspeed означава отчитане на всяка платена поръчка във вашия онлайн магазин в Lightspeed eCom към рекламни платформи като Meta и TikTok, така че те да приписват заслугата на правилните реклами и да оптимизират кампаниите ви. Надеждният начин е да изпращате всяка покупка от данните за поръчките на Lightspeed на сървъра и да добавите кратък фрагмент към страницата за благодарност, който свързва поръчката с кликването върху рекламата.

Това ръководство обхваща към кой продукт на Lightspeed се отнася, как поръчките стигат до ROASaurus, какво се чете от всяка поръчка, как покупките стигат до Meta и TikTok, настройката, тестването и ограниченията, които трябва да знаете.

Кой продукт на Lightspeed обхваща това ръководство?

Lightspeed продава повече от един продукт за онлайн търговия, затова първо проверете своя. ROASaurus се свързва с Lightspeed eCom (C-Series), платформата за онлайн магазини, чийто административен панел има Settings › Website Settings › Web Extras. Нейният API работи на два клъстера:

Всеки адрес на API съдържа и двубуквен код на езика, например /nl/ или /en/. ROASaurus го изисква като език на магазина и използва nl, когато го оставите празен.

Lightspeed предлага и eCom (E-Series). Lightspeed описва преминаването към E-Series като надграждане към отделен продукт, който в момента се предлага на определени търговци от Северна Америка. Конекторът на ROASaurus за Lightspeed чете поръчките само през API на C-Series, така че не обхваща магазини с E-Series.

Защо покупките от Lightspeed липсват в Meta и TikTok?

Пиксел в браузъра отчита покупка само когато браузърът на купувача зареди страницата за благодарност и скриптът на пиксела се изпълни. Това не се получава в няколко често срещани ситуации:

• Купувач плаща чрез пренасочване, например с iDEAL или PayPal, и затваря раздела, преди да се зареди страницата за благодарност.
• Блокер на реклами или настройка за поверителност в браузъра блокира скрипта на пиксела.
• Посетителят отказва маркетинговите бисквитки, така че пикселът не трябва да се зарежда.
• Поръчката се плаща по-късно, например чрез банков превод, когато не участва браузър.
• Safari ограничава колко дълго живеят бисквитките, зададени от скриптове, така че браузърът може да забрави по-старо кликване върху реклама.

Как поръчките от Lightspeed стигат до ROASaurus?

Когато натиснете Create webhook, ROASaurus регистрира webhook в Lightspeed за групата orders и действието updated, във формат JSON. Оттогава Lightspeed извиква ROASaurus, когато една поръчка се промени.

Защо ROASaurus чете поръчката отново

Lightspeed добавя заглавие x-signature към webhook само когато той е създаден от приложение. Webhook, създаден с обикновен API ключ, както е тук, не е подписан. Затова адресът на webhook-а съдържа токен, уникален за вашия магазин, а ROASaurus не се доверява на съдържанието на заявката. Той чете поръчката и продуктите ѝ от API на Lightspeed и сам проверява статуса на плащането.

5-минутната проверка

На всеки 5 минути ROASaurus също пита Lightspeed за поръчки, обновени след последната му проверка, с 30 минути припокриване, и записва платените поръчки, които още не притежава. Тъй като тази проверка използва времето на обновяване, поръчка, платена дни след направянето ѝ, се улавя, дори ако доставката на нейния webhook е неуспешна. Поръчките, които ROASaurus вече има, се игнорират, така че webhook-ът и проверката никога не създават две покупки.

От страна на Lightspeed webhook трябва да получи отговор 2xx в рамките на 5 секунди. Неуспешните доставки се повтарят, до общо 10 опита, а webhook, чието съотношение на грешки остава над 50% в продължение на 50 часа, се деактивира. 5-минутната проверка поддържа потока на поръчките през такава пауза.

Какво чете ROASaurus от поръчка в Lightspeed?

Стойността на покупката включва ДДС

priceIncl на Lightspeed е цената на поръчката с включен данък и това е стойността, която ROASaurus изпраща. Затова вашите рекламни платформи отчитат приходи с включен ДДС. Ето ефекта при 21% ДДС:

ROAS на точката на рентабилност използва приходи без ДДС. Разделете ROAS на платформата на 1 плюс вашата ставка на ДДС, преди да сравнявате двата.

Как поръчка от Lightspeed се свързва с кликването върху рекламата?

За да припише заслугата на реклама, платформата се нуждае от идентификаторите на кликването на посетителя, направил поръчката: click ID и ID на браузъра в Meta (fbc, fbp), click ID в TikTok (ttclid) и бисквитката на TikTok (ttp). Скриптът на ROASaurus ги съхранява за всеки посетител, когато той пристигне от реклама. ROASaurus не получава ID на този посетител от поръчката в Lightspeed, затова свързва всяка поръчка с посетител по друг начин. Опитва три метода, в този ред:

Фрагментът предава още общата сума на поръчката, валутата и имейла на клиента. ROASaurus записва хеш на този имейл при посетителя, което помага да се съпостави следващата поръчка на същия купувач. ROASaurus изчаква кратко, преди да изпрати всяка покупка, така че събитието от страницата за благодарност да може да пристигне първо, и опитва съпоставянето отново в момента на изпращане.

Lightspeed variables used by the ROASaurus snippet (Tracking box)

order.information.number      order id and event id order-<number>
order.information.price_incl  value
order.information.currency    currency
order.customer.email          email, hashed on the visitor

Страницата Orders показва как е свързана всяка поръчка, в колоната Matched by: thank_you, email, ip или не е съпоставена. Несъпоставена поръчка пак отива към вашите рекламни платформи с данните си за поръчката, но без идентификатори на кликвания, а атрибуцията на ROASaurus я показва като директна или неизвестна.

Изпращане на покупките от Lightspeed към Meta и TikTok

Всяка платена поръчка става едно събитие от сървъра за всяка свързана платформа: Purchase за Conversions API на Meta и CompletePayment за Events API на TikTok, и двете с ID на събитието order-ORD01042. TikTok вече показва CompletePayment като Purchase в отчетите си. Когато отметнете опцията да се зарежда и пикселът в браузъра, фрагментът на страницата за благодарност задейства същите събития в браузъра със същото ID на събитието. Meta и TikTok тогава запазват по едно копие.

Същите поръчки отиват към Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn и другите рекламни платформи, когато ги свържете. Конверсиите за покупки в Google Ads се изпращат само от страницата за плащане на Shopify, така че ROASaurus не ги изпраща от Lightspeed. За настройката от страна на Meta вижте ръководството за Meta Conversions API.

Как да настроите проследяване на конверсии в Lightspeed

1. Добавете магазина в ROASaurus

   Отидете в Add a store, изберете Lightspeed eCom и въведете адреса на магазина си. Разделът Connection след това показва вашия таг на скрипта и фрагмента за страницата за благодарност.

2. Добавете скрипта към всяка страница

   В административния панел на Lightspeed отидете в Settings › Website Settings › Web Extras › Custom JavaScript и поставете тага на скрипта. Lightspeed изпълнява този код на всички страници.

3. Добавете фрагмента за страницата за благодарност

   На същата страница, в областта Tracking, включете Status и поставете фрагмента. Lightspeed го изпълнява на страницата Thank You след поръчка.

4. Създайте API ключ

   Отидете в Settings › Store Settings › Developers › New API key. Включете ключа, отметнете достъп за четене до поръчките, запазете и изберете Show, за да видите тайния ключ.

5. Свържете API

   В раздела Connection въведете ключа, тайния ключ, региона и езика на магазина. Запазете, натиснете Test connection, след това Create webhook.

6. Свържете рекламните си платформи

   В Tracking & platforms използвайте Connect with Facebook или Add pixel за Meta и Add pixel за TikTok с кода на пиксела и токен за достъп до Events API. Отметнете опцията да се зарежда и пикселът в браузъра.

API key          (Settings › Store Settings › Developers)
API secret       (select Show next to the key)
Region           eu  →  api.webshopapp.com
                 us  →  api.shoplightspeed.com
Shop language    nl, en, de ...  (the code in your API addresses)

Съгласие

Извън Shopify скриптът на ROASaurus чете избора на посетителя от разпространени инструменти за съгласие: Cookiebot, OneTrust, банери на IAB TCF и Google consent mode. При друг банер за бисквитки извикайте tlq('consent', true), когато посетителят приеме маркетинговите бисквитки, и tlq('consent', false), когато ги откаже. Докато посетителят не приеме, той няма ID на посетител или click ID и не се задействат пиксели в браузъра. Платената поръчка все пак се изпраща от сървъра с хеширани данни за клиента от поръчката и с IP адреса и браузъра на поръчката. Помощната страница за съгласието обяснява подробностите.

Как да тествате проследяването на конверсии в Lightspeed?

• Отворете магазина си с ?roasaurus=connected в адреса. Известие потвърждава, че скриптът работи. ?roasaurus=debug записва в конзолата на браузъра какво изпраща.
• В Event log, под Collected events, прегледите на страници трябва да показват ID на посетител.
• Направете поръчка и се уверете, че статусът на плащането ѝ е paid. Под Collected events Event log трябва да покаже Purchase с номера на вашата поръчка в данните му. Ако липсва, проверете дали Status е включен в областта Tracking.
• В раздела Connection Last order received показва поръчката, а Last sync показва последната 5-минутна проверка, с евентуална грешка от Lightspeed.
• Под Server deliveries в Event log всяка свързана платформа получава ред със статус sent и отговора на платформата.

За да видите събитието в Meta, поставете кода от Events Manager › Test events в полето Test event code на вашия пиксел на Meta в ROASaurus и го премахнете, когато приключите. Настройките на пиксела на TikTok в ROASaurus имат същото поле.

Ограничения и гранични случаи

• Само C-Series. Магазини с Lightspeed eCom E-Series не могат да използват този конектор.
• Само платени поръчки. Частично платена поръчка се изпраща, когато статусът на плащането ѝ се промени на paid.
• Късни плащания и 7-дневното ограничение на Meta. Meta приема събития от сървъра до 7 дни след часа на събитието. ROASaurus използва времето на създаване на поръчката, така че поръчка, платена повече от 7 дни след направянето ѝ, се отхвърля от Meta.
• Покупки в браузъра преди плащането. Фрагментът на страницата за благодарност се изпълнява, когато поръчката е направена, така че пикселите в браузъра отчитат поръчка с банков превод, преди да е платена. Ако плащането дойде повече от 48 часа по-късно, Meta и TikTok не могат да обединят копията от браузъра и от сървъра.
• Анулиранията и възстановяванията на суми не се изпращат. След като една покупка бъде изпратена, тя остава в рекламната платформа.
• Само преглеждания на страници, без код. Прегледите на продукти и добавянията в количката се засичат автоматично само в Shopify. В Lightspeed разработчик може да ги изпраща чрез извикване на tlq track.
• Ограничения на API. Lightspeed позволява 300 заявки на 5 минути, 3,000 на час и 12,000 на ден за един API ключ. Ако друг инструмент използва същия ключ, те споделят тези ограничения. Lightspeed ви моли да се свържете с тях за втори ключ.

Страницата за интеграцията с Lightspeed изброява фактите за връзката на едно място, а помощната страница за други онлайн магазини сравнява Lightspeed с останалите платформи, към които се свързва ROASaurus.

Източници

1. Lightspeed eCom (C-Series) Help Center: Adding a web tracking code
2. Lightspeed eCom (C-Series) Help Center: Creating API keys
3. Lightspeed eCom developers: Webhooks
4. Lightspeed eCom developers: Order
5. Lightspeed eCom developers: Rate limiting

В ROASaurus

• Интеграция с Lightspeed
• Помощ: Wix, Lightspeed и други онлайн магазини
• Проследяване от страна на сървъра
• Интеграция с Meta

Продължете да четете