Ενεργοποίηση των συνδέσμων βάθος με αναβολή στο SDK μέτρησης

Αφού δημιουργήσετε συνδέσμους σε βάθος, θα πρέπει να τους ενεργοποιήσετε στο SDK μέτρησης, για να τους χρησιμοποιήσετε στις Καμπάνιες εφαρμογών.

Αυτό το άρθρο εξηγεί πώς μπορείτε να ενεργοποιήσετε τους συνδέσμους σε βάθος με αναβολή (DDL) σε υποστηριζόμενους Συνεργάτες απόδοσης εφαρμογών (AAP) τρίτου μέρους ή στο πιο πρόσφατο SDK του Google Analytics για Firebase (GA4F). Μάθετε πώς μπορείτε να παρακολουθείτε την παρακολούθηση μετατροπών εφαρμογών για κινητά με εργαλεία τρίτων.

Πριν ξεκινήσετε

Για να ενεργοποιήσετε το DDL σε υποστηριζόμενο AAP, θα πρέπει να έχετε ενεργούς συνδέσμους σε βάθος που περιλαμβάνονται σωστά στη συνημμένη ροή τους ή έχουν υποβληθεί ως DDL ομάδας διαφημίσεων.

Οδηγίες

Πώς να ενεργοποιήσετε το DDL σε υποστηριζόμενους AAP

Οι AAP τρίτου μέρους που υποστηρίζονται αυτή τη στιγμή από την Google για DDL είναι τα εξής:

Προσαρμογή
AppsFlyer
Branch
Kochava
Singular

Σημείωση: Άλλοι AAP βρίσκονται σε διαφορετικά στάδια ανάπτυξης. Οι σύνδεσμοι σε βάθος τρίτου μέρους, όπως οι σύνδεσμοι AppsFlyer Onelinks και άλλοι έξυπνοι σύνδεσμοι, δεν υποστηρίζονται. Επικοινωνήστε με τον αντίστοιχο εκπρόσωπο AAP για τις πιο πρόσφατες ενημερώσεις σχετικά με την ενεργοποίηση DDL.

Ακολουθήστε τα παρακάτω βήματα για να ενεργοποιήσετε το DDL στο AAP που έχετε επιλέξει.

Προσαρμογή

Δεν απαιτούνται πρόσθετες ρυθμίσεις για την ενεργοποίηση των επιστροφών δεδομένων DDL στο Google Ads. Αν θέλετε να απενεργοποιήσετε ή να αλλάξετε αυτή τη συμπεριφορά, θα πρέπει να ρυθμίσετε μια επανάκληση συνδέσμου σε βάθος με αναβολή.

AppsFlyer

Στην ενότητα AppsFlyer, κάντε κλικ στην επιλογή Διαμόρφωση > Ενσωματωμένοι συνεργάτες και, στη συνέχεια, επιλέξτε Google Ads (AdWords).
Στην καρτέλα Ενσωμάτωση, ενεργοποιήστε την επιλογή Σύνδεσμοι σε βάθος με αναβολή με ροές Google.
Κάντε κλικ στην επιλογή Save integration (Αποθήκευση ενσωμάτωσης).

Branch

Πρέπει να προστεθείτε στη λίστα επιτρεπομένων από το Branch, για να ενεργοποιήσετε τις επιστροφές δεδομένων DDL. Επικοινωνήστε με την ομάδα υποστήριξης του Branch για να αποκτήσετε πρόσβαση στη λειτουργία.

Kochava

Βεβαιωθείτε ότι είναι ενεργοποιημένη η ρύθμιση Εκτέλεση αιτήματος συνδέσμου σε βάθος. Αυτή η ρύθμιση ορίζεται από προεπιλογή, ώστε να ενεργοποιούνται οι επιστροφές δεδομένων DDL στο Google Ads.

Singular

Δεν απαιτούνται πρόσθετες ρυθμίσεις για την ενεργοποίηση των επιστροφών δεδομένων DDL στο Google Ads.

Μάθετε περισσότερα σχετικά με την παρακολούθηση μετατροπών εφαρμογής με Συνεργάτη απόδοσης εφαρμογών.

Πώς να ενεργοποιήσετε το DDL στο SDK του GA4F

Μπορείτε να ενεργοποιήσετε το DDL στο SDK του GA4F χρησιμοποιώντας την έκδοση Android 17.2.0+ ή νεότερη έκδοση, ακολουθώντας τα παρακάτω βήματα:

Βήματα για την ενεργοποίηση του DDL στο SDK του GA4F

1. Διαμορφώστε την εφαρμογή σας, ώστε να χρησιμοποιεί το Google Analytics για Firebase

Στην εφαρμογή build.gradle, καταργήστε όλες τις εξαρτήσεις στο firebase-core. Στη συνέχεια, προσθέστε ή ενημερώστε την εξάρτηση στην έκδοση 17.2.0+ του firebase-analytics. Το παρακάτω παράδειγμα χρησιμοποιεί μια νεότερη έκδοση του SDK.

