KWIGA Yardım Merkezi Hizmetler, entegrasyonlar, API, Ayarlar Genel ayarlar Projede değişkenleri kullanma, kullanılabilir değişkenlerin listesi

Projede değişkenleri kullanma, kullanılabilir değişkenlerin listesi

Makaleler:

1 yıl önce • Güncellendi

Bu makalede projenizde değişkenleri nasıl kullanacağınız, bunları nerede uygulayacağınız, hangi verilerin kullanılabilir olduğu ve otomasyon ile kişiselleştirme için nasıl kullanacağınız açıklanmaktadır. E-postalar, web kancaları, düğmeler, dersler ve daha fazlası için açıklamalar ve örnekler içeren bir liste bulunur.

Değişkenler hakkında genel bilgiler

Değişkenler, projenizin çeşitli öğelerine kişiselleştirilmiş veriler eklemenin pratik bir yoludur. Şu gibi yerlerde kullanılabilirler:

1. Otomasyonlardaki webhook'lar

Değişkenler şuralara eklenebilir:

webhook URL'sine, örneğin:
https://example.com/hook?user={user.email}
istek gövdesi parametrelerine
başlıklara

Bu sayede kişisel veriler otomatik olarak üçüncü taraf hizmetlere gönderilebilir.

2. CTA (Harekete Geçirici Mesaj)

Düğmelerde ve bağlantılarda değişkenler şunlar için kullanılabilir:

düğme metnini kişiselleştirmek
kullanıcı kimliği veya UTM etiketleri gibi verileri bağlantılar aracılığıyla aktarmak

3. Parametrelerde

Değişkenler form parametrelerinde veya diğer öğelerde kullanılabilir:

kullanıcı email'i
abonelik kimliği
benzersiz kodlar ve etiketler
bağlamda kullanılabilen diğer tüm değişkenler

4. Yönlendirme bağlantısında (ödeme geçişi kullanılmıyorsa)

Değişkenler yönlendirme bağlantısına manuel olarak eklenebilir:

https://my.site.com/thanks?email={user.email}&course={course.title}

5. Başarılı teklif ödemesi için yönlendirme bağlantısında

Başarılı teklif ödemesinden sonraki yönlendirme bağlantısında contact.*, order.* ve payment.* bloklarındaki değişkenler kullanılabilir

Örnek: https://my.site.com/success?order_id={order.id}&email={contact.email}&payment_price={payment.price}

6. Ders bilgi bloklarında

Değişkenler ve koşullu bloklar bilgi kutusu metinlerinde çalışır. Örneğin:

İsimle hitap: Merhaba, {user.first_name}!
Kurs adını, tarihi, durumu vb. görüntüleme
İletişim verileri: {contact.name}, {contact.email} ve diğer alanlar
Geçerli ders verileri: {lesson.title}, {lesson.slug} ve diğer ders alanları
Koşullu bloklar @if/@endif: iletişim kişisinin etiketi, teklife erişimi vb. olup olmamasına bağlı olarak farklı içerikler gösterin.

7. E-postalarda

E-postalarda değişken kullanmak iletişimi daha kişisel ve etkili hâle getirir. {name}, {date} veya {course_name} gibi değişkenlerle e-posta, müşteriye kişisel olarak gönderilmiş gibi görünür. Bu, güveni, etkileşimi ve kullanıcının e-postayı sonuna kadar okuma veya istenen işlemi gerçekleştirme olasılığını artırır. Ayrıca değişkenler, kişisel yaklaşımı kaybetmeden toplu e-posta gönderimlerini otomatikleştirmeyi kolaylaştırır.

8. Bildirimlerde

Otomasyon eylemlerinde bildirimleri ayarlarken değişkenler, kullanıcı adı, sipariş numarası veya teklif adı gibi bilgileri bildirimlere dinamik olarak eklemenizi sağlar. Bu, bildirim oluşturma sürecini basitleştirip hızlandırarak onları farklı senaryolar için daha anlaşılır ve uyarlanabilir hâle getirir.

Kullanılabilir değişkenlerin listesi

