OAID, Huawei Ads Panel ve AppsFlyer İşlemleri

Mustafa Dincay
Huawei Developers - Türkiye
8 min readJan 12, 2022

OAID Nedir?

  • MSA’nın (Mobile Security Alliance) Çin tarafından üretilen tüm cihazların sağlaması gerektiğini duyurduğu bir reklam kimliğidir.
  • Google Play Hizmelerinin olmadığı diğer uygulama mağazalarında, Android cihazları takip etmek için kullanılır.
  • HMS (Huawei Mobil Servisleri) kullanan tüm cihazlarda OAID kolay bir şekilde erişilebilir durumdadır.

3. Parti Takip Platformu Nedir?

Bir şirket (kampanya, tanıtım, duyuru vb. gibi) pazarlama işlemleri için reklam yayınladığında, bütçesini en iyi şekilde yönetmek için kullanıcıların bu reklam ile nasıl etkileşime geçtiğini (örn: reklama kaç kullanıcı tıkladı, kaç kullanıcı reklamdan gelerek uygulamayı indirdi, kaç kullanıcı reklamdan gelerek ürün satın aldı vb. ) detaylarıyla görmek ister. Bu, kullanıcı ve kullanıcı davranışlarının takibinin baz alındığı bir dizi işlemleri gerektirir.

AppsFlyer, Adjust, Kochava, Sizmek gibi platformlar bu konuda hizmet vermektedir.

Android (Client) Taraflı İşlemler

AppsFlyer ve OAID işlemleri için uygulamanızda yapmanız gereken birkaç işlem var. Öncelikle SDK implementasyonunu yapmalısınız.

Project gradle dosyasına;

App gradle dosyasına;

implementasyonlarını eklemelisiniz. Daha sonrasında Application sınıfının onCreate metodunda aşağıdaki kodları çağırmalısınız.

Bu aşamadan sonra eğer AppsFlyer SDK versiyonunuz 6.2.3 ya da üzeri ise cihazın OAID verisini elde etmek için yapmanız gereken ek birşey yok fakat daha düşük bir SDK versiyonu ise aşağıdaki kod satırlarını Application sınıfının onCreate metoduna eklemelisiniz.

Tüm bu işlemlerin doğru bir şekilde yapılıp yapılamadığını test edebilmek için bir log dinleme işlemi var. İşlemler doğru yapıldıysa Android Studio’da Logcat’i Verbose seviyesine getirip “oaid” olarak filtreleme yapıldığında, aşağıdaki gibi bir log görmelisiniz. “get oaid from:” kısmından sonra uygulamanızın paket adı gelmektedir.

Sırada panel tarafında yapılması gereken işlerler var. Huawei Ads ve AppsFlyer panellerinin birbirleriyle iletişim halinde olabilmeleri için birkaç entegrasyon işlemi yapılması gerekmektedir. Öncelikle AppsFlyer panelde Click ve Impression URL’lerinin oluşturulması gerekmektedir.

Daha sonrasında oluşturulan Click ve Impression URL’ler Huawei Ads paneline eklenmelidir. Tool provider kısmında AppsFlyer, App kısmında ise uygulamanız seçilmelidir.

Huawei Ads paneline bu veriler girildikten sonra bir adet KEY değeri elde ediceksiniz. Bu KEY değerini alıp AppsFlyer paneline girmelisiniz.

Bu işlemlerin ardından paneller arasındaki işlemler bitmiş olup, kampanyanızda kullanacağınız conversion’ların iki panele de eklenme işlemleri vardır. Öncelikle Huawei Ads panelinde takip edilecek conversion oluşturulmalıdır.

  • App: Takip etmek istediğiniz uygulamanızı seçiniz.
  • Conversion actions: Hangi konularda dönüşüm aksiyonları almak istediğinizi seçiniz.
  • Conversion name: Oluşturmak üzere olduğunu dönüşüme kolay anlaşılabilir bir isim veriniz.
  • Click attribution window: Reklam tıklandıktan ve dönüşüm oluşturulduktan sonraki periyottur. Varsayılan değeri 30 gündür ve bu değer Submit işleminden sonra değiştirilemez.
  • Display attribution window: Dönüşümün başlatılmasını sağlayan reklam izlenimi sonrası periyottur. Varsayılan değeri 1 gündür ve bu değer Submit işleminden sonra değiştirilemez.
  • Including Conversion Num: Dönüşüm aksiyonları için tanımladığınız her bir aksiyon için sayaç değeri tanımlayabilirsiniz. Örneğin uygulamanızda sepete ekleme işlemi 3, satın alma işlemi 2 kez gerçekleştiyse Conversion Num değeri size 5 olarak dönecektir.

