Panoramica API

Fanplayr 360 offre molte integrazioni per importare dati nel nostro sistema, ma se hai bisogno di ottenere dati da un'applicazione che non supportiamo ancora, come un'app per telefono o un CRM personalizzato, abbiamo anche delle opzioni per questo.

Eventi

Gli eventi sono il modo principale per importare dati in Fanplayr 360. Essi consistono in un nome evento e coppie chiave/valore di Attributi.

In generale gli Attributi saranno valori scalari come un numero o una stringa, ma se usati con gli Oggetti Semantici possono essere più complessi.

Un esempio per indicare che a un utente è stato mostrato un prodotto a sorpresa (è un negozio di maghi!) sarebbe simile a questo (usando l'API JavaScript):

// qualsiasi stringa può essere usata come nome dell'evento
fp360.track('Suprise Product', {
  // un attributo personalizzato
  websiteSection: 'wizard-shop',
  // un attributo e un oggetto semantico
  $product: {
    id: 'BF203',
    name: 'Beautiful Training Staff #1',
    price: 12.99,
    currency: 'EUR'
  }
});

Altre Interazioni

Le altre interazioni che potresti usare sono:

• Aggiungere informazioni identificative a un utente. Ad esempio "Questo utente è identificato dall'indirizzo email user@domain.com". Se identifichi nuovamente un utente con lo stesso indirizzo email, Fanplayr 360 unirà i Profili e gli Eventi per questo utente.

• Impostare il consenso per un utente. Ad esempio "Questo utente ha acconsentito a essere contattato telefonicamente, al numero 555-555-5555 per scopi di marketing".

API JavaScript

Il modo più semplice per importare dati nel nostro sistema è utilizzare la nostra API JavaScript. Abbiamo una libreria che gestisce tutte le complessità per te, così puoi semplicemente aggiungere fp360.track('EVENT', { data }) al tuo sito web per iniziare.

javascript-api

Carrelli della Spesa

Ancora più facile, abbiamo istruzioni di integrazione predefinite che utilizzano l'API JavaScript sotto il cofano.

• Shopify

API Personalizzata

Per inviare Eventi e impostare attributi del Profilo in Fanplayr 360, forniamo già un'API JavaScript, ma potresti voler importare dati in Fanplayr 360 da un servizio che non supportiamo ancora, come la tua app per telefono.

Per fare ciò, tutto ciò di cui hai bisogno è una WRITE_KEY e un ENDPOINT che puoi ottenere creando un'integrazione Personalizzata.

Puoi quindi creare un POST all'ENDPOINT. Facile (per il tuo sviluppatore).

custom-api

Dati Semantici

Se usi l'API JavaScript o scrivi la tua API personalizzata, è utile conoscere i Dati Semantici per ottenere il massimo dal sistema.

semantic-data