HMS ve OAID İşlemleri

OAID ile üçüncü parti takip platformları entegrasyonu ve panel işlemleri ile kullanıcı aksiyonları takip işlemleri

Başlamadan Önce

Üçüncü 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.

Adjust, AppsFlyer gibi platformlar bu konuda hizmet vermektedir.

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

---

HMS & Adjust

1. Client Taraflı İşlemler
   1. OAID için SDK'in Uygulamanıza İmplemente Edilmesi
   2. Adjust.readOaid() Methodu ile OAID değerinin Adjust'a Bildirilmesi
   3. Adjust.trackEvent() Methodu ile Olay Takibi
2. Panel Taraflı İşlemler
   1. Adjust Panel'de Huawei Ads için Takipçi Oluşturulması
   2. Click ve Impression URL'lerinin Oluşturulması
   3. Huawei Ads Panel'de Adjust için Ortalık Oluşturulması
   4. SecretKey Değerinin Adjust Panel'e Girilmesi
   5. Huawei Ads Panel'de Dönüşüm Takibi Oluşturulması
   6. Adjust Panel'de Dönüşümleri Takip Edecek Olayların Oluşturulması ve Linklenmesi
   7. Huawei Ads Panel'de Dönüşüm Takibi İçin Test İşlemlerinin Yapılması
3. Adjust Sıkca Sorulan Sorular
4. Kaynakça

HMS & AppsFlyer

1. Client Taraflı İşlemler
   1. OAID için SDK'in Uygulamanıza İmplemente Edilmesi
   2. setCollectOaid() Methodu ile OAID değerinin AppsFlyer'a Bildirilmesi
   3. trackEvent() Methodu ile Olay Takibi
2. Panel Taraflı İşlemler
   1. AppsFlyer Panel'de Huawei Ads için Takipçi Oluşturulması
   2. Click ve Impression URL'lerinin Oluşturulması
   3. Huawei Ads Panel'de AppsFlyer için Ortalık Oluşturulması
   4. SecretKey Değerinin AppsFlyer Panel'e Girilmesi
   5. Huawei Ads Panel'de Dönüşüm Takibi Oluşturulması
   6. AppsFlyer Panel'de Dönüşümleri Takip Edecek Olayların Oluşturulması
   7. Huawei Ads Panel'de Dönüşüm Takibi İçin Test İşlemlerinin Yapılması
3. AppsFlyer Sıkca Sorulan Sorular
4. Kaynakça

Adjust

Client Taraflı İşlemler

Adjust ve OAID işlemleri için öncelikle uygulama taraflı olan işlemleri tamamlamamız gerekmektedir.

Bu işlemler; SDK implemente etmek, test için fonksiyon oluşturmak gibi basit bir kaç adımda tamamlanmaktadır.

1. OAID için SDK'in Uygulamanıza İmplemente Edilmesi

app:build.gradle dosyanızda Adjust SDK bağımlılığının altına şu implementation satırını eklemelisiniz;

dependencies{
   ...
   implementation 'com.adjust.sdk:adjust-android:4.28.9'
   implementation 'com.adjust.sdk:adjust-android-oaid:4.28.9'
}

2.Adjust.readOaid() Methodu ile OAID değerinin Adjust'a Bildirilmesi

Uygulamanızda Adjust.onCreate(config) ile SDK işlemlerini başlattığınız satırın üstüne OAID değerini okumak için olan şu satırı eklemelisiniz;

AdjustOaid.readOaid(applicationContext)
Adjust.onCreate(config)

Adjust’ın sağladığı SDK ile OAID değerini doğru şekilde aldığınızı kontrol etmelisiniz. Bunun için şu kodları kullanıp;

Java

Context context = applicationContext;
String appToken = «{your token}»;
String environment =  
   if (BuildConfig.DEBUG) AdjustConfig.ENVIRONMENT_SANDBOX;
   else AdjustConfig.ENVIRONMENT_PRODUCTION;

AdjustOaid.readOaid(context);

AdjustConfig config = new AdjustConfig(context, appToken, environment);
config.setLogLevel(LogLevel.VERBOSE);

Adjust.onCreate(config);

Kotlin

