Query query

Descrizione description

L’attività Query ti consente di filtrare ed estrarre una popolazione di elementi dal database di Adobe Campaign. Puoi definire Additional data per la popolazione target tramite una scheda dedicata. Questi dati vengono memorizzati in colonne aggiuntive e possono essere utilizzati solo per il flusso di lavoro in corso.

L’attività utilizza lo strumento editor delle query. Questo strumento è descritto in una sezione dedicata.

Argomenti correlati:

Contesto di utilizzo context-of-use

L’attività Query può avere vari tipi di utilizzi:

  • Segmentazione di singoli utenti per definire il target di un messaggio, un pubblico, ecc.
  • Arricchimento dei dati dell’intera tabella di database di Adobe Campaign.
  • Esportazione dei dati.

Configurazione configuration

  1. Trascina e rilascia un’attività Query nel flusso di lavoro.

  2. Seleziona l’attività, quindi aprila utilizzando il pulsante delle azioni rapide visualizzate. Per impostazione predefinita l’attività è preconfigurata per ricercare profili.

  3. Se desideri eseguire una query su una risorsa diversa da quella del profilo, passa alla scheda Properties dell’attività e seleziona una Resource e una Targeting dimension.

    La Resource ti consente di perfezionare i filtri visualizzati nella palette, mentre la Targeting dimension, contestuale rispetto alla risorsa selezionata, corrisponde al tipo di popolazione che desideri ottenere (profili identificati, consegne, dati collegati alla risorsa selezionata, ecc.).

    Per ulteriori informazioni, consulta Dimensioni di targeting e risorse.

  4. Nella scheda Target, esegui la query definendo e combinando regole.

    note note
    NOTE
    Quando esegui il targeting di un pubblico, tieni presente che non viene fatto riferimento alla definizione del pubblico, ma copiato nella query. Se apporti modifiche al pubblico dopo che è stato impostato il targeting in una query, assicurati di configurare nuovamente la query per tenere conto della nuova definizione.
  5. Puoi definire Additional data per la popolazione target tramite una scheda dedicata. Questi dati vengono memorizzati in colonne aggiuntive e possono essere utilizzati solo per il flusso di lavoro in corso. In particolare, puoi aggiungere dati dalle tabelle del database di Adobe Campaign collegate alla dimensione di targeting della query. Consulta la sezione Arricchimento dei dati.

    note note
    NOTE
    Per impostazione predefinita, l’opzione Remove duplicate rows (DISTINCT) è selezionata nelle Advanced options della scheda Additional data della query. Se l’attività Query contiene molti (a partire da 100) dati aggiuntivi definiti, è consigliabile deselezionare questa opzione per motivi di prestazioni. Attenzione: se deselezioni questa opzione puoi ottenere duplicati, a seconda dei dati interrogati.
  6. Nella scheda Transition, l’opzione Enable an outbound transition ti consente di aggiungere una transizione in uscita dopo l’attività Query, anche se non recupera dati.

    Il codice del segmento della transizione in uscita può essere personalizzato utilizzando un’espressione standard e variabili di eventi (consulta questa pagina).

  7. Conferma la configurazione dell’attività e salva il flusso di lavoro.

Dimensioni di targeting e risorse targeting-dimensions-and-resources

Le dimensioni di targeting e le risorse ti consentono di definire su quali elementi basare una query per determinare il target di una consegna.

Sono configurati in mappature target, e vengono definiti durante la creazione di un flusso di lavoro, nel Properties di un’attività Query.

NOTE
Puoi anche definire la dimensione di targeting durante la creazione di un pubblico (vedi questa sezione).

Le dimensioni di targeting e le risorse sono collegate. Le dimensioni di targeting disponibili dipendono quindi dalla risorsa selezionata.

Ad esempio, per la risorsa Profiles (profile), sono disponibili le seguenti dimensioni di targeting:

Mentre per Deliveries (delivery), l’elenco contiene le seguenti dimensioni di targeting:

Dopo la specificazione della dimensione di targeting e della risorsa, nella query sono disponibili filtri diversi.

Esempio di filtri disponibili per la risorsa Profiles (profile):

Esempio di filtri disponibili per la risorsa Deliveries (delivery):

