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.

WICHTIG

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 verwenden zu können, müssen Sie auf Android SDK 4.x für Experience Cloud-Lösungen 4.6.0 oder höher aktualisieren.

Wenn sich die App noch nicht in Google Play befindet, wählen Sie beim Erstellen des Kampagne-Links eine beliebige App als Ziel aus. Dies betrifft nur die App, zu der Sie der Akquise-Server weiterleitet, nachdem Sie auf den Akquise-Link geklickt haben, hat jedoch keine Auswirkungen auf die Fähigkeit, den Link zu testen. Zeichenfolgenparameter der Abfrage werden an den Google Play Store übergeben, der bei der Installation im Zuge einer Kampagnenübertragung an die App übergeben wird. Für die Tests zur Akquise von Hin&Zurück-Abfragen mobiler Apps ist die Simulation dieser Art von Übertragungen erforderlich.

WICHTIG

Wenn Sie die Implementierung mit den Install-Referrer-APIs von Google Play durchführen, können Sie die Akquise erst testen, wenn sich Ihre App im Google Play Store befindet.

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.

    TIPP

    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 sein. appid sollte der appid in Ihrem Akquise-Link entsprechen.
    analytics Legen Sie für Testzwecke das Zeitlimit des Werbers so fest, dass ausreichend Zeit (mindestens 60 Sekunden) zum manuellen Durchführen des Versands zur Verfügung steht. Sie können die ursprüngliche Zeitlimiteinstellung 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 Protokolle oben nicht angezeigt werden, sollten Sie sicherstellen, dass Sie die Schritte 6 bis 12 abgeschlossen haben.

Die folgende Tabelle enthält weitere 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:

  • Treffer, die von der App gesendet werden, können mithilfe von HTTP-Überwachungstools überwacht werden, um die Akquise-Zuordnung zu überprüfen.

  • Weitere Informationen zu INSTALL_REFERRER-Broadcasts finden Sie unter Testen der Google Play-Kampagnenmessung im Google Developers-Handbuch.

  • Für Android 4.8.2 wurde eine Fehlerbehebung veröffentlicht.

    Aktualisieren Sie das SDK vor dem Testen auf die neueste Version.

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

    Java-Tool installieren

So installieren Sie das Java-Tool:

  1. Laden Sie die Datei acquisitionTester.zip herunter.

  2. Extrahieren Sie die JAR-Datei.

    Sie können die Datei in der 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
    

Auf dieser Seite