Verfolgen authentifizierter Benutzer mit Oracle Infinity im Web

Einführung

Dieses Tutorial zeigt, wie authentifizierte Benutzer auf Ihrer Website mit Oracle Infinity mit dem Oracle CX-Tag verfolgt werden, indem Sie Trackingparameter auf Benutzerebene zu Ihren Trackingaufrufen hinzufügen. Beispiel: Wenn Sie eine Kunden-ID für einen Benutzer deklarieren, können Sie den Umsatz pro Benutzer für eine E-Commerce-Website bestimmen oder Aktionen für authentifizierte Besucher auslösen.

Ziele

Das Tutorial hat folgende Ziele:

Voraussetzungen

Im Folgenden finden Sie die Voraussetzungen für dieses Tutorial:

Erstellen Sie ein Tag (für Ihr Oracle CX-Tag)

Sie müssen ein Tag für Ihre Website erstellt und konfiguriert haben:

Haben Sie bereits ein Oracle CX-Tag auf Ihrer Website?

Wenn Sie bereits ein Tag erstellt haben, das auf Ihrer Website verwendet wird, müssen Sie für diesen Anwendungsfall kein neues spezifisches Tag erstellen. Sie müssen sicherstellen, dass entweder (a) das vorhandene Tag bereits auf den erforderlichen Seiten implementiert wurde oder (b) Sie ein neues Tag erstellen und auf den erforderlichen Seiten implementieren müssen.

Schritt 1: Oracle CX-Tag auf Ihren Seiten implementieren

Wenn Sie das CX-Tag nicht bereits auf den gewünschten Seiten implementiert haben, müssen Sie es zu den Seiten hinzufügen, um die CX-Tag-Bibliothek zu laden, sodass Sie Trackinganforderungen an Oracle Infinity initiieren können.

  1. Sie benötigen eine Tag-URL gemäß den Voraussetzungen, die das folgende Format verwenden:

    //c.oracleinfinity.io/acs/account/{YOUR_ACCOUNT_GUID}/js/{YOUR_TAG_ID}/odc.js?_ora.config={_ora.config}

    Konto-GUID, Tag-ID und -Konfiguration

    {Account GUID} gibt Ihren Account an. Alle Ihre Tags verwenden dieselbe Konto-GUID, sodass alle für Ihr Konto erfassten Daten zusammen gespeichert werden.

    Mit {Tag ID} können Sie Ihren Oracle Infinity-Tags Zugriffsrechte zuweisen und in ein hierarchisches Format einfügen.

    {_ora.config} gibt an, auf welche Umgebung das Tag zeigt (z.B. analytics:test, damit Sie auf verschiedene Tagkonfigurationen pro Umgebung verweisen können, z.B. Test und Produktion). Weitere Informationen finden Sie unter Umgebungen.

  2. Implementieren Sie den folgenden Codeblock in <head>* aller Seiten, die Sie verfolgen (ersetzen Sie {Account GUID}, {Tag ID} und {_ora.config} gemäß Ihrer Tag-URL). Beispiel:

    Synchrone Implementierung

    <head>
...
<!-- CX Tag - Library Load -->
<script type="text/JavaScript" src="//c.oracleinfinity.io/acs/account/{Account GUID}/js/{Tag ID}/odc.js?_ora.config={_ora.config}"></script>
...
</head>

    Asynchrone Implementierung

    	<head>
	...
	<script type="text/JavaScript">
	(function() {

	    var accountGUID = "{Account GUID}";
	    var tagID = "{Tag ID}";
	    var config = "{_ora.config}";

	    // DO NOT EDIT BELOW THIS LINE
	    for(var odc_requested=!1,scripts=document.getElementsByTagName("SCRIPT"),s=0;s<scripts.length;s++)scripts[s].src&&/oracleinfinity.*odc\.\js/.test(scripts[s].src)&&(odc_requested=!0);if(!odc_requested){var sc_scripts=document.getElementsByTagName("script")[0],sc=document.createElement("script");if(sc.async=!0,void 0===config)var config="";config&&(config="?_ora.config="+config),sc.src="//c.oracleinfinity.io/acs/account/"+accountGUID+"/js/"+tagID+"/odc.js"+config,sc_scripts.parentNode.insertBefore(sc,sc_scripts)}
	}());
	</script>
	...
	</head>

    *Synchron oder asynchron?

    Wenn Sie Oracle Maxymiser verwenden, müssen Sie dies in <head> synchron implementieren, um sicherzustellen, dass der Seiteninhalt bearbeitet werden kann, bevor er für den Benutzer sichtbar ist. Wenn Sie Oracle Maxymiser jedoch nicht verwenden, kann dies asynchron sein und nicht unbedingt in <head>.

    Wenn dies nicht möglich ist, lesen Sie Oracle Maxymiser CX Tag Guidelines, oder wenden Sie sich an Oracle Consulting Services, um sich mit Ihren Tagginganforderungen für eine asynchrone Implementierung zu befassen.

