Shopify ürünlerinizi ve satın almalarınızı gösterin.

Social Stream Ninja'da Shopify

Herkese açık ürünleri görseller, fiyatlar, okunabilir bağlantılar ve QR kodlarıyla tanıtın. İmzalı ödenmiş sipariş bildirimlerini şu şekilde alın: purchase uyarıları olarak etkinlik akışında, çoklu uyarılarda ve Etkinlik Akışı'nda. Ürün tanıtımı ödeme uyarılarından bağımsız çalışır.

Satın almaları bağlayın · Ürünleri içe aktar · OBS katmanları · Güvenli test edin · Sınırlar ve sorun giderme

Kullanılabilirlik: otomatik uyarılar Shopify alıcısının SSN API'sinde dağıtılıp etkinleştirilmesini gerektirir. Kullanılamıyorsa Kurulumu kaydet hata bildirir ve Shopify'ı etkinleştirmez. Herkese açık ürün içe aktarma ve elle tanıtım bağımsız çalışır. Bu kılavuz entegrasyon kodunu açıklar; canlı hizmetin doğrulandığını söylemeden önce gerçek bir satıcı testi hâlâ gereklidir.

Ödenmiş satın almaları bağlayın

1. Shopify'da şunu açın: Ayarlar → Bildirimler → Webhook'lar. Elle oluşturulan webhook'lar için gösterilen imzalama sırrını bulun. Bu, Storefront belirtecinden farklıdır.
2. SSN'de şunu açın: Para Kazanma → Shopify satın almaları → Kurulum. Kalıcı şu alan adınızı girin: your-store.myshopify.com alan adını ve webhook imzalama sırrını. Shopify satın almalarını etkinleştirin, ardından şuna tıklayın: Kurulumu kaydet.
3. Tıklayın: Alıcı URL'sini kopyala. Shopify'da şu etkinlikle bir webhook oluşturun: Sipariş ödemesi, biçim JSONve bu alıcı URL'si. Desteklenen kararlı bir webhook API sürümü seçin; bu entegrasyon 2026-07 sipariş sözleşmesine göre geliştirildi.
4. Shopify webhook'unu kaydedin. Satın almaları işlemek için SSN'yi açık tutun. Alıcı, sipariş verilerini kabul etmeden önce ham gövde HMAC'sini ve eşleşen mağazayı doğrular.

İmzalama sırrı SSN alıcısında şifrelenir ve kaydettikten sonra giriş alanından temizlenir. Ayrı bir özel okuyucu anahtarı bu cihazda kalır. Hiçbiri OBS bağlantılarına veya izleyici QR kodlarına dahil edilmez. Shopify kendi özel alıcısını kullanır; eski uzaktan API kontrolü anahtarı gerekmez.

Oluşturulan URL, yapılandırmanın kaydedildiği anlamına gelir; Shopify'ın bir şey teslim ettiğini göstermez. Durum; beklemeyi, doğrulanmış testi, atlanan etkinliği ve alınan satın almayı ayırt eder. Mağaza değiştirmek için önce Bağlantıyı kes gerekir. Shopify'ı kapatmak yerel işlemeyi duraklatır; Bağlantıyı kes alıcısını ve kuyruktaki etkinliklerini siler. Bağlantıyı keserken ilgili Shopify webhook'unu kaldırın.

Shopify: elle webhook oluşturma · Shopify: teslimatları doğrulama

Herkese açık ürünü içe aktarın

1. Şunu girin: myshopify.com alan adınızı Shopify kurulumunda. Ürün içe aktarmak için satın alma uyarılarını etkinleştirmeniz veya imzalama sırrı girmeniz gerekmez.
2. Şunu genişletin: Ürün içe aktar, herkese açık bir ürün URL'si yapıştırın ve şuna tıklayın: Ürün bilgilerini yükle.
3. Belirteçsiz erişim ürünü göstermiyorsa şunu sağlayın: herkese açık Storefront belirteci. Shopify'ın Headless kanalı bir tane oluşturabilir. Ürünü o vitrine ve Online Store'a yayımlayın. Admin API belirteci veya özel Storefront belirteci yapıştırmayın.
4. SSN mevcut şu düzenleyiciyi açar: Ürünler ve destek bağlantıları Shopify'ın döndürdüğü başlık, görsel, fiyat ve standart herkese açık bağlantıyla düzenleyiciyi. Bunları gözden geçirin, şuna tıklayın: Ürün veya bağlantı ekle, kataloğu etkinleştirin ve Kurulumu kaydet.

