Connessione di personalizzazione personalizzata custom-personalization-connection

Registro modifiche destinazione changelog

Mese di rilascio
Tipo di aggiornamento
Descrizione
Maggio 2023
Aggiornamento della funzionalità e della documentazione
A maggio 2023, la connessione Custom personalization 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 Edge Network durante la configurazione della destinazione Custom Personalization per la personalizzazione basata su attributi. Tutte le chiamate API di Edge Network devono essere effettuate in un contesto autenticato.
Puoi recuperare gli attributi del profilo tramite l'API di Edge Network 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 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:

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 illustra i passaggi di configurazione necessari per i casi di utilizzo della personalizzazione della stessa pagina e della pagina successiva, su più componenti di Experience Platform.

Tipi di pubblico supportati supported-audiences

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

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

Tipo e frequenza di esportazione export-type-frequency

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 connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le View Destinations e le Manage Destinations autorizzazioni di controllo di accesso. 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 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: questo valore viene inviato ad Experience Platform Web SDK come nome di oggetto JSON.
  • 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

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 della connessione di destinazione, selezionare Next.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT
Per attivare i dati, sono necessarie le View Destinations, Activate Destinations, View Profiles e View Segments 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 exported-data

Se si utilizzano Tag in Adobe Experience Platform per distribuire Experience Platform Web SDK, utilizzare la funzionalità Invia evento completato e 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.

È 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.
  });

Esempio di risposta per Custom Personalization With 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.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6