dependencies {

        ...

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

        ...

    }

2. Ενεργοποιήστε τη λειτουργία στην εφαρμογή σας

Τροποποιήστε το μανιφέστο της εφαρμογής σας, προσθέτοντας την ακόλουθη ετικέτα μεταδεδομένων στην ετικέτα εφαρμογής.

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

Όταν είναι ενεργοποιημένο, το GA4F λαμβάνει τον διαμορφωμένο σύνδεσμο σε βάθος κατά την εκκίνηση της εφαρμογής, για την αντίστοιχη καμπάνια που διαμορφώσατε.

Σημείωση: Η εγγραφή ενός παραλήπτη μέσω του μανιφέστου έχει μειονεκτήματα, όπως χρήση μνήμης και λανθάνων χρόνο εκκίνησης. Αυτά μπορεί να μετριαστούν, δίνοντας μεγαλύτερο βάρος στο μητρώο περιβάλλοντος.

3. Λάβετε τον σύνδεσμο σε βάθος

Ρυθμίστε μια λειτουργία αναμονής αλλαγής SharedPreferences εντός της κύριας κατηγορίας δραστηριότητας εκκίνησης. Αυτό θα ενεργοποιηθεί όταν υπάρχει διαθέσιμο ένα DDL. Εάν κάνετε εγγραφή της λειτουργίας αναμονής αργότερα στον κύκλο ζωής της εφαρμογής, ο σύνδεσμος σε βάθος μπορεί να έχει ήδη ανακτηθεί. Σε αυτήν την περίπτωση, η λειτουργία αναμονής δεν θα ενεργοποιηθεί και μπορείτε να αναζητήσετε αμέσως την τιμή του συνδέσμου σε βάθος, διαβάζοντας το στοιχείο SharedPreferences.

Το GA4F αποθηκεύει τον σύνδεσμο σε βάθος σε ένα αρχείο SharedPreferences google.analytics.deferred.deeplink.prefs με το κλειδί deeplink. Το GA4F αποθηκεύει επίσης στο ίδιο αρχείο SharedPreferences τη χρονική σήμανση κλικ σε διαφήμιση με το κλειδί timestamp. Λάβετε υπόψη ότι η μορφή της χρονικής σήμανσης είναι μικροδευτερόλεπτα (χιλιοστά του δευτερολέπτου ακολουθούμενα από τελεία και μικροδευτερόλεπτα) και αποθηκεύεται στο SharedPreferences με τη χρήση του Long όταν ο τύπος είναι Διπλός. Χρησιμοποιήστε το Double.longBitsToDouble(...), για να αναλύσετε την πραγματική τιμή.

Παράδειγμα:

/** * Η κύρια δραστηριότητα εκκίνησης της εφαρμογής. */ public class MainActivity extends AppCompatActivity {

απόρρητο SharedPreferences preferences; απόρρητο 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. Προετοιμάστε τα δεδομένα για διαγνωστικό έλεγχο

Για να επικυρώσετε την υλοποίησή σας, αποκτήστε το ID διαφήμισης για τη συσκευή με την οποία θέλετε να πραγματοποιήσετε δοκιμή. Μπορείτε να χρησιμοποιήσετε την παρακάτω εντολή, για να ορίσετε το DDL που θα λαμβάνει η εφαρμογή.

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"

Για να ελέγξετε αν ο σύνδεσμος σε βάθος έχει οριστεί σωστά, μπορείτε να χρησιμοποιήσετε αυτό το αίτημα, προκειμένου να επαληθεύσετε την απάντηση.

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

Αυτός ο δοκιμαστικός σύνδεσμος σε βάθος λήγει μετά από 24 ώρες. Επαναλάβετε αυτό το βήμα, αν λήξει ο δοκιμαστικός σύνδεσμος σε βάθος.

5. Ενεργοποιήστε τη λειτουργία δοκιμής για τη λήψη του δοκιμαστικού DDL

Ενεργοποιήστε τη λειτουργία δοκιμής DDL, για να ξεκινήσετε τη δοκιμή στις συσκευές σας.

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

Στη συνέχεια, ενεργοποιήστε τη λειτουργία εντοπισμού σφαλμάτων στη συσκευή σας. Ξεκινήστε να χρησιμοποιείτε την εφαρμογή σας και, στο Logcat, ελέγξτε ότι το μήνυμα του αρχείου καταγραφής εμφανίζει ένα στοιχείο gmp_version τουλάχιστον 18200. Η αναζήτηση της λέξης-κλειδιού deferred θα φιλτράρει όλα τα μηνύματα εντοπισμού σφαλμάτων από το Google Analytics για Firebase που σχετίζονται με τη συγκεκριμένη λειτουργικότητα.