Ana içeriğe atla
Veri Etiketleri, OneSignal’da özel özellikleri depolamanıza ve kullanıcı davranışını izlemenize olanak tanıyan anahtar-değer çiftleridir. Güçlü segmentasyon ve kişiselleştirmeyi mümkün kılarlar.
Etiketleri şunlar için kullanın:
  • subscription_tier veya name gibi kullanıcı özelliklerini depolama
  • purchases, clicks veya levels gibi davranışları izleme
  • Mesajlar ve Journeys için kullanıcıları segmentlere ayırma
  • Mesaj içeriğini kişiselleştirme

Veri Etiketi Değer Biçimlendirme Kuralları

Tüm Etiket değerleri dizeler olmalıdır. Yine de sayıları, zaman damgalarını ve boolean benzeri değerleri depolayabilirsiniz—sadece bunları dizeye dönüştürün!
Değer TürüBiçim ÖrneğiNotlar
Dize Etiketi"free", "VIP"Kullanıcı türleri, ayrıcalıklar, durumlar için
Sayı"42", "3.14"Sayısal filtreleri etkinleştirir (büyüktür, küçüktür)
Zaman Damgası"1685400000"Unix zaman damgası (saniye cinsinden). Zaman Operatörleri ile kullanın
Boolean"true" / "false", "1" / "0"Yük boyutunu azaltmak için "1"/"0" kullanın
Desteklenmez: Diziler, nesneler, iç içe değerler veya JSON blob’ları. Karmaşık verileri depolamanız gerekiyorsa, Özel Olaylar’ı kullanın.

Kısıtlı Anahtar Kelimeler

Aşağıdaki anahtar kelimeler kısıtlıdır ve etiket anahtarları olarak kullanılmamalıdır çünkü mesaj kişiselleştirme için dahili olarak kullanılırlar: message, notification, subscription, user, template, app, org, dynamic_content, data_feed, journey, custom_data Daha fazla ayrıntı için Mesaj Kişiselleştirme bölümüne bakın.

Etiketler vs Özel Olaylar

Tags and Custom Events are both ways to add data to your users. However, there are some key differences:
FeatureTagsCustom Events
Data usageSegmentation and personalizationTrigger Journeys without a Segment, Wait Until steps, personalization directly within Journeys
Data retentionLifetime30+ days (lifetime storage is available)
Data formatKey-value strings or numbersJSON
Data sourceOneSignal SDK, API, or integrations (limited)OneSignal SDK, API, or integrations
Data accessSegmentation and message personalizationJourneys and Journey-message-template personalization, Segmentation (Coming soon)
The key distinction between Tags and Custom Events is in their depth and use cases. Tags are properties of a user, such as Name, Account Status, or Location. Events are thing that the user has done, such as Purchasing an Item, Completing a Level, or Inviting a Friend. Both tags and events can be used for segmentation and personalization. In practice, you will likely use both:
  • Tags for user properties that are static and don’t change often
  • Custom Events for real-time scenarios, complex segmentation, and more sophisticated journey workflows

Önerilen Etiket Stratejileri

Veri Etiketleri, mesajlarda veya hedef kitle segmentasyonunda kullanmak istediğiniz bilgileri temsil etmelidir. Tam kullanıcı profilleri veya günlükleri depolamak için değildirler—bunun için arka uç veritabanınızı kullanın.

Tutorials:

Olaya Dayalı Davranış Etiketleri

Kullanıcı eylemlerini etiketlerle izleyin. Journeys’leri, takipleri veya hatırlatmaları tetiklemek için harikadır.
KeyValue ExampleDescription
cart_update"1685400000"Last time user added something to cart. Use Time Operators.
last_order"1684100000"Last completed purchase timestamp
amount_spent"100"Total spent—stringified number, no currency symbol
social_share"2"Count of social shares or referrals
tutorial_status"step2" or "completed"Tutorial progress—use readable or numbered string values

Oyun Aktivitesi Etiketleri

Oyunlar tarafından kullanıcı performansına göre kişiselleştirmek için kullanılır.
KeyValue ExampleDescription
points"1250"Experience or game points
level"8"Current game level
high_score"3000"Highest score achieved

Hesap Durumu Etiketleri

Kullanıcıları hesap katmanına veya durum değişikliğine göre hedeflemek için bunları kullanın.
KeyValue ExampleDescription
user_type"free", "premium"Subscription or access tier
has_downgraded"1" or "1685400000"Boolean or timestamp of downgrade
user_privileges"admin", "guest"Role-based segmentation
Bireysel kullanıcıları tanımlamak için Harici Kimlik kullanın. Bu amaç için etiketleri kullanmayın. Harici Kimlik ve Takma Adlar’a bakın.

Kişiselleştirme Etiketleri

Değişken Değiştirme kullanarak ada dayalı mesaj özelleştirmesi için harikadır.
KeyValue ExampleDescription
first_name"Jon"First name
last_name"Smith"Last name
user_name"PokeCatcher22"Display or screen name

Konum ve Demografik Etiketler

Kullanıcıları bölgeye veya yaşa göre segmentlere ayırın.
KeyValue ExampleDescription
region"New York"Metro area, optionally use ISO 3166-2
postcode"94105"Zip or postal code
location"Downtown LA"Custom string location
birthdate"915148800"Unix timestamp in seconds (birth date)
birth_year"1998"Four-digit birth year
age_range"18-35"Useful for general audience segmentation

Etiketleri Ekleme, Güncelleme ve Kaldırma

Kullanım durumunuza ve teknik kurulumunuza bağlı olarak aşağıdaki yöntemlerden herhangi birini kullanarak Etiketleri yönetebilirsiniz.


SSS

Kullanıcı başına kaç etiket ayarlayabilirim?

Planınıza bağlıdır. Plan limitlerini görün veya kotanızı artırmak için satış ekibiyle iletişime geçin.

Plan limitlerini aşarsam etiketlerime ne olur?

Bir OneSignal uygulaması içinde mevcut etiket sayısında limit yoktur. Limit, her bir kullanıcı üzerinde aynı anda kaç etiketin ayarlanabileceğine uygulanır. Limitinde veya üzerinde olan kullanıcılar için etiketleri ekleyemez veya güncelleyemezsiniz. Önce etiketleri silmeli, ardından yenilerini eklemek için ikinci bir istek göndermelisiniz. Zaten ayarlanmış etiketler kalıcı olacaktır. Örnek: Plan limitiniz = kullanıcı başına 20 etiket.
  • Kullanıcının 19 etiketi var:
    • ✅ 1 yeni etiket ekle = başarılı
    • ❌ 2+ yeni etiket ekle = başarısız
  • Kullanıcının 20 etiketi var:
    • ❌ Herhangi bir yeni etiket ekle = başarısız
    • ✅ 1+ mevcut etiketi güncelle = başarılı

Etiket kullanımını nerede kontrol edebilirim?

Etiket kullanımını nasıl azaltırım?

  • SDK veya API kullanarak etiketleri kaldırın
  • Toplu silme için CSV İçe Aktarma’yı kullanın
  • Daha az, daha yeniden kullanılabilir etiketler kullanın (örn. status:active)
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!