val context = applicationContext
val appToken = "{your token}"
val environment =
   if (BuildConfig.DEBUG){
       AdjustConfig.ENVIRONMENT_SANDBOX 
   }
   else{
      AdjustConfig.ENVIRONMENT_PRODUCTION
   } 
AdjustOaid.readOaid(context)
val config = AdjustConfig(context, appToken, environment)
config.setLogLevel(LogLevel.VERBOSE)
Adjust.onCreate(config)

LogCat penceresinde Verbose seviyesindeki logları dinleyip, «oaid» şeklinde filtreleme yaptığınızda;

get oaid from:{package-name}

Şeklindeki satırları görmeniz gerekmektedir.

3.Adjust.trackEvent() Methodu ile Olay Takibi

Uygulama içerisinde yapmamız gereken bir diğer önemli işlem ise; Adjust Panelde oluşturulan olayları takip etmek için ilgili token’ların doğru yerlerde trackEvent methoduna parametre olarak verilme işlemidir.

Java

AdjustEvent adjustEvent = new AdjustEvent("abc123");
Adjust.trackEvent(adjustEvent);

Kotlin

val adjustEvent = AdjustEvent("abc123")
Adjust.trackEvent(adjustEvent)

Panel Taraflı İşlemler

Adjust ile Huawei Reklam Servisinin birlikte çalışabilmesi için hem Adjust hem de Huawei Ads Panellerinde bazı işlemler yapmamız gerekir. Öncelikle Adjust Panel taraflı işlemlerle başlayalım.

1.Adjust Panel'de Huawei Ads için Takipçi Oluşturulması

Adjust Panel’e giriş yaptıktan sonra yeni bir takipçi oluşturalım ve bunu Huawei Ads olarak isimlendirelim. Bunun için;

Tracker URLs > New Tracker > Enter Tracker Name ‘e gidin ve “华为 广告 | Huawei Ads“ olarak isimlendirin.

2. Click ve Impression URL'lerinin Oluşturulması

Ardından CUSTOMIZE > CREATE ‘e tıklayın.

Click ve Impression URL’leri sırasıyla oluşacaktır.

Not: Bu URL’leri Huawei Ads Platformuna eklenmek üzere not etmeyi lütfen unutmayın.

3.Huawei Ads Panel'de Adjust için Ortalık Oluşturulması

Huawei Ads Panel’e giriş yaptıktan sonra Adjust ile birlikte çalışacak alt yapıyı kurmak üzere bir ortaklık oluşturmakla başlayalım. Bunun için;

Tools > Delivery assistance > Associated tool menüsüne gidin ve New’e tıklayın.

Açılan sayfada;

• Tool provider olarak Adjust’ı,

• App olarak ilgili uygulamanızı seçiniz.

• Impression tracking URL ve Click tracking URL alanlarını Adjust Panelden aldığınız URL’ler ile doldurun ve Submit butonuna tıklayın.

Submit işleminden sonra karşınıza gelen listede bulunan Key değerini Adjust Panel’e eklememiz gerekiyor.

4.SecretKey Değerinin Adjust Panel'e Girilmesi

Adjust Panel’e geri dönelim ve Partner Setup > Add Partner ‘e gittikten sonra Huawei Ads’i arayalım.

Uygulama platformu doğru şekilde seçtikten sonra SECRETKEY alanına bir önceki aşamada aldığımız Key’i girip Save butonuna tıklayalım.

5.Huawei Ads Panel'de Dönüşüm Takibi Oluşturulması

Takip ve analiz edilmesi istenen dönüşüm aksiyonlarını hem Huawei Ads Paneline hem de Adjust paneline tanımlamamız gerekiyor. Öncelikle Huawei Ads Paneline geçelim;

• Tools > Delivery assistance > Conversion tracking menüsünde bulunan New conversion’a tıklayalım.

• Önce App tracking’i sonra Analysis tool’u seçelim ve Contiune butonuna tıklayarak devam edelim.

• Karşımıza çıkacak olan formu doldurarak takip etmek istediğimiz aksiyonlar için dönüşüm oluşturalım.

• App: Takip etmek istediğiniz uygulamanızı seçiniz.

• Conversion actions: Hangi konularda dönüşüm aksiyonları almak istediğinizi seçin.

