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 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 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 integrazione è basata su Adobe Experience Platform Web SDK o Adobe Experience Platform Mobile SDK. Per utilizzare questa destinazione, devi utilizzare uno di questi SDK.

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 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 il servizio di segmentazione Experience Platform.
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 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 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

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 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.

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