Ana içeriğe atla

​
Genel Bakış

Bu kılavuz, OneSignal’da terk edilmiş sepet hatırlatmalarını desteklemenin birden fazla yolunu anlatır. Kullanıcılar ürünleri geride bıraktığında sepet verilerini nasıl senkronize edeceğinizi ve e-postaları veya push bildirimlerini nasıl kişiselleştireceğinizi öğreneceksiniz. Terk edilmiş sepet şablonlarını şunlarla destekleyebilirsiniz:
  1. API custom_data — sepet ayrıntılarını mesaj isteğinizle birlikte aktarın.
  2. Etiketler — mesajları kişiselleştirmek için anahtar-değer çiftlerini depolayın.
  3. Özel Olaylar — cart_updated gibi kullanıcı olaylarından Journeys’i tetikleyin.
  4. Veri Beslemeleri — mesaj gönderme zamanında doğrudan API’nizden gerçek zamanlı sepet verilerini çekin.
Her yaklaşım Liquid kişiselleştirmeyi destekler ve hem E-posta hem de Push şablonlarıyla çalışır.

​
Kurulum Örnekleri

  • API: custom_data
  • Etiketler
  • Özel Olaylar
  • Veri Beslemeleri
Sunucunuzda depolanan sepet verilerini eklemek için Mesaj Oluşturma API’si’ni custom_data özelliğiyle kullanın. Sunucu tarafında kontrol edilen sepet verileri için en iyisidir.Örnek custom_data yükü:
JSON
{
  "custom_data": {
    "cart_url": "https://yourdomain.com/cart",
    "cart": [
      {
        "cartImageURL": "https://i.imgur.com/ssPCfbC.png",
        "cartProductName": "24 Pack of Acorns",
        "cartQuantity": "1",
        "cartPrice": "$12.99"
      },
      {
        "cartImageURL": "https://i.imgur.com/8QWTfV4.png",
        "cartProductName": "Fancy Sweater",
        "cartQuantity": "1",
        "cartPrice": "$9.99"
      }
    ]
  }
}

​
Terk edilmiş sepet e-posta şablonu

Bu e-posta şablonu örneği, Liquid Sözdizimini Kullanarak cart öğelerinin nasıl görüntüleneceğini gösterir:
  • Sepetteki toplam öğe sayısı
  • Kullanıcının sepetindeki öğeler, şunları içerir:
    • Ürün resmi
    • Ürün adı
    • Ürün miktarı
    • Ürün fiyatı
  • Müşterinin kişiselleştirilmiş sepet URL’sine bağlantı

Terk edilmiş sepet e-posta şablonu örneği

​
E-posta şablonu kurulumu

1

Yeni bir e-posta şablonu oluşturun

Mesajlar > Şablonlar > Yeni E-posta Şablonu’na gidin.
2

Sürükle ve Bırak Düzenleyiciyi kullanın

3

Aşağıdaki özelliklerde 5 satır oluşturun:

  • Satır 1, 2 ve 4, bir Metin bloğu ile 1 sütuna sahiptir.
  • Satır 3, 4 sütuna sahiptir: HTML bloğu | Metin bloğu | Metin bloğu | Metin bloğu
  • Satır 5, bir Düğme bloğu ile 1 sütuna sahiptir

Terk edilmiş sepet e-posta şablonu kurulumu

​
E-postada öğe sayısını görüntüleme

Liquid sözdizimini kullanarak, size özelliğini kullanarak ürün sayısını gösterin. Şablonunuzun satır 1 Metin bloğunda, istediğiniz gibi metninizi ayarlayın.Örnek:
We're holding onto {{message.custom_data.cart.size}} items in your cart, but don't wait too long, other squirrels are getting ahead!

​
E-postada öğeleri görüntüleme

custom_data sepet diziniz üzerinde yineleme yapmak için bir Liquid for-döngüsü kullanın.Şablon satır 2 Metin bloğunda, for-döngüsünü başlatan şunu ayarlayın: {% for product in message.custom_data.cart %}4 sütunlu satır 3, 1. sütunun HTML bloğunda aşağıdakilere sahip olacaktır:
<img src="{{product.cartImageURL}}" alt="Image" style="max-width:100%;" />
2., 3. ve 4. sütunların Metin blokları aşağıdaki metne sahip olacaktır:
  • {{product.cartProductName}}
  • {{product.cartQuantity}}
  • {{product.cartPrice}}
Satır 5 Metin bloğunda, şunu ayarlayın: {% endfor %}For-döngüsü, custom_data’ya aktardığımız cart dizisindeki her product’ı kontrol eder ve her ürün için değeri sütunlarda görüntüler.

Öğeleri göstermek için terk edilmiş sepet e-posta şablonu örneği

​
E-postaya özel sepet URL’si ekleme

