Connessione Personalization personalizzata custom-personalization-connection
Registro modifiche destinazione changelog
Utilizzare questo changelog per tenere traccia degli aggiornamenti alla destinazione Personalization personalizzata.
Panoramica overview
Configurare 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 le informazioni sul pubblico da Adobe Experience Platform.
Prerequisiti prerequisites
Questa destinazione richiede uno dei seguenti metodi di raccolta dati, a seconda dell’implementazione:
- Utilizza Adobe Experience Platform Web SDK per raccogliere dati dal tuo sito Web.
- Utilizza Adobe Experience Platform Mobile SDK per raccogliere dati dalla tua app mobile.
- Utilizza l'API Edge Network se non utilizzi il Web SDK o il Mobile SDK o se desideri personalizzare l'esperienza utente in base agli attributi del profilo.
Tipi di pubblico supportati supported-audiences
Nella tabella seguente sono elencati i tipi di pubblico che è possibile esportare in questa destinazione.
Questa categoria include tutte le origini del pubblico al di fuori dei tipi di pubblico generati tramite Segmentation Service. Leggi informazioni sulle diverse origini del pubblico. Alcuni esempi includono:
- i tipi di pubblico per caricamento personalizzati importati in Experience Platform da file CSV,
- pubblico simile,
- pubblico federato,
- tipi di pubblico generati in altre app Experience Platform come Adobe Journey Optimizer,
- e altro ancora.
Tipi di pubblico supportati per tipo di dati sul pubblico:
Tipo e frequenza di esportazione export-type-frequency
La tabella seguente descrive il tipo e la frequenza di esportazione per questa destinazione.
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:
- Name: immettere il nome preferito per la destinazione.
- Description: immettere una descrizione per la destinazione. Ad esempio, puoi indicare per quale campagna stai utilizzando questa destinazione. Questo campo è facoltativo.
- Integration alias: stringa obbligatoria che identifica questa destinazione nella risposta di personalizzazione. Il valore dell'alias viene restituito al sito Web o all'app insieme ai tipi di pubblico (e, se configurati, agli attributi) associati a questa destinazione. Utilizza l’alias nel codice lato client o lato server per individuare ed elaborare l’oggetto di personalizzazione corretto quando più destinazioni di personalizzazione sono attive sullo stesso flusso di dati. L’alias deve essere univoco all’interno di una sandbox in tutte le destinazioni Personalization personalizzate.
- Datastream: questo 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
Abilita gli avvisi per ricevere notifiche sullo stato del flusso di dati verso questa 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 della connessione di destinazione, selezionare Next.
Attivare tipi di pubblico in questa destinazione activate
Leggi Attivare profili e tipi di pubblico nelle destinazioni di personalizzazione Edge per le istruzioni sull'attivazione dei tipi di pubblico in questa destinazione.
Dati esportati exported-data
Se si utilizzano Tag in Adobe Experience Platform per distribuire Experience Platform Web SDK, utilizzare la funzionalità Invia evento completato. L'azione del codice personalizzato avrà una variabile event.destinations che è possibile 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.
Analizzare la risposta JSON da Adobe Experience Platform per trovare l'alias di integrazione dell'applicazione che si sta integrando con Adobe Experience Platform. Passa gli ID del pubblico nel codice dell’applicazione come parametri di targeting. Di seguito è riportato un esempio di questo aspetto specifico per la risposta della 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.
});
Esempio di risposta per Personalization personalizzato con attributi example-response-attributes
Quando si utilizza Custom Personalization With Attributes, la risposta API sarà simile all'esempio seguente.
La differenza tra Custom Personalization With Attributes e Custom Personalization è 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.