Veri akışları

• Kullanıcının mevcut ödül bakiyesi
• En son sipariş durumu
• Kişiselleştirilmiş ürün önerileri

​

Veri Akışları Nasıl Çalışır

1. Bir Veri Akışı Oluşturun – OneSignal’in API’nize nasıl bağlanacağını yapılandırın.
2. Veri Akışını bir mesaj şablonuna ekleyin.
3. Yanıt alanlarını mesajınıza Liquid sözdizimi kullanarak ekleyin.
4. Gönderim anında, OneSignal her alıcı için bir API çağrısı yapar, yanıtı ayrıştırır ve verileri mesajınıza enjekte eder.

​

Örnek: Ödül puanlarını gösterme

Hi {{ first_name }},

You have {{ data_feed.rewards.points }} points!
Your membership status is {{ data_feed.rewards.status_level }}.

Keep shopping to earn more points!

​

Veri Akışı oluşturma ve kullanma

​

1. Veri Akışı yapılandırmanızı ayarlayın

• Ad: Akış listenizde ayırt etmenize yardımcı olması için “Müşteri Ödülleri API’si” gibi açıklayıcı bir ad. Bunların benzersiz olmasını öneririz, ancak zorunlu değildir.
• Takma Ad: Liquid sözdiziminde kullanacağınız rewards gibi kısa bir ad. Bunlar benzersiz olmalı, boşluk içermemeli ve yalnızca özel semboller olmadan küçük harf alfasayısal karakterler içerebilir.
• Yöntem: API’nize nasıl ulaşmamız gerektiği. Genellikle bu GET’tir ancak POST da desteklenir.
• URL: API’nin adresi. Kullanıcıya özel verileri çekmek için API’yi çağırmamızı sağlayan Liquid sözdizimini dahil edebilirsiniz.

https://acme.com/customers/user_id={{ external_id }}/rewards

• Başlıklar: API spesifikasyonlarınızın gerektirdiği şekilde başlık anahtar-değer çiftlerini girin. Tipik bir önemli kullanım, kimlik doğrulama bilgilerini dahil etmek olacaktır. Bu alanlar gerektiğinde Liquid sözdizimini de destekler.
• Gövde: API’niz gerektiriyorsa, isteğe JSON formatında bir gövde dahil edebilirsiniz. Bu düzenleyici, tıpkı Journey Webhook’ları gibi Liquid sözdizimini destekler.

{
	"customer_id": "{{ external_id }}"
}

Veri Akışı yapılandırma örneği

​

2. Veri Akışını mesaj şablonunuza ekleyin

1. Mesajlar > Şablonlar’a gidin
2. Mesaj bölümünde Kişiselleştirme düğmesini seçin

Kişiselleştirme düğmesi seçenekleri

3. Veri Akışları’nı açın ve akışınızı seçin

Mesaj düzenleyicisinde Veri Akışları bölümü

4. Şablonunuzu kaydedin

​

3. Verileri mesajınızda kullanın

{
	"external_id": a1-b2c3,
	"points": 193,
	"status_level": "Gold"
}

You have {{ data_feed.rewards.points }} points!
Your membership status is {{ data_feed.rewards.status_level }}.

• Bir Veri Akışı kullan
• rewards Veri Akışını kullan
  • Hatırlayın: rewards akışı, API’yi alıcının external_id’si ile çağırmayı bilir
• Yanıttan, points öğesinin değerini (193) ve status_level öğesinin değerini (Gold) ekle

​

Gereksinimler ve Sınırlar

• Başlıklarda kimlik doğrulama belirteçleriyle tek adımlı kimlik doğrulamayı kabul etmek
• Hızlı yanıt vermek. 250ms altı önerilir (bu, gönderim hızını doğrudan etkiler)
• JSON döndürmek. Diğer formatlar şu anda desteklenmiyor.
  • Alternatif bir formata dayanan bir kullanım durumunuz varsa, sizden haber almak istiyoruz! Bu kısa anketi doldurun.
• Mesaj gönderme hacminizi ve oranınızı yönetmek. API’nizin düşük bir oran sınırı varsa, bu mesajlarınızı hızlı bir şekilde iletmemizi engelleyecektir.
• Makul boyutlu yükler döndürmek. En iyi performans için yanıtları 50kb altında tutmanızı öneririz.

• Şablon başına bir Veri Akışı. Bu sınırı gelecekte artırmayı bekliyoruz. Buna ihtiyacınız olduğunu bize bildirmek için bu kısa anketi doldurun.
• Mesaj başına Veri Akışı başına bir API çağrısı. İhtiyacınız olan her şeyi tek bir çağrıda alın.
• Yalnızca Journeys. Henüz diğer gönderim yöntemleri için kullanılamıyor. Buna ihtiyacınız olduğunu bize bildirmek için bu kısa anketi doldurun.
• Çağrı zincirlemesi yok. Bir Veri Akışından gelen yük, başka birini çağırmak için kullanılamaz.