Bu isteğe bağlıdır ve yalnızca sepetleriniz müşteri başına belirli bir URL’ye özel ise gereklidir.Sepet URL’sini ayarlamanın birkaç yolu vardır. Bu örnekte, tam URL’yi custom_data içinde sepete aktarıyoruz: "cart_url": "https://yourdomain.com/cart"Daha fazla ayrıntı için Dinamik URL’ler’e bakın.Düğme bloğunda > İçerik Özellikleri > Eylem > Url, {{message.custom_data.cart_url}} olarak ayarlayın

Özel URL için terk edilmiş sepet e-posta şablonu örneği

​
E-posta şablonunu sonlandırma

Şablonu özelleştirme hakkında daha fazla ayrıntı için Sürükle ve Bırak ile E-posta Tasarlama’ya bakın.
Hazır olduğunuzda, custom_data özelliği ile Mesaj oluşturma API isteklerinizde template_id’yi kullanabilirsiniz.

​
Terk Edilmiş Sepet Push şablonu

Bu push şablonu örneği, kullanıcının sepetindeki bir öğenin resmi ve adı dahil nasıl görüntüleneceğini gösterecektir. Ayrıca sepette toplam kaç öğe olduğunu gösterir ve müşterinin kişiselleştirilmiş sepet URL’sine bağlantı verir.

Terk edilmiş sepet push şablonu örneği

​
Push Şablonu Kurulumu

Push bildirimleri yalnızca sınırlı miktarda veriyle gönderilebilir. Sepetteki tüm öğeleri listelemek yerine, ilk öğeyi görüntülemek ve toplam kaç öğe olduğunu belirtmek istiyoruz.Mesajlar > Şablonlar > Yeni Push Şablonu’na gidin

​
Push’ta öğe ve öğe sayısını görüntüleme

Liquid sözdizimi, custom_data nesnenizin cart dizisinde kaç öğe olduğuna bağlı olarak mesajın ne söylediğini değiştirmek için kullanabileceğimiz if ifadeleri sağlar.Şablon Mesaj alanında, aşağıdaki metni ekleyin:
{% assign cart = message.custom_data.cart %}
{% assign item_count = cart.size | plus: 0 %}
{% if item_count == 1 %}
You left {{cart.first.cartProductName}} in your cart.
{% endif %}
{% if item_count == 2 %}
You left {{cart.first.cartProductName}} and {{item_count | minus: 1}} more item in your cart.
{% endif %}
{% if item_count > 2 %}
You left {{cart.first.cartProductName}} and {{item_count | minus: 1}} more items in your cart.
{% endif %}
Bu örnekte, önce cart değişkenini custom_data.cart olarak atarız, sonra item_count değişkenini cart.size olarak atarız ve bu sayı 1, 2 veya 2’den fazla ise farklı içerik görüntüleriz.Sepetin 1’den fazla öğeye sahip olabileceği için, sepetteki ilk öğeyi almak için first özelliğini kullanırız.Zaten bahsettiğimiz için toplam sepet öğeleri sayısını 1 azaltmak için minus özelliğini kullanırız.

​
Push’ta öğe resmini görüntüleme

Şablon Resim alanında, liquid sözdizimi ile Resim URL özelliğini ekleyin. Resim yoksa, hiçbir resim gösterilmez. default bir resim de ayarlayabilirsiniz. Örnek:
{{message.custom_data.cart.first.cartImageURL | default: "https://i.imgur.com/ssPCfbC.png"}}

​
Push’a özel sepet URL’si ekleme

Şablon Başlatma URL’si alanında, liquid sözdizimi ile sepet URL özelliğini ekleyin. Sepet yoksa, push, sitenin veya uygulamanın ana sayfasına yönlendirilir.Şablonlar içinde Başlatma URL’si hakkında not: https:// veya x:// formatında başka bir şema ayarlamak gereklidir. Bunu veri içinde ayarlarsanız, liquid sözdiziminin remove özelliğini şu şekilde kullanabilirsiniz:
  • https://{{message.custom_data.cart_url | remove: "https://"}}

​
Push şablonunu güncelleme ve mesajı gönderme

Push şablonları içinde sağlanan seçenekler hakkında daha fazla ayrıntı için Mesaj Gönderme’ye bakın.
Hazır olduğunuzda, custom_data özelliği ile Mesaj oluşturma API isteklerinizde template_id’yi kullanabilirsiniz.
Need help?Chat with our Support team or email support@onesignal.comPlease include:
  • Details of the issue you’re experiencing and steps to reproduce if available
  • Your OneSignal App ID
  • The External ID or Subscription ID if applicable
  • The URL to the message you tested in the OneSignal Dashboard if applicable
  • Any relevant logs or error messages
We’re happy to help!