Bütün Conversion‘lar için bakınız;

Daha sonrasında Huawei Ads panelinde oluşturulan aynı conversion’ın karşılığı Appsflyer panelde oluşturulmalıdır.

Kampanyaya başlayabilmeniz için Huawei Ads tarafına eklenen conversion’ların aktif olması gerekmektedir. İlk eklendiğinde bu değer pasif durumdadır. Bunu aktif edebilmek için ise eklenen conversion’ı test işleminden geçirmeniz gerekmektedir. Testi başarılı bir şekilde geçtiğinde conversion aktif olacaktır.

Test işlemine başlamak için öncelikle sağ tarafta bulunan “Test” butonuna tıklayınız.

Daha sonrasında açılan panele test yapılacak cihazın OAID verisi girilmelidir.

Cihazın OAID verisini şu şekilde öğrenebilirsiniz. Privacy → Ads and Privacy → More Information → Your Ad-ID

OAID verisi girildikten sonra karşınıza gelen karekod ile uygulamayı indirmeniz gerekmektedir.

Daha sonrasında ise test edilen conversion hangisi ise o işlemin gerçekleştirilmesi gerekmektedir. Örnek vermek gerekirse register conversion’ı test ediliyorsa uygulamayı indirdikten sonra çalıştırıp, register işleminin gerçekleştirilmesi gerekmektedir.

Test işlemi başarılı olduktan sonra Huawei Ads panelinde conversion’ın artık aktif durumda olduğunu göreceksiniz. Bu aşamadan sonra teknik işlemler bitmiş olup, kampanyanıza başlayabilirsiniz.

Sıkça Sorulan Sorular

1-) Conversion testi aktif edilemiyor. Ne yapmalıyım?

Eğer bir Conversion (dönüşüm) aktive edilemiyorsa, test öncesi cihazınızın OAID değerini sıfırlayabilir ya da daha önce test için kullanılmamış bir cihaz ile test işlemini yeniden gerçekleştirmeyi deneyebilirsiniz.

2-) MSA’nın SDK’ini uygulamama implemente etmem gerekiyor mu?

Çin anakarası dışında yayınlanan uygulamalar için MSA’nın SDK’ini uygulamaya implemente etme gerekliliği yoktur. Adjust, AppsFlyer gibi şirketlerin sunduğu ek SDK’ler sayesinde HMS cihazlarda OAID verisine kolayca ulaşabilmektedir.

3-) Google tarafında bugüne kadar sorunsuz ilerliyorduk, şimdi neden OAID işlemlerini yapmamız gerekiyor?

GMS Core’a sahip cihazlarda cihaz ve kullanıcı aksiyonları takibi GAID (Google Ad ID) üzerinden yapılmaktadır. 2020 yılı sonrası üretilen Huawei cihazlarda GMS Core olmadığı için aynı işlemler HMS Core’a sahip cihazlar için OAID üzerinden yapılmalıdır.

4-) OAID entegrasyonu yapmak uygulama boyutumu yükseltir ya da performansını kötü yönde etkiler mi?

AppsFlyer, Adjust gibi takip platformlarının sunduğu OAID SDK’larının amacı sadece cihazdaki OAID verisine ulaşıp kendi core yapılarına bu veriyi taşımaktır. Bu sebeple oldukça hafif boyutlardadırlar.

Örneğin: AppsFlyer OAID SDK’i sadece 11 KB boyutundadır. Adjust için ise OAID işlemlerini yapan SDK’ın boyutu sadece 15 KB civarındadır.

5-) OAID işlemlerini yaptıktan sonra GMS cihazlarda test ederken log ekranında neden uyarı alıyorum?

OIAD işlemleri sadece HMS Core üzerinde çalışmaktadır. Bu yüzden HMS Core’a sahip olmayan cihazlarda bu uyarının görünmesi çok normaldir ve bir sorun olduğu anlamına gelmemektedir.

6-) Huawei Panel’de ki “Activation” ne anlama gelmektedir?

Download: Reklam tıklanması sonucu, uygulamayı indirilme sayısı.

Install: Reklam tıklanması sonucu, indirilme sonrası uygulama yüklenme sayısı.

Activation: Reklam tıklanma sonucu, indirilme ve yüklenme sonrası uygulamanın ilk kez açılma sayısı.

