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 partire da maggio 2023, la Personalizzazione personalizzata supporto di connessione 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 il API server di rete Edge durante la configurazione di Personalizzazione personalizzata destinazione per la personalizzazione basata su attributi. Tutte le chiamate API server devono essere effettuate in un contesto autenticato.
Se utilizzi già Web SDK o Mobile SDK per l’integrazione, puoi recuperare gli attributi tramite l’API server aggiungendo un’integrazione lato server.
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 SDK di Adobe Experience Platform Mobile. Per utilizzare questa destinazione, devi utilizzare uno di questi SDK.

IMPORTANT
Prima di creare una connessione di personalizzazione personalizzata, consulta la guida su come attivare i dati del 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
Supportati
Descrizione
Segmentation Service
Tipi di pubblico generati dall’Experience Platform Servizio di segmentazione.
Caricamenti personalizzati
Tipi di pubblico importato in Experienci 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 personalizzate per diversi Adobe di flussi di dati di Raccolta dati.
Frequenza di esportazione
Streaming
Le destinazioni di streaming sono connessioni "sempre attive" basate su API. Non appena un profilo viene aggiornato in Experienci Platform in base alla valutazione del pubblico, il connettore invia l’aggiornamento a valle alla piattaforma di destinazione. Ulteriori informazioni su destinazioni di streaming.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, è necessario Visualizza destinazioni e Gestire le destinazioni autorizzazioni di controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

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

Parametri di connessione parameters

Mentre configurazione in questa destinazione, è necessario fornire le seguenti informazioni:

  • Nome: inserisci il nome preferito per questa 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 per Experienci Platform come nome di oggetto JSON.
  • ID flusso di dati: questo determina in quale flusso di dati di 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. Consulta Configurazione di uno stream di dati per ulteriori dettagli.

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 agli avvisi sulle destinazioni tramite l’interfaccia utente.

Una volta completate le informazioni sulla connessione di destinazione, seleziona Successivo.

Attivare tipi di pubblico in questa destinazione activate

IMPORTANT
Per attivare i dati, è necessario Visualizza destinazioni, Attivare le destinazioni, Visualizza profili, e Visualizzare segmenti autorizzazioni di controllo degli accessi. Leggi le panoramica sul controllo degli accessi oppure contatta l’amministratore del prodotto per ottenere le autorizzazioni necessarie.

Letto Attivare profili e tipi di pubblico nelle destinazioni di personalizzazione Edge per istruzioni sull’attivazione dei tipi di pubblico in questa destinazione.

Dati esportati exported-data

Se sta usando Tag in Adobe Experience Platform per distribuire Experienci Platform Web SDK, utilizza invio evento completato e l'azione del codice personalizzato avrà un event.destinations che è possibile utilizzare per visualizzare i dati esportati.

Esempio di valore per 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 utilizza Tag per distribuire Experienci 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 Personalizzazione Personalizzata Con Attributi

Quando si utilizza Personalizzazione Personalizzata Con Attributi, la risposta API sarà simile all’esempio seguente.

La differenza tra Personalizzazione Personalizzata Con Attributi e Personalizzazione personalizzata è l'inclusione di 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

Tutti Adobe Experience Platform le 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 Panoramica sulla governance dei dati.

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