• Conversion name: Oluşturmak üzere olduğunu dönüşüme kolay anlaşılabilir bir isim verin.

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

Conversion actions tablosu:

Tümü için bakınız; https://developer.huawei.com/consumer/en/doc/distribution/promotion/tracking-shu-0000001139892541#EN-US_TOPIC_0000001139892541__table10838115914391

Eklediğiniz her Conversion için Status sütunu altında «Unactivated» durumunu göreceksiniz. Bu durum şu an için normaldir, aktivasyon işlemine ilerleyen aşamalarda başlamış olacağız.

6.Adjust Panel'de Dönüşümleri Takip Edecek Olayların Oluşturulması ve Linklenmesi

Huawei Ads Panel’e eklenen dönüşüm aksiyonlarının Adjust Panel’ine de eklenmesi gerekmektedir.

Bunun için Adjust Panel’e geri dönmeli ve Partner Setup > Add Partner alanında “华为广告 | HUAWEI Ads” i bulup seçmeliyiz ve aksiyonları birbirine eşitlemek için Event Linking alanını kullanmalıyız.

Not: Adjust «Install» olayını otomatik eklediği için sizin ayrıca eklemeniz gerekmez.

Not 2: Adjust tarafındaki «Install» olayı Huawei Ads Panel tarafındaki «Activation» olayına karşılık gelmektedir.

7.Huawei Ads Panel'de Dönüşüm Takibi İçin Test İşlemlerinin Yapılması

Eklediğiniz her Conversion için «Unactivated» olan durumunu aktive etmek için öncelikle Test işlemine tabii tutmamız gerekiyor bunun için ilgili satırın sağında bulunan Test linkine tıklıyoruz.

Açılan ekranda sizden test etmek istediğiniz cihazın OAID değerini girmenizi isteyecek.

Bu değeri Huawei cihazınızda şu yolu takip ederek bulabilirsiniz;

Privacy > Ads and Privacy > More information

Burada gördüğünüz Ad-ID sizin OAID’inizdir.

İkinci aşamada sizden QR’u okutup uygulamayı indirmenizi isteyecektir. Bu işlemi tamamlayıp cihazınızdan uygulamayı açmanız gerekmektedir.

Üçüncü ve son aşama sizden test etmek istediğiniz Conversion’ı uygulama içerisinde tetiklemenizi bekler. Örneğin «addToCart» için bir dönüşüm eklediyseniz uygulama içerisinde bir ürünü sepete ekleyerek bu dönüşümü test etmeniz gerekir. Test işlemi tamamlandıktan sonra conversion (dönüşüm) aktif hale gelecektir.

Adjust Sıkça Sorulan Sorular

- Huawei Ads Panel ile Adjust Panel’deki Install sayıları birbirini neden tutmuyor?

• Adjust Panel’de ki “install” sayılarını Huawei Ads Panel’de ki “activation” alanı ile karşılaştırmamız gerekmektedir.

- Adjust Panelinde “install” için bir event’i neden göremiyorum?

• Install event’i Adjust Panelinde otomatik olarak eklenmiş / tanımlanmış olduğu için event listesinde görüntülenmemektedir.

- Aynı cihazla, aynı uygulamayı birden fazla kez test ederken nelere dikkat etmeliyim?

• Adjust Testing Console'da OAID ile filtremele yaptığınız zaman HMS cihazdan isteğin gelmiş olduğunu fakat "install_time" veya "tracker_name" gibi değerlerin yanlış olduğunu görüyorsanız ilgili OAID 'e sahip cihazı Adjust veritabanınından tamamen silmeniz gerekebilir bunun için; Testing Console'da filtreme yaptıktan sonra "Forget Device" butonuna basabilirsiniz;

Genel soru cevap kısmı için

Kaynakça

• https://github.com/adjust/android_sdk/blob/master/doc/english/plugins/oaid.md

• https://developer.huawei.com/consumer/en/doc/distribution/promotion/adjust-0000001121931660

• Adjust operation guide.pdf

• https://medium.com/huawei-developers/adjust-third-party-tracking-integration-on-huawei-ads-platform-59a22dfdf033

AppsFlyer

Client Taraflı İşlemler

