appendIdentityToUrl
Il comando appendIdentityToUrl consente di aggiungere un identificatore utente all'URL come stringa di query. Questa azione ti consente di trasmettere l’identità di un visitatore tra più domini, evitando conteggi duplicati dei visitatori per i set di dati che includono sia domini che canali. È disponibile su Web SDK versione 2.11.0 o successiva.
La stringa di query generata e aggiunta all'URL è adobe_mc. Se l'SDK Web non è in grado di trovare un ECID, chiama l'endpoint /acquire per generarne uno.
Aggiungere identità all’URL utilizzando l’estensione Web SDK extension
L’aggiunta di un’identità a un URL viene eseguita come azione all’interno di una regola nell’interfaccia dei tag di Adobe Experience Platform Data Collection.
- Accedi a experience.adobe.com utilizzando le credenziali Adobe ID.
- Passa a Raccolta dati > Tag.
- Seleziona la proprietà tag desiderata.
- Passa a Regole, quindi seleziona la regola desiderata.
- In Azioni, seleziona un'azione esistente o creane una.
- Imposta il campo a discesa Estensione su Adobe Experience Platform Web SDK e imposta Tipo azione su Reindirizza con identità.
- Fai clic su Mantieni modifiche, quindi esegui il flusso di lavoro di pubblicazione.
Questo comando viene in genere utilizzato con una regola specifica che ascolta i clic e controlla i domini desiderati.
Si attiva quando si fa clic su un tag di ancoraggio con una proprietà href.
- Estensione: Core
- Tipo evento: fare clic
- Quando l'utente fa clic su: elementi specifici
- Elementi corrispondenti al selettore CSS:
a[href]
Si attiva solo sui domini desiderati.
- Tipo di logica: regolare
- Estensione: Core
- Tipo condizione: confronto valori
- Operando sinistro:
%this.hostname% - Operatore: corrisponde a Regex
- Operando destro: espressione regolare che corrisponde ai domini desiderati. Ad esempio,
adobe.com$|behance.com$
Aggiungi l’identità all’URL.
- Estensione: Adobe Experience Platform Web SDK
- Tipo azione: reindirizzare con identità
Aggiungere identità all’URL utilizzando la libreria JavaScript dell’SDK web
Eseguire il comando appendIdentityToUrl con un URL come parametro. Il metodo restituisce un URL con l’identificatore aggiunto come stringa di query.
alloy("appendIdentityToUrl",document.location);
Puoi aggiungere un listener di eventi per tutti i clic ricevuti sulla pagina e verificare se l’URL corrisponde ai domini desiderati. In caso contrario, aggiungi l’identità all’URL e reindirizza l’utente.
document.addEventListener("click", event => {
// Check if the click was a link
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) return;
// Check if the link points to the desired domain
const url = new URL(anchor.href);
if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;
// Append the identity to the URL, then direct the user to the URL
event.preventDefault();
alloy("appendIdentityToUrl", {url: anchor.href}).then(result => {document.location = result.url;});
});
Oggetto di risposta
Se decidi di gestire le risposte con questo comando, l'oggetto di risposta contiene url, il nuovo URL con le informazioni di identità aggiunto come parametro della stringa di query.