Ölçüm SDK'nızda ertelenen derin bağlantıyı etkinleştirme

Derin bağlantılar oluşturduktan sonra bunları uygulama kampanyalarınızda kullanmak için ölçüm SDK'nızda etkinleştirmeniz gerekir.

Bu makalede, desteklenen üçüncü taraf Uygulama İlişkilendirme Ortakları (AAP'ler) veya en güncel Firebase için Google Analytics (GA4F) SDK'sında ertelenen derin bağlantının (DDL) nasıl etkinleştirileceği açıklanmaktadır. Üçüncü taraf araçlarıyla mobil uygulama dönüşümünü izleme hakkında bilgi edinin.

Başlamadan önce

Desteklenen bir AAP'de DDL'yi etkinleştirmek için ekli feed'lere düzgün bir şekilde dahil edilmiş veya reklam grubu ertelenen derin bağlantısı olarak gönderilmiş çalışan derin bağlantılarınızın olması gerekir.

Talimatlar

Desteklenen AAP'lerde DDL'yi etkinleştirme

Şu anda DDL için Google tarafından desteklenen üçüncü taraf AAP'ler aşağıdaki gibidir:

Adjust
AppsFlyer
Branch
Kochava
Singular

Not: Diğer AAP'ler farklı geliştirme aşamalarındadır. AppsFlyer Onelinks gibi üçüncü taraf derin bağlantılar ve diğer "akıllı bağlantılar" desteklenmez. DDL etkinleştirmeyle ilgili en son güncellemeler için ilgili AAP temsilcinizle iletişime geçin.

Seçtiğiniz AAP'de DDL'yi etkinleştirmek için aşağıdaki adımları uygulayın.

Adjust

Google Ads'e DDL geri göndermelerini etkinleştirmek için ek ayar gerekmez. Bu davranışı devre dışı bırakmak veya değiştirmek isterseniz ertelenen derin bağlantı geri çağırması ayarlamanız gerekir.

AppsFlyer

AppsFlyer'da Configuration (Yapılandırma) > Integrated Partners (Entegre İş Ortakları)'ı tıklayın ve ardından Google Ads (AdWords) seçeneğini belirleyin.
(Entegrasyon) sekmesinde "Deferred deep linking with Google feeds" (Google feed'leriyle ertelenmiş derin bağlantı)'yı etkinleştirin.
Save integration (Entegrasyonu kaydet) seçeneğini tıklayın.

Branch

DDL geri göndermelerini etkinleştirmek için Branch tarafından izin verilenler listesine eklenmiş olmanız gerekir. Özelliğe erişmek için Branch destek ekibiyle iletişime geçin.

Kochava

"Perform Deeplink Request" (Derin Bağlantı İsteği Gerçekleştir) ayarının etkinleştirildiğinden emin olun. Bu ayar, Google Ads'e DDL geri göndermelerini etkinleştirmek için varsayılan olarak ayarlanır.

Singular

Google Ads'e DDL geri göndermelerini etkinleştirmek için ek ayar gerekmez.

Uygulama dönüşümlerini Uygulama İlişkilendirme Ortağı ile izleme hakkında daha fazla bilgi edinin.

GA4F SDK'sında DDL'yi etkinleştirme

DDL'yi, GA4F SDK'sında Android 17.2.0+ veya daha yeni bir sürüm ile aşağıdaki adımları uygulayarak etkinleştirebilirsiniz:

GA4F SDK'sında DDL'yi etkinleştirme adımları

1. Uygulamanızı, Firebase için Google Analytics'i kullanacak şekilde yapılandırın

build.gradle uygulamasında firebase-core üzerindeki tüm bağımlılıkları kaldırın. Ardından, firebase-analytics 17.2.0+ sürümüne bağımlılığı ekleyin veya sürümde bulunan bağımlılığı güncelleyin. Aşağıdaki örnekte SDK'nın daha yeni bir sürümü kullanılmıştır.

dependencies {

        ...

        implementation 'com.google.firebase:firebase-analytics:21.0.0'

        ...

    }

2. Özelliği uygulamanızda etkinleştirin

Aşağıdaki meta veri etiketini uygulama etiketinize ekleyerek uygulama manifestinizi değiştirin.

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

        package="com.myawesome.app">

    

        <uses-permission android:name="android.permission.INTERNET" />

    

        <application

         android:name=".MainActivity">

    

         <!-- Value to be added to enable deferred deep links -->

         <meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>

    

           <activity

                android:name=".MainActivity" >

           </activity>

    

        </application>

    

    </manifest>

Bu özellik etkinleştirildiğinde GA4F, yapılandırdığınız ilgili kampanya için uygulama başlangıcında yapılandırılmış derin bağlantıyı getirir.

Not: Manifest dosyasında bir alıcının kaydedilmesi, bellek kullanımı ve başlatma gecikmesi gibi dezavantajlar doğurur. Bunlar, bağlam kaydı seçilerek azaltılabilir.

3. Derin bağlantıyı alın

Ana başlatma etkinliği sınıfınızda bir SharedPreferences değişiklik işleyici oluşturun. Bu, bir DDL kullanılabilir olduğunda tetiklenir. İşleyiciyi uygulama yaşam döngüsünün ilerleyen aşamalarında kaydediyorsanız derin bağlantı zaten alınmış olabilir. Bu durumda, işleyici tetiklenmez ve SharedPreferences'ı okuyarak derin bağlantının değerine hemen ulaşabilirsiniz.

GA4F, derin bağlantıyı deeplink anahtarıyla birlikte bir SharedPreferences dosyasında google.analytics.despecified.deeplink.prefs depolar. GA4F, aynı SharedPreferences dosyasında timestamp anahtarıyla birlikte reklam tıklama zaman damgasını da saklar. Zaman damgasının mikrosaniye (milisaniye, ardından bir nokta ve mikrosaniye) biçiminde olduğunu ve tür olarak "Double" olduğunda Long kullanılarak SharedPreferences'ta saklandığını unutmayın. Gerçek değeri ayrıştırmak için Double.longBitsToDouble(...) kullanın.

Örnek:

/** * Uygulamanın ana başlatma etkinliği. */ public class MainActivity extends AppCompatActivity {

private SharedPreferences preferences; private SharedPreferences.OnSharedPreferenceChangeListener deepLinkListener;

@Override protected void onStart() { super.onStart(); preferences.registerOnSharedPreferenceChangeListener(deepLinkListener); }

@Override protected void onStop() { super.onStop(); preferences.unregisterOnSharedPreferenceChangeListener(deepLinkListener); deepLinkListener = null; }

@Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); preferences = getSharedPreferences("google.analytics.deferred.deeplink.prefs", MODE_PRIVATE);

deepLinkListener = (sharedPreferences, key) -> { Log.d("DEEPLINK_LISTENER", "Deep link changed"); if ("deeplink".equals(key)) { String deeplink = sharedPreferences.getString(key, null); Double cTime = Double.longBitsToDouble(sharedPreferences.getLong("timestamp", 0)); Log.d("DEEPLINK_LISTENER", "Deep link retrieved: " + deeplink); showDeepLinkResult(deeplink); } }; }

public void showDeepLinkResult(String result) { String toastText = result; if (toastText == null) { toastText = "The deep link retrieval failed"; } else if (toastText.isEmpty()) { toastText = "Deep link empty"; } Toast.makeText(MainActivity.this, toastText, Toast.LENGTH_LONG).show(); Log.d("DEEPLINK", toastText); } }