Schritt 2: Parameter auf Benutzerebene in Verfolgungsaufrufen deklarieren

Wenn ein Benutzer authentifiziert wurde, können Sie Details zu ihm in neuen oder vorhandenen Trackingaufrufen hinzufügen (Beispiel: Sie möchten Ihre Kunden-ID für jeden authentifizierten Besucher anzeigen).

Verfügbare Parameter

Sie müssen entscheiden, welche Parameter Sie zur Hinzufügung von Warenkörben an Oracle Infinity senden möchten.

Im Folgenden finden Sie eine Tabelle der empfohlenen Parameter, die Sie für authentifizierte Benutzer senden können:

Vorgeschlagene Parameter auf Benutzerebene

Parameter Parametername Beispielwert Notizen
wt.dcsvid Externe Besucher-ID CUST123 Siehe unten*
wt.customer_id Kunden-ID CUST123 Ihre ID für den Kunden
wt.email E-Mail-Adresse stevie.nicks@oracle.com Einzelne E-Mail-Adresse
wt.e_id_s E-Mail-Adresse (SHA-256 Hash) 9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B E-Mail-Adresse mit Hash SHA-256
wt.e_id_m E-Mail-Adresse (MD5-Hash) 0FED850BA5BC6D3A126270F5DFA43C15 E-Mail-Adresse mit MD5-Hash
wt.mobile_phone Mobiltelefonnummer +447809839594 Einfache Telefonnummer
wt.riid Responsys Empfänger-ID (RIID) 564228225 Empfänger-ID von Responsys
wt.customer_type Kundentyp Prämie Kundentyp

*Externe Besucher-ID

Dieser Parameter überschreibt die von Oracle Infinity pro Besucher generierte Standardbesucher-ID. Weitere Informationen finden Sie unter Externe Besucher-ID.

Parameter deklarieren

Nachdem Sie die Parameter gewählt haben, können Sie sie in neuen oder vorhandenen Aufrufen deklarieren. Beispiel:

Beispielansichtsaufruf für authentifizierten Benutzer auf einer Homepage

(function(){
 
    // Declare Your Parameters
    var cxDataObject = {};
    cxDataObject["wt.page_name"] = "homepage"; // Custom parameter denoting page name
    cxDataObject["wt.customer_id"] = "EXAMPLECUSTOMERID123"; // Customer ID
    cxDataObject["wt.e_id_s"] = "9A0FF5B8ADEC41340B433CB2E343DA2DF0DFCBB7447301D97755B6568E41BB8B"; // SHA-256 hashed email address
    cxDataObject["wt.customer_type"] = "VIP Customer"; // Custom parameter denoting type of customer
     
    // DO NOT EDIT BELOW THIS LINE - ORA.click()
    window.ORA = window.ORA || {productReady: []};
    ORA.productReady.push(['analytics', function(cxDataObject) {return function() {return ORA.click({"data": cxDataObject})}}(cxDataObject)]);
})();

Schritt 3: Test der Parameter wird deklariert

Nachdem Sie die Parameter auf Benutzerebene deklariert haben, können Sie die Anforderung validieren, indem Sie den Chrome DevTools Network Debugger öffnen:

  1. Öffnen Sie den Netzwerk-Debugger Chrome DevTools.
  2. Stellen Sie sicher, dass Sie auf Ihrer Site authentifiziert sind (oder die Kriterien zum Deklarieren der neuen Parameter erfüllen).
  3. Aktualisieren Sie die Seite.
  4. Filtern nach dcs im Debugger.
  5. Wählen Sie die dcs.gif-Anforderung aus (dies ist der Oracle Infinity-Datenerfassungsaufruf).
  6. Zeigen Sie die gesendeten Parameter an.

Oracle Infinity-Datenerfassungsaufruf anzeigen

Oracle Infinity-Datenerfassungsaufruf anzeigen

Schritt 4: Prüfen, ob Oracle Infinity Daten empfängt

Sie können jetzt verfügbare Daten in Oracle Infinity prüfen, um Ihre Bestelldaten gemäß den Parametern zu prüfen, die in Ihrem Klickaufanruf über definiert sind (z.B. data.wt.customer_id).

Weitere Lernressourcen

Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere Inhalte für kostenloses Lernen im Oracle Learning YouTube-Kanal zu. Außerdem besuchen Sie education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.

Produktdokumentation finden Sie im Oracle Help Center.