Connessione di personalizzazione personalizzata custom-personalization-connection
Registro modifiche destinazione changelog
Panoramica overview
Configura questa destinazione per consentire alle piattaforme di personalizzazione esterne, ai sistemi di gestione dei contenuti, ai server di annunci e ad altre applicazioni in esecuzione sui siti web dei clienti di recuperare informazioni sul pubblico da Adobe Experience Platform.
Prerequisiti prerequisites
Questa destinazione richiede l’utilizzo di uno dei seguenti metodi di raccolta dati, a seconda dell’implementazione:
- Utilizza Adobe Experience Platform Web SDK se desideri raccogliere dati dal tuo sito Web.
- Utilizza Adobe Experience Platform Mobile SDK se desideri raccogliere dati dalla tua app mobile.
- Utilizza l'Edge Network Server API se non utilizzi Web SDK o Mobile SDK o se desideri personalizzare l'esperienza utente in base agli attributi del profilo.
Tipi di pubblico supportati supported-audiences
Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.
Tipo e frequenza di esportazione export-type-frequency
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione.
Parametri di connessione parameters
Durante la configurazione di questa destinazione, è necessario fornire le seguenti informazioni:
- Nome: immettere il nome preferito per la destinazione.
- Descrizione: immetti una descrizione per la destinazione. Ad esempio, puoi indicare per quale campagna stai utilizzando questa destinazione. Questo campo è facoltativo.
- Alias di integrazione: questo valore viene inviato all'SDK Web Experience Platform come nome di oggetto JSON.
- ID flusso di dati: determina in quale flusso di dati della raccolta dati i tipi di pubblico verranno inclusi nella risposta alla pagina. Il menu a discesa mostra solo gli stream di dati in cui è abilitata la configurazione della destinazione. Per ulteriori dettagli, vedere Configurazione di uno stream di dati.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
Leggi Attiva profili e tipi di pubblico destinazioni di personalizzazione edge per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.
Dati esportati exported-data
Se utilizzi Tag in Adobe Experience Platform per distribuire Experience Platform Web SDK, utilizza la funzionalità Invia evento completato e l'azione del codice personalizzato avrà una variabile event.destinations
che puoi utilizzare per visualizzare i dati esportati.
Di seguito è riportato un valore di esempio per la variabile event.destinations
:
[
{
"type":"profileLookup",
"destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
"alias":"personalizationAlias",
"segments":[
{
"id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Se non utilizzi Tag per distribuire Experience Platform Web SDK, utilizza risposte ai comandi per visualizzare i dati esportati.
È possibile analizzare la risposta JSON di Adobe Experience Platform per trovare l’alias di integrazione corrispondente dell’applicazione che si sta integrando con Adobe Experience Platform. Gli ID del pubblico possono essere trasmessi nel codice dell’applicazione come parametri di targeting. Di seguito è riportato un esempio di ciò che dovrebbe apparire specifico per la risposta di destinazione.
alloy("sendEvent", {
"renderDecisions": true,
"xdm": {
"commerce": {
"order": {
"purchaseID": "a8g784hjq1mnp3",
"purchaseOrderNumber": "VAU3123",
"currencyCode": "USD",
"priceTotal": 999.98
}
}
}
}).then(function(result) {
if(result.destinations) { // Looking to see if the destination results are there
// Get the destination with a particular alias
var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
if(personalizationDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to personalizationAlias
}
var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
if(adServerDestinations.length > 0) {
// Code to pass the audience IDs into the system that corresponds to adServerAlias
}
}
})
.catch(function(error) {
// Tracking the event failed.
});
Risposta di esempio per Personalization personalizzato con attributi
Quando si utilizza Personalization personalizzato con attributi, la risposta API sarà simile a quella riportata di seguito.
La differenza tra Personalization personalizzato con attributi e Personalization personalizzato è l'inclusione della sezione attributes
nella risposta API.
[
{
"type": "profileLookup",
"destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
"alias": "personalizationAlias",
"attributes": {
"countryCode": {
"value" : "DE"
},
"membershipStatus": {
"value" : "PREMIUM"
}
},
"segments": [
{
"id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
},
{
"id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
}
]
}
]
Utilizzo dei dati e governance data-usage-governance
Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, leggere la Panoramica sulla governance dei dati.