Adjust - OneSignal

Adjust, pazarlama kanallarınız genelinde yüklemeleri, oturumları ve uygulama içi olayları ilişkilendiren bir mobil ölçüm ortağıdır (MMP). Bu entegrasyon, OneSignal External ID’sini Adjust’a onesignal_customer_id partner parametresi olarak iletir; böylece Adjust, OneSignal’a ilettiği olayları doğru kullanıcıyla eşleştirebilir.

Gereksinimler

OneSignal mobil SDK sürüm 5.5.0 veya üzeri.
OneSignal kullanıcısında ayarlanmış bir External ID. Adjust ile OneSignal arasındaki veri senkronizasyonları bu ID’ye göre yapılır, bu nedenle entegrasyon anonim kullanıcılar için olayları ilişkilendiremez.

Kurulum

Adjust callback’lerinin doğru OneSignal kullanıcısına ulaşması için iki şeyin yerinde olması gerekir: Adjust’ın olayları OneSignal’a iletecek şekilde yapılandırılmış olması ve uygulamanızın her oturumda External ID’yi partner parametresi olarak eklemesi.

1. Adjust panelinde veri paylaşımını etkinleştirin

Adjust panelinizde OneSignal entegrasyonunu etkinleştirin ve hangi olayların iletileceğini seçin. Adjust varsayılan olarak install ve session etkinliğini gönderir; ayrıca özel olayları ve uygulama içi geliri eşleştirebilirsiniz. Tam adımlar için Adjust’ın Set up OneSignal kılavuzunu izleyin.

Bu panel adımı olmadan Adjust, OneSignal’a hiçbir zaman callback göndermez; dolayısıyla sonraki adımdaki SDK kodunun onesignal_customer_id parametresini ekleyeceği hiçbir şey olmaz.

2. External ID’yi partner parametresi olarak iletin

Bir kullanıcı uygulamanızda oturum açtığında, External ID’yi ayarlamak için OneSignal’ın login metodunu çağırın; ardından Adjust’ın addGlobalPartnerParameter metodunu onesignal_customer_id anahtarı ve aynı External ID’yi değer olarak vererek çağırın. Adjust bu anahtar–değer çiftini sonraki her callback’te iletir ve OneSignal, callback’i doğru kullanıcıyla eşleştirmek için onesignal_customer_id’yi kullanır.

iOS dışındaki her Adjust SDK’sı (key, value) argüman sırasını kullanır. iOS Swift ve Objective-C ise (value, forKey: key) sırasını kullanır. External ID’yi yanlışlıkla anahtar olarak geçirmek entegrasyonu sessizce bozar: Adjust, kullanıcı ID dizenizin adıyla bir parametre iletir ve OneSignal onesignal_customer_id’yi hiçbir zaman görmez.

val externalId = "your_user_id"
OneSignal.login(externalId)
Adjust.addGlobalPartnerParameter("onesignal_customer_id", externalId)

Alttaki Adjust SDK referansı için Adjust’ın Android ve iOS için Global Partner Parameters dokümanlarına bakın.

Deep linking

Adjust, push dokunmalarını uygulamanızdaki belirli ekranlara yönlendirmek için iOS Universal Links ve Android App Links kullanır. Bir Adjust deep link’ini açması gereken OneSignal bildirimleri gönderirken, Adjust’ın Push Notifications kılavuzunda anlatıldığı gibi bildirimin Launch URL’sini Adjust deep link’ine ayarlayın. Launch URL’lerin platformlar arasında nasıl ele alındığını görmek için OneSignal’ın Deep linking kılavuzuna bakın.

FAQ

`onesignal_customer_id` partner parametresi nedir?

onesignal_customer_id, OneSignal’ın bir Adjust olayını bir OneSignal kullanıcısıyla ilişkilendirmek için Adjust callback’lerinde okuduğu tam anahtardır. Değerini OneSignal.login’a ilettiğiniz External ID ile aynı olarak ayarlayın. Başka herhangi bir anahtar adı tanınmayacaktır.

`Adjust.addGlobalPartnerParameter`’ı ne zaman çağırmalıyım?

OneSignal.login’ı çağırdığınız her seferde çağırın: uygulama başlangıcında kullanıcı ID’si bilinir bilinmez ve hesap değişikliklerinde tekrar. Bu, OneSignal’ın login rehberliğini yansıtır ve Adjust partner parametresini geçerli OneSignal kullanıcısıyla senkronize tutar.

Bir kullanıcı oturumu kapattığında veya hesap değiştirdiğinde ne olur?

Adjust, siz değiştirene veya kaldırana kadar global partner parametrelerini bellekte tutar. Oturum kapatıldığında Adjust.removeGlobalPartnerParameter("onesignal_customer_id")’yi çağırın (veya bir sonraki oturum açmada değerin üzerine yazın). Aksi takdirde Adjust, sonraki olayları önceki kullanıcının External ID’sine atfetmeye devam eder.