CCV Shop dönüşüm takibi: kurulum rehberi

CCV Shop dönüşüm takibi, CCV Shop online mağazanızdaki her ödenmiş siparişi Meta ve TikTok gibi reklam platformlarına bildirmek demektir; böylece doğru reklamlara hakkını verirler ve gerçek satışlara göre optimize ederler. En eksiksiz yol, her satın alımı sunucuda CCV'nin sipariş verisinden göndermek ve sipariş başarı sayfasına siparişi reklam tıklamasına bağlayan kısa bir kod parçacığı eklemektir.

CCV Shop, 17,000 online mağaza işlettiğini söyleyen Hollandalı CCV şirketinin barındırılan bir online mağaza platformudur. Bu rehber, ROASaurus'un ona nasıl bağlandığını, siparişlerin reklam tıklamalarına nasıl bağlandığını, Meta ve TikTok'a nelerin gittiğini, kurulumu, testi ve geç ödemelerin nasıl işlediğini anlatır. Genel fikir için sunucu tarafı takip nedir yazısını okuyun.

ROASaurus CCV Shop'a nasıl bağlanır?

ROASaurus, CCV Shop'un üç bölümünü kullanır; hepsi CCV'nin API belgelerinde anlatılmıştır:

Tarayıcı pikselleri CCV Shop satın alımlarını neden kaçırır?

Tarayıcı pikseli, yalnızca alışveriş yapanın tarayıcısı sipariş başarı sayfasını yüklediğinde ve piksel betiği çalıştığında bir satın alım raporlar. Birkaç yaygın durum bunu bozar:

• Alışveriş yapan, örneğin iDEAL ile, yönlendirmeli ödeme yapar ve başarı 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ş, hiçbir tarayıcının söz konusu olmadığı bir anda, banka havalesiyle ya da teslimatta sonradan ödenir.

Her durumda CCV Shop siparişi yine de ödendi olarak işaretler. ROASaurus o siparişi sunucudan gönderir, böylece tarayıcıda ne olursa olsun satın alım raporlanır. Başarı sayfasındaki kod parçacığının işi farklıdır: ROASaurus'a siparişin hangi ziyaretçiye, dolayısıyla hangi reklam tıklamasına ait olduğunu söyler.

Sipariş ödendi webhook'u ve 5 dakikalık kontrol

Create webhook ne yapar

Create webhook düğmesine bastığınızda ROASaurus, CCV'nin bir siparişin ödeme özelliği değiştiğinde tetiklediği orders.updated.ispaid olayı için bir CCV webhook'u kaydeder. Adres, ROASaurus'taki mağazanızın webhook URL'sidir ve mağaza anahtarınızı ve özel bir token'ı içerir. CCV, bir webhook'a mağazayı tanımlayan hiçbir şey eklemez ve belgeleri adrese bir tanımlayıcı koymanızı önerir. Bunu mağaza anahtarı yapar.

CCV her webhook'a 32 karakterlik kendi gizli anahtarını verir. CCV o anahtarı döndürdüğünde ROASaurus onu kaydeder ve bundan sonra her teslimat geçerli bir x-hash başlığı taşımalıdır. Her teslimat ayrıca mağazanızın token'ını da taşımalıdır. ROASaurus bir teslimat aldığında ödenmemiş siparişleri yok sayar, tam siparişi ve sipariş satırlarını API'den okur ve siparişi yalnızca CCV ödendi dediğinde gönderir.

İmzalı API çağrıları

CCV her API çağrısının imzalanmasını ister. ROASaurus üç başlık gönderir: genel anahtarınızla x-public, geçerli zamanla x-date ve x-hash. CCV, kendi sunucu zamanından 5 dakikadan fazla farklı olan bir zaman damgasını reddeder. Gizli anahtarınızın kendisi hiçbir zaman gönderilmez.

API call (ROASaurus → CCV)
x-hash = HMAC-SHA512( public_key|METHOD|uri|body|timestamp , secret_key )

Webhook (CCV → ROASaurus)
x-hash = HMAC-SHA512( address|payload , webhook_key )

5 dakikalık kontrol

ROASaurus ayrıca her 5 dakikada bir, 30 dakikalık örtüşmeyle, son kontrolünden bu yana oluşturulmuş ödenmiş siparişleri CCV'den ister ve henüz sahip olmadıklarını kaydeder. CCV siparişleri yalnızca oluşturulma tarihine göre filtreler. Bu yüzden kontrol, verildikten kısa süre sonra ödenen siparişleri bulur; günler sonra ödenen bir sipariş ROASaurus'a yalnızca webhook ile ulaşır.

CCV, 200, 201, 202 ya da 204 yanıtını başarı sayar. 307, 408, 503 ya da 504 yanıtından sonra bir teslimatı açık tutar ve sonraki oluşumda yeniden dener; diğer her yanıtı başarısız olarak işaretler. Bağlantı için 2 saniye, yanıt için 5 saniye bekler.

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

Bir reklama hakkını vermek için platformun, sipariş veren ziyaretçinin tıklama tanımlayıcılarına ihtiyacı vardır; örneğin Meta tıklama kimliği (fbc) ve TikTok tıklama kimliği (ttclid). ROASaurus betiği, bir ziyaretçi reklamdan indiğinde bunları o ziyaretçi için saklar. ROASaurus bu ziyaretçi kimliğini CCV siparişinden almaz, bu yüzden siparişleri ziyaretçilere başka yollarla bağlar:

