Bereitstellen der Integration

Die Bereitstellung dieser Integration ist ein einfacher Prozess, der die folgenden Aktionen erfordert.

Abschließen des Adobe-Integrationsassistenten

Zum Aktivieren der Integration müssen Sie den Konfigurationsassistenten auf der Data Connectors-Oberfläche ausführen.

1. Navigieren Sie in der Adobe Experience Cloud zum Bereich „Data Connectors“ (früher Genesis).
2. Starten Sie den Integrationsassistenten für Demandbase 2.0.
3. Wählen Sie die gewünschte Report Suite aus. Geben Sie dann einen Namen für die Integration ein.
4. Konfigurieren Sie die folgenden Elemente:

Element	Beschreibung
E-Mail Adresse	Die E-Mail-Adresse des Hauptkontakts.
Beschreibung	(Optional) Beschreibung für die Einrichtung dieser Integration.
Demandbase-API-Schlüssel	Diesen können Sie von Ihrem Demandbase-Kundenbetreuer erhalten.
Benutzerspezifische Demandbase-Dimensionsnr.	Dies sind die IDs für die 8 optionalen Dimensionen. Weitere Informationen finden Sie unter „Benutzerdefinierte Demandbase-Dimensionen“.
An Adobe Target senden	Bei „true“ werden die Demandbase-Dimensionen auch mit einer ausgeblendeten mbox an Adobe Target gesendet. Hinweis: Eine konfigurierte mbox.js-Datei muss auf der Webseite implementiert werden, damit Dimensionen erfasst werden.

1. Konfigurieren Sie die folgenden Variablenzuordnungselemente:

   Element	Beschreibung
   Demandbase-Dimensionen	Wählen Sie eine verfügbare eVar-Variable aus Ihrer Report Suite aus.
   Benutzerspezifische Demandbase-Dimensionen (optional)	Wählen Sie eine verfügbare eVar-Variable aus Ihrer Report Suite aus.

2. Konfigurieren Sie die Namen für die benutzerspezifische Dimension (falls zutreffend).

   1. Wenn Sie in Schritt 4 ausgewählt haben, benutzerspezifische Dimensionen einzubeziehen, und die optionale eVar in Schritt 5 zugeordnet haben, müssen Sie Anzeigenamen für diese Dimensionen angeben. Wenn Sie beispielsweise „stock_ticker“ als benutzerspezifische Dimension 1 eingeben möchten, sollten Sie das Feld, in dem „Dimension 1“ enthalten ist, in „Börsenticker“ ändern.
   2. Die Namen der 8 Standarddimensionen sollte NICHT geändert werden (d. h. „Demandbase-SID“, „Firmenname“, „Branche“).

3. Aktivieren Sie das Kästchen, damit das Dashboard für die Demandbase-Integration automatisch für Sie erstellt wird (empfohlen).

4. Überprüfen Sie alle Konfigurationselemente. Klicken Sie dann auf Jetzt aktivieren.

Bereitstellen des Integrationscodes

Nach Abschluss des Integrationsassistenten müssen Sie den Integrationscode für Ihren Adobe Analytics-Bereitstellungscode (s_code) bereitstellen.

1. Navigieren Sie zur Registerkarte Support, laden Sie die Ressource integration code v2_0_1 im Bereich „Ressourcen“ der Integration herunter und speichern Sie sie.

2. Nehmen Sie gegebenenfalls die erforderlichen Änderungen am Code vor. Weitere Informationen finden Sie unter „Ändern des Integrationscodes“ (auf dieser Seite).

3. Schließen Sie das Integrate-Modul ein, sofern es nicht bereits in Ihrem Adobe Analytics-Bereitstellungscode vorhanden ist.

4. Stellen Sie den Code mit einer der folgenden Methoden bereit:

   • Verwenden Sie Adobe TagManager oder Dynamic Tag Management, um den Code hinzuzufügen.
   • Sie können den Code auch an die Organisationsressource übermitteln, die für die Aktualisierung Ihres Adobe Analytics-Bereitstellungscodes zuständig ist.

