Dokümantasyonumuzu sürekli güncel tutuyoruz, ancak bazı güncellemeler henüz tüm dillerde yayınlanmamış olabilir. En güncel bilgiler için lütfen İngilizce versiyonuna göz atın.

Segment'in bağımsız entegrasyonunun yapılandırılması

Segment, Adjust'ın analitik partnerlerinden biridir. Bağımsız entegrasyon ile Adjust SDK ve Segment SDK birbirinden bağımsız olarak çalışır. Bu çözümü kullanarak, deeplink'ler gibi ek Adjust SDK özelliklerini daha kolay kullanabilirsiniz.

Nasıl çalışır

Adjust SDK ve Segment SDK birbirinden bağımsız olarak çalıştığında kullanıcı aktivitesi aşağıdaki şekilde kaydedebilir:

  1. Uygulama doğrudan Adjust SDK'yı başlatır.
  2. Adjust SDK install'ları, session'ları ve reattribution'ları otomatik olarak kaydeder.
  3. Segment SDK, event'leri kaydeder ve Segment sunucusu bunları S2S event'leri olarak Adjust sunucusuna Cloud Modunda gönderir.
  4. Adjust sunucusu, Segment sunucusuna bir install callback gönderir. Segment ise bu install callback'ini Install Attributed adında bir track event'i olarak kaydeder.

Entegrasyonun yapılandırması

Segment ile bağımsız Adjust SDK çözümünü yapılandırmak için bu adımları takip edin.

1. Adjust ve Segment SDK'larını yapılandırın

Adjust SDK ve Segment SDK'nın yapılandırılmasına dair yönergeler için platformunuza özel geliştirici dokümantasyonuna göz atın:

📖 iOS / Android

2. Segment'i Adjust'ta etkinleştirin

Adjust'ta Segment kurmak için aşağıdaki adımları takip edin.

WRITE KEY bulmak için Segment dökümantasyonunu inceleyin.

Segment artık install aktiviteleri için callback'ler alacaktır.

3. Segment'te Adjust hedeflerini oluşturun ve Adjust app token'larını ekleyin

Segment dashboard'unda Adjust'ı bir hedef olarak eklemek için bu adımları takip edin.

  1. Destinations > Add Destination 'ı seçin.
  2. Adjust'ı aratın.
  3. Adjust 'ı kaynağınıza bir hedef olarak ekleyin.

Adjust hedeflerine Adjust app token'larını eklemek için bu adımları takip edin.

  1. Destinations 'ı seçin ve Adjust hedefinizi seçin.
  2. App Token 'ı seçin ve AppView'daki app token'ını girin.
  3. KAYDET 'i seçin.

Adjust'taki uygulama yapılandırmanıza bağlı olarak, Adjust hedeflerini kaynaklarınızla nasıl bağlayacağınızı bulmak için aşağıdaki tabloyu kullanabilirsiniz.

Segment SDK kullanıldığındaAdjust uygulama yapılandırmasıSegment dashboard'unda Adjust hedefi
Segment Android SDK ve Segment iOS SDKMultiplatform uygulama (iOS ve Android uygulamaları için aynı app token) 
  1. iOS kaynağına ve Android kaynağına bir Adjust hedefi ekleyin. 
  2. İki hedefi de aynı Adjust token'ı ile yapılandırın.
Segment Android SDK ve/veya Segment iOS SDKFarklı app token'larına sahip iOS ve/veya Android uygulamaları
  1. Mümkünse her kaynağa bir Adjust hedefi ekleyin.
  2. Her hedefi ilgili Adjust token'ı ile yapılandırın.
Segment React Native SDKMultiplatform uygulama (iOS ve Android uygulamaları için aynı app token)
  1. React Native source'a bir Adjust hedefi ekleyin.
  2. Hedefi app token ile yapılandırın.
Segment React Native SDKFarklı app token'larına sahip iOS ve Android uygulamaları 
  1. React Native kaynağına iOS için bir Adjust hedefi ve Android için bir Adjust hedefi ekleyin.
  2. Her hedefi ilgili app token ile yapılandırın.

4. Adjust'ta event token'ları oluşturun

Bu adımda Segment dashboard'undaki event'lerinizi gözden geçirin ve hangi event'leri Adjust'a bağlamak istediğinizi belirleyin.

Adjust'a bağlamak istediğiniz her Segment track call'una karşılık gelen bir Adjust event token oluşturun ve event token'ı kopyalayın.

Dikkat:

Bu çözüm, partner parametrelerini desteklemez. Ancak bazı değerleri Adjust SDK'ya göndermek için oturum partner parametreleri gereklidir. Platformunuz için geliştirici dokümantasyonumuza göz atın:


📖 iOS / Android

Ağlarınıza özel parametrelere sahip event'ler göndermeniz gerekiyorsa (örneğin dinamik retargeting desteği için), bu event'leri Segment SDK ve Adjust SDK'da ayrı ayrı yapılandırmalısınız.Segment dashboard'undaki bu event'leri Adjust'taki hedeflere bağlamayın.

5. Adjust event token'larını Segment'e girin

  1. Segment dashboard'unda Destinations seçeneğini ve ardından Adjust hedefinizi seçin.
  2. Map Your Events to Custom Adjust Event Tokens 'ı seçin ve Adjust dashboard'dan kopyaladığınız event token'larını girin.
    Her Segment track event'inin adının Adjust event token ile birebir aynı olması gerekir. Aynı Adjust event token'a farklı isimlere sahip Segment track call'ları bağlamayın.
  3. KAYDET 'i seçin.

6. Segment'teki ek ayarları yapılandırın

  1. Segment dashboard'unda Destinations seçeneğini ve ardından Adjust hedefinizi seçin.

  2. Track Attribution Data ayarına gidin ve bunu ON olarak seçin.

  3. Send Event Creation Time ayarına gidin ve gerekli seçeneği seçin:

    • ON - Segment created_at_unix zamanını S2S event'lerinde gönderir. Ancak Segment, event'lerin created_at_unix'e göre kronolojik sırayla gönderileceğini garanti etmez, bu nedenle Adjust sunucusu bazı event'leri reddedebilir.
    • OFF - Segment created_at parametresini S2S event'lerinde göndermez. Adjust sunucusu, event'leri kronolojik nedenlerden dolayı reddetmeyecektir. Bunun yerine, created_at timestamp'ini dahili olarak received_at timestamp'ine eşit olarak ayarlar. Yani bu, created_at timestamp'inin, cihazın event'i Segment SDK'da tam olarak ne zaman tetiklediğinin göstergesi olmayabileceği anlamına gelir.

  4. Adjust Settings'i ekranın üst kısmında bulabilirsiniz. Destination'ı etkinleştirmek için anahtarı ON konumuna getirin.

Entegrasyonu Production ortamında başlatmaya hazır olduğunuzda, Send to Production Environment on Adjust anahtarını ON konumuna getirin.

A screenshot from the Segment dashboard of how to configure your Adjust settings.

Segment'e gönderilen parametreler

Adjust callback'lerinde Segment'e gönderilen parametrelerin listesi:

PlaceholderBilgi
[anonymous_id]Segment anonymous_id
{adgroup_name}Adgroup adı, link'ten alındığı gibi
{campaign_name}Kampanya adı, link'ten alındığı gibi
{creative_name}Kreatif adı, link'ten alındığı gibi
{network_name}Ağ adı, link'ten alındığı gibi
{tracker_name}Şu andaki link adı