Ana içeriğe atla

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.

Sitenizde veya uygulamanızda kullanıcıların etkileşim kurduğu sayfalara göre OneSignal’de kullanıcıları etiketleyebilir, ardından bu etiketleri hedefli mesajlaşma için segmentleyebilirsiniz. Bu sayfa iki farklı kalıbı kapsar — hedefinize uyanı seçin veya ikisini birlikte çalıştırın.

Kalıbınızı seçin

KalıpKodun çalıştığı zamanAyarlanan değerPlatformlar
Sayfa konusuna göre etiketleHer sayfa veya ekran ziyaretindeKonu başına sayaç etiketi (gaming = 5)Web, Android, iOS
Abonelikte etiketleKullanıcı push’a opt-in yaptığında bir kezAtıf etiketi (subscription_page = gaming)Yalnızca Web
Sayfa konusuna göre etiketle, etkileşimle birlikte büyüyen davranışsal ilgi profili oluşturur — içerik önerileri, yeniden etkileşim kampanyaları ve kategori tabanlı segmentasyon için yararlıdır; bir konuya açıkça opt-in yapmayan kullanıcılar için bile. Abonelikte etiketle, opt-in sırasında tek bir zaman noktası sinyali yakalar — kaynak farkındalıklı karşılama mesajlaşması ve kullanıcının abone olduğu sayfanın sonra ne okumak istediğini öngördüğü damla kampanyaları için yararlıdır.

Ön koşullar


Sayfa konusuna göre etiketle (her ziyarette)

Kullanıcıları en çok etkileşim kurdukları konularla etiketleyerek daha kişiselleştirilmiş mesajlaşma sunun — alaka düzeyini, tıklamaları ve memnuniyeti artırın. Örnek kullanım durumları:
  • Bir moda sitesinde, bir kullanıcı yalnızca erkek ayakkabılarıyla ilgileniyor — kadın elbiseleriyle değil.
  • Bir haber uygulamasında, bir kullanıcı sürekli olarak finans ve spor makalelerini ziyaret ediyor — ancak hiçbir zaman eğlence veya siyaset konularını.

1. Konu taksonomisini tanımlayın

Takip etmek istediğiniz içerik kategorilerini veya konuları belirleyerek başlayın. Bunlar şunlar olabilir:
  • sports, finance veya entertainment gibi geniş dikeyler
  • laptops, accessories veya premium gibi ürün türleri
  • Yazarlar veya markalar
  • Yönetimi basit tutmak için 3-8 konuyla başlayın.
  • Şişkinliği önlemek için toplam 20 konunun altında kalın.

2. Konu ziyaretlerini takip etmek için kod ekleyin

Aşağıdaki örnekler üç şey yapar:
  • Her sayfa veya ekranda bir veya daha fazla konuyu takip eder.
  • Konu her görüntülendiğinde ziyaret sayısını artırır.
  • Her görüntülemede güncellenmiş sayımla kullanıcıyı etiketler.
const topics = ["sports", "entertainment"]; // One or many

if (typeof localStorage !== "undefined" && Array.isArray(topics)) {
  topics.forEach(topic => {
    let count = parseInt(localStorage.getItem(topic), 10);
    count = isNaN(count) ? 1 : count + 1;
    localStorage.setItem(topic, count);
    OneSignal.User.addTag(topic, count.toString());
  });
}

3. Segmentleyin ve kişiselleştirilmiş mesajlar gönderin

Etiketler kullanıcılara uygulandıktan sonra, bunları şunları kullanarak hedefleyebilirsiniz:
  • Kural tabanlı gruplar oluşturmak için Segmentler (örn. gaming >= 3 olan kullanıcılar).
  • Tek bir kampanyaya dinamik olarak kullanıcı eklemek için API Filtreleri.
Örnek kullanım durumları:
  • Yalnızca ilgili sayfaları 5 veya daha fazla ziyaret etmiş kullanıcılara belirli konular hakkında mesaj gönderin.
  • Belirli bir yazardan 3’ten fazla gönderi okumuş kullanıcılara gönderileri tanıtın.
  • Belirli bir ürün kategorisine dönmeye devam eden alışverişçilere indirimler sunun.

En iyi uygulamalar

