Guardrail per l'attivazione dei dati
Last update: Tue Nov 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
Controlla i diritti di licenza nell'ordine di vendita e la corrispondente
descrizione del prodotto sui limiti di utilizzo effettivi, oltre a questa pagina di guardrail.
Questa pagina fornisce i limiti predefiniti di utilizzo e tasso relativi al comportamento di attivazione. Durante la revisione dei seguenti guardrail, si presume che tu abbia connesso correttamente alle destinazioni.
- La maggior parte dei clienti non supera questi limiti predefiniti. Per informazioni sui limiti personalizzati, contatta il rappresentante dell’assistenza clienti.
- I limiti delineati nel presente documento vengono costantemente migliorati. Controlla regolarmente la disponibilità di aggiornamenti.
- A seconda delle limitazioni individuali a valle, alcune destinazioni potrebbero avere guardrail più rigidi rispetto a quelle documentate in questa pagina. Verificare anche la pagina del catalogo della destinazione a cui si sta effettuando la connessione e l'attivazione dei dati.
Tipi di guardrail limit-types
In questo documento sono disponibili due tipi di limiti predefiniti:
Tipo di guardrail
Descrizione
Guardrail delle prestazioni (limite software)
I guardrail di prestazioni sono limiti di utilizzo relativi all’ambito dei tuoi casi d’uso. Quando si superano i guardrail delle prestazioni, è possibile che si verifichi un peggioramento delle prestazioni e della latenza. Adobe non è responsabile di tale degrado delle prestazioni. I clienti che superano costantemente il limite di prestazioni possono scegliere di concedere licenze aggiuntive per evitare il degrado delle prestazioni.
Guardrail applicati dal sistema (limite rigido)
I guardrail applicati dal sistema vengono applicati dall’interfaccia utente o dall’API di Real-Time CDP. Questi sono i limiti che non puoi superare, poiché l’interfaccia utente e l’API ti impediranno di farlo o restituiranno un errore.
Limiti di attivazione activation-limits
I seguenti guardrail forniscono i limiti consigliati per l’attivazione dei dati Real-Time Customer Profile nelle destinazioni.
Guardrail di attivazione generale general-activation-guardrails
I guardrail di seguito si applicano generalmente all'attivazione tramite tutti i tipi di destinazione.
Guardrail
Limite
Tipo limite
Descrizione
Numero massimo di tipi di pubblico per una singola destinazione
250
Guardrail delle prestazioni
Si consiglia di mappare un massimo di 250 tipi di pubblico su una singola destinazione in un flusso di dati.
Se devi attivare più di 250 tipi di pubblico in una destinazione, puoi:
- Annullare la mappatura dei tipi di pubblico che non desideri più attivare oppure
- Crea un nuovo flusso di dati nella destinazione desiderata e mappa i tipi di pubblico su questo nuovo flusso di dati.
Tieni presente che nel caso di alcune destinazioni, puoi essere limitato a meno di 250 tipi di pubblico mappati alla destinazione. Tali destinazioni sono richiamate più avanti nella pagina, nelle rispettive sezioni.
Numero massimo di attributi mappati a una destinazione
50
Guardrail delle prestazioni
Nel caso di più destinazioni e tipi di destinazione, puoi selezionare gli attributi e le identità del profilo da mappare per l’esportazione. Per prestazioni ottimali, è necessario mappare un massimo di 50 attributi in un flusso di dati su una destinazione.
Numero massimo di destinazioni
100
Guarddrail imposto dal sistema
Tipo di dati attivati nelle destinazioni
Dati profilo, comprese identità e mappa identità
Guarddrail imposto dal sistema
Attualmente, è possibile esportare solo attributi record profilo nelle destinazioni. Al momento, gli attributi XDM che descrivono i dati dell’evento non sono supportati per l’esportazione.
Tipo di dati attivati nelle destinazioni: supporto degli attributi di array e mappa
Parzialmente disponibile
Guarddrail imposto dal sistema
Puoi esportare gli attributi dell'array in
destinazioni basate su file. È comunque necessario utilizzare la funzione
array_to_string per appiattire l'array in una stringa nel file di destinazione.
Ulteriori informazioni sulla funzionalità.
Al momento, è
non possibile esportare
attributi di mappa nelle destinazioni. L'eccezione a questa regola è la
mappa identità, che viene esportata sia nello streaming che nelle attivazioni basate su file.
Attivazione streaming streaming-activation
I guardrail di seguito si applicano all'attivazione tramite destinazioni di streaming.
Guardrail
Limite
Tipo limite
Descrizione
Numero di attivazioni (messaggi HTTP con esportazioni profilo) al secondo
N/D
-
Al momento non esiste alcun limite al numero di messaggi al secondo inviati dagli endpoint API di Experience Platform alle destinazioni partner.
Eventuali limiti o latenze sono determinati dall'endpoint in cui Experience Platform invia i dati. Verificare anche la pagina del
catalogo della destinazione a cui si sta effettuando la connessione e l'attivazione dei dati.
Attivazione batch (basata su file) batch-file-based-activation
I guardrail riportati di seguito si applicano all'attivazione tramite destinazioni batch (basate su file).
Guardrail
Limite
Tipo limite
Descrizione
Frequenza di attivazione
Un’esportazione completa giornaliera o esportazioni incrementali più frequenti ogni 3, 6, 8 o 12 ore.
Guarddrail imposto dal sistema
Numero massimo di tipi di pubblico che possono essere esportati in una determinata ora
100
Guardrail delle prestazioni
Si consiglia di aggiungere un massimo di 100 tipi di pubblico ai flussi di dati di destinazione batch.
Numero massimo di righe (record) per file da attivare
5 milioni
Guarddrail imposto dal sistema
Adobe Experience Platform divide automaticamente i file esportati in 5 milioni di record (righe) per file. Ogni riga rappresenta un profilo. Ai nomi dei file suddivisi viene aggiunto un numero che indica che il file fa parte di un'esportazione più grande:
filename.csv,
filename_2.csv,
filename_3.csv. Per ulteriori informazioni, leggere la
sezione di pianificazione dell'esercitazione attivare destinazioni batch.
Attivazione ad hoc ad-hoc-activation
I guardrail seguenti si applicano al metodo ad-hoc activation.
Guardrail
Limite
Tipo limite
Descrizione
Tipi di pubblico attivati per processo di attivazione ad hoc
80
Guarddrail imposto dal sistema
Attualmente, ogni processo di attivazione ad hoc può attivare fino a 80 tipi di pubblico. Se si tenta di attivare più di 80 tipi di pubblico per processo, il processo non riuscirà. Questo comportamento è soggetto a modifiche nelle versioni future.
Processi di attivazione ad-hoc simultanei per pubblico
1
Guarddrail imposto dal sistema
Non eseguire più di un processo di attivazione ad hoc simultaneo per pubblico.
Attivazione delle destinazioni di personalizzazione Edge edge-destinations-activation
I guardrail riportati di seguito si applicano all'attivazione tramite destinazioni di personalizzazione edge.
Guardrail
Limite
Tipo limite
Descrizione
10
Guardrail delle prestazioni
Puoi impostare flussi di dati su 10 destinazioni di personalizzazione personalizzate per sandbox.
Numero massimo di attributi mappati a una destinazione di personalizzazione per sandbox
30
Guarddrail imposto dal sistema
È possibile mappare un massimo di 30 attributi in un flusso di dati a una destinazione di personalizzazione, per sandbox.
Numero massimo di tipi di pubblico mappati a una singola destinazione
Adobe Target50
Guardrail delle prestazioni
Puoi attivare fino a 50 tipi di pubblico in un flusso di attivazione verso una singola destinazione di Adobe Target.
Esportazioni di set di dati dataset-exports
Le esportazioni di set di dati sono attualmente supportate in un Primo modello completo e quindi incrementale pattern. I guardrail descritti in questa sezione si applicano alla prima esportazione completa che si verifica dopo la configurazione di un flusso di lavoro di esportazione del set di dati.
Tipi di set di dati dataset-types
I guardrail di esportazione dei set di dati si applicano a due tipi di set di dati esportati da Experience Platform, come descritto di seguito:
Set di dati basati sullo schema XDM Experience Events
Nel caso di set di dati basati sullo schema XDM Experience Events, lo schema del set di dati include una colonna timestamp di livello principale. I dati vengono acquisiti in modalità di sola aggiunta.
Set di dati basati sullo schema Profilo individuale XDM
Nel caso di set di dati basati sullo schema Profilo individuale XDM, lo schema del set di dati non include una colonna timestamp di livello principale. I dati vengono acquisiti in modalità upsert.
Il soft guardrail riportato di seguito si applica a tutti i set di dati esportati da Experience Platform. Consulta anche i guardrail rigidi riportati di seguito, specifici per set di dati e tipi di compressione diversi.
Guardrail
Limite
Tipo limite
Descrizione
Dimensione dei set di dati esportati
5 miliardi di record
Guardrail delle prestazioni
Il limite qui descritto per le esportazioni di set di dati è un guardrail soft. Ad esempio, anche se l’interfaccia utente non blocca l’esportazione di set di dati superiori a 5 miliardi di record, il comportamento è imprevedibile e le esportazioni potrebbero non riuscire o avere una latenza di esportazione molto lunga.
Guardrail per esportazioni di set di dati pianificate
Per le esportazioni di set di dati pianificate o ricorrenti, i guardrail riportati di seguito sono identici per i due formati del file esportato (JSON o parquet) e sono raggruppati per tipo di set di dati.
Le esportazioni in file JSON sono supportate solo in modalità compressa.
Tipo di set di dati
Guardrail
Tipo di guardrail
Descrizione
Set di dati basati sullo schema XDM Experience Events
Ultimi 365 giorni di dati
Guarddrail imposto dal sistema
Vengono esportati i dati dell'ultimo anno di calendario.
Set di dati basati sullo schema Profilo individuale XDM
Dieci miliardi di record in tutti i file esportati in un flusso di dati
Guarddrail imposto dal sistema
Il numero di record del set di dati deve essere inferiore a dieci miliardi per i file JSON o parquet compressi e a un milione per i file parquet non compressi, altrimenti l’esportazione non riesce. Riduci le dimensioni del set di dati che stai tentando di esportare se è più grande della soglia consentita.
Ulteriori informazioni sull'esportazione di set di dati.
Destination SDK guardrail destination-sdk-guardrails
Destination SDK è una suite di API di configurazione che ti consente di configurare i modelli di integrazione delle destinazioni, ad Experience Platform per fornire i dati di pubblico e profilo all'endpoint, in base ai formati di dati e autenticazione scelti. I guardrail riportati di seguito si applicano alle destinazioni configurate mediante Destination SDK.
Guardrail
Limite
Tipo limite
Descrizione
5
Guardrail delle prestazioni
Puoi creare fino a 5 destinazioni private di flussi personalizzati o batch utilizzando Destination SDK. Se devi creare più di 5 di queste destinazioni, rivolgiti a un rappresentante dell’assistenza personalizzata.
Criterio di esportazione profilo per Destination SDK
maxBatchAgeInSecs (minimo 1.800 e massimo 3.600)maxNumEventsInBatch (minimo 1.000 e massimo 10.000)
Guarddrail imposto dal sistema
Quando utilizzi l'opzione di
aggregazione configurabile per la destinazione, tieni presente i valori minimo e massimo che determinano la frequenza con cui i messaggi HTTP vengono inviati alla destinazione basata su API e il numero di profili che i messaggi devono includere.
Criterio di limitazione e nuovo tentativo della destinazione destination-throttling-and-retry-policy
Dettagli sulle soglie o limitazioni di limitazione per determinate destinazioni. Questa sezione fornisce anche informazioni sui criteri per i nuovi tentativi per le destinazioni.
Tipo di destinazione
Descrizione
Destinazioni Enterprise (API HTTP, Amazon Kinesis, Azure EventHubs)
Nel 95% del tempo, Experience Platform tenta di offrire una latenza di velocità effettiva inferiore a 10 minuti per i messaggi inviati correttamente con una frequenza inferiore a 10.000 richieste al secondo per ogni flusso di dati verso una destinazione aziendale.
In caso di richieste non riuscite alla destinazione Enterprise, Experience Platform memorizza le richieste non riuscite e tenta di inviarle all'endpoint due volte.
Passaggi successivi
Consulta la seguente documentazione per ulteriori informazioni su altri guardrail dei servizi Experience Platform, informazioni sulla latenza end-to-end e informazioni sulle licenze dai documenti di descrizione del prodotto Real-Time CDP:
7f4d1967-bf93-4dba-9789-bb6b505339d6