AppsFlyer ve OAID işlemleri için öncelikle uygulama taraflı olan işlemleri tamamlamamız gerekmektedir.

Bu işlemler; SDK implemente etmek, test için fonksiyon oluşturmak gibi basit bir kaç adımda tamamlanmaktadır.

1. OAID için SDK'in Uygulamanıza İmplemente Edilmesi

project:build.gradle dosyanızda şu satırların olduğundan emin olunuz;

allprojects {
  repositories {
    //...
    maven { url 'https://developer.huawei.com/repo/' }
    mavenCentral()
  }
}

app:build.gradle dosyanızda Appsflyer SDK bağımlılığının altında şu satırların olduğundan emin olunuz;

dependencies{
   //...
   implementation 'com.appsflyer:af-android-sdk:6.2.3@aar'
   implementation 'com.appsflyer:oaid:6.2.4'
   implementation 'com.huawei.hms:ads-identifier:3.4.39.302'
}

Daha sonrasında Application sınıfının onCreate metodunda init ve start kodlarını, log dinleme işlemi için ise setDebugLog kodunu eklemelisiniz.

AppsFlyerLib.getInstance().init(<AF_DEV_KEY>, null, this)
AppsFlyerLib.getInstance().start(this)
AppsFlyerLib.getInstance().setDebugLog(true)

Aşağıda bir örnek görebilirsiniz.

Java

import android.app.Application;
import com.appsflyer.AppsFlyerLib;
// ...
public class AFApplication extends Application {
    // ...
    @Override
    public void onCreate() {
        super.onCreate();
        // ...
        AppsFlyerLib.getInstance().init(<AF_DEV_KEY>, null, this);
        AppsFlyerLib.getInstance().start(this);
        // ...
    }
    // ...
}

Kotlin

import android.app.Application
import com.appsflyer.AppsFlyerLib
// ...
class AFApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        // ...
        AppsFlyerLib.getInstance().init(<AF_DEV_KEY>, null, this)
        AppsFlyerLib.getInstance().start(this)
        // ...
    }
    // ...
}

2. setCollectOaid() Methodu ile OAID değerinin AppsFlyer'a Bildirilmesi

Bu aşamada, 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 işlem yoktur. Fakat daha düşük bir SDK versiyonu kullanıyorsanız aşağıdaki kod satırını da Application sınıfının onCreate metoduna eklemelisiniz.

AppsFlyerLib.getInstance().setCollectOaid(true)

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.

3. trackEvent() Methodu ile Olay Takibi

Uygulama içerisinde yapmamız gereken bir diğer önemli işlem ise; AppsFlyer Panelde oluşturulan eventleri takip etmek için, ilgili eventleri doğru yerlerde trackEvent methoduna parametre olarak verilme işlemidir.

Java

      Map<String, Object> eventValues = new HasMap<>();
      eventValues.put(AFInAppEventParameterName.REVENUE, 1.99);
      eventValues.put(AFInAppEventParameterName.CURRENCY, "USD");
      AppsFlyerLib.getInstance().trackEvent(getApplicationContext(), APInAppEventType.PURCHASE, eventValues);

Kotlin

val eventValues: MutableMap<String, Any> = HasMap()
        eventValues[AFInAppEventParameterName.REVENUE] = 1.99
        eventValues[AFInAppEventParameterName.CURRENCY] = "USD"
        AppsFlyerLib.getInstance()
            .trackEvent(applicationContext, APInAppEventType.PURCHASE, eventValues)

Panel Taraflı İşlemler

Client tarafındaki işlemler tamamlandıktan sonra sırada iki panelin de birbirleri ile iletişim kurabilmeleri için panel tarafındaki entegrasyon işlemlerinin yapılması gerekmektedir.

1. AppsFlyer Panel'de Huawei Ads için Takipçi Oluşturulması

AppsFlyer Panel’e giriş yaptıktan sonra yeni bir takipçi oluşturalım ve bunu Huawei Ads olarak isimlendirelim. Bunun için;
AF integrated Partners > Huawei Ads Global > Integration

2. Click ve Impression URL'lerinin Oluşturulması

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

Configuration > Integreted Partners > Attribution Link adımları takip edilerek Click ve Impression URL'ler oluşturulabilir.