Per impostazione predefinita, la dimensione di targeting e la risorsa sono impostate per eseguire il targeting dei profili. Tuttavia, se desideri cercare un record specifico in una tabella lontana, potrebbe risultare utile usare una risorsa diversa dalla dimensione di targeting.

Per ulteriori informazioni, consulta questo caso d’uso: Utilizzo di risorse diverse dalle dimensioni di targeting

Arricchimento dei dati enriching-data

La scheda Additional data delle attività Query, Incremental query e Enrichment ti consentono di arricchire i dati target e trasferirli alle seguenti attività del flusso di lavoro, dove è possibile utilizzarli. In particolare, puoi aggiungere:

  • Dati semplici
  • Aggregati
  • Raccolte

Per aggregati e raccolte, viene automaticamente definito un Alias per assegnare un ID tecnico a un’espressione complessa. Questo alias, che deve essere univoco, ti consente di trovare facilmente gli aggregati e le raccolte in seguito. Puoi modificarlo per assegnargli un nome facilmente riconoscibile.

NOTE
Gli alias devono rispettare le seguenti regole di sintassi: sono autorizzati solo caratteri alfanumerici e i caratteri "_". Gli alias distinguono tra maiuscole e minuscole. L’alias deve iniziare con il carattere "@". Il carattere immediatamente successivo a "@" non deve essere numerico. Ad esempio: @mioAlias_1 e @_1Alias sono corretti, mentre @mioAlias#1 e @1Alias non sono corretti.

Dopo l’aggiunta di eventuali dati aggiuntivi, puoi applicare un livello di filtro aggiuntivo ai dati inizialmente interessati dal targeting creando condizioni in base ai dati aggiuntivi definiti.

NOTE
Per impostazione predefinita, l’opzione Remove duplicate rows (DISTINCT) è selezionata nelle Advanced options della scheda Additional data della query. Se l’attività Query contiene molti (a partire da 100) dati aggiuntivi definiti, è consigliabile deselezionare questa opzione per motivi di prestazioni. Attenzione: se deselezioni questa opzione puoi ottenere duplicati, a seconda dei dati interrogati.

Un caso di utilizzo su come personalizzare un’e-mail con dati aggiuntivi è presentato in questa sezione.

Aggiunta di un campo semplice adding-a-simple-field

Aggiungendo un campo semplice come dati aggiuntivi, quel campo diventa direttamente visibile nella transizione in uscita dell’attività. In questo modo l’utente può verificare, ad esempio, che i dati della query corrispondano ai dati desiderati.

  1. Aggiungi un nuovo elemento dalla scheda Additional data.

  2. Nella finestra visualizzata, nel campo Expression, seleziona uno dei campi disponibili direttamente dalla dimensione di targeting o in una dimensione collegata. Puoi modificare espressioni e utilizzare funzioni o calcoli semplici (ad eccezione di aggregati) dai campi della dimensione.

    Se modifichi un’espressione che non è un semplice percorso XPATH, viene creato automaticamente un Alias (ad esempio: "Year(@datadinascita)"). Se lo desideri, puoi modificarlo. Se selezioni un solo campo (ad esempio: "@età"), non devi definire un Alias.

  3. Seleziona Add per confermare l’aggiunta del campo ai dati aggiuntivi. Quando la query viene eseguita, nella transizione in uscita dell’attività è presente una colonna aggiuntiva corrispondente al campo aggiunto.

Aggiunta di un aggregato adding-an-aggregate

Gli aggregati consentono di calcolare valori dai campi della dimensione di targeting o dai campi delle dimensioni a essa collegati. Ad esempio: l’importo medio acquistato da un profilo.
Quando utilizzi l’aggregato con la query, la sua funzione può tornare a zero, venendo quindi considerata NULL. Utilizza la scheda Output filtering della query per filtrare il valore aggregato:

  • se desideri valori zero, imposta il filtro su is null.
  • se non desideri valori zero, imposta il filtro su is not null.

