Documentazione Experience Platform Guida alle destinazioni

Connessione di personalizzazione personalizzata

Ultimo aggiornamento: 29 agosto 2024

Argomenti:
Destinazioni

Creato per:

Amministratore
Utente

Registro modifiche destinazione

Mese di rilascio	Tipo di aggiornamento	Descrizione
Maggio 2023	Aggiornamento della funzionalità e della documentazione	A maggio 2023, la connessione Personalizzazione personalizzata supporta la personalizzazione basata su attributi ed è generalmente disponibile per tutti i clienti.

IMPORTANT

Gli attributi del profilo possono contenere dati sensibili. Per proteggere questi dati, è necessario utilizzare l'API server Edge Network durante la configurazione della destinazione Personalization personalizzata per la personalizzazione basata su attributi. Tutte le chiamate API server devono essere effettuate in un contesto autenticato.

È possibile recuperare gli attributi del profilo tramite Edge Network Server API aggiungendo un'integrazione lato server che utilizza lo stesso flusso di dati già in uso per l'implementazione Web o Mobile SDK.

Se non segui i requisiti di cui sopra, la personalizzazione sarà basata solo sull'iscrizione al pubblico.

Panoramica

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

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.

IMPORTANT

Prima di creare una connessione di personalizzazione personalizzata, leggi la guida su come attivare i dati sul pubblico nelle destinazioni di personalizzazione Edge. Questa guida descrive i passaggi di configurazione richiesti per i casi di utilizzo di personalizzazione della stessa pagina e della pagina successiva, su più componenti di Experience Platform.

Tipi di pubblico supportati

Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.

Origine pubblico	Supportato	Descrizione
Segmentation Service	✓	Tipi di pubblico generati tramite il servizio di segmentazione Experience Platform.
Caricamenti personalizzati	✓	Tipi di pubblico importati in Experience Platform da file CSV.

Tipo e frequenza di esportazione

Elemento	Tipo	Note
Tipo di esportazione	Profile request	Stai richiedendo per un singolo profilo tutti i tipi di pubblico mappati nella destinazione di personalizzazione personalizzata. È possibile impostare diverse destinazioni di personalizzazione personalizzata per diversi flussi di dati di raccolta dati di Adobe.
Frequenza di esportazione	Streaming	Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experience Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni sulle destinazioni di streaming.

Connettersi alla destinazione

IMPORTANT

Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione.

Parametri di connessione

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

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

IMPORTANT

Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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

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

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.

recommendation-more-help