Implementierung von Analytics für Target

Bei der Implementierung von Adobe Analytics als Berichtsquelle für Adobe Target (A4T) sind mehrere Schritte erforderlich. Der Prozess variiert je nachdem, ob Sie A4T mit Adobe Experience Platform Web SDK oder mit at.js implementieren.

Implementierungsschritte für eine Adobe Experience Platform Web SDK-Implementierung platform

In den folgenden Abschnitten werden die Schritte beschrieben, die zum Bereitstellen dieser Integration auf Ihrer Site erforderlich sind, wenn Sie das Platform Web SDK verwenden möchten:

Schritt 1: Anfordern der Bereitstellung für Analytics und Target

Vor der Implementierung von A4T müssen Sie für Analytics und Target freigeschaltet werden. Verwenden Sie dieses Formular, um die Bereitstellung anzufordern.

Schritt 2: Einrichten der Benutzerberechtigungen

Die Benutzerkontoanforderungen müssen erfüllt sein, bevor Sie eine Aktivität erstellen können, die auf Analytics in Target basiert. Siehe Anforderungen an Benutzerberechtigungen.

Schritt 3: Erstellen einer Edge-Konfiguration

Erstellen Sie mit dem Edge-Konfigurationstool eine Edge-Konfiguration mit "Adobe Experience Platform". Konfigurieren Sie die Erstellung und Konfiguration von Datastreams.

Schritt 4: Installieren und Konfigurieren des Platform Web SDK

Um mit der Bereitstellung von Target Erlebnissen zu beginnen und Analytics für Tracking- und Analysezwecke anzuwenden, Installieren und konfigurieren Sie das Platform Web SDK auf Ihren Webseiten.

Schritt 5: Aktivieren der Optionen für die Verwendung von A4T

Klicken Sie in der Target -Benutzeroberfläche auf Administration > Visual Experience Composer und wählen Sie dann entweder Select per activity oder Adobe Analytics aus.

Implementierungsschritte für eine at.js-Implementierung section_73961BAD5BB4430A95E073DE5C026277

In den folgenden Abschnitten werden die Schritte beschrieben, die zum Bereitstellen dieser Integration auf Ihrer Site erforderlich sind, wenn Sie at.js verwenden möchten:

Schritt 1: Anfordern der Bereitstellung für Analytics und Target

Nachdem Sie Analytics als Berichtsquelle für Target implementiert haben, müssen Sie für Analytics und Target bereitgestellt werden. Verwenden Sie dieses Formular, um die Bereitstellung anzufordern.

Schritt 2: Einrichten der Benutzerberechtigungen

Die Benutzerkontoanforderungen müssen erfüllt sein, bevor Sie eine Analytics-basierte Aktivität in Target erstellen können. Siehe Anforderungen an Benutzerberechtigungen.

Schritt 3: Implementieren des Experience Cloud-Besucher-ID-Service

Mit dem Besucher-ID-Dienst können Sie Benutzer über Adobe Experience Cloud -Lösungen hinweg identifizieren. Implementieren oder migrieren Sie die erforderliche Version der Experience Cloud-Besucher-ID. Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Siehe Implementieren des Experience Cloud ID-Diensts für Target in der Dokumentation zum Experience Cloud-Besucher-ID-Dienst .

Schritt 4: Aktualisierung von AppMeasurement für JavaScript oder s_code

Implementieren oder migrieren Sie die erforderliche Version von appMeasurement.js. Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Neue Implementierungen finden Sie unter JavaScript-Implementierungsübersicht im Analytics-Implementierungshandbuch.

Informationen zur Migration finden Sie unter Migration zu AppMeasurement für JavaScript im Analytics-Implementierungshandbuch.

Schritt 5: Herunterladen und Aktualisieren von at.js

Implementieren oder migrieren Sie mithilfe Ihres Produktionskontos zur erforderlichen Version von at.js. Es müssen keine Änderungen am Code vorgenommen werden.

Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Schritt 6: Hosten von at.js

Wenn Sie at.js bereits bereitgestellt haben, können Sie Ihre vorhandene Datei durch die aktualisierte Version ersetzen. Weitere Informationen finden Sie in den „Implementierungsanforderungen“ unter Vor der Implementierung.

Alternativ kann diese Datei zusammen mit dem Besucher-ID-Service und AppMeasurement for JavaScript-Dateien gehostet werden. Diese Dateien müssen auf einem Webserver gehostet werden, der für alle Seiten Ihrer Site zugänglich ist. Für den nächsten Schritt benötigen Sie den Pfad zu den Dateien.

Schritt 7: Verweisen auf at.js auf allen Seiten der Site step7

Fügen Sie at.js unterhalb von VisitorAPI.js ein, indem Sie dem Tag auf jeder Seite die folgende Codezeile hinzufügen:

Für at.js:

<script language="JavaScript" type="text/javascript"
src="http://INSERT-DOMAIN-AND-PATH-TO-CODE-HERE/at.js"></script>

Die Datei VisitorAPI.js muss vor at.js geladen werden. Wenn Sie eine vorhandene at.js-Datei aktualisieren, überprüfen Sie die Ladereihenfolge.

