eCom online mağazaları için Lightspeed dönüşüm takibi

Lightspeed dönüşüm takibi, Lightspeed eCom online mağazanızdaki her ödenmiş siparişi Meta ve TikTok gibi reklam platformlarına bildirmek demektir; böylece doğru reklamlara hakkını verebilir ve kampanyalarınızı optimize edebilirler. Güvenilir yol, her satın alımı sunucuda Lightspeed'in sipariş verisinden göndermek ve teşekkür sayfasına siparişi reklam tıklamasına bağlayan kısa bir kod parçacığı eklemektir.

Bu rehber, hangi Lightspeed ürünü için geçerli olduğunu, siparişlerin ROASaurus'a nasıl ulaştığını, her siparişten nelerin okunduğunu, satın alımların Meta ve TikTok'a nasıl ulaştığını, kurulumu, testi ve bilmeniz gereken sınırları kapsar.

Bu rehber hangi Lightspeed ürününü kapsıyor?

Lightspeed birden fazla e-ticaret ürünü satar, bu yüzden önce kendinizinkini kontrol edin. ROASaurus, yönetim panelinde Settings › Website Settings › Web Extras bulunan online mağaza platformu Lightspeed eCom'a (C-Series) bağlanır. API'si iki kümede çalışır:

Her API adresi ayrıca /nl/ veya /en/ gibi iki harfli bir dil kodu içerir. ROASaurus bunu mağaza dili olarak sorar ve boş bırakırsanız nl kullanır.

Lightspeed ayrıca eCom (E-Series) sunar. Lightspeed, E-Series'e geçişi ayrı bir ürüne yükseltme olarak tanımlar ve şu anda belirli Kuzey Amerikalı satıcılara sunar. ROASaurus Lightspeed bağlayıcısı siparişleri yalnızca C-Series API'si üzerinden okur, bu yüzden E-Series mağazalarını kapsamaz.

Lightspeed satın alımları Meta ve TikTok'ta neden kayboluyor?

Tarayıcıdaki bir piksel, yalnızca alışveriş yapanın tarayıcısı teşekkür sayfasını yüklediğinde ve piksel betiği çalıştığında bir satın alım bildirir. Bu birkaç yaygın durumda başarısız olur:

• Alışveriş yapan yönlendirmeli ödeme yapar, örneğin iDEAL veya PayPal ile, ve teşekkür sayfası yüklenmeden sekmeyi kapatır.
• Bir reklam engelleyici ya da tarayıcı gizlilik ayarı piksel betiğini engeller.
• Ziyaretçi pazarlama çerezlerini reddeder, bu yüzden piksel yüklenmemelidir.
• Sipariş daha sonra, örneğin banka havalesiyle, hiçbir tarayıcı devrede değilken ödenir.
• Safari betiklerle ayarlanan çerezlerin ne kadar süre kalacağını sınırlar, bu yüzden tarayıcı eski bir reklam tıklamasını unutabilir.

Lightspeed siparişleri ROASaurus'a nasıl ulaşır?

Create webhook düğmesine bastığınızda ROASaurus, Lightspeed'de orders grubu ve updated eylemi için JSON biçiminde bir webhook kaydeder. O andan itibaren bir sipariş değiştiğinde Lightspeed ROASaurus'u çağırır.

ROASaurus siparişi neden yeniden okur

Lightspeed bir webhook'a x-signature başlığını yalnızca onu bir uygulama oluşturduysa ekler. Burada olduğu gibi düz bir API anahtarıyla oluşturulan webhook imzasızdır. Bu yüzden webhook adresi mağazanıza özel bir token içerir ve ROASaurus yüke güvenmez. Siparişi ve ürünlerini Lightspeed API'sinden okur ve ödeme durumunu kendisi kontrol eder.

5 dakikalık kontrol

ROASaurus ayrıca her 5 dakikada bir Lightspeed'den son kontrolünden bu yana güncellenen siparişleri 30 dakikalık örtüşmeyle ister ve henüz elinde olmayan ödenmiş siparişleri kaydeder. Bu kontrol güncelleme zamanını kullandığı için verildikten günler sonra ödenen bir sipariş, webhook teslimatı başarısız olsa bile yakalanır. ROASaurus'un zaten sahip olduğu siparişler yok sayılır, bu yüzden webhook ve kontrol asla iki satın alım oluşturmaz.

Lightspeed tarafında bir webhook, 5 saniye içinde 2xx yanıtı almalıdır. Başarısız teslimatlar toplamda en fazla 10 denemeye kadar yeniden denenir ve hata oranı 50 saat boyunca %50'nin üzerinde kalan bir webhook devre dışı bırakılır. 5 dakikalık kontrol, böyle bir boşluk sırasında siparişlerin gelmeye devam etmesini sağlar.

