Show Menu
THEMEN×

V3-Akquise testen

Diese Informationen helfen Ihnen dabei, eine Hin&Zurück-Abfrage für einen Version-3-Akquise-Kampagnenlink auf einem Android-Gerät durchzuführen.
Die Akquise in Version 3 bezieht sich auf die Akquise-Links, die Sie mithilfe des Akquise-Builders auf der Adobe Mobile Services-Benutzeroberfläche erstellen. Um diese Funktion zu verwenden, müssen Sie für Experience Cloud-Lösungen 4.6.0 oder höher auf Android SDK 4.x aktualisieren.
Wenn die mobile App beim Erstellen des Kampagnenlinks noch nicht in Google Play vorhanden ist, können Sie eine beliebige mobile App als Ziel auswählen. Dies wirkt sich nur auf die App aus, an die Sie vom Akquise-Server umgeleitet werden, wenn Sie auf den Akquise-Link klicken – nicht auf die Möglichkeit, den Link zu testen. Abfragezeichenfolgen-Parameter, die im Rahmen eines Kampagnen-Broadcasts an die App übergeben werden, wenn diese installiert wird, werden an den Google Play Store übergeben. Hin&Zurück-Akquisetests für mobile Apps erfordern die Simulation eines solchen Broadcasts.
Vor jedem Testlauf muss die App neu installiert bzw. müssen ihre Daten in den Einstellungen gelöscht werden. So wird gewährleistet, dass die anfänglichen Lebenszyklusmetriken mit den Abfragezeichenfolgen-Parametern der Kampagne gesendet werden, wenn die App zum ersten Mal gestartet wird.
  1. Führen Sie die erforderlichen Aufgaben in App-Akquise aus und stellen Sie sicher, dass Sie den Broadcast-Empfänger für INSTALL_REFERRER ordnungsgemäß implementiert haben.
  2. Klicken Sie in der Adobe Mobile Services-Benutzeroberfläche auf Akquise > Marketing Links Builder und generieren Sie eine Akquise-Marketinglink-URL, die Google Play als Ziel für Android-Geräte festlegt.
    Weitere Informationen finden Sie unter Marketing Links Builder .
    Beispiel: https://c00.adobe.com/v3/<appid>/start?a_i_id=iostestapp&a_g_id=com.adobe.android&a_dd=g&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=trackingcode .
    Wenn Sie im Akquise-Link sowohl auf die Android- als auch auf die iOS-App verweisen, nutzen Sie Google Play als standardmäßigen Store.
  3. Öffnen Sie den generierten Link in einem Desktop-Browser.
    Sie sollten auf eine Seite umgeleitet werden, deren URL folgendem Beispiel ähnelt: https://play.google.com/store/apps/details?id=com.adobe.android&referrer=utm_campaign%3Dadb_acq_v3%26utm_source%3Dadb_acq_v3%26utm_content%3D91b52ce097b1464b9b47cb2995c493cc6ab2c3a3
  4. Kopieren Sie die eindeutige ID hinter utm_content%3D .
    Im vorherigen Beispiel lautet die ID 91b52ce097b1464b9b47cb2995c493cc6ab2c3a3 .
  5. Erstellen Sie einen Akquise-Endlink mithilfe der eindeutigen URL aus Schritt 3. Verwenden Sie hierfür folgendes Format:
    https://c00.adobe.com/v3/<appid>/end?a_ugid=<unique id> .
    Beispiel: https://c00.adobe.com/v3/<appid>/end?a_ugid=91b52ce097b1464b9b47cb2995c493cc6ab2c3a3 .
  6. Öffnen Sie den Link in einem Desktop-Browser.
    Sie sollten die Kontextdaten ( contextData ) in der JSON-Antwort sehen:
    {"fingerprint":"228d7e6058b1d731dc7a8b8bd0c15e1d78242f31","timestamp":1457989293,"appguid":"","contextData":{"a.referrer.campaign.name":"name","a.referrer.campaign.trackingcode":"trackingcode"}}.
    Wenn die Kontextdaten ( contextData ) nicht angezeigt werden oder Teile der Zeichenfolge fehlen, stellen Sie sicher, dass die Akquise-URL das Format aus Akquise-Link manuell erstellen aufweist.
  7. Wiederholen Sie Schritt 3, um eine neue eindeutige URL zu erhalten.
  8. Stellen Sie sicher, dass die folgenden Einstellungen in Ihrer Konfigurationsdatei vorhanden sind:
    Wenn
    Wert
    Akquise
    Der Server sollte c00.adobe.com lauten. appid sollte der appid in Ihrem Akquise-Link entsprechen.
    analytics
    Legen Sie zu Testzwecken genügend Zeit für das Referrer-Timeout fest (mindestens 60 Sekunden), um den Broadcast manuell zu senden. Sie können die ursprüngliche Timeout-Einstellung nach dem Test wiederherstellen.
  9. Verbinden Sie das Gerät mit einem Computer, deinstallieren Sie die App und installieren Sie sie anschließend erneut.
  10. Starten Sie ADB Shell und rufen Sie die Anwendung auf dem Gerät auf.
  11. Senden Sie einen Broadcast mithilfe des folgenden adb -Befehls:
    am broadcast -a com.android.vending.INSTALL_REFERRER -n com.adobe.android/com.adobe.android.YourBroadcastReceiver --es "referrer" "utm_source=adb_acq_v3&utm_campaign=adb_acq_v3&utm_content=<unique id get on step 5>"
  12. Führen Sie die folgenden Schritte aus:
    1. Ersetzen Sie com.adobe.android durch den Paketnamen Ihrer Anwendung.
    2. Ändern Sie die Empfängerreferenz zum Standort des Kampagnenverfolgungs-Empfängers in Ihrer App
    3. Ersetzen Sie die Werte für utm_content . Wenn der Broadcast erfolgreich ist, können Sie eine Antwort ähnlich der folgenden erhalten:
    Broadcasting: Intent { act=com.android.vending.INSTALL_REFERRER cmp=com.adobe.adms.tests/.ReferralReceiver (has extras) } Broadcast completed: result=0
  13. (Optional) Sie können die Debugging-Protokollierung des SDK aktivieren, um zusätzliche Informationen zu erhalten.
    Wenn alles funktioniert, sollten Sie folgende Protokolle erhalten:
