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:

  1. Innanzitutto, devi definire la sostituzione della configurazione dello stream di dati nella pagina di configurazione dello stream di dati.

  2. Quindi, devi inviare le sostituzioni all’Edge Network in uno dei seguenti modi:

    • Tramite i comandi sendEvent o configure Web SDK.
    • Tramite l'estensione tag Web SDK.
    • Tramite l'API Mobile SDK sendEvent o utilizzando Rules.

Questo articolo spiega il processo di override della configurazione dello stream di dati end-to-end per ogni tipo di override supportato.

IMPORTANT
Le sostituzioni dello stream di dati sono supportate solo per le integrazioni Web SDK e Mobile SDK. Le integrazioni API server non supportano attualmente le sostituzioni dello stream di dati.


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.

Schermata dell’interfaccia utente degli stream di dati che mostra le impostazioni del servizio Adobe Target, con gli override del token di proprietà evidenziati.

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.

Schermata dell’interfaccia utente Stream di dati che mostra le impostazioni del servizio Adobe Analytics, con gli override delle suite di rapporti evidenziati.

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.

Schermata dell’interfaccia utente degli stream di dati che mostra le impostazioni del servizio Adobe Experience Platform, con gli override del set di dati dell’evento evidenziati.

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.

IMPORTANT
Gli ID contenitore devono essere valori numerici, come 1234567, e non stringhe, come "1234567". Se invii un valore stringa tramite Web SDK come override dell’ID contenitore, ti verrà restituito un errore.

Schermata dell’interfaccia utente per gli stream di dati che mostra le impostazioni dello stream di dati, con gli override del contenitore di sincronizzazione ID di terze parti evidenziati.

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.

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": [  ]
}
recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac