CSV ile Dinamik İçerik

• Ölçekte kişiselleştirmek için bir CSV kullanın – Bir mesaj, herkes için özel deneyimler
• Çok dilli destek – Kullanıcı başına otomatik dil değiştirme
• Dinamik kişiselleştirme – İçerik kullanıcı özelliklerine (dil, bölge, kampanya ID) uyum sağlar
• Ekip işbirliği – Teknik olmayan kullanıcılar CSV dosyalarında içerik düzenler
• HTML enjeksiyonu (e-posta) – CSV hücrelerine HTML işaretlemesi ekleyerek dinamik olarak zengin e-posta içeriği oluşturun
• Kanallar arası uyumluluk – Kanallar arasında CSV mantığını yeniden kullanın

• Çok dilli onboarding veya pazarlama
• Bölgeye özel promosyonlar
• Konuma göre etkinlik duyuruları
• Kampanyaya dayalı kişiselleştirme

​

CSV ile Dinamik İçerik kurulum adımları

1. İçerik varyasyonlarınızla bir CSV dosyası oluşturun.
2. Liquid sözdizimindeki dynamic_content özelliğini kullanarak CSV verilerini mesaja eşleyin.
3. OneSignal kontrol panelinden yeni bir mesaj veya şablon oluşturun.
4. Dinamik İçerik veya Kişiselleştirme düğmesini seçin.
5. CSV dosyasını yükleyin ve mesajı gönderin.

​

CSV gereksinimleri ve kurulum

• Dosya boyutu: 200 KB’nin altında
• Sütun başlıkları:
  • Etiket anahtarı için ilk sütun başlığını ayırın veya bölümlere referans vermek için boş bırakın
  • Yalnızca alfanümerik karakterler ve alt çizgiler
  • Boşluk yerine alt çizgi (_) kullanın
• Kodlama: UTF-8

• Çok dilli – İçeriği dile göre yerelleştirin
• İçerik kişiselleştirme – İçeriği Data Tag’lere göre özelleştirin

​

Örnek CSV’ler

• Çok Dilli Şablon Örneği
• İçerik Kişiselleştirme Şablon Örneği

• Sütun başlıklarını desteklenen dil kodlarınıza eşleyin.
• Her dil kodu için her satıra çevirilerinizi ekleyin.
• Birden fazla bölümünüz varsa (bir e-postada olduğu gibi), ilk sütunu bölüm adı olarak belirleyin.

Bu örnek şunları içerir:

• 3 dil: İngilizce, İspanyolca ve Fransızca.
• 2 bölüm: “section_1” ve “section_2”.

• İlk sütun başlığını etiket anahtarına ve alttaki satırları referans vermek istediğiniz değerlere eşleyin. Kullanıcılara etiket ekleme hakkında daha fazla bilgi için Etiketler’e bakın.
• Kalan sütun başlıklarını kişiselleştirmek istediğiniz bölümlere veya bileşenlere eşleyin.

Bu örnekte:

• Etiket anahtarı campaign_id olup olası değerleri A ve B’dir.
• 3 bileşen vardır: “title”, “message” ve “url”.

Önemli: CSV başlıklarından boşlukları ve alfanümerik olmayan karakterleri kaldırın veya Liquid’de hash notasyonu kullanın.

​

CSV verilerini mesaj içeriğine eşleme

<!-- Seçenek 1: önce bileşene göre erişim -->
{{dynamic_content.file_name.message_component[user_property]}}

<!-- Seçenek 2: önce kullanıcı özelliğine göre erişim -->
{{dynamic_content.file_name[user_property].message_component}}

• dynamic_content – CSV verilerine referans vermek için kullanılan özellik adı
• file_name – CSV dosya adı (.csv uzantısı olmadan)
• message_component – Kişiselleştirmek istediğiniz belirli mesaj bileşeni. Bu, CSV sütun başlığındaki veya ilk satırdaki statik metindir.
• user_property – Referans vermek istediğiniz kullanıcı özelliği.

{{ dynamic_content.my_template.header[user.language] | default: "En son güncellememize hoş geldiniz" }}

