Configurazione batch batch-configuration
Utilizza le opzioni di configurazione batch in Destination SDK per consentire agli utenti di personalizzare i nomi dei file esportati e configurare la pianificazione dell’esportazione in base alle loro preferenze.
Quando crei destinazioni basate su file tramite Destination SDK, puoi configurare la denominazione file predefinita e le pianificazioni di esportazione, oppure puoi dare agli utenti la possibilità di configurare queste impostazioni dall’interfaccia utente di Platform. Ad esempio, puoi configurare comportamenti quali:
- Includere informazioni specifiche nel nome del file, ad esempio ID pubblico, ID destinazione o informazioni personalizzate.
- Consente agli utenti di personalizzare la denominazione dei file dall’interfaccia utente di Platform.
- Configura le esportazioni di file in modo che avvengano a intervalli di tempo impostati.
- Definisci le opzioni di denominazione dei file e di personalizzazione della pianificazione di esportazione che gli utenti possono visualizzare nell’interfaccia utente di Platform.
Le impostazioni di configurazione batch fanno parte della configurazione di destinazione per le destinazioni basate su file.
Per capire dove questo componente si inserisce in un’integrazione creata con Destination SDK, consulta il diagramma riportato di seguito. opzioni di configurazione o consulta la guida su come utilizzare Destination SDK per configurare una destinazione basata su file.
È possibile configurare le impostazioni di denominazione ed esportazione dei file tramite /authoring/destinations
endpoint. Consulta le seguenti pagine di riferimento API per esempi dettagliati di chiamate API, in cui puoi configurare i componenti mostrati in questa pagina.
Questo articolo descrive tutte le opzioni di configurazione batch supportate che puoi utilizzare per la tua destinazione e mostra cosa vedranno i clienti nell’interfaccia utente di Platform.
Tipi di integrazione supportati supported-integration-types
Consulta la tabella seguente per informazioni dettagliate sui tipi di integrazioni che supportano le funzionalità descritte in questa pagina.
Parametri supportati supported-parameters
I valori impostati qui vengono visualizzati in Pianificare l’esportazione del pubblico passaggio del flusso di lavoro di attivazione delle destinazioni basate su file.
"batchConfig":{
"allowMandatoryFieldSelection":true,
"allowDedupeKeyFieldSelection":true,
"defaultExportMode":"DAILY_FULL_EXPORT",
"allowedExportMode":[
"DAILY_FULL_EXPORT",
"FIRST_FULL_THEN_INCREMENTAL"
],
"allowedScheduleFrequency":[
"DAILY",
"EVERY_3_HOURS",
"EVERY_6_HOURS",
"EVERY_8_HOURS",
"EVERY_12_HOURS",
"ONCE"
],
"defaultFrequency":"DAILY",
"defaultStartTime":"00:00",
"filenameConfig":{
"allowedFilenameAppendOptions":[
"SEGMENT_NAME",
"DESTINATION_INSTANCE_ID",
"DESTINATION_INSTANCE_NAME",
"ORGANIZATION_NAME",
"SANDBOX_NAME",
"DATETIME",
"CUSTOM_TEXT"
],
"defaultFilenameAppendOptions":[
"DATETIME"
],
"defaultFilename":"%DESTINATION%_%SEGMENT_ID%"
},
"segmentGroupingEnabled": true
}
allowMandatoryFieldSelection
true
per consentire ai clienti di specificare quali attributi di profilo sono obbligatori. Il valore predefinito è false
. Consulta Attributi obbligatori per ulteriori informazioni.allowDedupeKeyFieldSelection
true
per consentire ai clienti di specificare le chiavi di deduplicazione. Il valore predefinito è false
. Consulta Chiavi di deduplicazione per ulteriori informazioni.defaultExportMode
Definisce la modalità di esportazione predefinita del file. Valori supportati:
DAILY_FULL_EXPORT
FIRST_FULL_THEN_INCREMENTAL
Il valore predefinito è DAILY_FULL_EXPORT
. Consulta la documentazione sull’attivazione batch per informazioni dettagliate sulla pianificazione delle esportazioni di file.
allowedExportModes
Definisce le modalità di esportazione dei file disponibili per i clienti. Valori supportati:
DAILY_FULL_EXPORT
FIRST_FULL_THEN_INCREMENTAL
allowedScheduleFrequency
Definisce la frequenza di esportazione dei file disponibile per i clienti. Valori supportati:
ONCE
EVERY_3_HOURS
EVERY_6_HOURS
EVERY_8_HOURS
EVERY_12_HOURS
DAILY
defaultFrequency
Definisce la frequenza di esportazione predefinita dei file. Valori supportati:
ONCE
EVERY_3_HOURS
EVERY_6_HOURS
EVERY_8_HOURS
EVERY_12_HOURS
DAILY
Il valore predefinito è DAILY
.
defaultStartTime
filenameConfig.allowedFilenameAppendOptions
Obbligatorio. Elenco delle macro di nomi file disponibili tra cui gli utenti possono scegliere. Questo determina quali elementi vengono aggiunti ai nomi dei file esportati (ID pubblico, nome organizzazione, data e ora di esportazione e altri). Quando si imposta defaultFilename
, assicurarsi di evitare la duplicazione delle macro.
Valori supportati:
DESTINATION
SEGMENT_ID
SEGMENT_NAME
DESTINATION_INSTANCE_ID
DESTINATION_INSTANCE_NAME
ORGANIZATION_NAME
SANDBOX_NAME
DATETIME
CUSTOM_TEXT
Indipendentemente dall'ordine in cui si definiscono le macro, l'interfaccia utente di Experienci Platform le visualizzerà sempre nell'ordine presentato qui.
Se defaultFilename
è vuoto, il allowedFilenameAppendOptions
l'elenco deve contenere almeno una macro.
filenameConfig.defaultFilenameAppendOptions
Le macro di questo elenco sono un sottoinsieme di quelle definite in
allowedFilenameAppendOptions
.filenameConfig.defaultFilename
Qualsiasi macro definita da
allowedFilenameAppendOptions
verrà aggiunto dopo il defaultFilename
macro.Se
defaultFilename
è vuoto, è necessario definire almeno una macro in allowedFilenameAppendOptions
.segmentGroupingEnabled
Definisce se i tipi di pubblico attivati devono essere esportati in un singolo file o in più file, in base al pubblico criterio di unione. Valori supportati:
true
: esporta un file per criterio di unione.false
: esporta un file per pubblico, indipendentemente dal criterio di unione. Questo è il comportamento predefinito. È possibile ottenere lo stesso risultato omettendo completamente questo parametro.
Configurazione del nome file file-name-configuration
Utilizzare le macro di configurazione dei nomi di file per definire i nomi di file esportati da includere. Le macro nella tabella seguente descrivono gli elementi presenti nell’interfaccia utente di configurazione del nome file schermo.
SEGMENT_ID
nei nomi dei file esportati. Poiché gli ID segmento sono univoci, includerli nel nome file è il modo migliore per garantire che anche i nomi dei file siano univoci.DESTINATION
SEGMENT_ID
SEGMENT_NAME
DESTINATION_INSTANCE_ID
DESTINATION_INSTANCE_NAME
ORGANIZATION_NAME
SANDBOX_NAME
DATETIME
/ TIMESTAMP
DATETIME
e TIMESTAMP
entrambi definiscono quando il file è stato generato, ma in formati diversi.
DATETIME
utilizza il seguente formato: YYYYMMDD_HHMMSS.TIMESTAMP
utilizza il formato Unix a 10 cifre.
DATETIME
e TIMESTAMP
si escludono a vicenda e non possono essere utilizzate simultaneamente.
DATETIME
: 20220509_210543TIMESTAMP
: 1652131584
CUSTOM_TEXT
defaultFilename
.TIMESTAMP
MERGE_POLICY_ID
segmentGroupingEnabled:true
.MERGE_POLICY_NAME
segmentGroupingEnabled:true
.Esempio di configurazione del nome file
L’esempio di configurazione seguente mostra la corrispondenza tra la configurazione utilizzata nella chiamata API e le opzioni visualizzate nell’interfaccia utente.
"filenameConfig":{
"allowedFilenameAppendOptions":[
"CUSTOM_TEXT",
"SEGMENT_ID",
"DATETIME"
],
"defaultFilenameAppendOptions":[
"SEGMENT_ID",
"DATETIME"
],
"defaultFilename": "%DESTINATION%"
}
Passaggi successivi next-steps
Dopo aver letto questo articolo, sarai in grado di comprendere meglio come configurare la denominazione dei file e le pianificazioni di esportazione per le destinazioni basate su file.
Per ulteriori informazioni sugli altri componenti di destinazione, consulta i seguenti articoli:
- Configurazione autenticazione cliente
- Autorizzazione OAuth2
- Campi dati cliente
- Attributi dell’interfaccia utente
- Configurazione dello schema
- Configurazione dello spazio dei nomi dell’identità
- Configurazioni di mappatura supportate
- Consegna della destinazione
- Configurazione dei metadati del pubblico
- Criterio di aggregazione
- Qualifiche del profilo storico