OneSignal

OneSignal, push bildirimleri, e-posta, SMS ve uygulama içi mesajlaşma sunan önde gelen bir müşteri etkileşim platformudur. Adapty ile OneSignal’ı entegre ederek tüm abonelik olaylarınıza tek bir yerden erişebilir ve bu olaylara dayalı otomatik iletişimler tetikleyebilirsiniz.

Adapty ile birden fazla mağazadaki abonelik olaylarını takip edebilir, kullanıcı davranışını analiz edebilir ve daha hedefli iletişim için bu verilerden yararlanabilirsiniz. Bu entegrasyon, OneSignal kontrol panelinizdeki abonelik olaylarını izlemenize ve bunları edinim kampanyalarınıza eşlemenize olanak tanır.

Adapty, abonelik olaylarına göre OneSignal etiketlerini güncelleyerek minimum kurulumla kişiselleştirilmiş push bildirimleri göndermenizi sağlar.

Entegrasyon özellikleri

OneSignal entegrasyonunu kurma

Entegrasyonu kurmak için:

1. Adapty Kontrol Paneli’nde Integrations → OneSignal sayfasını açın.

   

2. Entegrasyon geçişini etkinleştirin.

3. OneSignal App ID’nizi girin.

OneSignal entegrasyonunu kurmak için Adapty kontrol panelinizde Integrations -> OneSignal sayfasına gidin, geçişi açın ve entegrasyon kimlik bilgilerini yapılandırın.

OneSignal App ID’nizi alma

OneSignal App ID’nizi OneSignal Dashboard’da bulun:

1. Settings → Keys & IDs bölümüne gidin.

   

2. OneSignal App ID’nizi kopyalayın ve Adapty Kontrol Paneli’ndeki App ID alanına yapıştırın.

   

OneSignal ID hakkında daha fazla bilgiye bu dokümantasyondan ulaşabilirsiniz.

Olayları yapılandırma

Adapty, OneSignal’a üç grup olay göndermenize olanak tanır. İhtiyacınız olanları Adapty Kontrol Paneli’nden açın. Mevcut olayların tamamını ayrıntılı açıklamalarıyla buradan görüntüleyebilirsiniz.

Adapty, abonelik olaylarını sunucudan sunucuya entegrasyon aracılığıyla OneSignal’a göndererek tüm abonelikle ilgili aktivitelerinizi OneSignal’da takip etmenizi sağlar.

Özel etiketler

Bu entegrasyon, Adapty kullanıcılarınıza çeşitli özellikleri etiket olarak atar ve günceller; bu etiketler daha sonra OneSignal’a gönderilir. İhtiyaçlarınıza en uygun olanları bulmak için aşağıdaki etiket listesine bakın.

Tüm ondalıklı değerler tam sayıya yuvarlanır. Dizeler değişmeden kalır.

Önceden tanımlanmış etiketlere ek olarak, özel nitelikleri etiket olarak gönderebilir ve dahil ettiğiniz verilerde daha fazla esneklik sağlayabilirsiniz. Bu, ürününüz veya hizmetinizle ilgili belirli ayrıntıları takip etmek için kullanışlıdır.

Özel kullanıcı nitelikleri, entegrasyon sayfasında Send user attributes onay kutusu etkinleştirildiğinde otomatik olarak OneSignal’a gönderilir. İşaret kaldırıldığında Adapty tam olarak 10 etiket gönderir. İşaretlendiğinde ise 10’dan fazla etiket gönderilebilir, bu da daha gelişmiş veri yakalamaya olanak tanır.

SDK yapılandırması

OneSignal ile Adapty’yi entegre etmenin iki yolu vardır:

1. Eski yöntem (v5 öncesi): OneSignal SDK v5’te kullanımdan kaldırılan playerId kullanır.
2. Güncel yöntem (v5+): subscriptionId kullanır.

// SubscriptionID
OneSignal.Notifications.requestPermission({ accepted in
    Task {
        try await Adapty.setIntegrationIdentifier(
            key: "one_signal_subscription_id", 
            value: OneSignal.User.pushSubscription.id
        )
    }
}, fallbackToSettings: true)