Yapın:
  • Kampanyaları başlatmadan önce console.log() (web) veya platformunuzun logger’ını kullanarak etiket mantığınızı test edin.
  • Sayfalar arasında tutarlı konu adlandırma kuralları kullanın.
  • Her sayfayı düzenlemeden ayarlayabilmeniz için konu listesini merkezi bir yerde (yapılandırma dosyası veya uzaktan yapılandırma) tutun.
Kaçının:
  • Uzun veya aşırı spesifik etiket anahtarları (tam makale başlıkları, uzun URL’ler).
  • OneSignal’ın etiket sınırlarını aşmaktan.
  • Kişisel olarak tanımlanabilir bilgilerle (PII) etiketleme yapmaktan.

Abonelikte etiketle (tek seferlik, yalnızca web)

Web push abonelerini — abone oldukları sayfa konusu veya URL yolu gibi — bağlamsal verilerle etiketleyerek hedefli takip kampanyaları sunun. Bu kalıp opt-in’i tespit eder, etiketleri uygular ve damla tarzı mesajlaşma için segmentleri besler.

1. Opt-in sırasında kullanıcıları etiketleyin

Bir kullanıcı push bildirimlerine abone olduğunda, opt-in’i tespit etmek ve görüntüledikleri sayfa hakkında bağlamsal veri içeren etiketler uygulamak için PushSubscription change dinleyicisini kullanın.
function pushSubscriptionChangeListener(event) {
  if (event.current.optedIn && !event.previous.optedIn) {
    // User just opted in — tag with subscription context
    var pathSegment = window.location.pathname.split('/')[1] || 'home';
    var pageTopic = document.querySelector('meta[name="article-topic"]')?.content || 'general';

    OneSignal.User.addTags({
      subscription_page: pathSegment,
      subscription_page_topic: pageTopic,
    });
  }
}

OneSignalDeferred.push(function(OneSignal) {
  OneSignal.User.PushSubscription.addEventListener("change", pushSubscriptionChangeListener);
});
Bu nasıl çalışır:
  • change olayı, kullanıcının push abonelik durumu değiştiğinde (opt-in, opt-out, token yenileme) tetiklenir.
  • Kullanıcının aktif bir aboneliği olduğunda event.current.optedIn true’dur. !event.previous.optedIn kontrolü, etiketlerin her durum değişikliğinde değil yalnızca ilk opt-in’de uygulanmasını sağlar.
  • window.location.pathname.split('/')[1], abonelik bağlamı olarak ilk yol segmentini yakalar. Örneğin, URL https://example.com/gaming/article-123 ise, subscription_page etiketi gaming olarak ayarlanır.
  • pageTopic, bir <meta> etiketinden çıkarılır ve 'general' değerine geri düşer. Sitenizin meta veri yapısına uyacak şekilde ayarlayın.

2. Kullanıcıları etikete göre segmentleyin

Etiketler uygulandıktan sonra, bu etiketlere dayalı kullanıcıları hedeflemek için Segmentler veya API Filtreleri’ni kullanın. Örneğin:
  • subscription_page’in gaming olduğu kullanıcılara bir kampanya gönderin.
  • Etiket değerlerine ve zamanlamaya göre dinamik segmentler oluşturun (örn. ilk oturumdan bu yana geçen saatler).

3. Takip mesajlaşmasını otomatikleştirin

Kullanıcının ne zaman abone olduğuna ve hangi içerik altında abone olduğuna göre mesajları tetikleyen damla tarzı kampanyalar oluşturun. Örnek: Oyun aboneleri için damla kampanyası
Segment AdıFiltrelerAçıklama
Gaming 1subscription_page = gaming AND First Session > 2h AND < 24hAbonelikten 2–24 saat sonra ulaşın.
Gaming 2subscription_page = gaming AND First Session > 24h AND < 48h1 gün sonra takip edin.
Gaming 3subscription_page = gaming AND First Session > 72h AND < 96h3 gün sonra son kontrol.
Mesajlaşma penceresi geçtiğinde kullanıcıların segmentlerde kalmasını önlemek için üst zaman sınırlarını (<) kullanın.

4. Segmentleri mesaj şablonlarıyla birleştirin

Segmentler oluşturulduktan sonra:
  • Kampanyadaki her aşama için Şablonlar oluşturun (tanıtım, hatırlatma, promosyon).
  • Kullanıcılar uygun segmente girdiğinde bu mesajları göndermek için Journey’leri kullanın.