• Mevcut olduğunda Dinamik İçerik kullanılır
• Dinamik İçerik başarısız olursa sabit kodlanmış bir mesaj görünür
• Kullanıcılar asla boş içerik almaz

• Çok Dilli Mesaj Örneği
• İçerik Kişiselleştirme Mesaj Örneği

translations.csv

,en,es,fr
section_1,Hello,Hola,Bonjour
section_2,Thanks for shopping with us...,Gracias por comprar con nosotros...,Merci pour votre achat avec nous...

• file_name translations.csv’dir.
• message_component ilk sütunun satırlarında section_1 ve section_2’dedir.
• user_property dil koduyla eşleşen sütun başlığıdır. Bunu kullanıcı üzerinde user.language özelliği ile referans verebiliriz.

Çok dilli mesaj için temel Liquid sözdizimi

{{dynamic_content.translations.section_1[user.language]}}
{{dynamic_content.translations.section_2[user.language]}}

(Önerilen) Varsayılan yedekli çok dilli mesaj için Liquid sözdizimi

{% assign supported_langs = "en,es,fr,de" | split: "," %}
{% assign lang = user.language | default: "en" %}

{% unless supported_langs contains lang %}
  {% assign lang = "en" %}
{% endunless %}

{{ dynamic_content.translations.section_1[lang] | default: "Hello" }}
{{ dynamic_content.translations.section_2[lang] | default: "Thanks for shopping with us..." }}

content_personalization_template.csv

campaign_id,title,message,url
campaign_123,Flash deal for you,Tap to claim,https://example.com/flash
campaign_456,Weekend picks are here,See what's trending,https://example.com/weekend
default,Our latest offers,See what's new,https://example.com

• file_name content_personalization_template.csv’dir.
• user_property etiket anahtarına eşlenir: campaign_id.
• message_component kişiselleştirmek istediğiniz mesaj bölümüne eşlenen sütun başlığıdır (title, message veya url).

İçerik kişiselleştirme mesajı için Liquid sözdizimi

{{ dynamic_content.content_personalization_template[campaign_id].title }}
{{ dynamic_content.content_personalization_template[campaign_id].message }}
{{ dynamic_content.content_personalization_template[campaign_id].url }}

(Önerilen) Varsayılan yedekli içerik kişiselleştirme mesajı için Liquid sözdizimi

{% assign cid = campaign_id | default: "default" %}

{% unless dynamic_content.content_personalization_template[cid] %}
  {% assign cid = "default" %}
{% endunless %}

{{ dynamic_content.content_personalization_template[cid].title | default: "En son tekliflerimiz" }}
{{ dynamic_content.content_personalization_template[cid].message | default: "Yenilikleri görün" }}
{{ dynamic_content.content_personalization_template[cid].url | default: "https://example.com" }}

​

CSV hücrelerinde HTML kullanma (yalnızca e-posta)

campaign_id,banner_html
spring_sale,<div style="background:#4CAF50;padding:16px;text-align:center;"><a href="https://example.com/spring" style="color:#fff;font-size:18px;">Shop the Spring Sale</a></div>
default,<div style="background:#333;padding:16px;text-align:center;"><a href="https://example.com" style="color:#fff;font-size:18px;">See What's New</a></div>

{{ dynamic_content.promo_banners[campaign_id].banner_html | default: "<p>Check out our latest offers</p>" }}

​

Referans

​

Şablonları güncelleme

​

Anahtarlardaki özel karakterler

{{ dynamic_content.file_name["!the_row!"]["&the_column&"] }}

{{ dynamic_content.file_name.the_row.the_column }}

​

SSS

​

CSV ile Dinamik İçerik’i nasıl test edebilirim?

• Birden fazla varyasyonu test etmek için e-postalarda + adresleme kullanın: username+test@example.com.
• Yukarıdaki çok dilli ve içerik kişiselleştirme örneklerini takip ederek etiketleri ayarlayın.
• Birden fazla kullanıcı ve data tag’i yükleme hakkında daha fazla bilgi için İçe Aktarma’ya bakın.

​

CSV ile Dinamik İçerik ile diğer kişiselleştirme seçeneklerini ne zaman kullanmalıyım?

​

İlgili sayfalar