Genel bakış
OneSignal + Segment entegrasyonu şunları yapmanıza olanak tanır:
- Kullanıcı profillerini zenginleştirmek, segmentasyonu güçlendirmek ve mesajlaşmayı tetiklemek için Segment’ten OneSignal’e kullanıcı özellikleri ve olayları gönderin.
- Merkezi analitik ve veri ambarlama için OneSignal’den Segment’e mesaj teslimi ve etkileşim olaylarını gönderin.
Bu çift yönlü kurulum, tüm büyük OneSignal kanallarını destekler: Push, In-App, Email ve SMS.
Gereksinimler
- Growth, Professional veya Enterprise OneSignal Hesabı.
- Segment Yönetici İzinleri
- Veri göndermek istediğiniz OneSignal Mobile SDK ve/veya Web SDK. Yalnızca Email veya SMS entegrasyonları SDK gerektirmez.
- Segment.com
userId’ye eşlenen OneSignal Özelliği: External ID.
Kurulum
1. OneSignal’i kurun
OneSignal dashboard’unda mevcut bir uygulamayı kullanın veya yeni bir tane oluşturun. Ardından tercih ettiğiniz kanalları kurun:
2. Segment’i OneSignal’e bağlayın
OneSignal Dashboard’da, Data > Integrations’a gidin ve Segment.com kartı içinde Active’e tıklayın. Ardından kurulum seçenekleriyle devam edin.
Data in
OneSignal’e “Data In”, Segment.com hesabınızdan OneSignal’e OneSignal segments, tags ve custom events göndermenizi sağlar. OneSignal Dashboard’daki Segment.com ayar sayfasının Data In bölümünde Authenticate’e tıklayın.
Özel olayları izlemek için etkinleştirildikten sonra, Segment.com entegrasyonu hem Data Tags hem de Events gönderecektir, bu nedenle veri etiketlerine referans veren mevcut şablonları güncellemenize gerek kalmayacaktır.
Data out
Segment.com’a “Data Out” etkinleştirmek, OneSignal platformunda kullanıcılarınıza mesaj göndermekten oluşturulan mesaj olaylarını Segment.com hesabınıza geri senkronize eder. Ne tür olayların oluşturulabileceği ve hangi özelliklerle gönderildikleri hakkında daha fazla ayrıntı aşağıda bulunabilir.
İlk olarak, Segment.com hesabınızdan OneSignal’i kaynak olarak eklemeniz gerekir. Bunu, Segment Connections Catalogue’daki OneSignal Source listeleme’ye giderek yapabilirsiniz.
Oradan, OneSignal Dashboard’a Segment.com API token’ınızı ekleyebilirsiniz. Segment API anahtarını eklemek için lütfen OneSignal Dashboard’da Data > Integrations > Segment’e gidin.
API anahtarını kurduktan sonra, lütfen olayları Segment’in AB Yerleşim Endpoint’ine göndermeniz gerekip gerekmediğini belirlemek için Segment.com’daki Data Policy ayarlarınızı kontrol ettiğinizden emin olun.
Tüm bu ayarlar tamamlandıktan sonra, OneSignal ile kullandığınız kanallara bağlı olarak Segment Hesabınıza hangi olayları senkronize etmek istediğinizi seçebilirsiniz.
3. Segment’te OneSignal hedefi ekleyin
Segment.com Dashboard > Destinations içinde OneSignal’i görmelisiniz. Görmüyorsanız, OneSignal’i yeni bir hedef olarak ekleyin.
OneSignal Destination’ı etkinleştirin, OneSignal API Key ve App ID’nizi zaten görmelisiniz
API anahtarı ve App Id ayarlanmamışsa, OneSignal dashboard’a gidin, Uygulamayı seçin ve Settings > Keys & IDs’e gidin. “App ID” ve “API key“‘i kopyalayıp Segment.com’a yapıştırın.
Birden fazla kaynağınız varsa, birden fazla kaynağı bir hedefe bağlamak için Segment’in Personas > Spaces özelliğini kullanabilirsiniz.
4. Segment’ten OneSignal’e veri gönderin
OneSignal kanal düzeyinde kayıtlar saklar: Push/IAM, Email ve SMS. Bu kayıtlar OneSignal’de zaten oluşturulmuş olmalıdır ve ayrıca OneSignal’deki External ID takma adını Segment.com tarafından gönderilen userID alanıyla eşleşecek şekilde ayarlamalısınız.
Segment User ID <—> OneSignal External ID eşleşmesi olmayan kayıtlar düşürülecektir.
Kullanıcı özellikleri
Segment’teki her müşteri temas noktasında verileri toplayabilir ve ardından bu kullanıcı özelliklerini gerçek zamanlı olarak OneSignal’e Data Tags olarak gönderebilirsiniz.
Not: OneSignal, kullanıcı özellikleri olarak iç içe nesneleri veya dizileri kabul edemez.
Identify - Segment’in Identify çağrısı kullanılarak gönderilen kullanıcı özellikleri veya özellikleri, OneSignal’de veri etiketleri olarak saklanır. Örneğin:
Track - Segment’in Track çağrısı kullanılarak gönderilen olaylar ve ilişkili özellikler için, OneSignal tüm olay özelliklerini veri etiketleri olarak saklayacak, ancak etiketleri saklarken olay adını düşürecektir. Olay adlarını veri etiketlerinde tutmak istiyorsanız, OneSignal’e göndermeden önce olay adını özelliklere ekleyebilirsiniz. Örneğin:
let timestampInSeconds = Int(NSDate().timeIntervalSince1970).toString()//convert to string since Segment adds decimals to end
//name will be dropped and only properties will be sent to OneSignal as tag "last opened: timestampInSeconds"
analytics.track(
name: "iOS App Last Opened",
properties: ["last opened": timestampInSeconds]
)
Personas Audience ve Computed Traits
Persona Audiences, OneSignal’de bir segment olarak otomatik olarak görünür.
Computed traits, OneSignal kullanıcı kayıtlarında Data Tags olarak güncellenir.
Audience
Segment’in Track çağrısı kullanılarak gönderilen Audience’lar, Audience Name ile bir OneSignal segmenti oluşturacaktır.
Segment’in Identify çağrısı kullanılarak gönderilen Audience’lar:
- Audience Name ile bir OneSignal segmenti oluşturacaktır
- eşleşen tüm kullanıcı kayıtlarına veri etiketleri ekleyecektir (Identify çağrısında ek özellikler varsa).
Identify ve Track çağrıları, bir kullanıcı Audience’a girdiğinde veya çıktığında otomatik olarak OneSignal’e gönderilir.
Computed Traits Personas Computed Traits, OneSignal’e Identify çağrısı veya Track çağrısı olarak iletilip iletilmediğine bakılmaksızın OneSignal kullanıcı kayıtlarında Data Tags olarak saklanır. Ardından bu veri etiketlerini manuel olarak OneSignal segmentleri oluşturmak ve mesajlaşma iş akışlarınızı otomatikleştirmek için kullanabilirsiniz.
Mesaj Olayları
Olay Türleri
Bunlar, OneSignal’in Segment’e gönderdiği mesaj olayı türleridir
| MessageEvent Türü | Olay Açıklaması |
|---|
| Push Sent | Push bildirimi başarıyla gönderildi |
| Push Received | Push bildirimi başarıyla alındı |
| Push Clicked | Cihazda push bildirimine dokunuldu |
| In-App Message Displayed | In-App Message cihazda başarıyla görüntülendi |
| In-App Message Clicked | Cihazda In-App Message tıklandı |
| In-App Message Page Displayed | In-App Message sayfası görüntülendi |
| Email Sent | E-posta başarıyla gönderildi |
| Email Opened | E-posta alıcı tarafından açıldı |
| Email Unsubscribed | E-posta alıcı tarafından abonelikten çıkıldı |
| Email Received | E-posta alıcı tarafından alındı |
| Email Reported As Spam | E-posta alıcı tarafından spam olarak bildirildi |
| Email Bounced | Kalıcı hata nedeniyle e-posta gönderene geri döndü |
| Email Failed | E-posta alıcının gelen kutusuna teslim edilemedi |
| SMS Sent | SMS alıcıya gönderildi |
| SMS Delivered | SMS başarıyla teslim edildi |
| SMS Failed | SMS gönderilemedi |
Olay Özellikleri
Bunlar, OneSignal’den Segment.com’a gönderilen olaylarda bulunan özelliklerdir
| ÖZELLİK ADI | AÇIKLAMA |
|---|
userId | Mesajla ilişkili external_id |
anonymousId | subscription_id |
messageId | Ayrık mesajın tanımlayıcısı |
campaign_id | messageId ile aynı değer |
message_name | Mesaj adı |
message_title | Mesaj başlığı |
message_contents | Mesaj içeriği |
| |
subscription_type | Mesajın gönderildiği kanal |
template_id | Kullanılan mesaj şablonu |
subscription_id. | OneSignal tarafından ayarlanan cihaz/e-posta/sms tanımlayıcısı |
device_type | Mesajı alan cihaz türü |
language | Cihazın iki karakterlik dil kodu |
message_type | Gönderilen mesaj türü, push, in-app, email, SMS |
SSS
Subscription olaylarını nasıl iletebiliriz?
Subscription olayları şu anda otomatik olarak gönderilmemektedir. Bu, OneSignal SDK Subscription Observer Yöntemleri ile yapılabilir. Daha fazla ayrıntı için Subscription Tracking’e bakın.
Segment’in Ayrılmış ve Özel Kullanıcı Özelliklerini OneSignal’de Yönetme
- Tüm Segment kullanıcı özellikleri, OneSignal’e veri etiketleri olarak gönderilir. OneSignal’de izin verilen veri etiketi sayısı, OneSignal fiyatlandırma planınıza bağlıdır. Hak verilen sayının üzerindeki etiketler düşürülecektir.
- OneSignal her zaman eşleşen kullanıcılar için firstName ve lastName özelliklerini günceller. Diğer tüm özellikler ilk gelen esasına göre eklenir/güncellenir. firstName ve lastName etiketleri “first_name” ve “last_name” olarak saklanır.
- OneSignal’e boş/null değerlerle gönderilen kullanıcı özellikleri, OneSignal kullanıcı kaydından kaldırılır. Bu, veri etiketi limitleriniz içinde olduğunuzdan emin olmak için yapılır.