3. Huawei Ads Panel'de AppsFlyer için Ortalık Oluşturulması

Daha sonrasında oluşturulan Click ve Impression URL’ler Huawei Ads paneline eklenmelidir. Bunun için;

Tools > Delivery assistance > Associated tool menüsüne gidin ve New’e tıklayın.

Tool provider kısmında AppsFlyer, App kısmında ise uygulamanız seçilmelidir.

4. SecretKey Değerinin AppsFlyer Panel'e Girilmesi

Huawei Ads paneline bu veriler girildikten sonra bir adet KEY değeri elde ediceksiniz.

Bu KEY değerini alıp AppsFlyer paneline girmelisiniz.

5. Huawei Ads Panel'de Dönüşüm Takibi Oluşturulması

Bu işlemlerin ardından paneller arasındaki işlemler bitmiş olup, takip ve analiz edilmesi istenen dönüşüm aksiyonlarını hem Huawei Ads Paneline hem de Adjust paneline tanımlamamız gerekiyor. Öncelikle Huawei Ads Paneline geçelim;

Tools > Delivery assistance > Conversion tracking menüsünde bulunan New conversion’a tıklayalım. Önce App tracking’i sonra Analysis tool’u seçelim ve Contiune butonuna tıklayarak devam edelim. Karşımıza çıkacak olan formu doldurarak takip etmek istediğimiz aksiyonlar için dönüşüm oluşturalım.

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.

Huawei Conversion actions tablosu için bakınız: https://developer.huawei.com/consumer/en/doc/distribution/promotion/tracking-shu-0000001139892541#EN-US_TOPIC_0000001139892541__table10838115914391

6. AppsFlyer Panel'de Dönüşümleri Takip Edecek Olayların Oluşturulması

Daha sonrasında Huawei Ads panelinde oluşturulan conversion'ların karşılıkları Appsflyer panelde de oluşturulmalıdır.

7. Huawei Ads Panel'de Dönüşüm Takibi İçin Test İşlemlerinin Yapılması

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

Bunun 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ızı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.

AppsFlyer Sıkça Sorulan Sorular

- Neden Appsflyer panelde install verisi her zaman organik olarak görülüyor?

• Dev key değeri yanlış olabilir. Eğer bu değer yanlış ise paid install verisi sayılmaz, dolayısıyla install organik olarak sayılır.

- AppsFlyer panelde Install verisi neden gözükmüyor?

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

- Neden loglarda 404 hatası alıyorum?

• 404 hatası ID'nin doğru bir şekilde alınamadığıyla alakalıdır. applicationId verisinin build.gradle dosyası ile panelde aynı olduğundan emin olunuz.

- AppsFlyer panelde neden Revenue kısmını göremiyorum?

• Bunun sebebi revenue parametresinin düzgün bir şekilde formatlanmamış olmasıdır. Revenue herhangi bir şekilde formatlanmamalıdır. Örnek format 1234.56 şeklinde verilebilir.

- Neden "AppsFlyer's SDK cannot send any event without providing devkey" şeklinde bir log görüyorum?

• Bu log start fonksiyonuna dev_key parametresi verilmediğinde görülmektedir.

- Neden "Not sending data yet, waiting for dev key" şeklinde bir log görüyorum?

• Bu log init fonksiyonuna dev_key parametresi olarak boş string verildiğinde görülmektedir.

Genel soru cevap kısmı için

---

Sıkça Sorulan Sorular

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

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

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

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

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

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

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

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

- SDK implementasyonu yapılmasına rağmen neden sadece organik install sayıları görülü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.

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

- Neden üçüncü parti takip platformundaki veriler 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.

- Neden üçüncü taraf izleme platformunda yükleme sayısı 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.

Kaynakça

• https://developer.huawei.com/consumer/en/doc/distribution/promotion/appsflyer-0000001122291488
• https://support.appsflyer.com/hc/en-us/articles/360006278797-Android-OAID-implementation-in-the-SDK
• https://dev.appsflyer.com/hc/docs/integrate-android-sdk
• https://medium.com/huawei-developers-tr/oaid-huawei-ads-panel-ve-appsflyer-i%CC%87%C5%9Flemleri-f953a3604531