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.

Epic Games yapılandırması

Bu makalede bir Epic Games uygulamasının oluşturulmasına, güvenli sunucudan sunucuya (S2S) API bağlantısının kurulmasına ve başarılı bir attribution ölçümlemesi için linklerin yönetimini bulabilirsiniz. Kullanıcılarınız oyununuzu indirmek için Windows veya Mac'te, Epic Games store'u veya kendi özel store'unuzu kullanabilirler.

Epic Games oyunları ölçümlemesini yapılandırmak için yapmanız gerekenler:

  1. AppView'da yeni bir uygulama oluşturun.
  2. Session kaydına başlamak için Adjust'ın S2S API'ını yapılandırın.
  3. Campaign Lab'de linklerinizi yapılandırın.

Epic Games uygulamanızın yapılandırması

Bir PC uygulaması eklemek ve yapılandırmak için bu adımları takip edin.

  1. AppView 'ın altında Tüm uygulamalar 'ı seçin.

  2. Yeni uygulama 'yı seçin.

  3. Uygulama bilgilerinizi girin kısmına uygulamanızın adını girin, raporlama para biriminizi seçin ve uygulamanızın aşağıdakiler ile uyumlu olması gerekip gerekmediğini kontrol edin.

    • COPPA uyumluluğu . Bu, sadece ABD merkezli şirketler için geçerlidir. COPPA uyumluluğuna dair daha fazla bilgiyi burada bulabilirsiniz.
    • Google DMA . Bu, sadece kullanıcı kitlesi Avrupa Ekonomik Alanı (EEA)'nın dışında bulunan uygulamalar için geçerlidir. Google DMA hakkında daha fazla bilgi için buraya göz atın.
  4. Add App 'i seçin.

  5. Oyununuza bir platform bağlamak için Platform ekle seçeneğini seçin.

    1. PC > Epic Games 'i seçin. Windows ve Mac'teki Epic Games store'ları için geçelidir.
    2. App ID 'nizi girin veya Henüz bir App ID'ye sahip değilim seçeneğini seçin.
    3. (Opsiyonel) Kullanıcılarınızı Epic'in app store'u yerine bir web sitesine yönlendirmek istiyorsanız Tüm tıklamaları özel bir URL'e yönlendir anahtarını açık konuma getirin ve bir Özel URL girin. Uygulamanız bir App ID'sine sahip değilse bunu yapmanızı öneririz.
    4. Kaydet 'i seçin.
  1. Ayrıca Uygulama bilgileri kısmında oyununuza dair link'lerin sosyal medya uygulamalarında paylaşıldığında nasıl görüneceğini de özelleştirebilirsiniz.

  2. Oyununuzdaki kullanıcı aktivitesini ölçümlemek için Event'ler sekmesinde bir uygulama-içi event ekleyin.

  3. Attribution ayarları sekmesinde attribution ayarlarını (cihaz eşleştirmesi, olasılıksal modelleme ve geçici attribution için) ve reattribution ayarlarını belirleyin.

    • Olasılıksal modellemenin hem tıklamalar hem de gösterimler için etkin olduğundan emin olun. Olasılıksal modelleme için attribution penceresinin 24 saat olarak ayarlanmasını şiddetle tavsiye ediyoruz ancak 90 güne kadar seçim yapabilirsiniz. 90 gün attribution penceresi sadece PC ve Konsol platformları tarafından kullanılabilir.
  4. Veri yönetimi sekmesinde sunucu callback'lerini ya da bulut depolama upload'larını yapılandırarak kullanıcı seviyesi ham verileri alın, ya da Test konsolu ile test cihazı verilerini inceleyin.

  5. Koruma sekmesinde S2S güvenliğini yapılandırın. S2S API yapılandırmasında bu token gerekecektir.

Adjust S2S API yapılandırması

Kullanıcılarınızın session'larını ve event'lerini ölçümlemeye başlamak ve uygulamanızı herhangi bir kod değişikliği yapmadan Adjust'a bağlamak için Adjust S2S API'ını kullanın.

Yapılandırma sürecine session endpoint'ini kullanarak devam edin.

Başlamadan önce

Adjust sunucusu, sistemin kötüye kullanılmasını veya aşırı yüklenmesini önleyen sıkı tutarlılık kontrollerine sahiptir.S2S attribution sadece tek başına kullanılabilen bir entegrasyondur ve Adjust SDK ile birlikte kullanılamaz.

  • SDK Entegrasyonu yerine bir S2S yapılandırması kullanmanın sınırlamalarını tam olarak anlamak için S2S attribution kontrol listemizi okumadan geçmeyin.
  • Sunucularımıza gönderdiğiniz request'leri cihazda oluşan sıra ile aynı sırayla yapmalısınız.

Doğrulama

S2S Güvenliğini yapılandırarak S2S session güvenliğini garanti altına alabilir ve spoof'lu request'lerden koruyabilirsiniz. Bu, gelen her request'in Adjust dashboard'da oluşturulan bir authentication token'ı taşımasını gerektirir. Bu token'ı taşımayan ya da yanlış token'a sahip request'ler, sunucumuz tarafından reddedilir.