İçe aktarma, Storefront API ile her seferinde tek ürün okur. Belirteç isteğe bağlıdır, yalnızca o istek için kullanılır ve ardından temizlenir. Shopify'ın standart Online Store URL'si, Shopify döndürdüğünde özel alan adı da dahil, herkese açık bağlantı olur. Kullanılamayan ürünler ve herkese açık Online Store bağlantısı olmayan ürünler dışarıda bırakılır.

Fiyat yalnızca ürünün en düşük ve en yüksek varyant fiyatları eşleştiğinde doldurulur. Aksi halde boş kalır; yalnızca teklifi doğru biçimde tanımlıyorsa kendiniz belirli bir fiyat seçin. İçe aktarılan bilgiler anlık görüntüdür, sürekli stok veya fiyat eşitlemesi değildir. Mağazanız değiştiğinde gözden geçirin. Her zaman bunun yerine elle ürün girişi yapabilirsiniz.

Shopify Storefront kimlik doğrulaması · Ürün sorgusu · Headless kullanarak herkese açık belirteç oluşturma

Mevcut katmanları kullanın

Şu bölümde: Şunun için katman bağlantısı:, şunu seçin: Ürünler ve destek bağlantıları. Kullanın: Yalnızca ürün vitrini görseller, fiyatlar ve QR kodları için, Yalnızca destek kartı küçük, kalıcı veya periyodik mağaza bağlantısı için ya da Yalnızca etkinlik uyarıları satın almalar için. İstediğiniz her OBS bağlantısını 800 × 600 ile başlayarak ayrı bir Tarayıcı Kaynağı'na kopyalayın.

İsteğe bağlı uyarı kaynak filtresini şu değere ayarlayın: shopify genel para kazanma katmanında yalnızca Shopify etkinliğini göstermek için. Bu genel görünüm için Ürünler ve destek bağlantıları'nı etkinleştirin. Mevcut çoklu uyarılar ve etkinlik akışı Shopify satın almalarını ürün kataloğundan bağımsız alır.

Ürün kartları herkese açık ürün sayfalarına bağlanır. Şunu kullanın: Herkese açık bağlantıyı kopyala tıklanabilir adresi sohbette paylaşmak için ve QR kodunu son yayın boyutunuzda bir telefondan test edin. Satın alma uyarısı, ilgisiz dönüşümlü üründen QR kodu veya görsel almaz. Sipariş webhook'ları güvenilir ürün görseli URL'leri sağlamadığı için satın alma uyarıları metin kullanır; içe aktarılan tanıtım kartları görsel gösterebilir.

Etkinlik Akışı için şu Etkinlik Türü'nü seçin: purchase ve kaynak/türü şu değere filtreleyin: shopify. Şunu karşılaştırın: meta.commerce.orderTotal sipariş değeri kuralları için ve şunu kontrol edin: meta.commerce.currency tutarları karşılaştırmadan önce. Bunlar satın almadır: şu etkinlik hasDonation veya donoValue yayımlanmaz ve bağış hedefleri artmaz. Hediye etiketli tanıtım kartı, sipariş etkinliklerinin sınıflandırılmasını değiştirmez. Başka birine gönderim yapmak, içerik üreticisine hediye verildiğinin kanıtı değildir.

Güvenli önizleme ve test

Örneği önizle oturum bağlantısı olmadan yalıtılmış örnek katman açar. Etkinlik Akışı'nı asla tetiklemez, toplamları değiştirmez veya ödemeyi doğrulamaz.