Ändern des Integrationscodes

In den meisten Fällen müssen Sie keine Änderungen am Integrationscode vornehmen, der vom Data Connector-Assistenten erstellt wird.

Wenn Sie jedoch Anpassungen vornehmen müssen, können Sie einige der Codeeinstellungen konsultieren, die im Folgenden beschrieben sind.

Codeeinstellung	Beschreibung
s.maxDelay	Die maximale Anzahl von Millisekunden, welche die Adobe Analytics-Bildanforderung auf die Demandbase-Daten wartet, bevor sie an den Analytics-Erfassungsserver gesendet wird. Hinweis: Diese Einstellung gilt für alle Integrationen, die möglicherweise über das Integrate-Modul ausgeführt werden.
_db._key	Ihr Demandbase-API-Schlüssel.
_db._apiURL	Die URL-Vorlage für die Demandbase-API.
_db._delim	Das Trennzeichen, mit dem die Dimensionselemente der Demandbase getrennt werden, wenn sie an Adobe Analytics gesendet werden. Eine Änderung dieser Einstellung kann dazu führen, dass die standardmäßigen Klassifizierungsregeln nicht korrekt funktionieren.
_db._setTnt	Bei „true“ versucht der Integrationscode, mithilfe einer ausgeblendeten mbox die Demandbase-Dimensionen als Profilparameter an Adobe Target zu senden. Hinweis: Hierfür muss der mbox.js-Code auf der Seite vorhanden sein.
_db._tntVarPrefix	Diese Zeichenfolge wird jedem Demandbase-Dimensionsnamen vorangestellt, bevor er an Adobe Target gesendet wird. Wenn diese Einstellung beispielsweise den Wert „db_“ aufweist, wird die Dimension „industry“ als „db_industry“ an Adobe Target gesendet.
_db._dimensionsArray	Die Demandbase-Standarddimensionen, die an Adobe Analytics gesendet werden. Es wird empfohlen, diese Einstellung nicht zu ändern. Die Eigenschaft „max_size“ ist die Anzahl der zulässigen Zeichen für die Dimension, bevor die Kürzung erfolgt.
_db._dimensionsArrayCustom	Die benutzerspezifischen Demandbase-Dimensionen, die an Adobe Analytics gesendet werden. Die Eigenschaft „max_size“ ist die Anzahl der zulässigen Zeichen für die Dimension, bevor die Kürzung erfolgt.
_db._cName	Der Name des Sitzungs-Cookies, mit dem der Status für die Demandbase-API-Kommunikation beibehalten wird.
_db._contextName	Der Name der contextData-Variablen, mit der die Standarddimensionen an Adobe Analytics gesendet werden. Es wird empfohlen, diese Einstellung nicht zu ändern.
_db._contextNameCustom	Der Name der contextData-Variablen, mit der die benutzerspezifischen Dimensionen an Adobe Analytics gesendet werden. Es wird empfohlen, diese Einstellung nicht zu ändern.

Einschließen des Integrate-Moduls

Für den Integrationscode muss das Integrate-Modul in Ihrer Adobe Analytics-Bereitstellung vorhanden sein.

Wenn Sie das Integrate-Modul noch nicht im Rahmen Ihrer Bereitstellung installiert haben, führen Sie je nach Art der Implementierung die folgenden Schritte aus.

Für AppMeasurement v1.0+

1. Entpacken Sie die AppMeasurement-ZIP-Datei, die Sie unter Analytics > Admin > CodeManager heruntergeladen haben.

2. Öffnen Sie die Datei mit dem Namen AppMeasurement_Module_Integrate.js.

3. Kopieren Sie die Inhalte dieser Datei und fügen Sie diese in Ihre primäre AppMeasurement.js-Datei ein.

   HINWEIS

   Fügen Sie sie direkt vor dem Kommentar DO NOT ALTER ANYTHING BELOW THIS LINE (ÄNDERN SIE NICHTS UNTERHALB DIESER LINIE) in der Datei ein.