Değişkenlerin kullanılabildiği her yerde kullanılabilen değişkenler.

Değişken	Değer
contact.id	İletişim kişisi kimliği
contact.user_id	Kullanıcı kimliği
contact.first_name	İletişim kişisi adı
contact.last_name	İletişim kişisi soyadı
contact.middle_name	İletişim kişisinin ikinci adı
contact.name	İletişim kişisinin tam adı
contact.email	İletişim kişisi email'i
contact.phone	İletişim telefonu
contact.country	İletişim ülkesi. Örneğin: Ukraine
contact.timezone	İletişim saat dilimi. Örneğin: Europe/Kyiv
contact.currency	İletişim para birimi. Örneğin: USD
contact.city	İletişim şehri
contact.utm_source	Benzersiz iletişim utm_source listesi (ayırıcı ", ")
contact.utm_medium	İletişimin benzersiz utm_medium listesi (ayırıcı ", ")
contact.utm_campaign	İletişimin benzersiz utm_campaign listesi (ayırıcı ", ")
contact.utm_term	İletişimin benzersiz utm_term listesi (ayırıcı ", ")
contact.utm_content	İletişimin benzersiz utm_content listesi (ayırıcı ", ")
contact.field_<id>	Özel alanlar (açıklama aşağıda)
datetime	UTC biçiminde tarih ve saat YYYY-MM-DD HH:mm:ss
contact.visit_source	Ziyaret kaynağı
Bu değişkenler, başarılı teklif ödemesi için yönlendirme bağlantısında kullanılabilir.

Özel alanlar

{contact.field_<id>}

Örnek {contact.field_123}