"Analytics - Received referrer information(<referrer content>)" "Analytics - Trying to fetch referrer data from (acquisition end url)"; "Analytics - Received Referrer Data(<A JSON Response>)"
Falls die obigen Protokolle nicht angezeigt werden, sollten Sie sicherstellen, dass Sie die Schritte 6 und 12 abgeschlossen haben.
Die folgende Tabelle enthält zusätzliche Informationen zu möglichen Fehlern:
Fehler
Beschreibung
Analytics - Unable to decode response( String ).
Die Antwort ist falsch formatiert.
Analytics - Unable to parse response ( a JSON Response ).
Die JSON-Zeichenfolge ist falsch formatiert.
Analytics - Unable to parse acquisition service response (no contextData parameter in response).
In der Antwort ist kein contextData-Parameter enthalten.
Analytics - Acquisition referrer data was not complete (no a.referrer.campaign.name in context data), ignoring.
a.referrer.campaign.name ist nicht in contextData vorhanden.
Analytics - Acquisition referrer timed out.
Die Antwort konnte nicht in der durch referrerTimeout festgelegten Zeit abgerufen werden. Erhöhen Sie den Wert und versuchen Sie es erneut. Sie sollten auch sicherstellen, dass Sie den Akquise-Link geöffnet haben, bevor Sie die App installieren.
Beachten Sie die folgenden Informationen:
  • Von der App gesendete Treffer können über HTTP-Überwachungstools überwacht werden, um die Akquise-Attribution zu überprüfen.
  • Weitere Informationen zu INSTALL_REFERRER -Broadcasts finden Sie unter Testen der Google Play-Kampagnenmessung im Google Developers-Handbuch.
  • Es wurde ein Fehler der Akquise unter Android 4.8.2 behoben.
    Führen Sie vor dem Test ein Upgrade auf die neueste SDK-Version durch.
  • Sie können das bereitgestellte Java-Tool acquisitionTest.jar verwenden, um die eindeutige ID abzurufen und den Installations-Referrer-Broadcast durchzuführen. So erhalten Sie die Informationen aus den Schritten 3 bis 12.
    Installation des Java-Tools
So installieren Sie das Java-Tool:
  1. Laden Sie die Datei acquisitionTester.zip herunter.
  2. Entpacken Sie die JAR-Datei.
    Sie können die Datei über die Befehlszeile ausführen.
    Beispiel:
    java -jar acquisitionTester.jar -a com.adobe.test -r com.adobe.test.ReferrerReceiver -l "https://c00.adobe.com/v3/appid/start?a_i_id=123456&a_g_id=com.adobe.test&a_dd=i&ctxa.referrer.campaign.name=name&ctxa.referrer.campaign.trackingcode=1234