Web push bildirimleri, müşteri etiketleri, ticaret etkinlikleri ve davranışsal hedefleme için Vendo entegrasyonu aracılığıyla Shopify’ı OneSignal’a bağlayın.
OneSignal, sorunsuz bir Shopify entegrasyonu oluşturmak için Vendo ile ortaklık kurdu. Vendo, OneSignal SDK’sını Shopify mağazanıza tek tıklamayla dağıtır — manuel tema kodu düzenlemesi gerekmez. Müşteri etiketlerini, istemci taraflı gezinme etkinliklerini ve sunucu taraflı ticaret etkinliklerini OneSignal’a senkronize ederek gerçek davranış ve satın alma geçmişinden segmentler oluşturabilir ve push kampanyaları tetikleyebilirsiniz.Vendo’nun belgelerine ulaşmak için bkz. Vendo OneSignal Destination.
Müşteriler sitenize https://your-site.com/ gibi özel bir alan adı üzerinden erişiyorsa https://your-site.myshopify.com/ kullanmayın.
Default Icon URL: Bildirim istemleri ve mesajları için 256x256px kare bir PNG veya JPG resim yükleyin. Ayarlanmazsa zil simgesi kullanılır.
3
Service Worker yolunu yapılandırın
Shopify, site kökünden dosya sunmaya izin vermediği için OneSignal’a Vendo’nun service worker dosyasını nerede sunduğunu belirtmeniz gerekir.OneSignal’da Settings > Push & In-App > Web Settings’e gidin, Advanced Push Settings’e kadar aşağı kaydırın ve şunları yapılandırın:
Ayar
Değer
Service Worker Path
/apps/vendo/
Service Worker Filename
OneSignalSDKWorker.js
Updater Filename
OneSignalSDKWorker.js
Service Worker Registration Scope
/apps/vendo/
Vendo kullanan Shopify mağazaları için service worker yapılandırması.
Vendo, gerekli OneSignalSDKWorker.js dosyasını https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js adresinde otomatik olarak sunar — manuel dosya yüklemesi gerekmez.
Updater Filename ve Service Worker Filename aynı dosyadır. OneSignal v16+, her iki amaç için de tek bir service worker kullanır.
4
Kimlik bilgilerinizi kopyalayın
OneSignal’da Settings > Keys & IDs’e gidin ve App ID’nizi ile REST API Key’inizi kopyalayın. Bunları Vendo’ya gireceksiniz.
Önceki bölümdeki OneSignal App ID’nizi ve REST API Key’inizi girin, ardından Save’e tıklayın.
4
Vendo tema bloğunu etkinleştirin
Vendo tema bloğu, mağazanıza OneSignal SDK’sını yükler. Bu olmadan push istemi görünmez ve istemci taraflı izleme çalışmaz.
Shopify yönetici panelinizde Online Store > Themes > Customize’a gidin.
App embeds’e tıklayın (sol kenar çubuğundaki yapboz parçası simgesi).
Vendo’yu açın.
Save’e tıklayın.
Tema bloğu; SDK başlatma, service worker kaydı, push istemi gösterimi, kullanıcı tanımlama (push aboneliği, giriş, bülten kaydı) ve etiket senkronizasyonunu yönetir.
5
Senkronize edilecek etkinlikleri seçin
Vendo uygulamasında OneSignal > Events altında, OneSignal’a göndermek istediğiniz istemci taraflı ve sunucu taraflı etkinlikleri etkinleştirin. Tam etkinlik listesi için aşağıdaki İzleme bölümüne bakın.
6
Geçmiş veri senkronizasyonu (isteğe bağlı)
Vendo, mevcut müşterileri ve son sipariş geçmişini OneSignal’a geriye dönük olarak doldurabilir. Bu, kimlik bilgilerinizi kaydettikten sonra arka planda otomatik olarak gerçekleşir.
Vendo'daki geçmiş veri senkronizasyonu seçenekleri.
Vendo yalnızca tanımlanmış kullanıcı yaklaşımını kullanır — anonim ziyaretçiler OneSignal’da izlenmez. Etkinliklerin gönderilebilmesi için kullanıcıların dört yöntemden biriyle tanımlanması gerekir. Bu, yinelenen kullanıcıları önler ve temiz, eyleme geçirilebilir veriler sağlar.
Yöntem
Nasıl çalışır
Kullanılan tanımlayıcı
Web push aboneliği
Ziyaretçi push isteminde “İzin Ver”e tıklar. OneSignal otomatik olarak bir kullanıcı oluşturur ve Vendo OneSignal ID’yi yakalar.
OneSignal ID
Bülten kaydı
Ziyaretçi bülten veya e-posta formu gönderir. Vendo e-postayı yakalar ve OneSignal.login(email) çağırır.
Email
Müşteri girişi
Müşteri Shopify hesabına giriş yapar. Vendo bunu algılar ve yapılandırılmış tanımlayıcıyla OneSignal.login() çağırır.
Shopify Customer ID veya Email
Ödeme tamamlandı
Müşteri satın alma işlemini tamamlar. Vendo tanımlayıcıyı depolar ve OneSignal.login() çağırır.
Shopify Customer ID veya Email
Mobil uygulamanız veya üçüncü taraf bağlantılarınız varsa, kullanıcı profillerinin platformlar arasında tutarlı kalması için diğer araçlarınızla eşleşen tanımlayıcıyı (Shopify Customer ID veya Email) seçin. Bunu Vendo uygulamasında Settings > Customer Identifier altında yapılandırın.
Bir push abonesi (OneSignal ID ile tanımlanan) daha sonra giriş yapar veya satın alma işlemini tamamlarsa, Vendo Shopify Customer ID veya e-postasıyla OneSignal.login() çağırır. OneSignal, push aboneliğini tanımlanan kullanıcıya bağlar — yinelenen kullanıcı oluşturulmaz. Tüm geçmiş push abonelikleri korunur ve sunucu taraflı etkinlikler (siparişler, karşılamalar) doğru kullanıcı profiline ulaşır.
Vendo, segmentasyon için müşteri özelliklerini OneSignal’daki etiketler olarak senkronize eder. Tüm değerler dize olarak saklanır (OneSignal’ın yerel formatı).
Vendo, Shopify Web Pixel aracılığıyla mağazanızdaki istemci taraflı özel etkinlikleri izler ve OneSignal’a gönderir. Bu etkinlikler yalnızca bir kullanıcı tanımlandıktan sonra gönderilir.
Etkinlik
Açıklama
page_viewed
Müşteri bir sayfayı ziyaret eder (mağaza, ödeme veya sipariş durumu)
Shopify ticaret etkinlikleri, Vendo ardışık düzeni aracılığıyla dışa aktarılır ve OneSignal’a iletilir. Bunlar her zaman Shopify Customer ID’yi external_id olarak kullanır.
abandoned_checkouts etkinliğiyle tetiklenen bir Journey oluşturun. Terk ettikten 1 saat sonra checkout_url özelliğini kullanarak kurtarma bağlantısı içeren bir push bildirimi gönderin.
fulfilled_orders ve delivered_orders için Journey’ler oluşturarak siparişler sevk edildiğinde ve ulaştığında takip bilgileriyle anında push bildirimleri gönderin.
OneSignal, aşağıdaki Vendo veri kaynaklarıyla çalışır:
Kaynak
Etkinlikler
Kullanıcı etiketleri
Kitleler
Shopify
Evet
Evet
Evet
Stripe
Evet
Evet
Evet
Mixpanel
—
—
Evet
Segment
—
—
Evet
Amplitude
—
—
Evet
Etkinlikler ve kullanıcı etiketleri, veri kaynağı olarak Shopify veya Stripe gerektirir. Kitle segmentleri, BigQuery veri setinizdeki herhangi bir kaynak veriden oluşturulabilir.
Tarayıcınızda https://yourstore.myshopify.com/apps/vendo/OneSignalSDKWorker.js adresini ziyaret edin. JavaScript kodu görmelisiniz. 404 alırsanız Vendo uygulamasının yüklü olduğunu doğrulayın.Ayrıca tarayıcı DevTools’u açabilir (F12), Application > Service Workers’a gidebilir ve OneSignalSDKWorker.js’nin /apps/vendo/ kapsamıyla kayıtlı olduğunu doğrulayabilirsiniz.
2
Push istemini test edin
Mağazanızı gizli/özel bir pencerede açın. OneSignal bildirim izni istemini görmelisiniz. Abone olmak için İzin Ver’e tıklayın.
3
Test bildirimi gönderin
OneSignal panosunda Messages > Push > New Message’a gidin. Abonecinize bir test bildirimi gönderin ve göründüğünü doğrulayın.
4
OneSignal'daki kullanıcı verilerini doğrulayın
Audience > Subscriptions’a gidin ve test aboneliğinizin göründüğünü doğrulayın. Tanımlanmış kullanıcılar için kullanıcı etiketlerinin (e-posta, ad, vb.) senkronize edildiğini kontrol edin.
5
Test etkinliği tetikleyin
Mağazanızda bir ürüne göz atın veya test ödemesi tamamlayın. Etkinliğin OneSignal panosundaki kullanıcı etkinliğinde göründüğünü doğrulayın.
Service Worker /apps/vendo/OneSignalSDKWorker.js konumunda olmalıdır. Kök yolda (/OneSignalSDKWorker.js) 404 hatası görürseniz, service worker yolu OneSignal’da yapılandırılmamıştır — service worker yapılandırma adımını takip edin. 404 /apps/vendo/ yolundaysa Vendo uygulamasının yüklü ve tema bloğunun etkin olduğunu doğrulayın.
App embeds’te Vendo tema bloğunun etkin olduğunu kontrol edin. Tarayıcınızın bildirimlere izin verdiğini doğrulayın (adres çubuğundaki kilit simgesine tıklayın). İstem önceden reddedilmiş olabileceği için gizli/özel pencerede deneyin.
Etiketler yalnızca tanımlanmış kullanıcılar için senkronize edilir — anonim ziyaretçiler izlenmez. Kullanıcının push aboneliği, giriş, bülten kaydı veya ödeme yoluyla tanımlandığından emin olun. İlk etiket senkronizasyonları birkaç saat sürebilir.
Etkinliklerin Vendo uygulamasında OneSignal > Events altında etkinleştirildiğini doğrulayın. İstemci taraflı etkinlikler Shopify Web Pixel’in etkin olmasını ve kullanıcının tanımlanmış olmasını gerektirir. Sunucu taraflı etkinlikler REST API Key’in yapılandırılmış olmasını gerektirir.
Bildirimler “Teslim Edildi” gösteriyor ama görünmüyor
Entegrasyon çalışıyor — sorun tarayıcı veya işletim sistemi bildirim ayarlarınızdadır. Tarayıcınız için işletim sistemi bildirim ayarlarınızı kontrol edin, Rahatsız Etme / Odaklanma modunun kapalı olduğundan emin olun ve tarayıcı düzeyindeki bildirim izinlerini doğrulayın.
Kurulumdan sonra müşteri tanımlayıcısını değiştirebilir miyim?
Evet. Vendo uygulamasında Settings > Customer Identifier altındaki ayarı güncelleyin. Mevcut kullanıcılar önceki yöntemle zaten tanımlanmışsa tanımlayıcıyı değiştirmek ayrı kullanıcı profilleri oluşturabilir.
Vendo entegrasyonu mobil uygulamaları destekliyor mu?
Vendo entegrasyonu Shopify mağazaları ve web push’a odaklanır. Mobil uygulamanız da varsa, kullanıcı profillerinin tutarlı kalması için Vendo’da seçtiğiniz tanımlayıcının mobil uygulamanızda kullandığınızla eşleştiğinden emin olun.
Tanımlanmamış ziyaretçilerin etkinlikleri OneSignal’a gönderilmez. Ziyaretçi kendini tanımladığında (push aboneliği, giriş, bülten kaydı veya ödeme tamamlama), Vendo etkinlik göndermeye başlar. Bu yalnızca tanımlanmış kullanıcı yaklaşımı, yinelenen kullanıcıları önler ve temiz veriler sağlar.
Vendo neden yalnızca tanımlanmış kullanıcı yaklaşımını kullanıyor?
Önceki sürümler, tanımlayıcı olarak Shopify’ın oturum çerezini kullanarak anonim ziyaretçileri izliyordu. Bu durum, hiçbir zaman düzgün birleştirilemeyen yinelenen OneSignal kullanıcıları oluşturarak şişirilmiş kullanıcı sayılarına ve parçalanmış verilere yol açıyordu. Yalnızca tanımlanmış kullanıcı yaklaşımı, her OneSignal kullanıcısının gerçek ve eyleme geçirilebilir olmasını sağlar.