<id> — kişi alanı ayarlarından alınabilen alan kimliği (örnek https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

Bir değişkenin değeri nasıl değiştirilir

Görünümünü değiştirmek için bir değişkenden sonra seçenekler ekleyebilirsiniz: metin ekleyebilir, harfleri büyük yapabilir veya tarihi biçimlendirebilirsiniz.

Genel biçim: {variable|option:value|option} . Örneğin: {order.id|prefix:ORDER-} veya {payment.paid_at|format:DD.MM.YYYY} .

Elde etmek istediğiniz sonuç	Yazılacak ifade
Değerden önce metin ekleyin	`{order.id\|prefix:ORDER-}` → sonuç `ORDER-123` olur
Değerden sonra metin ekleyin	`{order.id\|suffix:-EU}` → sonuç `123-EU` olur
Sayıyı sabit uzunlukta yapın	`{payment.number\|pad:6}` → sonuç `000001` olur
Sıfırlar yerine kendi karakterinizle doldurun	`{payment.number\|pad:6\|padchar:_}` → sonuç `_____1` olur
Tüm harfleri büyük yapın	`{contact.city\|upper}` → `KYIV`
Tüm harfleri küçük yapın	`{contact.city\|lower}` → `kyiv`
Yalnızca ilk harfi büyük yapın	`{contact.city\|ucfirst}` → `Kyiv`
Tarihi gerekli biçimde gösterin	`{payment.paid_at\|format:DD.MM.YYYY}` → sonuç `24.12.2026` olur

Kendi tarih biçimi kalıbınızı istiyorsanız, hazır token'ları herkese açık dokümanlarda inceleyebilirsiniz: DD.MM.YYYY, MMMM YYYY, dddd gibi biçimler için Carbon dokümanları yardımcı olur. Y-m-d ve H:i:s gibi biçimler için resmî PHP dokümanlarını kullanın.

Önemli: pad kullanılırsa değer önce gerekli uzunluğa kadar doldurulur, ardından diğer seçenekler uygulanır.

Koşullu bloklar @if / @endif

Bir koşula bağlı olarak metnin bir bölümünü göstermenizi veya gizlemenizi sağlar. Koşul doğruysa blok görüntülenir; değilse tamamen kaldırılır.

Sözdizimi: @if(condition)...text...@endif

Örnek:
@if({contact.has|offer:123})Materyallere erişim sağlayın@endif

@if() içindeki koşul, true veya false döndüren herhangi bir değişkendir. Şu anda {contact.has|...} desteklenmektedir (kişi üyelik kontrolü).

contact.has koşulu — kişi kontrolü

Bir kişinin belirli koşulları karşılayıp karşılamadığını kontrol etmenizi sağlar. true veya false döndürür. Genellikle @if/@endif koşullu bloklarıyla birlikte kullanılır.

Sözdizimi: {contact.has|type:value}

Tür	Değer	Açıklama
`offer`	Teklif kimliği	Kişinin teklife erişimi var
`order`	Sipariş kimliği	Kişinin bu kimliğe sahip bir siparişi var
`product`	Ürün kimliği	Kişinin ürüne erişimi var
`tag`	Etiket kimliği veya adı	Kişinin bir etiketi var (addaki Kiril harfleri ve boşluklar desteklenir)
`list`	Liste kimliği	Kişi listede yer alıyor
`course`	Kurs kimliği	Kişi kursa kayıtlı
`marathon`	Kurs kimliği	course için diğer ad (bootcamp, course'un bir alt türüdür)
`webinar`	Web semineri kimliği	Kişinin web seminerine erişimi var
`closed_group`	Kapalı grup kimliği	Kişinin kapalı gruba erişimi var

| ile ayrılmış birden fazla koşul belirtebilirsiniz — tümünün aynı anda karşılanması gerekir (VE mantığı). Örneğin: {contact.has|offer:123|tag:VIP}

Kullanım örnekleri:

{contact.has\|offer:123}	123 kimlikli bir teklifin varlığını kontrol eder
{contact.has\|tag:VIP}	Bir etiketi adına göre kontrol eder
{contact.has\|tag:sınav etiketi}	Boşluk ve Türkçeye özgü harfler içeren etiket
{contact.has\|offer:123\|tag:VIP}	Her iki koşul aynı anda (VE)

CTA'da ek olarak kullanılabilen değişkenler

parametrelerde
yönlendirme bağlantısında (ödeme geçişi kullanılmıyorsa)

Değişken	Değer
first_name	Başvurudaki ad
last_name	Başvurudaki soyad
middle_name	Başvurudaki ikinci ad
name	Başvurudaki tam ad
email	Başvurudaki email
phone	Başvurudaki telefon
field_<id>	İstekten gelen özel alanlar (açıklama aşağıda)
utm_source	utm_source - özellikle başvurunun gönderildiği ziyaretten
utm_medium	utm_medium - özellikle başvurunun gönderildiği ziyaretten
utm_campaign	utm_campaign - özellikle başvurunun gönderildiği ziyaretten
utm_term	utm_term - özellikle başvurunun gönderildiği ziyaretten
utm_content	utm_content - özellikle başvurunun gönderildiği ziyaretten
widget_landing	İsteğin gönderildiği açılış sayfasının URL'si
widget_landign_referer	Başvuru gönderildiğinde açılış sayfasında bulunan yönlendiren
Belirli formlarda, "Otomasyon web kancalarında kullanılabilen değişkenler" bölümünde aşağıda açıklanan değişkenlere de erişim olabilir Siparişe göre ({order.}) — "Ürüne erişim" form seçeneği belirlenmişse (Tam erişim / Teklife göre) Ürüne göre ({product.}) — "Ürüne erişim" + "Tam erişim" form seçenekleri belirlenmişse Teklife göre ({offer.*}) — "Teklife göre" + "Ürüne erişim" form seçenekleri belirlenmişse

Özel alanlar

{field_<id>}

Örnek {field_123}

<id> — kişi alanı ayarlarından alınabilen alan kimliği (örnek https://sampleschool.kwiga.com/expert/crm/contacts?view=settings)

Custom fields example

CTA'nın veya Kwiga ziyaret izleme betiğinin yer aldığı sayfada UTM etiketli ziyaretler olduysa ve müşteri açılış sayfasında UTM etiketi olmadan bir talep gönderirse, bunlar bu değişkenlerde yer almaz. Ancak yukarıda açıklanan {contact.utm_...} değişkenlerinde kullanılabilirler.

Otomasyon webhook'larında kullanılabilen değişkenler (URL, parametreler, e-postalar)