​

API’nizi ayarlama

​

Kimlik Doğrulama

Authorization: Bearer YOUR_TOKEN

X-API-Key: YOUR_KEY

​

JSON İstek Gövdesi

​

JSON Yanıtı

​

Kişiselleştirme Parametreleri

https://api.example.com/users/{{external_id}}/data
https://api.example.com/rewards?email={{email | url_encode}}

{
	"customer_id": "{{ external_id }}",
	"email": "{{ subscription.email }}"
}

​

Oran Sınırları

​

Hata İşleme

​

Başlangıç Kontrol Listesi

• Mesajımda hangi verileri göstermek istiyorum? API’nizden doldurulacak öğelerin tanımlandığı basit bir taslaktan geriye doğru çalışmak, düşüncelerinizi organize etmenize yardımcı olacaktır.
• Bu veriler tek bir API uç noktası üzerinden kullanılabilir mi?
• API isteklerini nasıl doğrulayacağım?
• Kişiselleştirilmiş verileri almak için hangi tanımlayıcıyı veya diğer veri öğesini kullanacağım?
• Bu tanımlayıcı zaten OneSignal’de depolanıyor mu? Değilse, nasıl doldurulacak?
• API’m üreteceğim istek hacmini kaldırabilir mi?
• API’m bir kullanıcı için veriye sahip değilse ne olur?

​

Örnekler ve gelişmiş kullanım durumları

​

Döngülerle yineleme: terk edilmiş sepet

{
  "items": [
    {
      "name": "Blue Running Shoes",
      "price": 84.00,
      "image_url": "https://acme.com/blue-running-shoes.png"
    },
    {
      "name": "Protein Bar",
      "price": 5.99,
      "image_url": "https://acme.com/protein-bar.png"
    }
  ],
  "total": 89.99
}

<ul>
  {% for item in data_feed.cart.items %}
    <li>
      <strong>{{ item.name }}</strong><br>
      ${{ item.price }}<br>
      <img src="{{ item.image_url }}" alt="{{ item.name }}">
    </li>
  {% endfor %}
</ul>

<p>Cart total: ${{ data_feed.cart.total }}</p>

- Blue Running Shoes
- $84.00
- <koşu ayakkabısı resmi>
- Protein Bar
- $5.99
- <protein bar resmi>
Sepet toplamı: $89.99

​

Özel olay özellikleri

curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Accept: application/json' \
  --data '{
  "events": [
    {
      "name": "cart_abandoned",
      "external_id": "user_12345",
      "properties": {
        "cart_id": 98765
      }
    }
  ]
}'

Journey girişi için özel olay

https://acme.com/carts/{{ journey.event.cart_abandoned.data.cart_id }}

1. 98765 olan cart_id değeri Journey’ye depolanacaktır
2. E-posta adımına ulaşıldığında, cart Veri Akışı bu cart_id değerine referans verecek ve onu sepet API’sini çağırmak için kullanacaktır
3. Döndürülen JSON özellikleri, yukarıdaki önceki örnekteki gibi ayrıştırılacak ve e-postaya eklenecektir

​

Koşullu görüntüleme: sipariş durumu

Your order is {{data_feed.order.status}}!

{% if data_feed.order.tracking_number != empty %}
Track it here: {{data_feed.order.tracking_url}}
{% endif %}

​

Kişiselleştirme olmadan otomasyon

https://acme.com/assets/email-banner

{
	"banner_url": "https://acme.com/assets/email-banner/2025july.png"
}

​

Sorun Giderme

​

Verilerim görünmüyor

1. Veri Akışınızın şablona eklendiğini kontrol edin
2. Liquid sözdizminizin JSON yapınızla tam olarak eşleştiğini doğrulayın
3. API uç noktanızı veri döndürdüğünden emin olmak için manuel olarak test edin
4. Kullanıcının gerekli veri etiketlerine (external_id gibi) sahip olduğunu kontrol edin

​

Mesajlar yavaş gönderiliyor

1. API yanıt sürenizi kontrol edin
2. API’nizin eş zamanlı istekleri işleyebildiğinden emin olun

​

Bazı alıcılar mesaj almıyor

1. API’niz bu kullanıcılar için veriye sahip olmayabilir
2. 404’ler veya hatalar için Veri Akışı yapılandırmasındaki hata günlüğünü kontrol edin
3. 404’ler veya hatalar için API günlüklerinizi kontrol edin
4. Bu kullanıcıların OneSignal’de gerekli tanımlayıcılara sahip olduğunu doğrulayın