ROASaurus bir Lightspeed siparişinden neleri okur?

Satın alım değeri KDV'yi içerir

Lightspeed'in priceIncl alanı vergi dahil sipariş fiyatıdır ve ROASaurus'un gönderdiği değer budur. Bu yüzden reklam platformlarınız ciroyu KDV dahil bildirir. %21 KDV'de etki şöyledir:

Başabaş ROAS KDV'siz ciroyu kullanır. İkisini karşılaştırmadan önce platform ROAS'ını 1 artı KDV oranınıza bölün.

Bir Lightspeed siparişi reklam tıklamasına nasıl bağlanır?

Bir reklama pay vermek için platformun, sipariş veren ziyaretçinin tıklama tanımlayıcılarına ihtiyacı vardır: Meta tıklama kimliği ve tarayıcı kimliği (fbc, fbp), TikTok tıklama kimliği (ttclid) ve TikTok çerezi (ttp). ROASaurus betiği, bir ziyaretçi bir reklamdan geldiğinde bunları ziyaretçi için saklar. ROASaurus o ziyaretçi kimliğini Lightspeed siparişinden almaz, bu yüzden her siparişi bir ziyaretçiye başka bir yolla bağlar. Üç yöntemi şu sırayla dener:

Kod parçacığı ayrıca sipariş toplamını, para birimini ve müşterinin e-postasını da iletir. ROASaurus bu e-postanın hash'ini ziyaretçide saklar; bu, aynı alışveriş yapanın sonraki siparişini eşleştirmeye yardımcı olur. ROASaurus her satın alımı göndermeden önce kısa süre bekler, böylece teşekkür olayı önce gelebilir ve gönderim sırasında eşleştirmeyi yeniden dener.

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 sayfası, her siparişin nasıl bağlandığını Matched by sütununda gösterir: thank_you, email, ip veya not matched. Eşleşmeyen bir sipariş yine sipariş verisiyle reklam platformlarınıza gider, ama tıklama tanımlayıcıları olmadan; ROASaurus atfı onu doğrudan veya bilinmeyen olarak gösterir.

Lightspeed satın alımlarını Meta ve TikTok'a göndermek

Her ödenmiş sipariş, bağlı her platform için bir sunucu olayı olur: Meta'nın Conversions API'si için bir Purchase ve TikTok'un Events API'si için bir CompletePayment; ikisi de order-ORD01042 olay kimliğini taşır. TikTok artık raporlarında CompletePayment'ı Purchase olarak gösterir. Tarayıcı pikselini de yükleme seçeneğini işaretlediğinizde teşekkür sayfasındaki kod parçacığı aynı olayları tarayıcıda aynı olay kimliğiyle tetikler. Meta ve TikTok bunun üzerine tek bir kopyayı tutar.

Bağladığınızda aynı siparişler Snapchat, Pinterest, Reddit, X, Microsoft Ads, Taboola, LinkedIn ve diğer reklam platformlarına da gider. Google Ads satın alma dönüşümleri yalnızca Shopify ödeme sayfasından gönderilir, bu yüzden ROASaurus onları Lightspeed'den göndermez. Kurulumun Meta tarafı için Meta Conversions API rehberine bakın.

Lightspeed dönüşüm takibi nasıl kurulur

1. Mağazayı ROASaurus'a ekleyin

   Add a store bölümüne gidin, Lightspeed eCom'u seçin ve mağaza adresinizi girin. Connection sekmesi bundan sonra betik etiketinizi ve teşekkür sayfası kod parçacığını gösterir.

2. Betiği her sayfaya ekleyin

   Lightspeed yönetim panelinde Settings › Website Settings › Web Extras › Custom JavaScript yolunu izleyin ve betik etiketini yapıştırın. Lightspeed bu kodu tüm sayfalarda çalıştırır.

3. Teşekkür sayfası kod parçacığını ekleyin

   Aynı sayfada Tracking alanında Status'u açın ve kod parçacığını yapıştırın. Lightspeed onu bir siparişten sonra teşekkür sayfasında çalıştırır.

4. Bir API anahtarı oluşturun

   Settings › Store Settings › Developers › New API key yolunu izleyin. Anahtarı açın, siparişlere okuma erişimini işaretleyin, kaydedin ve gizli anahtarı görmek için Show'u seçin.

5. API'yi bağlayın

   Connection sekmesinde anahtarı, gizli anahtarı, bölgeyi ve mağaza dilini girin. Kaydedin, Test connection düğmesine basın, ardından Create webhook düğmesine basın.