Örnek mesaj fikirleri:
  • Bir oyun topluluğuna veya sosyal gruba davet.
  • Konularıyla ilgili trend makaleleri önerin.
  • Özel bir teklif veya indirim kodu gönderin.

En iyi uygulamalar

  • Gerçek kullanıcı niyetini yansıtan anlamlı etiket adları ve değerleri kullanın.
  • Mümkün olduğunda sayfa meta verilerinden etiket değerlerini dinamik olarak çıkarın.
  • Yalnızca ilk opt-in’de etiketleyin — yukarıdaki dinleyici örneği, her durum değişikliğinde yeniden etiketlemeyi önlemek için !event.previous.optedIn’i kontrol eder.
Etiket değerlerine ad veya e-posta adresi gibi kişisel olarak tanımlanabilir bilgiler (PII) eklemeyin. Tüm sitenizde etiket değerlerini sabit kodlamaktan kaçının — bunları sayfa bağlamından dinamik olarak çıkarın.

SSS

Hangi kalıbı kullanmalıyım?

Zaman içinde davranışsal ilgi profili oluşturmak için sayfa konusuna göre etiketle’yi kullanın. Sayaç her ziyaretle artar, böylece segmentler etkileşim derinliğine (gaming >= 5) göre ayarlanabilir. Opt-in sırasında tek bir zaman noktası atıfını yakalamak için abonelikte etiketle’yi kullanın; kullanıcıların uzun bir ziyaret geçmişine sahip olmadan önce, abone oldukları yere tepki vermek istediğiniz kaynak farkındalıklı karşılama mesajlaşması için yararlıdır. Her iki kalıp da aynı sitede yan yana çalışabilir — farklı etiketler ayarlarlar ve farklı sorulara yanıt verirler.

Kullanıcı tarayıcı verilerini temizlerse etiketler devam eder mi?

Hayır. Web’de tarayıcı verilerini temizlemek yeni bir Abonelik oluşturur ve localStorage içinde saklanan konu başına sayaçlar da onunla birlikte sıfırlanır. Kullanıcı yeniden abone olursa (manuel olarak veya otomatik yeniden abonelik aracılığıyla), change dinleyicisi tekrar tetiklenir ve mevcut sayfaya göre abonelik etiketini yeniden uygular, ancak ziyaret sayaçları sıfırdan başlar.

İlk abonelikten sonra etiketleri güncelleyebilir miyim?

Evet. Etiket eklemek veya güncellemek için istediğiniz zaman OneSignal.User.addTag() veya OneSignal.User.addTags()’i çağırabilirsiniz. Abonelik dinleyicisi ilk bağlam için kullanışlıdır, ancak süregelen davranışa göre de kullanıcıları etiketleyebilirsiniz.

Mesaj olay filtreleri yerine bu kalıpları kullanmalı mıyım?

Farklı amaçlara hizmet ederler. Kullanıcının ziyaret ettiği veya abone olduğu sayfalara göre segmentlemek istediğinizde — yani sitenizde veya uygulamanızda ortaya çıkan sinyal — bu sayfadaki kalıpları kullanın. Kullanıcının hangi OneSignal mesajlarıyla etkileşim kurduğuna (teslim edildi, tıklandı vb.) göre segmentlemek istediğinizde Mesaj olay filtreleri’ni kullanın. Birbirlerini tamamlarlar, gereksiz değildirler.

Abonelik kaynağı kalıbı mobilde çalışıyor mu?

Doğrudan değil. PushSubscription.addEventListener("change", ...) API’si yalnızca web içindir. iOS ve Android’de, opt-in akışınızın içinden addTag çağırarak benzer bir atıf elde edebilirsiniz — örneğin, kullanıcı bir izin istemini kabul ettikten hemen sonra, bulundukları ekran veya özellikle etiketleyin.

İlgili sayfalar

Etiketler

Kişiselleştirme ve segmentasyon için kullanıcılara özel özellikler ekleyin.

Segmentler

Hedefli mesajlaşma için kullanıcıları özellikler, etiketler ve davranışa göre gruplandırın.

Web SDK Referansı

Abonelik dinleyicileri ve etiketleme yöntemleri dahil OneSignal Web SDK’sının tam referansı.

Mobil SDK Referansı

Etiketleme yöntemleri dahil OneSignal Mobil SDK’sının tam referansı.

Journey'ler

Segment girişi veya özel olaylar tarafından tetiklenen çok adımlı mesajlaşma iş akışları oluşturun.