Die Standardeinstellung für die Integration von Target und Analytics besteht aus Implementierungsperspektive darin, die von der Seite übergebene SDID zu verwenden, um die Target - und Analytics -Anfrage automatisch am Backend zuzuordnen.

Sie können steuern, wie und wann Analysedaten im Zusammenhang mit Target an Analytics zu Berichtszwecken gesendet werden. Wenn Sie nicht die Standardeinstellungen Target und Analytics verwenden möchten, um die Analysedaten automatisch über die SDID zuzuordnen, legen Sie analyticsLogging = client_side über window.targetGlobalSettings fest. Hinweis: Keine Version unter 2.1 unterstützt diesen Ansatz.

Beispiel:

window.targetGlobalSettings = {
  analyticsLogging: "client_side"
};

Diese Einrichtung hat einen globalen Effekt, d. h. jeder Aufruf von at.js hat analyticsLogging: "client_side" , der innerhalb der Target -Anforderungen gesendet wird, und für jede Anfrage wird eine Analytics-Nutzlast zurückgegeben. Wenn diese Option eingerichtet ist, sieht das Format der zurückgegebenen Payload wie folgt aus:

"analytics": {
   "payload": {
      "pe": "tnt",
      "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
   }
}

Die Payload kann dann über die Dateneinfüge-API an Analytics weitergeleitet werden. Bei Aktivitäten mit automatischer Zuordnung und automatischem Targeting müssen Sie auch die sessionId weiterleiten. Weitere Informationen finden Sie unter Berichterstellung von Analytics for Target (A4T) im Handbuch Adobe Target SDKs .

Wenn keine globale Einstellung gewünscht wird und ein situationsbezogener Ansatz vorzuziehen ist, verwenden Sie die at.js-Funktion getOffers(), indem Sie analyticsLogging: "client_side" übergeben. Die Analytics-Payload wird nur für diesen Aufruf zurückgegeben und das Target-Backend leitet die Payload nicht an Analytics weiter. Bei diesem Ansatz gibt jede at.js Target -Anfrage standardmäßig die Payload zurück, jedoch nur, wenn dies gewünscht und spezifiziert ist.

Beispiel:

adobe.target.getOffers({
      request: {
        experienceCloud: {
          analytics: {
            logging: "client_side"
          }
        },
        prefetch: {
          mboxes: [{
            index: 0,
            name: "a1-serverside-xt"
          }]
        }
      }
    })
    .then(console.log)

Dieser Aufruf ruft eine Antwort auf, aus der Sie die Analyse-Nutzlast extrahieren können.

Die Antwort sieht wie folgt aus:

{
  "prefetch": {
    "mboxes": [{
      "index": 0,
      "name": "a1-serverside-xt",
      "options": [{
        "content": "<img src=\"http://s7d2.scene7.com/is/image/TargetAdobeTargetMobile/L4242-xt-usa?tm=1490025518668&fit=constrain&hei=491&wid=980&fmt=png-alpha\"/>",
        "type": "html",
        "eventToken": "n/K05qdH0MxsiyH4gX05/2qipfsIHvVzTQxHolz2IpSCnQ9Y9OaLL2gsdrWQTvE54PwSz67rmXWmSnkXpSSS2Q==",
        "responseTokens": {
          "profile.memberlevel": "0",
          "geo.city": "bucharest",
          "activity.id": "167169",
          "experience.name": "USA Experience",
          "geo.country": "romania"
        }
      }],
      "analytics": {
        "payload": {
          "pe": "tnt",
          "tnta": "167169:0:0|0|100,167169:0:0|2|100,167169:0:0|1|100"
        }
      }
    }]
  }
}

Die Payload kann dann über die Dateneinfüge-API an Analytics weitergeleitet werden.

Schritt 8: Validieren der Implementierung step8

Laden Sie Ihre Seiten, nachdem Sie die JavaScript-Bibliotheken aktualisiert haben, um sicherzustellen, dass die mboxMCSDID -Parameterwerte in Target -Aufrufen mit dem sdid -Parameterwert im Analytics-Seitenansichtsaufruf übereinstimmen.

Es ist besonders wichtig zu bestätigen, dass diese Werte in Einzelseiten-Apps (SPA) übereinstimmen, bei denen die Reihenfolge der Aufrufe nicht immer vorhersehbar ist.

Schritt 9: (Optional) Entfernen des vorherigen Integrationscodes

Adobe empfiehlt, die vorherige Integration zu entfernen, um Ihre Implementierung zu vereinfachen und die Notwendigkeit zur Regelung von Systemdiskrepanzen zu beseitigen. Sie können sämtlichen Code entfernen, den Sie für eine vorherige Integration von SC zu T&T bereitgestellt haben, einschließlich mboxLoadSCPlugin.

Schritt 10: Aktivieren der Optionen für die Verwendung von Analytics als Berichtsquelle für Target

Klicken Sie in Target auf Administration > Reporting und wählen Sie entweder Select per activity oder Adobe Analytics aus, um die Optionen zu aktivieren.