Configurare gli override dello stream di dati
Le sostituzioni dello stream di dati consentono di definire configurazioni aggiuntive per gli stream di dati, che vengono passati all’Edge Network tramite l’SDK per web o l’SDK di Mobile.
Questo consente di attivare comportamenti diversi dello stream di dati rispetto a quelli predefiniti, senza creare uno stream di dati o modificare le impostazioni esistenti.
La sostituzione della configurazione dello stream di dati è un processo in due fasi:
-
Innanzitutto, devi definire la sostituzione della configurazione dello stream di dati nella pagina di configurazione dello stream di dati.
-
Quindi, devi inviare le sostituzioni all’Edge Network in uno dei seguenti modi:
Questo articolo spiega il processo di override della configurazione dello stream di dati end-to-end per ogni tipo di override supportato.
Gli override dello stream di dati devono essere utilizzati quando è necessario inviare dati diversi a stream di dati diversi. Non utilizzare le sostituzioni dello stream di dati per i casi d’uso di personalizzazione o i dati di consenso.
Casi d’uso use-cases
Per aiutarti a comprendere meglio come e quando utilizzare gli override dello stream di dati, ecco alcuni casi d’uso che i clienti di Adobe Experience Platform possono risolvere utilizzando questa funzione.
Raccolta di dati per più aree geografiche
Un’azienda dispone di siti web o sottodomini diversi per diversi Paesi in cui opera. Ha configurato stream di dati separati con le corrispondenti suite di rapporti specifiche per l’analisi, i token di proprietà di Adobe Target specifici per Paese, gli schemi specifici per Paese, i set di dati, le configurazioni di Journey Optimizer e così via. L’azienda dispone anche di un set globale di configurazioni in cui vengono aggregati tutti i dati specifici per Paese.
Utilizzando gli override dello stream di dati, l’azienda può cambiare dinamicamente il flusso di dati in flussi di dati diversi, invece del comportamento predefinito di invio dei dati a uno stream di dati.
Un caso d’uso comune potrebbe essere l’invio di dati a un flusso di dati specifico per paese e anche a un flusso di dati globale in cui i clienti eseguono un’azione importante, ad esempio l’ordine o l’aggiornamento del profilo utente.
Differenziazione di profili e identità per diverse unità aziendali
Un’azienda con più business unit desidera utilizzare più Experienci Platform di sandbox per memorizzare i dati specifici di ogni business unit.
Invece di inviare dati a uno stream di dati predefinito, l’azienda può utilizzare gli override dello stream di dati per assicurarsi che ogni unità aziendale abbia il proprio stream di dati tramite cui ricevere i dati.
Configurare gli override dello stream di dati nell’interfaccia utente dello stream di dati configure-overrides
Gli ovverride della configurazione dello stream di dati consentono di modificare le seguenti configurazioni dello stream di dati:
- Set di dati evento di Experience Platform
- Token di proprietà di Adobe Target
- Contenitori di sincronizzazione ID di Audience Manager
- Suite di rapporti di Adobe Analytics
Override dello stream di dati per Adobe Target target-overrides
Per configurare gli override dello stream di dati per uno stream di dati di Adobe Target, devi prima aver creato uno stream di dati di Adobe Target. Segui le istruzioni per configurare uno stream di dati con il servizio Adobe Target.
Dopo aver creato lo stream di dati, modifica il servizio Adobe Target aggiunto e utilizza la sezione Sostituzioni token di proprietà per aggiungere le sostituzioni dello stream di dati desiderate, come illustrato nell'immagine seguente. Aggiungi un token di proprietà per riga.
Dopo aver aggiunto gli override desiderati, salva le impostazioni dello stream di dati.
Ora dovresti avere configurato gli override dello stream di dati di Adobe Target. Ora puoi inviare le sostituzioni all'Edge Network tramite Web SDK o Mobile SDK.
Override dello stream di dati per Adobe Analytics analytics-overrides
Per configurare gli override dello stream di dati per uno stream di dati di Adobe Analytics, devi prima aver creato uno stream di dati di Adobe Analytics. Segui le istruzioni per configurare uno stream di dati con il servizio Adobe Analytics.
Dopo aver creato lo stream di dati, modifica il servizio Adobe Analytics aggiunto e utilizza la sezione Override suite di rapporti per aggiungere le sostituzioni dello stream di dati desiderate, come illustrato nell'immagine seguente.
Seleziona Mostra modalità batch per attivare la modifica in batch degli override delle suite di rapporti. Puoi copiare e incollare un elenco di override delle suite di rapporti inserendo una suite di rapporti per riga.
Dopo aver aggiunto gli override desiderati, salva le impostazioni dello stream di dati.
Ora gli override dello stream di dati di Adobe Analytics saranno configurati. Ora puoi inviare le sostituzioni all'Edge Network tramite Web SDK o Mobile SDK.
Override di stream di dati per i set di dati evento di Experience Platform event-dataset-overrides
Per configurare gli override dello stream di dati per i set di dati evento di Experience Platform, accertati di aver prima creato uno stream di dati di Adobe Experience Platform. Segui le istruzioni per configurare uno stream di dati con il servizio Adobe Experience Platform.
Dopo aver creato lo stream di dati, modifica il servizio Adobe Experience Platform aggiunto e seleziona l'opzione Aggiungi set di dati evento per aggiungere uno o più set di dati evento di sostituzione, come illustrato nell'immagine seguente.
Dopo aver aggiunto gli override desiderati, salva le impostazioni dello stream di dati.
Ora dovresti aver configurato gli override dello stream di dati di Adobe Experience Platform. Ora puoi inviare le sostituzioni all'Edge Network tramite Web SDK o Mobile SDK.
Override dello stream di dati per i contenitori di sincronizzazione ID di terze parti container-overrides
Per configurare gli override degli stream di dati per i contenitori di sincronizzazione ID di terze parti, devi prima aver creato uno stream di dati. Segui le istruzioni per configurare uno stream di dati per crearne uno.
Dopo aver creato lo stream di dati, passa a Opzioni avanzate e abilita l’opzione Sincronizzazione ID di terze parti.
Quindi, utilizza la sezione Override ID contenitore per aggiungere gli ID contenitore che dovranno sovrascrivere l’impostazione predefinita, come illustrato nell’immagine seguente.
1234567
, e non stringhe, come "1234567"
. Se invii un valore stringa tramite Web SDK come override dell’ID contenitore, ti verrà restituito un errore.
Dopo aver aggiunto gli override desiderati, salva le impostazioni dello stream di dati.
Ora gli override del contenitore di sincronizzazione ID saranno configurati. Ora puoi inviare le sostituzioni all'Edge Network tramite Web SDK o Mobile SDK.
Inviare le sostituzioni all’Edge Network send-overrides
Dopo aver configurato le sostituzioni dello stream di dati nell’interfaccia utente di Data Collection, puoi inviare le sostituzioni all’Edge Network tramite Web SDK o Mobile SDK.
- Web SDK: per istruzioni sull'estensione dei tag ed esempi di codice della libreria JavaScript, vedi sostituzioni della configurazione dello stream di dati.
- Mobile SDK: è possibile inviare le sostituzioni degli ID dello stream di dati utilizzando sendEvent API o utilizzando Rules.
Esempio di payload payload-example
Gli esempi precedenti generano un payload Edge Network simile a quello seguente.
{
"meta": {
"configOverrides": {
"com_adobe_experience_platform": {
"datasets": {
"event": {
"datasetId": "SampleProfileDatasetIdOverride"
}
}
},
"com_adobe_analytics": {
"reportSuites": [
"MyFirstOverrideReportSuite",
"MySecondOverrideReportSuite",
"MyThirdOverrideReportSuite"
]
},
"com_adobe_identity": {
"idSyncContainerId": "1234567"
},
"com_adobe_target": {
"propertyToken": "63a46bbc-26cb-7cc3-def0-9ae1b51b6c62"
}
},
"state": { }
},
"events": [ ]
}