6. Reklam platformlarınızı bağlayın

   Tracking & platforms sayfasında Meta için Connect with Facebook veya Add pixel, TikTok için ise piksel koduyla ve bir Events API erişim token'ıyla Add pixel kullanın. Tarayıcı pikselini de yükleme seçeneğini işaretleyin.

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)

Rıza

Shopify dışında ROASaurus betiği ziyaretçinin tercihini yaygın rıza araçlarından okur: Cookiebot, OneTrust, IAB TCF bildirimleri ve Google consent mode. Başka bir çerez bildirimiyle, ziyaretçi pazarlama çerezlerini kabul ettiğinde tlq('consent', true), reddettiğinde tlq('consent', false) çağırın. Ziyaretçi kabul edene kadar ziyaretçi kimliği ya da tıklama kimlikleri olmaz ve hiçbir tarayıcı pikseli tetiklenmez. Ödenmiş sipariş yine de sunucudan, siparişteki hash'lenmiş müşteri verisi ile siparişin IP adresi ve tarayıcısıyla birlikte gönderilir. Ayrıntılar rıza yardım sayfasında yer alır.

Lightspeed dönüşüm takibi nasıl test edilir?

• Mağazanızı adreste ?roasaurus=connected ile açın. Bir uyarı betiğin çalıştığını doğrular. ?roasaurus=debug tarayıcı konsoluna ne gönderdiğini kaydeder.
• Event log içinde, Collected events altında sayfa görüntülemeleri bir ziyaretçi kimliği göstermelidir.
• Bir sipariş verin ve ödeme durumunun paid olduğundan emin olun. Event log'da Collected events altında, verisinde sipariş numaranızla bir Purchase görünmelidir. Görünmüyorsa Tracking alanında Status'un açık olduğunu kontrol edin.
• Connection sekmesinde Last order received siparişi, Last sync ise son 5 dakikalık kontrolü ve Lightspeed'den gelen hatayı, varsa, gösterir.
• Event log içinde Server deliveries altında, bağlı her platform için sent durumunu ve platformun yanıtını içeren bir satır bulunur.

Olayı Meta'da görmek için Events Manager › Test events içindeki kodu ROASaurus'ta Meta pikselinizin Test event code alanına yapıştırın ve işiniz bitince kaldırın. ROASaurus'taki TikTok piksel ayarlarında da aynı alan vardır.

Sınırlar ve uç durumlar

• Yalnızca C-Series. Lightspeed eCom E-Series mağazaları bu bağlayıcıyı kullanamaz.
• Yalnızca ödenmiş siparişler. Kısmen ödenmiş bir sipariş, ödeme durumu paid olarak değiştiğinde gönderilir.
• Geç ödemeler ve Meta'nın 7 günlük sınırı. Meta, sunucu olaylarını olay zamanından sonra 7 güne kadar kabul eder. ROASaurus siparişin oluşturulma zamanını kullanır, bu yüzden verildikten 7 günden fazla sonra ödenen bir sipariş Meta tarafından reddedilir.
• Ödemeden önce tarayıcı satın alımları. Teşekkür sayfası kod parçacığı sipariş verildiğinde çalışır, bu yüzden tarayıcı pikselleri bir banka havalesi siparişini ödenmeden önce bildirir. Ödeme 48 saatten fazla sonra gelirse Meta ve TikTok tarayıcı ve sunucu kopyalarını birleştiremez.
• İptaller ve iadeler gönderilmez. Bir satın alım gönderildikten sonra reklam platformunda kalır.
• Kod olmadan yalnızca sayfa görüntülemeleri. Ürün görüntülemeleri ve sepete eklemeler yalnızca Shopify'da otomatik algılanır. Lightspeed'de bir geliştirici bunları bir tlq track çağrısıyla gönderebilir.
• API sınırları. Lightspeed, API anahtarı başına 5 dakikada 300, saatte 3,000 ve günde 12,000 isteğe izin verir. Başka bir araç aynı anahtarı kullanıyorsa bu sınırları paylaşırlar. Lightspeed, ikinci bir anahtar için kendileriyle iletişime geçmenizi ister.

Lightspeed entegrasyon sayfası bağlantı bilgilerini tek bir yerde listeler, diğer online mağazalar için yardım sayfası ise Lightspeed'i ROASaurus'un bağlandığı diğer platformlarla karşılaştırır.

Kaynaklar

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'ta

• Lightspeed entegrasyonu
• Yardım: Wix, Lightspeed ve diğer online mağazalar
• Sunucu tarafı takip
• Meta entegrasyonu

Okumaya devam edin