Connessione Kevel kevel

Panoramica overview

Kevel fornisce la tecnologia basata sull'intelligenza artificiale e la guida di esperti che aiutano i leader di settore innovativi a lanciare, scalare e avere successo nel settore dei media retail. Retail Media Cloud di Kevel offre formati di annunci mirati, attribuibili e personalizzabili per la pubblicità nel sito e fuori dal sito.

La destinazione di streaming Kevel per Adobe Experience Platform consente ai clienti di attivare i tipi di pubblico di Adobe direttamente nelle API UserDB e Segment Management di Kevel per supportare il targeting in tempo reale al momento della decisione dell'annuncio.

IMPORTANT
Se hai domande o desideri richiedere un aggiornamento sulla destinazione Kevel o sulla relativa documentazione, invia un'e-mail al team Kevel all'indirizzo support@kevel.com.

Casi d’uso use-cases

Puoi attivare tipi di pubblico comportamentali avanzati e di prime parti nelle esperienze multimediali per la vendita al dettaglio, per offrire annunci più rilevanti e prestazioni più elevate. In Experience Platform, puoi creare tipi di pubblico di alto valore basati su intent, ad esempio acquirenti di categorie frequenti o utenti con interessi recenti sui prodotti, e sincronizzare tali appartenenze a Kevel in tempo reale. Kevel rende immediatamente disponibili questi segmenti per le decisioni sugli annunci, abilitando il targeting preciso per i prodotti sponsorizzati e altri formati nelle esperienze di ricerca, navigazione e app. Non appena gli utenti si qualificano, puoi agire su questi segnali per ottenere impressioni più rilevanti, un targeting migliore e misurazioni e ROAS migliorati.

Prerequisiti prerequisites

Per prepararsi a utilizzare la destinazione Kevel, verificare che siano soddisfatti i prerequisiti seguenti:

  • È necessario disporre di una rete Kevel attiva e dell'accesso API.
  • È necessaria una chiave API Kevel con autorizzazioni per creare segmenti e aggiornare record UserDB.
  • Devi configurare in Experience Platform gli spazi dei nomi delle identità mappati alle identità inviate dal sito o dall'app durante Kevel richieste di annunci (ad esempio, ECID, GAID, IDFA, ID fedeltà, ecc.).
  • I clienti di Adobe devono mappare solo le identità utilizzate durante le richieste di annunci in tempo reale, in quanto ogni identità darà luogo a un record UserDB.

Identità supportate supported-identities

La destinazione Kevel supporta l'attivazione di qualsiasi identità utilizzata dall'applicazione per l'invio di richieste di annunci a Kevel. Puoi mappare fino a tre spazi dei nomi di identità per generare i record UserDB corrispondenti.

Kevel supporta i seguenti spazi dei nomi di identità di Experience Platform:

Spazio dei nomi identità
Descrizione
Utilizzo tipico
ECID
Experience Cloud ID
Utilizzato per la personalizzazione nel sito e l’identificazione tra più Adobe.
GAID
GOOGLE ADVERTISING ID
Utilizzato per il traffico dell’app/dispositivo Android.
IDFA
APPLE ADVERTISING ID
Utilizzato per il traffico dell’app/dispositivo iOS (soggetto al consenso ATT).
EXTERNAL_ID
ID esterno (identificatore personalizzato)
Trasmette ID proprietari o generati dal back-end.

Supporto per spazi dei nomi di identità personalizzati

La destinazione Kevel di accetta anche spazi dei nomi personalizzati, come definito nell'implementazione di Experience Platform.

Ciò significa che:

  • È possibile mappare spazi dei nomi di identità specifici del cliente (ad esempio: loyalty_id, gigya_id o qualsiasi identità personalizzata definita in Identity Service).
  • Questi spazi dei nomi possono essere assegnati a kevel_user_key1, kevel_user_key2 o kevel_user_key3 nello stesso modo degli spazi dei nomi globali.
  • Kevel genererà un record UserDB per istanza di ogni identità mappata, consentendo la corrispondenza in tempo reale al momento della decisione dell'annuncio per ogni identificatore inviato dai sistemi.

Comportamento di mappatura identità

  • È possibile mappare fino a tre spazi dei nomi di identità di Experience Platform ai tre slot di identità di Kevel.
  • Per ogni profilo attivato, Kevel riceve un record UserDB per istanza di ogni identità mappata.
  • I clienti devono mappare solo le identità effettivamente inviate nelle richieste di annunci a Kevel per evitare un inutile archivio UserDB.

Esempio di mappatura per la destinazione Kevel

Tipi di pubblico supportati supported-audiences

Origine pubblico
Supportato
Descrizione
Servizio di segmentazione
Tipi di pubblico di Adobe Profile valutati dal motore di segmentazione.
Caricamenti personalizzati
No
Al momento non supportato.

Tipo e frequenza di esportazione export-type-frequency