4. Teşhis testi için verileri hazırlayın

Uygulamanızı doğrulamak için test yapmak istediğiniz cihazın Reklam Kimliği'ni alın. Uygulamanın alacağı DDL'yi ayarlamak için aşağıdaki komutu kullanabilirsiniz.

curl

"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<your application package>>&deeplink=<<deeplink you want to receive>>&ddl_test=1"

Derin bağlantının doğru şekilde ayarlanıp ayarlanmadığını kontrol etmek için bu isteği kullanarak yanıtı doğrulayabilirsiniz.

curl "www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<your device adid>>&id_type=adid&bundleid=<<your application package>>&ddl_test=1"

Bu test derin bağlantısının süresi 24 saat sonra dolar. Test derin bağlantısının süresi dolarsa bu adımı tekrarlayın.

5. Test DDL'sini getirmek için test modunu etkinleştirin

Cihazlarınızda teste başlamak için DDL test modunu etkinleştirin.

adb shell setprop debug.deferred.deeplink <<your application package>>

Ardından cihazınızda hata ayıklama modunu etkinleştirin. Uygulamanızı kullanmaya başlayın ve Logcat'te, günlük mesajında gmp_version değerinin en az 18200 olduğundan emin olun. deferred anahtar kelimesi için arama yaptığınızda Firebase için Google Analytics'ten bu işlevle ilgili tüm hata ayıklama mesajları filtrelenir.