Açıkça şu şekilde işaretlenen Shopify siparişleri: test: true alındı olarak onaylanır ve satın alma uyarısı veya eylemi olmadan alıcı durumunda test olarak gösterilir. Eksik test bayrakları, ödenmemiş/kısmen ödenmiş siparişler, iptal edilmiş siparişler, sıfır toplamlar ve eski veya geçersiz zaman damgaları da atlanır. Uçtan uca test için geliştirme mağazası kullanın. Güvenilir test bayrağı olmayan bir yönetici örneği etkin ödül iş akışına gönderilmemelidir; güvenli görünüm kontrolü SSN önizlemesidir.

Mağaza olmadan neleri kontrol ettik?

Yalıtılmış testler, gerçek SSApp çalışma zamanı üzerinden imzalı Unicode JSON ile gerçek HTTP teslimatını, değiştirilmiş imzaları, yinelenen teslimatları, test siparişi yalıtımını, para birimi hassasiyetini, aşırı büyük istekleri, özel müşteri verilerinin kaldırılmasını ve çevrimdışı kurtarmayı kapsar. Bu kontroller sipariş vermez veya satıcı hesabı gerektirmez.

Üretim Shopify alıcısı, gerçek mağaza teslimatı testi beklenirken devre dışı kalır. Elle ürün tanıtımı bağımsız olarak kullanılabilir. Shopify CLI örnek webhook'ları veri yükü işlemeyi test etmeye yardımcı olabilir, ancak abonelikleri veya yeniden denemeleri doğrulamaz ve yine uygulama kimlik bilgilerini gerektirir. Şuna bakın: Shopify CLI webhook test sınırları.

Teslimat sınırları ve sorun giderme

• Alıcı kullanılamıyor: SSN API operatörü Shopify alıcısını dağıtmalı ve etkinleştirmelidir. Şuna bakın: sunucu kurulumu. Eski imzasız oturum webhook URL'sini bunun yerine kullanmayın.
• Etkinlik bekleniyor: Sipariş ödemesi'ni, JSON'u, tam alıcı URL'sini, eşleşen kalıcı mağaza alan adını ve o webhook'un imzalama sırrını doğrulayın. Özel uygulamanın webhook'u, elle Bildirimler sırrını değil o uygulamanın imzalama sırrını kullanır.
• İmzalı etkinlik atlandı: bu entegrasyon pozitif tutarlı, tamamen ödenmiş bir sipariş gerektirir, test: false ve imzalı bir gövde updated_at son yedi gün içinde (geleceğe yönelik saat farkı için beş dakika toleransla). Sipariş oluşturulmasından, yerine getirilmesinden veya stoktan ödeme sonucu çıkarmaz.
• SSN çevrimdışıydı: kabul edilen etkinlikler yedi güne kadar kuyrukta tutulur. Devam etmek için SSN'yi yeniden başlatın. Durum ve bekleyen işler alıcı yeniden başlatıldığında korunur. Hizmetin depolaması sınırlıdır ve işi kalıcı biçimde kuyruğa alamadığında Shopify'dan yeniden denemesini ister.
• Yinelenenler varsa: Shopify teslimat kimlikleri farklı olsa bile alıcı mağaza/siparişe göre tekilleştirir. Tekilleştirme kayıtları yedi gün tutulur. SSN, alındı onayından önce işlenen kimlikleri kalıcı kaydeder. Harici eylem ile bu kayıt arasındaki bir çökme eylemi yine tekrarlayabilir; önemli sonuçları olan otomasyonlar için kendi idempotans korumanızı kullanın.
• Alıcı adı eksik: bilinçli bir tercihtir. SSN müşteri adlarını, e-postayı, adresleri, sipariş notlarını, satır öğesi özel özelliklerini, ödeme URL'lerini ve ham sipariş kimliklerini dışarıda bırakır. Herkese açık ürün başlıkları düz metin olarak kalır.
• İadeler veya sipariş değişiklikleri: bu bir canlı uyarı akışıdır, muhasebe veya sipariş yerine getirme sistemi değildir. İadeler, iptaller ve düzenlenen toplamlar önceki uyarıları geri almaz. Sipariş geçmişi mutabakatı veya otomatik ürün kaldırma dahil değildir.

Bkz. Shopify etkinlik sözleşmesi ve ortak ürün ve QR kılavuzu.