Segment (Twilio)

OneSignal Segment entegrasyon genel bakışı

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 şu anda beta aşamasındadır. Erişim talep etmek için support@onesignal.com ile şunları paylaşarak iletişime geçin:

Şirket adınız
OneSignal Organizasyon ID’niz
Etkinleştirmek istediğiniz Uygulama ID’si/ID’leri

Ö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 In kimlik doğrulama ayarları

Authenticate’e tıkladığınızda, bir Segment.com web sayfası açılacak ve Segment.com hesabınıza giriş yapmanız istenecektir. Ardından Segment.com hesabınızdan yeni bir veri hedefi yapılandırmanız istenecektir.

Segment kurulum yapılandırma ekranı

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.

Data Out API key yapılandırması

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

Segment'te OneSignal hedef yapılandırması

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 Segment.com Kaynağı

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:

Kullanıcı identify çağrısı örneği

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]
)

Track çağrısı özellikleri örneği

Kullanıcı özellikleri arayüzü

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

Persona audience ve computed traits arayüzü

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).

Segment'ten OneSignal'de oluşturulan segmentler

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 Hardbounced	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.

İlk adımlar & ayarlar

Mesaj kanalları

Journey'ler

Hedeflenen & özel olaylar

Analitik ve Entegrasyonlar

Gizlilik & Güvenlik

Genel bakış

Gereksinimler