Po utworzeniu precyzyjnych linków musisz je włączyć w pakiecie SDK do pomiarów skuteczności, aby móc ich używać w kampaniach promujących aplikacje.
Z tego artykułu dowiesz się, jak włączyć odroczone precyzyjne linki (DDL) u obsługiwanych firm uczestniczących w programie App Attribution Partner lub w najnowszym pakiecie SDK Google Analytics dla Firebase (GA4F). Dowiedz się, jak stosować śledzenie konwersji z aplikacji mobilnych za pomocą narzędzi innych firm.
Zanim zaczniesz
Aby włączyć DDL w obsługiwanym App Attribution Partner, musisz mieć działające precyzyjne linki, które są prawidłowo uwzględnione w załączonym pliku danych lub przesłane jako grupa reklam DDL.
Instrukcje
Włączanie odroczonych precyzyjnych linków u obsługiwanych firm uczestniczących w programie App Attribution Partner
Oto lista firm zewnętrznych, u których DDL są obecnie obsługiwane przez Google:
- Adjust
- AppsFlyer
- Branch
- Kochava
- Singular
Aby włączyć odroczone precyzyjne linki u wybranej firmy, wykonaj poniższe czynności.
Adjust
AppsFlyer
- W AppsFlyer kliknij Configuration > Integrated Partners (Konfiguracja > Partnerzy zintegrowani), a potem wybierz Google Ads (AdWords).
- Na karcie Integration (Integracja) włącz „Deferred deep linking with Google feeds” (Odroczone precyzyjne linki za pomocą plików danych Google).
- Kliknij Save integration (Zapisz integrację).
Branch
Kochava
Singular
Dowiedz się więcej o śledzeniu konwersji z aplikacji w ramach programu App Attribution Partner.
Jak włączyć odroczone precyzyjne linki w pakiecie SDK GA4F
Odroczone precyzyjne linki możesz włączyć w pakiecie SDK GA4F, korzystając z jego wersji 17.2.0 lub nowszej na Androida, w taki sposób:
Włączanie odroczonych precyzyjnych linków w pakiecie SDK GA4F
1. Skonfiguruj aplikację pod kątem używania Google Analytics dla Firebase
W pliku build.gradle aplikacji usuń wszystkie zależności od firebase-core
. Następnie dodaj lub zaktualizuj zależność od firebase-analytics
w wersji 17.2.0 bądź nowszej. W podanym niżej przykładzie użyto nowszej wersji pakietu SDK.
dependencies {
...
implementation 'com.google.firebase:firebase-analytics:21.0.0'
...
}
2. Włącz tę funkcję w aplikacji
Zmodyfikuj plik manifestu aplikacji poprzez dodanie do tagu aplikacji podanego niżej tagu metadanych.
<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">
<!-- Wartość, którą trzeba dodać, aby włączyć odroczone precyzyjne linki -->
<meta-data android:name="google_analytics_deferred_deep_link_enabled" android:value="true"/>
<activity
android:name=".MainActivity" >
</activity>
</application>
</manifest>
Gdy włączysz tę funkcję, GA4F będzie podczas uruchamiania aplikacji pobierać skonfigurowany precyzyjny link przeznaczony do odpowiedniej skonfigurowanej przez Ciebie kampanii.
3. Przechwytuj precyzyjny link
W klasie głównej aktywności związanej z uruchamianiem skonfiguruj w obiekcie SharedPreferences detektor zmian. Zostanie on wywołany, gdy będzie dostępny odroczony precyzyjny link. Jeśli zarejestrujesz detektor na późniejszym etapie działania aplikacji, może się okazać, że precyzyjny link został już pobrany. W takim przypadku detektor nie zostanie wywołany, a wartość precyzyjnego linku będziesz móc od razu sprawdzić, odczytując obiekt SharedPreferences.
GA4F przechowuje precyzyjny link w kluczu deeplink
w pliku obiektu SharedPreferences o nazwie google.analytics.deferred.deeplink.prefs
. GA4F przechowuje też w tym samym pliku, ale w kluczu timestamp
, sygnaturę czasową kliknięcia reklamy. Pamiętaj, że sygnatura czasowa jest podawana w mikrosekundach (w formacie: milisekundy, a po nich kropka i mikrosekundy) oraz przechowywana w obiekcie SharedPreferences jako dane typu Long, jeśli jej typ danych to Double. Aby uzyskać faktyczną wartość, użyj metody Double.longBitsToDouble(...).
Przykład:
/**
* Główna aktywność związana z uruchamianiem aplikacji.
*/
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", "Precyzyjny link uległ zmianie");
if ("deeplink".equals(key)) {
String deeplink = sharedPreferences.getString(key, null);
Double cTime = Double.longBitsToDouble(sharedPreferences.getLong("timestamp", 0));
Log.d("DEEPLINK_LISTENER", "Otrzymany precyzyjny link: " + deeplink);
showDeepLinkResult(deeplink);
}
};
}
public void showDeepLinkResult(String result) {
String toastText = result;
if (toastText == null) {
toastText = "Nie udało się otrzymać precyzyjnego linku";
} else if (toastText.isEmpty()) {
toastText = "Precyzyjny link jest pusty";
}
Toast.makeText(MainActivity.this, toastText, Toast.LENGTH_LONG).show();
Log.d("DEEPLINK", toastText);
}
}
4. Przygotuj dane do testów diagnostycznych
Aby sprawdzić swoją implementację, pobierz identyfikator reklamy przeznaczony do urządzenia, na którym chcesz ją przetestować. Za pomocą podanego niżej polecenia możesz skonfigurować odroczony precyzyjny link, który otrzyma aplikacja.
"www.googleadservices.com/pagead/conversion/app/deeplink?&rdid=<<identyfikator reklamy Twojego urządzenia>>&id_type=adid&bundleid=<<pakiet Twojej aplikacji>>&deeplink=<<odroczony precyzyjny link, który chcesz otrzymać>>&ddl_test=1"
Aby sprawdzić, czy precyzyjny link został prawidłowo skonfigurowany, możesz użyć tego żądania i zweryfikować odpowiedź na nie.
Ten testowy precyzyjny link wygaśnie po 24 godzinach. Gdy to nastąpi, powtórz ten krok.
5. Włącz tryb testowy, aby pobrać testowy odroczony precyzyjny link
Aby rozpocząć testy na urządzeniach, włącz tryb testowy odroczonych precyzyjnych linków.
adb shell setprop debug.deferred.deeplink <<pakiet Twojej aplikacji>>
Następnie włącz w urządzeniu tryb debugowania. Zacznij korzystać ze swojej aplikacji i sprawdź w narzędziu Logcat, czy komunikat dziennika zawiera parametr gmp_version
o wartości co najmniej 18200
. Wyszukanie słowa kluczowego deferred
spowoduje odfiltrowanie wszystkich komunikatów o debugowaniu z Google Analytics dla Firebase związanych z tą funkcją.
Przykład:
D/FA: Deferred Deep Link feature enabled.
FA-SVC: Uploading data. app, uncompressed size, data: <<pakiet Twojej aplikacji>>,
…
gmp_version: 18200