In questa pagina viene descritto il metodo appendIdentityToUrl di Server SDK. Per il Web SDK, vedere appendIdentityToUrl.
Il metodo appendIdentityToUrl aggiunge l’identità del visitatore a un URL come parametro della stringa di query denominato adobe_mc. Quando il visitatore segue l’URL di un altro dominio di tua proprietà, il Web SDK o il Server SDK di tale dominio legge il parametro e mantiene lo stesso Experience Cloud ID (ECID). Questo impedisce che il visitatore venga conteggiato due volte nei set di dati che includono entrambi i domini.
Su un server, un uso comune consiste nell’aggiungere l’identità del visitatore a un reindirizzamento a un altro dominio:
const visitor = alloy.forRequest({ request: req, cookie: visitorCookies });
const { url } = await visitor.appendIdentityToUrl({
url: "https://shop.example.net/checkout"
});
res.writeHead(302, { Location: url });
res.end();
L’URL risultante sarà simile al seguente:
https://shop.example.net/checkout?adobe_mc=TS%3D1792711449%7CMCMID%3D34567890123456789012345678901234567890%7CMCORGID%3DADB3LETTERSANDNUMBERS%2540AdobeOrg
Se SDK non dispone ancora dell’ECID del visitatore, ne richiede uno prima da Edge Network. Richiesta non autenticata. Vedere Impostare il tipo di accesso allo stream di dati.
Se il visitatore ha rinunciato o defaultConsent è "out" e il visitatore non ha acconsentito, il metodo restituisce l’URL invariato. Inoltre, restituisce l’URL invariato, invece di rifiutare, se non è in grado di ottenere l’identità del visitatore, ad esempio a causa di un errore di rete. Quando debugging è attivo, SDK registra un avviso che include Unable to append identity to url.
Opzioni options
Il metodo appendIdentityToUrl accetta un oggetto con le seguenti proprietà:
url: obbligatorio. L’URL a cui aggiungere l’identità del visitatore.edgeConfigOverrides: oggetto di override della configurazione dello stream di dati per questa richiesta.
Oggetto risultato result
Il metodo appendIdentityToUrl restituisce una promessa. Quando viene risolto, l’oggetto risultato contiene url, l’URL con il parametro della stringa di query adobe_mc aggiunto.