Özel Mağaza Sayfası Tetikleyicileri

Yerleşik mağaza ön yüzü tetikleyicileri, Shopify’un bildirdiği olayları kapsar. Özel Mağaza Ön Yüzü Tetikleyicisi ise mağaza ön yüzünüzde gerçekleşen diğer tüm olayları kapsar: Temanızdan tek satırlık bir JavaScript koduyla bir olay yayınladığınızda, bu olay Shopify Flow’da kullanabileceğiniz bir tetikleyici haline gelir.

En net örnek, alışveriş sepeti çekmecesidir. Shopify’ın “cart view” olayı /cart sayfasında tetiklenir; ancak çoğu modern tema bu sayfaya yönlendirme yapmaz - bunun yerine bir çekmeceyi kaydırarak açar. Shopify bu konuda herhangi bir bildirimde bulunmadığından, hiçbir uygulama bunu algılayamaz. Çekmece açıldığında kendi olayınızı yayınlamak, bu boşluğu doldurur.

Mağazaların bunu kullandığı diğer amaçlar:

• İstek listesine ekleme ya da bana haber ver seçeneğine tıklama; Shopify, bunların hiçbirini raporlamıyor.
• Bir ürünle ilgili bilgi vermek amacıyla bir beden kılavuzu veya iade politikası sayfası açıldı.
• Seçicide gerçekleşen bir varyant değişikliği; bu, yeni bir sayfa görüntüleme değildir (bkz. Mağaza vitrini tetikleyicileri).
• Temanızın veya bir üçüncü taraf uygulamanın zaten bildiği, ancak Shopify’ın bilmediği her şey.

Nasıl çalışır?

1. Uygulamada tetikleyiciyi oluşturun ve ona bir olay adı verin; örneğin cart_drawer_opened. Her Storefront tetikleyicisi gibi, bu tetikleyicinin de Storefront Davranış Erişimi'ne ihtiyacı vardır; bu erişim, İzinler sayfasında bir kez verilir.
2. Uygulamanın size gösterdiği tek satırlık kod parçasını kopyalayın ve temanızda ilgili bölümün bulunduğu yere yapıştırın. Neyi nereye yapıştırmanız gerektiğinden emin değilseniz, AI ile tetikleyici kodu oluştur komutu, basit bir İngilizce açıklamadan temanız için gerekli kod parçasını oluşturur.
3. Gönderilecek içeriği filtrelemek veya yeniden biçimlendirmek istiyorsanız bir dönüştürme kodu yazın; her şeyi olduğu gibi iletmek istiyorsanız bu alanı boş bırakın.
4. Özelliği etkinleştirin, ardından Shopify Flow’da “Özel Mağaza Sayfası Tetikleyicisi”ni ekleyin ve olay adına göre dallandırın.

Bu kod parçacığı, tema tarafındaki entegrasyonun tamamını oluşturmaktadır:

Shopify.analytics.publish("cart_drawer_opened", {
  // anything you want the Flow to receive
  itemCount: 3,
  total: "129.90"
});

Etkinliğe isim vermek

Etkinlik adı, Shopify Flow iş akışınızın dallanma noktasıdır; bu nedenle anlaşılır bir ad seçin ve iş akışları bu adı kullanmaya başladığında artık değiştirmeyin.

Adlar harf, rakam, alt çizgi ve tire içerebilir; bir harf veya rakamla başlamalıdır ve en fazla 64 karakterden oluşabilir. Uygulama, yazdıklarınızı kısaltır; bu nedenle Cart drawer opened, cart_drawer_opened haline gelir.

Bu ad, dahili olarak ad alanına alınmıştır; bu sayede hiçbir zaman bir Shopify olayıyla veya aynı adlı bir webhook özel tetikleyicisiyle çakışmaz.

Filtreleme ve yeniden şekillendirme

İkinci argüman olarak ilettiğiniz veriler, Shopify Flow’da tetikleyicinin output öğesi olarak gelir. İhtiyacınız olan tek şey buysa, işlem tamamdır.

Yalnızca belirli durumlarda tetikleme yapmak veya temanın yayınladığından farklı alanlar göndermek istediğinizde, bir dönüştürme işlevi yazın - bu, Özel tetikleyiciler tarafından kullanılan JavaScript modülüyle aynıdır. Tetiklemek için bir nesne döndürün, atlamak için null döndürün:

export async function transform(payload, topic, shop, ctx) {
  // Anything you published is on `payload`.
  if ((payload.itemCount || 0) < 2) return null;

  return {
    itemCount: payload.itemCount,
    total: payload.total,
    // Present only when the shopper is signed in.
    customerId: payload.customerId,
  };
}

Shopify Flow’da kullanma

Her “Özel Mağaza Sayfası Tetikleyicisi”, Shopify Flow’da aynı tetikleyici olarak görünür: “Özel Mağaza Sayfası Tetikleyicisi”. Bunu bir iş akışına ekleyin, ardından “eventName” değerinin seçtiğiniz adla eşleşmesi koşulunu ekleyin.

İşte bu sayede tek bir Shopify Flow tetikleyicisi, mağaza ön yüzünüzdeki tüm olayları geri gönderebilir. Tetikleyici ayrıca, uygulamada ona verdiğiniz adı ve dönüştürme işleminizin çıktısını da içerir.

Bu, webhook tabanlı Özel tetikleyiciler öğesini destekleyen **Özel **Tetikleyiciden kasıtlı olarak ayrı tutulmuştur. İkisi arasında bilinmesi gereken bir fark vardır: Bir webhook özel tetikleyicisi sunucularımızda çalışır ve güvenilirdir; oysa bir mağaza önü olayı, alışverişçinin tarayıcısının bize ulaşmasına ve analitik iznine bağlıdır.

Neler gönderilmemelidir?

publish işlevinin ikinci argümanı tamamen sizin kontrolünüz altındadır; bu da, kişisel verilerin bu argümanda yer almamasını sağlamak sizin sorumluluğunuzda olduğu anlamına gelir.

Tanımlayıcıları ve bilgileri gönderin: ürün ve varyant kimlikleri, miktarlar, fiyatlar, meydana gelen olayın adı. Oturum açmış müşterinin kimliği varsa sizin adınıza eklenir; bu nedenle bunu kendiniz iletmenize gerek kalmaz.

İsim, e-posta adresi, telefon numarası veya posta adresi göndermeyin. İş akışınız, Shopify Flow’daki müşteri kimliğinden bu bilgileri herhangi bir şekilde sorgulayabilir; dolayısıyla bunları bir mağaza ön yüzü olayına eklemenin hiçbir faydası yoktur ve bunu yapmak, bir analiz olayını kişisel veri içeren bir olaya dönüştürür.

Sonraki adımlar

• Mağaza vitrini tetikleyicileri - Yerleşik mağaza tetikleyicileri ve pikselin çalışma şekli.
• AI ile tetikleyici kodu oluştur - Tema kod parçacığını veya dönüştürme kodunu yapay zekanın sizin için yazmasına izin verin.
• Özel tetikleyiciler - Shopify webhook olayları için aynı konsept, ancak sunucu tarafında güvenilirlikle.
• Planlar ve kullanım - Neyin bir olay olarak kabul edildiği.