Elemento
Tipo
Note
Tipo di esportazione
Esportazione segmento
Kevel riceve un aggiornamento ogni volta che un profilo si qualifica per un pubblico o ne esce.
Frequenza di esportazione
Streaming
Gli aggiornamenti vengono inviati in tempo reale utilizzando Destination SDK Streaming Framework.

Connettersi alla destinazione connect

Segui il flusso di lavoro standard di Experience Platform connetti una destinazione.

IMPORTANT
È necessario disporre di autorizzazioni Visualizza destinazioni e Gestisci destinazioni.

Autenticarsi nella destinazione authenticate

Durante la connessione a Kevel, fornire il seguente campo:

  • Token Bearer - Chiave API Kevel.

Opzioni di autenticazione per la destinazione Kevel

Inserire i dettagli della destinazione destination-details

Dopo l’autenticazione, configura:

  • Nome: etichetta per identificare l'istanza di destinazione.
  • Descrizione — Testo facoltativo per descrivere questa istanza di destinazione.
  • KevelID di rete — L'identificatore di rete Kevel.

Dettagli destinazione per destinazione Kevel

Attiva i segmenti in questa destinazione activate

Per inviare tipi di pubblico a Kevel, segui il flusso di lavoro in
Attiva profili e segmenti nelle destinazioni di esportazione dei segmenti in streaming.

Disattivazione dei tipi di pubblico deactivate

Quando un pubblico viene disattivato o rimosso dalla destinazione Kevel in Experience Platform, Experience Platform smette di inviare ulteriori aggiornamenti di qualificazione del profilo per tale pubblico. Qualsiasi segmento esistente creato in Kevel rimane disponibile e non viene eliminato automaticamente.

Se il segmento Kevel è attualmente utilizzato in una campagna attiva, Kevel impedisce l'eliminazione per evitare di interrompere la consegna live. In questo caso, la disattivazione in Experience Platform determina quanto segue:

  • Il flusso di dati di Experience Platform si interrompe
  • Il segmento Kevel continua a esistere e può rimanere associato alle campagne fino alla rimozione manuale o all'aggiornamento della campagna

Per interrompere completamente il targeting in Kevel, assicurati che il segmento venga rimosso da tutte le campagne attive nel sistema di gestione campagne di Kevel.

Mappare attributi e identità map

Kevel richiede:

  • Spazi dei nomi di identità: fino a tre spazi dei nomi di identità mappati a Kevel slot di identità.
  • Appartenenza al segmento: non è richiesta alcuna mappatura manuale; Experience Platform trasmette automaticamente gli identificatori e gli alias di appartenenza al segmento.

Durante l'attivazione, selezionare gli spazi dei nomi di identità configurati per Kevel. Ogni identità genera la propria chiamata di aggiornamento UserDB.

Dati esportati / Convalida esportazione dati exported-data

Quando un profilo si qualifica per un pubblico o ne esce, Experience Platform invia un aggiornamento in streaming a Kevel.

Payload di esempio ricevuto da Kevel UserDB

PUT /udb/{networkId}/segments?userKey=ECID-12345
{
  "segments": [1723, 3344, 9988]
}
Parametro
Descrizione
chiaveUtente
Derivato dall’identità Adobe mappata.
segmenti
Il set di Kevel ID segmento corrispondenti ai tipi di pubblico di Adobe per i quali è attualmente realizzato il profilo.

Profilo Experience Platform di esempio utilizzato durante l’esportazione sample-profile

Quando si attivano i tipi di pubblico nella destinazione Kevel, Experience Platform invia frammenti di profilo contenenti sia le qualifiche del segmento che le identità mappate dal cliente agli slot di identità di Kevel.

Di seguito è riportato un esempio di profilo esportato che mostra:

  • Più spazi dei nomi di identità mappati a kevel_user_key1, kevel_user_key2 e kevel_user_key3
  • Un singolo segmento attivato nello spazio dei nomi ups
{
  "segmentMembership": {
    "ups": {
      "9d161bbb-c785-474a-965b-7d7bc2adf879": {
        "status": "realized",
        "lastQualificationTime": "2025-12-10T21:43:38.541076Z"
      }
    }
  },
  "identityMap": {
    "kevel_user_key1": [
      {
        "id": "ECID-fN1zo"
      },
      {
        "id": "ECID-9Xr2p"
      }
    ],
    "kevel_user_key2": [
      {
        "id": "GAID-4oic4"
      }
    ],
    "kevel_user_key3": [
      {
        "id": "IDFA-nB5fU"
      }
    ]
  }
}

Come Kevel interpreta questo profilo

Con la configurazione di destinazione Kevel, ogni identità mappata genera un record UserDB distinto, ovvero Kevel riceve:

  • Un aggiornamento per ECID-fN1zo
  • Un aggiornamento per ECID-9Xr2p
  • Un aggiornamento per GAID-4oic4
  • Un aggiornamento per IDFA-nB5fU

Questo consente di riconoscere la stessa persona al momento della decisione dell’annuncio utilizzando una qualsiasi delle identità disponibili, con ogni identità che trasporta un identico set di appartenenze a segmenti.

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.

Risorse aggiuntive additional-resources

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