ROASaurus her satın alımı göndermeden önce kısa bir süre bekler; böylece başarı sayfası olayı önce gelebilir ve gönderim anında eşleştirmeyi yeniden dener. Orders sayfası sonucu sipariş başına Matched by sütununda gösterir: thank_you, email ya da not matched.

Eşleşmeyen bir sipariş, siparişteki hash'lenmiş müşteri verileriyle yine de reklam platformlarınıza gider. Tıklama tanımlayıcıları yoktur ve CCV siparişleri IP adresi ya da tarayıcı taşımadığı için onlar da yoktur. Bu, Meta'nın bir kişiyle eşleştirebileceği olayların payını düşürür; Event Match Quality yazısı Meta'nın bunu nasıl puanladığını anlatır. ROASaurus atfında eşleşmeyen bir sipariş doğrudan ya da bilinmeyen olarak görünür.

Bir CCV siparişinden Meta ve TikTok'a neler gider?

Meta, Conversions API'si üzerinden bir Purchase, TikTok ise Events API'si üzerinden bir CompletePayment alır; ikisi de order-58213 olay kimliğiyle. TikTok artık CompletePayment'ı raporlarında Purchase olarak gösteriyor. Tarayıcı pikselini de yükleme seçeneğini işaretlediğinizde başarı sayfası kod parçacığı aynı olayları tarayıcıda aynı olay kimliğiyle tetikler ve Meta ile TikTok tek bir kopya tutar. Siz 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 bunları CCV Shop'tan göndermez.

CCV Shop dönüşüm takibi nasıl kurulur

1. Mağazayı ROASaurus'a ekleyin

   Add a store sayfasına gidin, CCV Shop'u seçin ve mağaza adresinizi girin. Connection sekmesi bundan sonra betik etiketinizi ve başarı sayfası kod parçacığını gösterir.

2. API anahtarlarınızı bulun

   CCV Shop'ta My webshop › Settings › General › API settings yoluna gidin ve New API key'e tıklayın. Görmüyorsanız önce CCV App Store'dan API uygulamasını yükleyin.

3. Betiği her sayfaya ekleyin

   Betik etiketini mağazanızın Header HTML alanına yapıştırın. CCV'nin yardım merkezi bunu sayfanın en altında Mijn webshop › Instellingen › Lay-out › Layout altına yerleştirir. Başlıktaki bir uygulama kod bloğu da işe yarar.

4. Kod parçacığını başarı sayfasına ekleyin

   Mijn webshop › Instellingen › Algemeen › Teksten yoluna gidin, sipariş verildikten sonra gösterilen metni açın, Source'a geçin ve kod parçacığını oraya yapıştırın. CCV Shop de bunu sipariş başarı sayfasında çalıştırır.

5. API'yi bağlayın

   Connection sekmesinde genel anahtarı ve gizli anahtarı girin. Shop URL'sini yalnızca API'niz mağazanızdan farklı bir alan adında çalışıyorsa doldurun. Kaydedin, Test connection'a, ardından Create webhook'a basın.

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

   Tracking & platforms sayfasında, Meta için Connect with Facebook ya da Add pixel, TikTok için Add pixel seçeneğini kullanın. Tarayıcı pikselini de yükleme seçeneğini işaretleyin.

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 verisiyle gönderilir. Ayrıntılar rıza yardım sayfasında yer alır.

CCV Shop 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 ödeyin ya da ödendi olarak işaretleyin. Collected events altında Event log, verisinde CCV sipariş kimliği olan bir Purchase göstermelidir. Eksikse başarı sayfası kod parçacığı çalışmamıştır.
• Connection sekmesinde Last order received siparişi, Last sync ise CCV'den gelen hatalarla birlikte son 5 dakikalık kontrolü 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'taki Meta pikselinizin Test event code alanına yapıştırın ve işiniz bitince kaldırın.

Geç ödemeler ve diğer sınırlar

Banka havaleleri ve kapıda ödeme, sipariş verildikten sonra ödenir. Örnek bir banka havalesi siparişine, verildiği günden itibaren olanlar şöyle:

• Kapıda ödeme. ROASaurus bu siparişleri CCV ödendi olarak işaretlediğinde, genellikle teslimattan sonra gönderir. Bu tür siparişleri ne zaman sayacağınız için kapıda ödeme takibi yazısına bakın.
• Ödemeden önce tarayıcı satın alımları. Başarı sayfası kod parçacığı sipariş verildiğinde çalışır, bu yüzden tarayıcı pikselleri bir banka havalesi siparişini ödenmeden önce raporlar. Ödeme 48 saatten fazla sonra gelirse Meta ve TikTok tarayıcı ve sunucu kopyalarını birleştiremez.
• IP yedeği yok. Başarı sayfası kod parçacığını ekleyin ve mümkün olduğunda sitenizde e-postaları daha erken toplayın.
• İ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 olarak algılanır. CCV Shop'ta bir yazılımcı bunları tlq track çağrısıyla gönderebilir.

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

Kaynaklar

1. CCV Shop: API Documentatie
2. CCV: Webshop API
3. Meta for Developers: Server Event Parameters
4. Meta for Developers: Handling Duplicate Pixel and Conversions API Events
5. TikTok Ads Manager: About Event Deduplication

ROASaurus'ta

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

Okumaya devam edin