Uygulama indirilme ve yüklenme işlemlerinde uygulama çalışmamış / ayağa kalkmamış durumunda olduğu için Download ve Install değerlerini HMS Core ile Huawei Ads Panel üzerinden takip edebiliyoruz. Adjust ise Huawei için Activation olan olayı Install (yani başarıyla yüklenme) olarak adlandırmaktadır.

7-) Appsflyer panelde install verisi her zaman organik olarak gözüküyor

Dev key değeri yanlış olabilir. Eğer bu değer yanlışsa install sayısı organic sayılmaz ve olarak gözükür.

8-) Hem HMS hem de GMS servislerine sahip telefonlarda kullanıcının reklama tıklamasından sonraki yönlendirme işlemleri nasıl çalışacak?

Bu reklamın hangi sağlayıcıdan sağlandığı ile alakalı bir durumdur. Kullanıcının gördüğü ve tıkladığı reklamın sağlayıcısı Huawei ise, tıklama işleminden sonraki takip ve yönlendirme işlemleri Huawei için eğer reklam diğer bir sağlayıcıdan sağlanıyor ise bu işlemler o sağlayıcı için devam edecektir.

9-) AppGallery ile 3. Parti Takip Platformu panel sayıları birbirini neden tutmuyor?

Bu olayın bir çok sebebi olabilir. Örnek vermek gerekirse bir kullanıcı aynı Huawei hesabı ile hem telefonuna hem de tabletine uygulamanızı indirebilir. Bu Adjust gibi 3. Parti Takip platformları tarafında 2 indirme sayılırken mağaza tarafında 1 indirme sayılır.

Ya da başka bir örnekle eğer uygulamanız daha önceden 3. Parti Takip Platformu SDK’ini yüklemeden mağazaya çıkmışsa, daha sonra 3. Parti Takip Platformu entegre edip güncelleme çıktığında 3. Parti Takip Platformu tarafında tüm eski kullanıcılar yeni kullanıcı olarak sayılacaktır, market tarafında ise bu güncelleme olarak görülecektir.

Dolayısıyla market tarafında eski kullanıcılar yeni gibi görünmeyecektir. Bu sebeple uygulamanın büyüklüğüne göre ilk güncelleme sonrası haftalar, aylar boyunca sayılarda tutarsızlık olabilir.

10-) SDK implementasyonu yapılmasına rağmen neden sadece organik install sayıları gözüküyor?

Bu durum büyük ihtimalle; Huawei Ads Panel ve üçüncü parti takip platformu arasındaki panel bağlantılarının yanlış yapılandırılmasından kaynaklanıyor olabilir.

Ayrıntılı bilgi için dokümandaki paneller arası işlemlerin tanıldığı kısımlara ve üçüncü parti takip platformlarının kendi dokümanlarını inceleyebilirsiniz.

11-) Neden Huawei Ads platformu ile 3. Parti takip platformlarının Impression ve Click sayıları farklı?

Click veya impression verileri, HUAWEI Ads SDK ile entegre edilmiş medya tarafından HUAWEI Ads’e ve üçüncü taraf izleme platformuna aynı anda bildirilir. Ağ paket kaybı olduğunda veri farkı oluşabilir. % 5 ile %10 arasındaki sayı tutarsızlığı normal olarak kabul edilir.

12-) Üçüncü parti takip platformundaki veriler neden HUAWEI Reklam raporlarındaki verilerden farklı?

Üçüncü parti takip platformundan geri gönderilen veriler için HUAWEI Ads, verileri sadeleştirme, dolandırıcılık önleme ve yeniden ilişkilendirme dahil olmak üzere bir dizi işlemle filtreler ve ardından nihai sonucu raporlar.

Bu sebeple HUAWEI Reklam raporlarındaki gösterge değerleri üçüncü taraf izleme platformundakilerden daha az olabilir.

13-) Üçüncü taraf izleme platformunda yükleme sayısı neden az veya 0 olarak görünüyor?

Üçüncü taraf izleme platformunun SDK’i talimatlara uygun olarak entegre edilmemişse ya da kullanılan versiyon çok düşükse OAID’ler toplanmaz ve HUAWEI Reklamlarından gelen çoğu dönüşüm yanlışlıkla organik trafik veya diğer trafik olarak sayılabilir.

14-) Appsflyer panelde install verisi gözükmüyor.

Init ve start fonksiyonlarının Application sınıfında çağırıldığından emin olunuz.

Referanslar

--

--