Für alten Code (H-Code)

1. Laden Sie das Integrate-Modul aus dem Bereich „Ressourcen“ auf der Data Connectors-Benutzeroberfläche herunter (unter der Registerkarte „Support“).

   

2. Kopieren Sie die Inhalte dieser Datei und fügen Sie diese in Ihre s_code-Datei ein.

   HINWEIS

   Fügen Sie sie direkt vor dem Kommentar DO NOT ALTER ANYTHING BELOW THIS LINE (ÄNDERN SIE NICHTS UNTERHALB DIESER LINIE) in der Datei ein.

Überprüfen der Integration

Überprüfen Sie anhand des Live-Trackings und der Berichterstellung, ob die Integration Daten erfolgreich erfasst.

Live-Tracking

Überprüfen Sie mit dem Debugger-Tool für DigitalPulse, ob Demandbase-Dimensionsdaten an Adobe Analytics gesendet werden. Laden Sie nach dem Löschen der Cookies eine Seite auf Ihrer Website neu, auf welcher der Integrationscode bereitgestellt wurde. Vorausgesetzt, dass Ihre aktuelle IP einer von Demandbase anerkannten Organisation zugeordnet ist, sollten Sie die folgenden Ergebnisse sehen.

„Reports & Analysen“ (früher „SiteCatalyst“) umfasst die beiden folgenden Demandbase-Kontextdatenvariablen:

Target Mbox enthält Parameter für das Demandbase-Profil:
Dies wird nur angezeigt, wenn Target auf der Seite implementiert ist UND Sie diese Integration für Adobe Target konfiguriert haben (siehe Schritt 4 des Adobe-Integrationsassistenten).

Berichterstellung

Überprüfen Sie Ihre Demandbase-Berichte in Adobe Analytics mit dem Dashboard, das automatisch mit dem Adobe-Integrationsassistenten erstellt wurde (Schritt 7).

Alternativ können Sie in der Menüstruktur von Adobe Analytics zur Demandbase-Berichterstellung navigieren (siehe Screenshots unten).

Häufig gestellte Fragen

Was bedeutet „[k. A.]“?

Der Demandbase-Data Connector gibt an, wenn ein Attribut nicht verfügbar ist, indem dieser Standardwert festgelegt wird. Es gibt zwei gängige Szenarien, in denen die Standardeinstellung festgelegt ist:

• Demandbase erkennt, dass der Besucher von einer IP-Adresse stammt, die nicht zu einer Firma gehört.
• Es wird ein Kontoüberwachungsattribut (beginnend mit „watch_list“) verwendet, die Firma befindet sich jedoch nicht in Ihrer Kontoüberwachungsliste.

Warum wird „[n/a]“ bei bestimmten Attributen häufiger angezeigt?

Demandbase klassifiziert alle IP-Adressen und stellt die Attribute „audience“ und „audience_segment“ bereit, auch wenn der Besucher nicht von einer Firmen-IP stammt. Wenn „audience“ Werte wie „Residential“ (Wohneinrichtung), „Wireless“ und „Hospitality“ (Bewirtung) zurückgibt, sind die übrigen Attribute wahrscheinlich nicht verfügbar.

Manchmal ist die Zielgruppe eines Besuchers „KMU“, aber andere Attribute zeigen „[n/a]“. Demandbase kann also den Besucher als kleines Unternehmen klassifizieren, aber das vollständige Firmenprofil ist nicht verfügbar. Dies geschieht in der Regel bei den kleinsten Firmen, wenn mehr als ein kleines Unternehmen denselben Dienstleister oder IP-Adressblock verwendet.

Hinweise für Entwickler

Wenn Sie den Standardwert in Ihrer Implementierung anpassen müssen, aktualisieren Sie die Zeile:

_db._nonOrgMatchLabel = "[n/a]";