// SubscriptionID
val oneSignalSubscriptionObserver = object: IPushSubscriptionObserver {
    override fun onPushSubscriptionChange(state: PushSubscriptionChangedState) {
        Adapty.setIntegrationIdentifier("one_signal_subscription_id", state.current.id) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
}

// SubscriptionID
IPushSubscriptionObserver oneSignalSubscriptionObserver = state -> {
    Adapty.setIntegrationIdentifier("one_signal_subscription_id", state.getCurrent().getId(), error -> {
        if (error != null) {
            // handle the error
        }
    });
};

// 1. Since OneSignal.User.pushSubscription.id may return null if called too early, 
// OneSignal suggests to listen for the updates:

OneSignal.User.pushSubscription.addObserver((state) {
   if (state.current.optedIn) {
      // now you can try to retrieve subscriptionId
   }
});

// 2. Then you can push subscriptionId to Adapty:
final subscriptionId = OneSignal.User.pushSubscription.id;
if (subscriptionId != null) {
   await Adapty().setIntegrationIdentifier(key: "one_signal_subscription_id", value: subscriptionId);
}

using AdaptySDK;
using OneSignalSDK;

var pushUserId = OneSignal.Default.PushSubscriptionState.userId;

Adapty.SetIntegrationIdentifier(
  "one_signal_player_id", 
  pushUserId, 
  (error) => {
  // handle the error
});

OneSignal.User.pushSubscription.addEventListener('change', (subscription) => {
  const subscriptionId = subscription.current.id;

  if (subscriptionId) {
    adapty.setIntegrationIdentifier("one_signal_subscription_id", subscriptionId);
  }
});

// PlayerID
// in your OSSubscriptionObserver implementation
func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
    if let playerId = stateChanges.to.userId {
        Task {
            try await Adapty.setIntegrationIdentifier(
                key: "one_signal_player_id", 
                value: playerId
            )
        }
    }
}

// PlayerID
val osSubscriptionObserver = OSSubscriptionObserver { stateChanges ->
    stateChanges?.to?.userId?.let { playerId ->
        Adapty.setIntegrationIdentifier("one_signal_player_id", playerId) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
}

// PlayerID
OSSubscriptionObserver osSubscriptionObserver = stateChanges -> {
    OSSubscriptionState to = stateChanges != null ? stateChanges.getTo() : null;
    String playerId = to != null ? to.getUserId() : null;
    
    if (playerId != null) {
        Adapty.setIntegrationIdentifier("one_signal_player_id", playerId, error -> {
            if (error != null) {
                // handle the error
            }
        });
    }
};

// PlayerID (pre-v5 OneSignal SDK)
// in your OSSubscriptionObserver implementation
func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
    if let playerId = stateChanges.to.userId {
        Task {
            try await Adapty.setIntegrationIdentifier(
                key: "one_signal_player_id", 
                value: playerId
            )
        }
    }
}

OneSignal.addSubscriptionObserver(event => {
  const playerId = event.to.userId;
  
  adapty.setIntegrationIdentifier("one_signal_player_id", playerId);
});

OneSignal dokümantasyonunda daha fazla bilgi edinin:

• Push abonelik ID’si
• Push abonelik değişiklikleri

Birden fazla cihazı yönetme

Bir kullanıcının birden fazla cihazı varsa satın alma olaylarını ve abonelikleri takip etmek güçleşebilir. OneSignal, bunu harici kullanıcı ID’leri aracılığıyla yönetmenin bir yolunu sunar.

Kullanıcı verilerini cihazlar arasında tutarlı tutmak için:

1. Sunucu tarafında farklı cihazları eşleştirin ve bu verileri OneSignal’a gönderin.
2. OneSignal’da Adapty’nin customer_user_id’sini externalUserId olarak kullanın. Uygulamanızın bir kayıt sistemi yoksa, kullanıcının cihazları arasında tutarlı kalan başka bir benzersiz tanımlayıcı kullanmayı düşünün.

Kullanıcı tanımlayıcısının tüm cihazlarda tutarlı olmasını sağlamak ve bir kullanıcının ID’si değiştiğinde OneSignal’ı güncellemek önemlidir. Bu, kullanıcı aktivitesini ve abonelikleri takip etmeyi kolaylaştırır, tutarlı mesajlaşma sağlar ve daha doğru analizler ile daha iyi bir kullanıcı deneyimine olanak tanır. Daha fazla ayrıntı için OneSignal’ın harici kullanıcı ID dokümantasyonuna bakın.