Raccolta di dati personalizzati con il criterio DataCapture

Questa pagina si applica a Apigee e Apigee ibridi.

Visualizza documentazione di Apigee Edge.

Oltre ai solidi dati API raccolti da Apigee, puoi anche raccogliere dati personalizzati utilizzando DataCapture . Sono necessari due passaggi principali, descritti nelle seguenti sezioni:

1. Crea una risorsa REST Data Collector.
2. Specificare i dati da raccogliere utilizzando l'elemento <Collect> del criterio Data Capture.

Nota:se hai un'organizzazione Apigee con fatturazione a consumo, devi abilitare Componente aggiuntivo di analisi delle API Apigee per utilizzare questo criterio. Per ulteriori informazioni, vedi Gestire il componente aggiuntivo Apigee API Analytics.

Se non sai con certezza se stai utilizzando un abbonamento o un pagamento a consumo Apigee contatta l'amministratore della tua organizzazione Apigee.

Crea una risorsa REST raccoglitore dati

Per utilizzare il criterio DataCapture, devi prima creare un Risorsa REST Data Collector. Per farlo, invia una richiesta API simile alla seguente:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST -H "content-type:application/json" \
  -d '
{
  "name": "dc_my_custom_data",
  "description": "Collects data for analysis.",
  "type": "STRING",
}' \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/datacollectors"

Viene creata una risorsa denominata dc_my_custom_data, che puoi utilizzare con il criterio DataCapture.

Note:

• Il nome della risorsa Raccoglitore dati deve iniziare con il prefisso dc_.
• Se utilizzi un raccoglitore dati in più criteri, i dati acquisiti verranno sovrascritti dall'ultimo criterio eseguito.

.

Avviso: non creare due raccoglitori dati con nomi diversi solo per caso, ad esempio dc_my_data e dc_My_Data, quindi l'esportazione generano "nomi di colonna duplicati" .

Specifica i dati da raccogliere

Puoi specificare i dati da raccogliere utilizzando lo strumento <Collect>. Esistono vari modi per farlo, come mostrato in Esempi nella pagina di riferimento di DataCapure. Un modo è specificare un variabile di flusso, che memorizza i dati passati nelle richieste e nelle risposte API. Ad esempio, potresti raccogliere dati che i clienti inseriscono in un modulo di una pagina web utilizzando il flusso variabile message.formparam.param_name.values, dove param_name è il nome di un parametro nel modulo. Supponiamo che il modulo ha un parametro denominato payment_amount. La variabile di flusso corrispondente sarebbe message.formparam.payment_amount.values.

Il codice seguente specifica questa variabile tramite l'attributo ref dell'elemento <Collect>.

<DataCapture name="capturepayment">
    <Capture>
        <DataCollector>dc_my_custom_data</DataCollector>
        <Collect ref="message.form_param.payment_amount.values" >
    </Capture>
</DataCapture>

Con questa impostazione, i dati inseriti nel campo payment_amount del modulo verranno raccolti da Data Capture e archiviati in una variabile denominata dc_my_custom_data.

Creazione di un report personalizzato dai dati raccolti con Data Capture

Dopo aver configurato la raccolta dei dati con il criterio Data Capture, puoi utilizzare i dati per creare un report personalizzato con la procedura descritta Aggiunta di un report personalizzato. A questo scopo, quando selezioni una metrica per il report, come mostrato in Passaggio 4 della procedura, scegli la variabile che ha lo stesso nome del raccoglitore dati Risorsa REST che hai creato per Data Capture, ad esempio dc_my_custom_data. come mostrato di seguito.

Puoi anche utilizzare la stessa variabile di una dimensione in un report personalizzato. Poiché le dimensioni raggruppare i dati in base ai valori della variabile, di solito è preferibile che la variabile sia una stringa che accetta solo un numero limitato di e i relativi valori.