> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Örnek uygulama: custom_data ile haftalık e-posta

> Clean Beans örnek uygulamasının custom_data ve Liquid ile her alıcıya göre kişiselleştirilmiş haftalık rapor e-postasını nasıl gönderdiği ve bunun Data Feeds ile karşılaştırması.

Bu sayfa, gerçek bir uygulamayı baştan sona takip eden [Örnek uygulama: eksiksiz bir OneSignal entegrasyonu](https://documentation.onesignal.com/docs/tr/example-full-integration-overview.md) kılavuzunun bir parçasıdır. Uygulama, ortak yaşanan evler için bir temizlik nöbet çizelgesi olan **Clean Beans**'tir ve Expo (React Native) ile bir Supabase backend'i kullanılarak geliştirilmiştir.

Her pazar her hane, haftasını özetleyen bir e-posta alır: oturumlar, görevler, dakikalar, bir liderlik tablosu ve her kişinin kendi rakamları.

![Clean Beans haftalık rapor e-postası](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-email.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=386b96883e6b7af79d0406d4095f73c7)

Haftalık rapor: hane toplamları, sizin haftanız ve liderlik tablosu.

İlginç sorun kişiselleştirmedir. Bir hanedeki herkes aynı liderlik tablosunu görür, ancak her kişi kendi adını ve istatistiklerini görmelidir. Kişi başına bir istek göndermek işe yarardı, ancak daha iyi bir yol var.

## Hane başına bir istek, kişi başına kişiselleştirme \\

Fonksiyon hane başına **bir** istek gönderir. External ID ile anahtarlanmış bir `users` nesnesi de dahil olmak üzere tüm verileri `custom_data` içinde iletir. Şablon daha sonra işlediği kişi için doğru girişi seçer.

```typescript supabase/functions/weekly-report/index.ts theme={null}
const customData = {
  household_name: householdNames[householdId] || 'Your Household',
  week_label: weekLabel,
  household_sessions: String(householdSessions.length),
  household_tasks: String(totalTasks),
  household_mins: String(totalMins),
  top_room: topRoom,
  leaderboard,
  users,
};

    // ...

const onesignalPayload: Record<string, unknown> = {
  app_id: ONESIGNAL_APP_ID,
  template_id: ONESIGNAL_WEEKLY_TEMPLATE_ID,
  include_aliases: {
    external_id: externalIds,
  },
  target_channel: 'email',
  custom_data: customData,
};
```

Şablonda tek bir Liquid satırı mevcut alıcının verilerini seçer.

```liquid email-templates/weekly-report.html theme={null}
{% assign user = message.custom_data.users[subscription.external_id] %}
{% assign lb = message.custom_data.leaderboard %}
```

Bundan sonra `user` bu kişinin istatistiklerini tutar ve doğrudan `message.custom_data` içinden okunan her şey hane tarafından paylaşılır.

```liquid email-templates/weekly-report.html theme={null}
Hey {{ user.name | default: "there" }}! 👋
Here's how <strong>{{ message.custom_data.household_name | default: "your household" }}</strong> did this week.

{% for member in lb %}
  {% if forloop.index == 1 %}🥇{% elsif forloop.index == 2 %}🥈{% elsif forloop.index == 3 %}🥉{% else %}{{ forloop.index }}{% endif %}
  {{ member.name }}{% if member.name == user.name %} (you){% endif %}
{% endfor %}
```

> [!NOTE]
>
> İkinci Liquid örneği, mantığı tablo işaretlemesi olmadan göstermek için şablondan sadeleştirilmiştir.

## Boyut sınırı içinde kalın \\

E-posta için `custom_data` 10 KB ile sınırlıdır. Büyük bir hane bunu aşabilir, bu yüzden fonksiyon yükü ölçer ve gerekirse liderlik tablosunu kısaltır.

```typescript supabase/functions/weekly-report/index.ts theme={null}
// Check payload size (10KB limit for email)
const payloadSize = new TextEncoder().encode(JSON.stringify(customData)).length;
if (payloadSize > 10000) {
  console.warn(`Household ${householdId} custom_data is ${payloadSize} bytes (over 10KB limit). Trimming leaderboard.`);
  customData.leaderboard = customData.leaderboard.slice(0, 5);
}
```

## Zamanlama ve tercihler \\

Haftalık bir zamanlama, push hatırlatıcılarıyla aynı `pg_cron` kalıbını `0 9 * * 0` ifadesiyle kullanarak fonksiyonu her pazar 09:00 UTC'de çağırır. Yalnızca **Weekly Email Summary** seçeneğini açmış kullanıcılar dahil edilir.

**Kontrol paneli kurulumu.** **Messages > Templates** bölümünde bir e-posta şablonu oluşturun, HTML'yi yapıştırın ve şablon kimliğini backend'inizin gizli anahtarlarına kopyalayın. `custom_data` yalnızca bir şablonla çalışır, bu yüzden `template_id` zorunludur.

## Alternatif: Data Feeds \\

Kişiye özel verileri bir e-postaya almanın ikinci bir yolu vardır ve Clean Beans bunu kullanmamayı seçti. Bazı uygulamalar için daha uygun olduğundan bu yöntemi anlamak faydalıdır.

`custom_data` ile backend'iniz gönderim yaparken verileri OneSignal'a **iter**. Bir **Data Feed** ile OneSignal, her e-posta gönderildiği anda verileri API'nizden **çeker**. Gönderimin kendisini backend'iniz değil bir Journey başlatır.

> [!NOTE]
>
> Bu alt bölümdeki örnekler açıklama amaçlıdır. Haftalık raporun bir Data Feed ile nasıl oluşturulacağını gösterirler. Uygulamadan alınmamıştır.

Haftalık rapor şöyle çalışırdı.

**1. Bir kişinin haftasını döndüren bir uç nokta açın**

Bir backend fonksiyonu bir kullanıcı kimliği alır ve o kullanıcının istatistiklerini ve hanesinin liderlik tablosunu JSON olarak döndürür.

```json Response from your API theme={null}
{
  "name": "George",
  "household_name": "The Smiths",
  "week_label": "Nov 10 – Nov 16",
  "sessions": 5,
  "tasks": 19,
  "mins": 63,
  "streak": 24,
  "leaderboard": [
    { "name": "George", "sessions": 5, "mins": 63 },
    { "name": "Jonny", "sessions": 4, "mins": 52 }
  ]
}
```

**2. Data Feed'i kontrol panelinde oluşturun**

**Settings > Data feeds** bölümünde feed'e bir takma ad verin ve onu uç noktaya yönlendirin. URL ve başlıklar Liquid kabul eder, böylece alıcının External ID'si iletilebilir.

```text Data Feed configuration theme={null}
Alias:   weekly
Method:  GET
URL:     https://YOUR_PROJECT_REF.supabase.co/functions/v1/weekly-stats?user_id={{ external_id }}
Headers: { "Authorization": "Bearer YOUR_FEED_SECRET" }
```

**3. Feed'i e-posta şablonuna bağlayın ve ondan okuyun**

Şablonda değerler `data_feed` ve ardından takma addan gelir.

```liquid Email template theme={null}
Hey {{ data_feed.weekly.name | default: "there" }}!
Here's how {{ data_feed.weekly.household_name }} did this week.

{% for member in data_feed.weekly.leaderboard %}
  {{ member.name }}: {{ member.sessions }} sessions
{% endfor %}
```

**4. Yinelenen bir Journey'den gönderin**

İlk adımı pazar sabahı zaman aralığı olan ve bir yeniden giriş kuralına sahip bir Journey, şablonu her hafta gönderir. Backend'inizde hiçbir zamanlama veya gönderim kodu bulunmaz.

### Hangisi kullanılmalı \\

| | `custom_data` (Clean Beans'in kullandığı) | Data Feeds |
| - | - | - |
| Gönderimi kim başlatır | API'yi çağırarak backend'iniz | Kontrol panelindeki bir Journey |
| Veriler ne zaman okunur | Backend'iniz isteği oluşturduğunda | Her mesaj gönderildiğinde |
| Dört kişilik bir hane için istekler | OneSignal'a bir istek | OneSignal'dan API'nize dört çağrı |
| Kanallar | Push, e-posta ve SMS | E-posta ve SMS, yalnızca Journeys içinde |
| Boyut sınırı | E-posta için 10 KB | Yaklaşık 50 KB'a kadar yanıtlar önerilir |
| Veri eksikse | Ne yapılacağına kodunuz karar verir | O alıcı mesaj almaz |
| Zamanlamayı veya akışı değiştirmek | Bir backend değişikliği | Bir kontrol paneli değişikliği |
| API'nizin açığa çıkması | Hiçbir şey açığa çıkmaz | Güvenliğini sağlamanız ve hızlı tutmanız gereken herkese açık bir uç nokta |

**Gönderme kararını zaten backend'iniz veriyorsa `custom_data` seçin.** Haftalık raporda durum budur. Backend bir zamanlamayla çalışır, hangi hanelerin izin verdiğini bilir ve tüm rakamlar elindedir, bu yüzden verileri iletmenin ek bir maliyeti yoktur. Tek istek tüm haneyi kapsar, korunacak bir uç nokta yoktur ve bir hata kendi günlüklerinizde görünür. Bunun bedeli, zamanlama ve kitlenin kodda yaşaması ve yükün sabit bir boyut sınırı olmasıdır.

**Gönderim bir Journey'ye aitse Data Feed seçin.** Bir Journey, birine ne zaman mesaj göndereceğine kendisi karar verir: bir olaydan günler sonra veya bir bekleme koşulu karşılandığında. Backend'iniz o anda veri sağlamak için orada değildir. Data Feed bu boşluğu doldurur ve mesajlaşmayı yöneten kişilerin dağıtım yapmadan zamanlamayı değiştirmesine, bir dal eklemesine veya varyantları test etmesine olanak tanır. Bunun bedeli, API'nizin alıcı başına bir kez çağrılması ve yaklaşık çeyrek saniyede yanıt vermesi gerekmesi, her şablonun yalnızca bir feed kullanabilmesi ve başarısız bir çağrının o kişinin sessizce hiçbir şey almaması anlamına gelmesidir.

Clean Beans için belirleyici etkenler basitti. Backend'de veriler ve zamanlama zaten vardı, liderlik tablosu hane tarafından paylaşıldığından tek bir istek kişi başına bir çağrıdan çok daha ucuzdu ve tercihler uygulamanın veritabanında saklandığından backend bunları doğrudan kontrol edebiliyordu.

> [card] [custom\_data ile kişiselleştirme](https://documentation.onesignal.com/docs/tr/personalization-api-custom-data.md)
>
> Boyut sınırları ve Liquid erişim kalıpları.

> [card] [Data feeds](https://documentation.onesignal.com/docs/tr/data-feeds.md)
>
> Journey e-postalarına ve SMS'lerine canlı veri çekin.

> [card] [Liquid söz dizimini kullanma](https://documentation.onesignal.com/docs/tr/using-liquid-syntax.md)
>
> Filtreler, döngüler ve koşullar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.