Se devi applicare l’ordinamento all’aggregato, dovresti filtrare valori zero, altrimenti il valore NULL viene visualizzato come numero maggiore.

  1. Aggiungi un nuovo elemento dalla scheda Additional data.

  2. Nella finestra visualizzata, seleziona la raccolta che desideri utilizzare per creare l’aggregato nel campo Expression.

    Un Alias viene creato automaticamente. Se lo desideri, puoi modificarlo tornando alla scheda Additional data della query.

    Viene visualizzata la finestra di definizione dell’aggregato.

  3. Definisci un aggregato dalla scheda Data. A seconda del tipo di aggregato selezionato, nel campo Expression sono disponibili solo gli elementi che presentano dati compatibili. Ad esempio, è possibile calcolare una somma solo con dati numerici.

    Puoi aggiungere diversi aggregati per i campi della raccolta selezionata. Assicurati di definire etichette esplicite per distinguere in dettaglio le diverse colonne dei dati in uscita dell’attività.

    Puoi anche modificare gli alias definiti automaticamente per ogni aggregato.

  4. Se necessario, puoi aggiungere un filtro per limitare i dati presi in considerazione.

    Consulta la sezione Filtro dei dati aggiunti.

  5. Seleziona Confirm per aggiungere aggregati.

NOTE
Non puoi creare un’espressione contenente un aggregato direttamente dal campo Expression della finestra New additional data.

Aggiunta di una raccolta adding-a-collection

  1. Aggiungi un nuovo elemento dalla scheda Additional data.

  2. Nella finestra visualizzata, seleziona la raccolta che desideri aggiungere nel campo Expression. Un Alias viene creato automaticamente. Se lo desideri, puoi modificarlo tornando alla scheda Additional data della query.

  3. Seleziona Add. Viene visualizzata una nuova finestra che ti consente di perfezionare i dati della raccolta da visualizzare.

  4. Nella scheda Parameters, seleziona Collection e definisci il numero di righe della raccolta da aggiungere. Ad esempio, se desideri ottenere i tre acquisti più recenti effettuati da ciascun profilo, immetti "3" nel campo Number of lines to return.

    note note
    NOTE
    Devi immettere un numero maggiore o uguale a 1.
  5. Definisci i campi della raccolta da visualizzare per ogni riga dalla scheda Data.

  6. Se lo desideri, puoi aggiungere un filtro per limitare le righe della raccolta presa in considerazione.

    Consulta la sezione Filtro dei dati aggiunti.

  7. Se lo desideri, puoi definire un ordinamento dei dati.

    Ad esempio, se hai selezionato 3 righe da restituire nella scheda Parameters e desideri determinare i tre acquisti più recenti, puoi definire un ordinamento decrescente nel campo "date" della raccolta corrispondente alle transazioni.

  8. Consulta la sezione Ordinamento dei dati aggiuntivi.

  9. Seleziona Confirm per aggiungere la raccolta.

Filtraggio dei dati aggiunti filtering-added-data

Quando aggiungi un aggregato o una raccolta, puoi specificare un filtro aggiuntivo per limitare i dati da visualizzare.

Ad esempio, se desideri elaborare solo le righe della raccolta delle transazioni con importi pari o superiori a 50 dollari, puoi aggiungere una condizione nel campo corrispondente all’importo della transazione dalla scheda Filter.

Ordinamento dei dati aggiuntivi sorting-additional-data

Quando aggiungi un aggregato o una raccolta ai dati di una query, puoi specificare se desideri applicare un ordinamento, crescente o decrescente, in base al valore del campo o all’espressione definita.

Ad esempio, se desideri salvare solo la transazione eseguita più di recente da un profilo, immetti "1" nel campo Number of lines to return della scheda Parameters e applica un ordinamento decrescente nel campo corrispondente alla data della transazione tramite la scheda Sort.

Filtrare i dati target in base ai dati aggiuntivi filtering-the-targeted-data-according-to-additional-data

Dopo l’aggiunta dei dati aggiuntivi, nella Query viene visualizzata una nuova scheda Output filtering. Questa scheda ti consente di applicare un filtro aggiuntivo ai dati inizialmente inclusi nella scheda Target tenendo conto dei dati aggiunti.

Ad esempio, se hai eseguito il targeting di tutti i profili che hanno effettuato almeno una transazione e un aggregato calcolando l’importo medio della transazione eseguita per ciascun profilo aggiunto agli Additional data, puoi perfezionare la popolazione inizialmente calcolata utilizzando questa media.

A questo scopo, nella scheda Output filtering aggiungi semplicemente una condizione a questi dati aggiuntivi.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff