Connessione personalizzazione personalizzata custom-personalization-connection

Changelog delle destinazioni changelog

Mese di uscita
Tipo di aggiornamento
Descrizione
Maggio 2023
Aggiornamento di funzionalità e documentazione
A partire da maggio 2023, la connessione personalizzazione personalizzata supporta personalizzazione basate su attributi ed è disponibile a livello generale per tutti i clienti.
IMPORTANT
Gli attributi del profilo possono contenere dati sensibili. Per proteggere questi dati, è necessario usare l'API🔗 del server di rete Edge quando si configura la destinazione di personalizzazione ​personalizzata per personalizzazione basate su attributi. Tutte le chiamate API server devono essere effettuate in un contesto autenticato.
È possibile recuperare gli attributi del profilo tramite l'API🔗 del server di rete Edge aggiungendo un'integrazione lato server che utilizza lo stesso flusso di dati già in uso per l'SDK Web o Mobile SDK implementazione.
Se non seguire i requisiti di cui sopra, personalizzazione si baserà solo sull'iscrizione del pubblico.

Panoramica overview

Configura questa destinazione per consentire alle piattaforme personalizzazione esterne, ai sistemi di gestione contenuto, ai server annuncio e ad altre applicazioni in esecuzione sui siti Web dei clienti di recuperare informazioni sul pubblico dai Adobe Experience Platform.

Prerequisiti prerequisites

Questa destinazione richiede l'utilizzo di uno dei seguenti metodi di raccolta dati, a seconda delle implementazione:

  • Utilizza Adobe Experience Platform Web SDK per raccogliere dati dal tuo sito Web.
  • Utilizza l'SDK 🔗 di Adobe Experience Platform Mobile per raccogliere dati dal tuo app mobile.
  • Usa l'API del 🔗server di rete Edge se non usi Web SDK o Mobile SDK o se desideri personalizzare il esperienza di utilizzo in base agli attributi del profilo.
IMPORTANT
Prima di creare una connessione personalizzazione personalizzata, leggi la guida su come attivare i dati del pubblico nelle destinazioni Edge personalizzazione. Questa guida illustra i passaggi di configurazione necessari per i casi d'uso dei personalizzazione della stessa pagina e della pagina successiva, su più componenti Experience Platform.

Pubblico supportato supported-audiences

In questa sezione vengono descritti i tipi di pubblico che puoi esportare verso questa destinazione.

Origine del pubblico
Sostenuto
Descrizione
Segmentation Service
Audiences generati tramite il servizio🔗 di segmentazione Experience Platform.
Caricamenti personalizzati
Audiences 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 un unico profilo a tutti i tipi di pubblico mappati nella destinazione personalizzazione personalizzata. È possibile configurare destinazioni personalizzazione personalizzate diverse per diversi flussi di dati di raccolta dati Adobe Systems dati.
Frequenza di esportazione
Streaming
Le destinazioni di streaming sono connessioni basate su API "sempre attive". 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 in 🔗streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le autorizzazioni Visualizza Destinazioni] e Gestisci destinazioni accesso controllo. Leggi la panoramica sul [controllo accesso o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Per connetterti a questa destinazione, seguire i passaggi descritti nella esercitazione🔗 di configurazione della destinazione.

Parametri di connessione parameters

Durante la configurazione di questa destinazione, è necessario fornire le seguenti informazioni:

  • Nome: inserisci il nome che preferisci per questa destinazione.
  • Descrizione: inserisci una descrizione della 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 oggetto JSON.
  • ID flusso di dati: determina in quale flusso di dati raccolta dati il pubblico verrà incluso nella risposta alla pagina. Il menu a discesa mostra solo gli stream di dati in cui è abilitata la configurazione della destinazione. Per ulteriori informazioni, consulta Configurazione di un flusso di dati.

Abilitare gli avvisi enable-alerts

È possibile abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la destinazione. Seleziona un avviso dall'elenco a cui iscriverti per ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida sulla sottoscrizione agli avvisi relativi alle destinazioni utilizzando il interfaccia.

Dopo aver fornito i dettagli per la connessione di destinazione, selezionare Successivo.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT
Per attivare i dati, sono necessarie le autorizzazioni Visualizza Destinazioni], Attiva destinazioni, Profili Visualizza e Segmenti Visualizza accesso controllo. Leggi la panoramica sul [controllo accesso o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

Leggi Attivare profili e tipi di pubblico ai margini personalizzazione destinazioni per istruzioni su come attivare i tipi di pubblico verso questa destinazione.

Dati esportati exported-data

Se si utilizzano tag in Adobe Experience Platform per distribuire l'SDK Web Experience Platform, utilizzare la funzionalità di invio evento completo🔗 e l'azione codice personalizzato avrà una event.destinations variabile che è possibile utilizzare per visualizzare i dati esportati.

Ecco un esempio di valore per la event.destinations variabile:

[
   {
      "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 si utilizzano tag per distribuire l'SDK Web Experience Platform, utilizzare le risposte dei comandi per visualizzare i dati esportati.

La risposta JSON di Adobe Experience Platform può essere analizzata per trovare l'alias di integrazione corrispondente del applicazione che si sta integrando con Adobe Experience Platform. Gli ID pubblico possono essere passati nel codice dell'applicazione come parametri targeting. Di seguito è riportato un esempio di ciò che questo aspetto like specifico per la risposta alla 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 la personalizzazione personalizzata con attributi

Quando si utilizza la personalizzazione personalizzata con attributi, la risposta dell'API sarà simile a quella riportata di seguito.

La differenza tra Personalizzazione personalizzata con attributi e Personalizzazione ​personalizzata consiste nell'inclusione attributes della sezione 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 e governance dei dati data-usage-governance

Tutte le Adobe Experience Platform destinazioni 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, leggi la panoramica🔗 sulla governance dei dati.

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