Customer Journey Analytics BI-Erweiterung
Der Customer Journey Analytics BI extension ermöglicht SQL-Zugriff auf Datenansichten, die Sie in Customer Journey Analytics definiert haben. Ihre Dateningenieurinnen und -ingenieure sowie Ihre Datenanalytikerinnen und -analytiker sind möglicherweise besser mit Power BI, Tableau oder anderen Business Intelligence- und Visualisierungs-Tools (im Folgenden „BI-Tools“ genannt) vertraut. Sie können jetzt Berichte und Dashboards basierend auf denselben Datenansichten erstellen, die Benutzerinnen und Benutzer von Customer Journey Analytics beim Erstellen ihrer Analysis Workspace-Projekte verwenden.
Der Abfrage-Service von Adobe Experience Platform ist die SQL-Schnittstelle zu Daten, die im Data Lake von Experience Platform verfügbar sind. Wenn der Customer Journey Analytics BI extension aktiviert ist, wird die Funktionalität von Query Service erweitert, damit Ihre Datenansichten von Customer Journey Analytics als Tabellen oder Ansichten in einer Query Service-Sitzung zu sehen sind. Daher profitieren Business-Intelligence-Tools, die Query Service als Ihre PostgresSQL-Schnittstelle verwenden, nahtlos von dieser erweiterten Funktion.
Die wichtigsten Vorteile sind:
- Es ist nicht erforderlich, eine äquivalente Darstellung von Datenansichten aus Customer Journey Analytics im BI-Tool selbst zu erstellen.
Siehe Datenansichten für weitere Informationen zur Funktionalität von Datenansichten, um zu verstehen, was neu erstellt werden muss. - Mehr Konsistenz bei Reporting und Analyse zwischen BI-Tools und Customer Journey Analytics.
- Kombinieren Sie Customer Journey Analytics-Daten mit anderen Datenquellen, die bereits in BI-Tools verfügbar sind.
Voraussetzungen
Um diese Funktion verwenden zu können, müssen Sie:
-
Konfigurieren Sie die Funktionalität für die relevanten Produktprofile, Benutzergruppen und/oder einzelnen Benutzer. Zu den Zugriffsanforderungen gehören:
- Query Service von Adobe Experience Platform
- Workspace-Projekte im Customer Journey Analytics
- Gewünschte CJA-Datenansichten zur Verwendung
- Zugriff auf die BI-Erweiterung in den Datenansichts-Tools
-
Verwenden Sie das Ablaufdatum für nicht ablaufende Anmeldedaten, um BI-Tools mit dem Customer Journey Analytics BI extension. Die Handbuch zu Anmeldeinformationen enthält weitere Informationen zum Festlegen ablaufender oder nicht ablaufender Anmeldeinformationen.
Weitere Informationen sind im Abschnitt „Verwaltung von Customer Journey Analytics“ unter Zugriffssteuerung zu finden.
Nutzung
Um die Funktion Customer Journey Analytics BI extension zu verwenden, können Sie SQL entweder direkt verwenden oder das Drag-and-Drop-Erlebnis verwenden, das im jeweiligen BI-Tool verfügbar ist.
SQL
Sie können die Funktion direkt in SQL-Anweisungen verwenden, indem Sie entweder den Abfrageeditor oder einen standardmäßigen Client der Befehlszeilenschnittstelle (CLI) von Postgres verwenden.
In Adobe Experience Platform:
-
Wählen Sie **** Abfragen **** unter DATEN-MANAGEMENT in der linken Leiste aus.
-
Wählen Sie Abfrage erstellen aus.
-
Wählen Sie die
cja
Datenbank . -
Um die Abfrage auszuführen, geben Sie Ihre SQL-Anweisung ein und wählen Sie die Taste (oder drücken
[SHIFT]
+[ENTER]
).
-
Suchen und kopieren Sie Ihre PostgresSQL-Anmeldeinformationen in Adobe Experience Platform:
-
Wählen Sie **** Abfragen **** aus der linken Leiste (unter DATEN-MANAGEMENT ) aus.
-
Wählen Sie Anmeldeinformationen aus der oberen Leiste aus.
-
Wählen Sie die
cja
Datenbank . -
Um die Befehlszeichenfolge zu kopieren, verwenden Sie im PSQL-Befehl Abschnitt.
-
-
Öffnen Sie einen Befehl oder ein Terminal-Fenster.
-
Um sich anzumelden und mit der Ausführung Ihrer Abfragen zu beginnen, fügen Sie die Befehlszeichenfolge in Ihr Terminal ein.
Siehe Anleitung zur Benutzeroberfläche des Abfrageeditors für weitere Informationen.
BI-Tools
Derzeit wird die Customer Journey Analytics BI extension wird nur für Power BI und Tableau unterstützt und getestet. Andere BI-Tools, die die PSQL-Oberfläche verwenden, funktionieren möglicherweise ebenfalls, werden jedoch noch nicht offiziell unterstützt.
-
Suchen Sie die Details Ihrer PostgresSQL-Anmeldedaten in Adobe Experience Platform:
-
Wählen Sie **** Abfragen **** aus der linken Leiste (unter DATEN-MANAGEMENT ) aus.
-
Wählen Sie Anmeldeinformationen aus der oberen Leiste aus.
-
Wählen Sie die
cja
Datenbank . -
Verwenden Sie , um jeden Parameter der Postgres-Anmeldeinformationen (Host, Port, Datenbank, Benutzername und andere) zu kopieren, wenn sie in Power BI benötigt werden.
-
-
In Power BI:
-
Wählen Sie im Hauptfenster Daten abrufen aus der oberen Symbolleiste aus.
-
Wählen Sie Mehr… in der linken Leiste aus.
-
Suchen Sie im Bildschirm Daten abrufen nach
PostgresSQL
und wählen Sie die PostgresSQL-Datenbank aus der Liste aus. -
Im Dialogfeld PostgresSQL-Datenbank :
-
Fügen Sie den Parameter **** Host **** aus den Anmeldeinformationen von Experience Platform-Abfragen in das Textfeld Server ein.
-
Fügen Sie den Parameter **** Datenbank **** aus den Anmeldedaten von Experience Platform-Abfragen in das Textfeld Datenbank ein.
Fügen Sie
?FLATTEN
zum Parameter Datenbank hinzu, damit er sich beispielsweise liest wieprod:cja?FLATTEN
. Weitere Informationen finden Sie unter Reduzieren verschachtelter Datenstrukturen für die Verwendung mit BI-Tools von Drittanbietern. -
Wenn Sie dazu aufgefordert werden Data Connectivity mode, select DirectQuery.
-
Sie werden aufgefordert, Benutzername und Passwort einzugeben. Verwenden Sie die entsprechenden Parameter aus den Anmeldeinformationen von Experience Platform-Abfragen.
-
-
Nach erfolgreicher Anmeldung werden die Customer Journey Analytics-Datenansichtstabellen in der Power BI Navigator .
-
Wählen Sie die Datenansichtstabellen aus, die Sie verwenden möchten, und wählen Sie dann Laden aus.
Alle Dimensionen und Metriken, die mit einer oder mehreren ausgewählten Tabellen verknüpft sind, werden im rechten Bereich angezeigt und können in Ihren Visualisierungen verwendet werden.
Weitere Informationen sind unter Verbinden von Power BI mit dem Abfrage-Service zu finden.
-
-
Suchen Sie die Details Ihrer PostgresSQL-Anmeldedaten in Adobe Experience Platform:
-
Wählen Sie **** Abfragen **** aus der linken Leiste (unter DATEN-MANAGEMENT ) aus.
-
Wählen Sie Anmeldeinformationen aus der oberen Leiste aus.
-
Wählen Sie die
cja
Datenbank . -
Verwenden Sie , um jeden Parameter der Postgres-Anmeldedaten (Host, Port, Datenbank, Benutzername und andere) bei Bedarf in Tableau zu kopieren.
-
-
In Tableau:
-
Wählen Sie **** Mehr **** aus Zu einem Server in der linken Leiste aus.
-
Wählen Sie PostgresSQL aus der Liste aus.
-
Im Dialogfeld PostgresSQL:
-
Fügen Sie den Parameter **** Host **** aus den Anmeldeinformationen von Experience Platform-Abfragen in das Textfeld Server ein.
-
Fügen Sie den Parameter **** Port **** aus den Anmeldeinformationen von Experience Platform-Abfragen in das Textfeld Port ein.
-
Fügen Sie den Parameter **** Datenbank **** aus den Anmeldeinformationen von Experience Platform-Abfragen in das Textfeld Datenbank ein.
Fügen Sie
%3FFLATTEN
zum Parameter Datenbank hinzu, damit er sich beispielsweise liest wieprod:cja%3FFLATTEN
. Weitere Informationen finden Sie unter Reduzieren verschachtelter Datenstrukturen für die Verwendung mit BI-Tools von Drittanbietern. -
Wählen Sie **** Benutzername und Passwort **** aus der Liste Authentifizierung aus.
-
Fügen Sie den Parameter **** Benutzername **** aus den Anmeldeinformationen von Experience Platform-Abfragen in das Textfeld Benutzername ein.
-
Fügen Sie den Parameter **** Passwort **** aus den Anmeldeinformationen von Experience Platform-Abfragen in das Textfeld Passwort ein.
-
Wählen Sie Anmelden aus.
-
-
Customer Journey Analytics-Datenansichten werden als Tabellen in der Verzeichnis Liste.
-
Ziehen Sie die Tabellen, die Sie verwenden möchten, auf die Arbeitsfläche.
Sie können jetzt mit den Daten aus den Datenansichtstabellen arbeiten, um Ihre Berichte und Visualisierungen zu erstellen.
Weitere Informationen erhalten Sie unter Verbinden von Tableau mit dem Abfrage-Service.
-
Siehe Verbinden von Clients mit dem Abfrage-Service, um einen Überblick und weitere Informationen über die verschiedenen verfügbaren Tools zu erhalten.
Funktionalität
Standardmäßig wird für Ihre Datenansichten ein tabellensicherer Name aus ihrem Anzeigenamen generiert. Beispielsweise die Datenansicht mit dem Namen Meine Webdatenansicht hat den Namen der Ansicht my_web_data_view
. Sie können einen bevorzugten Namen definieren, der in Ihrem BI-Tool für Ihre Datenansicht verwendet werden soll. Siehe Datenansichtseinstellungen für weitere Informationen.
Wenn Sie die Datenansichts-IDs als Tabellennamen verwenden möchten, können Sie beim Verbinden die optionale Einstellung für CJA_USE_IDS
auf Ihren Datenbanknamen festlegen. Zum Beispiel zeigt prod:cja?CJA_USE_IDS
Ihre Datenansichten mit Namen wie dv_ABC123
an.
Data Governance
Einstellungen in Bezug auf die Data Governance in Customer Journey Analytics werden von Adobe Experience Platform übernommen. Die Integration zwischen Customer Journey Analytics und Adobe Experience Platform Data Governance ermöglicht die Kennzeichnung sensibler Daten von Customer Journey Analytics und die Durchsetzung von Datenschutzrichtlinien.
Datenschutzbeschriftungen und -richtlinien, die für von Experience Platform genutzte Datensätze erstellt wurden, können im Datenansichts-Workflow von Customer Journey Analytics angezeigt werden. Daher werden Daten mit der Variablen Customer Journey Analytics BI extension bei Nichteinhaltung der definierten Datenschutzbezeichnungen und Datenschutzrichtlinien entsprechende Warnungen oder Fehler anzeigen.
Auflisten von Datenansichten
In der standardmäßigen PostgresSQL-CLI können Sie Ihre Ansichten mithilfe von \dv
auf folgende Arten anzeigen:
prod:all=> \dv
List of relations
Schema | Name | Type | Owner
--------+--------------------------------------------+------+----------
public | my_web_data_view | view | postgres
public | my_mobile_data_view | view | postgres
Verschachtelt oder reduziert
Standardmäßig verwendet das Schema Ihrer Datenansichten verschachtelte Strukturen wie die ursprünglichen XDM-Schemata. Die Integration unterstützt auch die Option FLATTEN
. Mit dieser Option können Sie erzwingen, dass das Schema für die Datenansichten (und jede andere Tabelle in der Sitzung) reduziert wird. Die Reduzierung ermöglicht eine einfachere Verwendung in BI-Tools, die keine strukturierten Schemata unterstützen. Weitere Informationen finden Sie unter Arbeiten mit verschachtelten Datenstrukturen im Abfrage-Service.
Unterstützte SQL
Die vollständige Referenz dazu, welcher SQL-Typ unterstützt wird, finden Sie unter SQL-Referenz für den Abfrage-Service.
Beispiele für SQL, die Sie verwenden können, finden Sie in der folgenden Tabelle.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto | |
---|---|
Muster | Beispiel |
Schema-Erkennung |
|
Mit Ranking/Aufschlüsselung |
|
HAVING clause |
|
Eindeutige, obere Dimensionswerte |
|
Metriksummen |
|
Mehrere Dimensionen Aufschlüsselungen und obere eindeutige Werte |
|
Unterauswahl: Zusätzliche Filter Ergebnisse |
|
Unterauswahl: Abfrage über Datenansichten |
|
Unterauswahl: Ebenenquelle, Filtern, und Aggregation |
Geschichtet, mit den Unterauswahlen:
Ebenen, die CTE WITH verwenden:
|
Wählt aus, wo die Metriken vor den Dimensionen erscheinen oder mit den Dimensionen gemischt werden |
|
Dimensionen
Sie können jede der Dimensionen auswählen, die standardmäßig verfügbar oder in der Datenansicht definiert sind. Sie wählen eine Dimension anhand ihrer ID aus.
Metriken
Folgende Metriken stehen zur Auswahl:
- Jede der standardmäßig verfügbaren Metriken;
- Definiert in der Datenansicht;
- Berechnete Metriken, die mit der Datenansicht kompatibel sind, auf die der Benutzer Zugriff hat.
Sie wählen eine Metrik anhand ihrer ID aus, die in einen SUM(metric)
-Ausdruck eingeschlossen ist, wie Sie es mit jeder SQL-Quelle tun würden.
Sie können:
SELECT COUNT(*)
oderCOUNT(1)
verwenden, um die Metrik „Vorfälle“ zu erhalten.SELECT COUNT(DISTINCT dimension)
oderSELECT APPROX_COUNT_DISTINCT(dimension)
verwenden, um die ungefähren eindeutigen Werte einer Dimension zu zählen. Siehe Details unter Zählung unterschiedlicher Werte.- Inline-Berechnungen , um Metriken spontan zu kombinieren und/oder mathematisch zu gestalten.
Zählung unterschiedlicher Werte
Aufgrund der zugrunde liegenden Funktionsweise von Customer Journey Analytics ist die einzige Dimension, für die Sie die Anzahl der eindeutigen Werte genau bestimmen können, die Dimension adobe_personid
. Die folgenden SQL-Ausdrücke SELECT COUNT(DISTINCT adobe_personid)
oder SELECT APPROX_COUNT_DISTINCT(adobe_personid)
geben den Wert der Standardmetrik „Personen“ zurück, die der Anzahl der eindeutigen Personen entspricht. Bei anderen Dimensionen wird eine ungefähre Zählung der eindeutigen Personen zurückgegeben.
Bedingte Metriken
Sie können die Klausel IF
oder CASE
in der Funktion SUM
oder COUNT
einbetten, um eine zusätzliche Filterung hinzuzufügen, die spezifisch für eine ausgewählte Metrik ist. Das Hinzufügen dieser Klauseln ähnelt dem Anwenden eines Filters auf eine Metrikspalte in einer Workspace-Berichtstabelle.
Beispiele:
SUM(IF(dim1 = 'X' AND dim2 = 'A', metric1, 0)) AS m1
SUM(CASE WHEN dim1 = 'X' AND dim2 = 'A' THEN metric1 END) AS m1
Inline-Berechnungen
Sie können zusätzliche Mathematik auf Metrikausdrücke in Ihrer SELECT
anstatt die Mathematik in einer berechneten Metrik zu definieren. In der folgenden Tabelle ist aufgeführt, welche Arten von Ausdrücken unterstützt werden.
+
, -
, *
, /
, und %
-X
oder +X
PI()
POSITIVE
, NEGATIVE
, ABS
, FLOOR
, CEIL
, CEILING
, EXP
, LN
, LOG10
, LOG1P
, SQRT
, CBRT
, DEGREES
, RADIANS
, SIN
, COS
, TAN
, ACOS
, ASIN
, ATAN
, COSH
, SINH
und TANH
MOD
, POW
, POWER
, ROUND
, LOG
Spezielle Spalten
Zeitstempel
Die spezielle Spalte timestamp
wird verwendet, um die Datumsbereiche für die Abfrage bereitzustellen. Ein Datumsbereich kann durch einen BETWEEN
-Ausdruck oder ein mit AND
verbundenes Paar aus den Überprüfungen timestamp
>
, >=
, <
, <=
definiert werden.timestamp
ist optional, und falls kein vollständiger Bereich angegeben wird, werden die Standardwerte verwendet:
- Wenn nur ein Minimum angegeben wird (
timestamp > X
odertimestamp >= X
), reicht der Bereich von X bis jetzt. - Wenn nur eine maximale Anzahl angegeben wird (
timestamp < X
odertimestamp <= X
), liegt der Bereich zwischen X minus 30 Tagen und X. - Wenn nichts angegeben wird, liegt der Bereich von jetzt abzüglich 30 Tagen bis jetzt.
Der Zeitstempelbereich wird in einen globalen Datumsbereich-Filter in RankedRequest konvertiert.
Das Zeitstempelfeld kann auch in Datums-/Uhrzeitfunktionen verwendet werden, um den Zeitstempel des Ereignisses zu analysieren oder abzuschneiden.
Datumsbereich
Die Sonderspalte daterange
funktioniert ähnlich wie timestamp
, die Filterung ist jedoch hier auf volle Tage beschränkt. daterange
ist ebenfalls optional und hat denselben Standardbereich wie timestamp
.
Die daterange
-Feld kann auch in Datums-/Uhrzeitfunktionen verwendet werden, um das Ereignisdatum zu analysieren oder abzuschneiden.
Die daterangeName
Eine spezielle Spalte kann verwendet werden, um Ihre Abfrage mit einem benannten Datumsbereich wie Last Quarter
.
daterange
Metriken, die weniger als einen Tag betragen (Stunde, 30 Minuten, 5 Minuten usw.).Filter-ID
Die spezielle Spalte filterId
ist optional und wird verwendet, um einen extern definierten Filter auf die Abfrage anzuwenden. Das Anwenden eines extern definierten Filters auf eine Abfrage ähnelt dem Ziehen eines Filters auf ein Bedienfeld in Workspace. Mehrere Filter-IDs können durch Verbinden mit AND
bereitgestellt werden.
Zusammen mit filterId
, können Sie filterName
, um den Namen eines Filters anstelle der ID zu verwenden.
Wo
Die WHERE
-Klausel wird in drei Schritten verarbeitet:
-
Suchen Sie den Datumsbereich aus dem
timestamp
,daterange
oderdaterangeName
spezielle Felder. -
Suchen nach extern definierten
filterId
s oderfilterName
s, die in die Filterung einbezogen werden sollen. -
Umwandeln der verbleibenden Ausdrücke in Ad-hoc-Filter.
Die Umsetzung erfolgt durch Parsen der ersten Ebene von AND
s in der WHERE
-Klausel. Jede oberste Ebene AND
-ed -Ausdruck muss mit einem der oben genannten Werte übereinstimmen. Alles, was tiefer als die erste Ebene der AND
-Operatoren ist, oder, wenn die WHERE
-Klausel auf der obersten Ebene OR
-Operatoren verwendet, wird als Ad-hoc-Filter behandelt.
Sortierreihenfolge
Standardmäßig sortiert die Abfrage die Ergebnisse nach der ersten ausgewählten Metrik in absteigender Reihenfolge. Sie können die Standardsortierreihenolge überschreiben, indem Sie ORDER BY ... ASC
oder ORDER BY ... DESC
angeben. Wenn Sie ORDER BY
verwenden, müssen Sie in der ersten ausgewählten Metrik ORDER BY
angeben.
Sie können die Reihenfolge auch umdrehen, indem Sie -
(Minus) vor der Metrik verwenden. Die beiden folgenden Anweisungen ergeben dieselbe Reihenfolge:
ORDER BY metric1 ASC
ORDER BY -metric1 DESC
Allgemeine Funktionsunterstützung
CAST(`timestamp` AS STRING)
oder`timestamp`::string
CAST
-Funktion wird ignoriert.WHERE `timestamp` >= TIMESTAMP('2022-01-01 00:00:00') AND `timestamp` < TIMESTAMP('2022-01-02 00:00:00')
WHERE
-Klausel.WHERE `timestamp` >= TO_TIMESTAMP('01/01/2022', 'MM/dd/yyyy') AND `timestamp` < TO_TIMESTAMP('01/02/2022', 'MM/dd/yyyy')
WHERE
-Klausel, wobei optional ein Format für diese Zeitzeichenfolge angegeben werden kann.WHERE `timestamp` >= DATE('2022-01-01') AND `timestamp` < DATE('2022-01-02')
WHERE
-Klausel.WHERE `timestamp` >= TO_DATE('01/01/2022', 'MM/dd/yyyy') AND `timestamp` < TO_DATE('01/02/2022', 'MM/dd/yyyy')
WHERE
-Klausel, wobei optional ein Format für diese Datumszeichenfolge angegeben werden kann.Unterstützung von Dimension-Funktionen
Diese Funktionen können für Dimensionen in der WHERE
- oder SELECT
-Klausel oder in bedingten Metriken verwendet werden.
Zeichenfolgen-Funktionen
SELECT LOWER(name) AS lower_name
Funktionen für Datum/Uhrzeit
SELECT YEAR(`timestamp`)
SELECT MONTH(`timestamp`)
SELECT DAYOFWEEK(`timestamp`)
SELECT DAYOFYEAR(`timestamp`)
SELECT WEEK(`timestamp`)
SELECT QUARTER(`timestamp`)
SELECT HOUR(`timestamp`)
SELECT MINUTE(`timestamp`)
SELECT EXTRACT(MONTH FROM `timestamp`)
Folgende Teile werden unterstützt:
-Suchbegriffe:
YEAR
, MONTH
, DAYOFMONTH
, DAYOFWEEK
, DAYOFYEAR
, WEEK
, QUARTER
, HOUR
, MINUTE
.-Zeichenfolgen:
'YEAR'
, 'Y'
, 'MONTH'
, 'M'
, 'DAYOFMONTH'
, 'DAY'
, 'D'
, 'DAYOFWEEK'
, 'DOW'
, 'DAYOFYEAR'
, 'DOY'
, 'WEEK'
, 'WOY
, 'W'
, 'QUARTER'
, 'QOY'
, 'Q'
, 'HOUR'
oder 'MINUTE'
.SELECT DATE_PART('month', `timestamp`)
Unterstützte Zeichenfolgenteile sind:
'YEAR'
, 'Y'
, 'MONTH'
, 'M'
, 'DAYOFMONTH'
, 'DAY'
, 'D'
, 'DAYOFWEEK'
, 'DOW'
, 'DAYOFYEAR'
, 'DOY'
, 'WEEK'
, 'WOY
, 'W'
, 'QUARTER'
, 'QOY'
, 'Q'
, 'HOUR'
o der 'MINUTE'
.SELECT DATE_TRUNC('quarter', `timestamp`)
Folgende Zeichenfolgengranularitäten werden unterstützt:
'YEAR'
, 'Y'
, 'MONTH'
, 'M'
, 'DAYOFMONTH'
, 'DAY'
, 'D'
, 'DAYOFWEEK'
, 'DOW'
, 'DAYOFYEAR'
, 'DOY'
, 'WEEK'
, 'WOY
, 'W'
, 'QUARTER'
, 'QOY'
, 'Q'
, 'HOUR'
oder 'MINUTE'
.