Endpoint

session endpoint'i kullanıcılarınız oyununuzu başlattığında session'ları kaydetmenizi sağlar. Session, kullanıcının oyunu arka plandan devam ettirmesi veya başlatmasıdır, örneğin oyunu çalışır durumda tutarken başka bir uygulamayı açmak veya bir önceki kapanıştan sonra oyunu başlatmak. Adjust sunucuları, kaynakların verimli kullanılması için her 30 dakikada bir yeni session kabul eder.

https://s2s.adjust.com/session

POST header

Authorization : Adjust API'larına call yaptığınızda, Adjust auth token'ınızın değerini gönderirken doğrulama türünü Bearer olarak ayarlayın.

Örnek: Bearer authentication_token

POST Payload

Not:

***** ile işaretli parametreler zorunludur

ParametreVeri TürüİçindeAçıklama
s2s*StringQuerySunucudan sunucuya parametresi: Adjust sunucularının sunucu tarafı aktiviteyi tanımasını sağlar Bu her zaman `1` olarak gönderilmelidir.
app_token*StringQueryUygulamanız için benzersiz auth token
os_name*StringQueryUygulamanızın işletim sistemine göre mevcut olan parametrelerden birini seçin:
  • windows 
  • macos
ip_address*StringQueryCihazın IP adresi
created_at*TimestampQueryYerel cihazın timestamp'i, saat dilimi ile paketin oluşturulması.
external_device_id*StringQueryUnique user_id, örnek: kullanıcının account_id'si ya da enkripsiyonlu e-posta adresi

Request örneği:

cURL
curl -X 'POST' -d 's2s=1&app_token=a1234b2x3a4o&ip_address=0.0.0.0&created_at=2018-03-23T09:46:47.288Z-0400&sent_at=2018-03-23T09:46:47.288Z-0400&external_device_id=099aa0bc' -H 'Authorization: Bearer BURAYA_AUTH_TOKEN_GİRİN' -H 'User-Agent: Adjust Streaming Job (akka-http)' 'https://s2s.adjust.com/session'

Event'lerin S2S API ile kaydına dair daha fazla bilgi için Sunucudan sunucuya (S2S) event'lerimakalemize göz atabilirsiniz.

Link yapılandırması

Uygulamanızın sunucusu ile Adjust arasındaki S2S API entegrasyonunu yapılandırdıktan ve test ettikten sonra, Adjust'ı kampanyanızı yürüttüğünüz reklam ağına bağlamanız gerekir.

Linkleri kullanmak, kullanıcıların reklamınızla diğer cihazlarda etkileşime girdiğinde attribution kaydı yapabileceğiniz anlamına gelir, örneğin bir kullanıcının telefonunda ya da CTV'de bir reklam izledikten sonra oyunu PC'de install etmesi gibi. Web kampanyaları için iki ağ örneği:

Bu adımları Campaign Lab'de takip edin:

  1. Campaign Lab kısmında Partnerler seçeneğini seçin.

  2. Yeni partner 'i seçin.

  3. Partner seçimi ekranında yapılandırmak istediğiniz reklam ağını seçin.

  4. Uygulama seçimi ekranında, link oluşturmak istediğiniz ilgili uygulamayı seçin.

  5. (Opsiyonel) Veri paylaşımı ekranında ağınız ve Adjust arasındaki entegrasyonu yapılandırın ve veri paylaşımı seçeneklerini seçin.

  6. Link yapısı ekranında ağ tarafından sağlanan varsayılan link yapısı parametrelerini gözden geçirin ve gerekiyorsa bu değerleri güncelleyin.

  7. (Opsiyonel) Kullanıcı hedefleri ekranında bir deeplink yapılandırın veya link'inize yönlendirme ve fallback ekleyin.

    • Kullanıcılarınızı belli bir oyun store'una yönlendirmek istiyorsanız, URL'i ek bir yönlendirme parametresi olarak ekleyin.
  8. (Opsiyonel) Attribution ayarları ekranında yeni ve mevcut kullanıcılar için özel attribution ayarları belirleyin. Bu attribution ayarları tıklamalar ve gösterimler için kullanılabilir. Bu adımı atlarsanız, uygulama yapılandırması aşamasında seçtiğiniz attribution ayarları geçerli olacaktır.

    • Olasılıksal modellemenin hem tıklamalar hem de gösterimler için etkin olduğundan emin olun. Olasılıksal modelleme için attribution penceresinin 24 saat olarak ayarlanmasını şiddetle tavsiye ediyoruz ancak 90 güne kadar seçim yapabilirsiniz. 90 gün attribution penceresi sadece PC ve Konsol platformları tarafından kullanılabilir.
  9. Yapılandırma kontrolü ekranında seçimlerinizi gözden geçirin ve gerekiyorsa değişiklik yapın.

  10. Link oluştur seçeneğini seçerek tıklama URL'ini, gösterim URL'ini, QR kodunu, link token'ını oluşturun ve yapılandırıldıysa veri paylaşımını etkinleştirin.