Registrazione degli eventi con l'API Events per la messaggistica aziendale

Questa guida descrive come registrare gli eventi dell'app e della Pagina Facebook per analizzare come gli utenti interagiscono con la propria esperienza su Messenger.

Prima di iniziare

Ecco di cosa avrai bisogno:

• L'autorizzazione page_events

  • L'accesso avanzato verrà concesso automaticamente per questa autorizzazione durante l'invio per l'analisi dell'app se l'app ha già ottenuto l'accesso avanzato per l'autorizzazione pages_messaging e non ha violato alcuna normativa negli ultimi 90 giorni
• Un token d'accesso della Pagina richiesto da una persona con l'autorizzazione per eseguire l'attività ANALYZE sulla Pagina oggetto di query

Limitazioni

Al momento, questa API non è disponibile per le aziende o i clienti con sede in Europa o in Giappone.

Normativa e condizioni

• Condizioni per gli strumenti di Facebook Business
• Normative relative a Pagine, gruppi ed eventi

Registrazione degli eventi

Gli eventi vengono registrati inviando una richiesta POST al segmento page_activities di un'app:

https://graph.facebook.com/

Esempio di richiesta:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "fb_mobile_purchase",
      "_valueToSum": 57.23,
      "fb_currency": "USD"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

La tabella seguente descrive le proprietà e i valori che devono essere forniti all'endpoint per la registrazione degli eventi di Messenger:

Creazione di report sui contatti utilizzando l'API Messaging Event

Ora le app possono iniziare a creare report sulle risposte di contatti acquisiti sulle conversazioni. L'evento lead_submitted consente alle app di automatizzare la creazione di report di conversazioni che vengono considerate come contatti per le vendite (ad esempio, l'utente ha condiviso le proprie informazioni di contatto e ha chiesto di essere contattato in merito alla vendita).

L'evento è ideale per distinguere utenti specifici come contatti potenziali, il che dovrebbe essere di aiuto per le aziende a mostrare più in alto le loro conversazioni. Ad esempio, un'azienda può configurare un flusso automatizzato che qualifichi un utente come contatto potenziale e attivare questo evento quando l'utente completa il flusso, in modo da passarlo a un operatore come conversazione con potenziale elevato.

Al momento, questa funzione è disponibile in una versione beta aperta e la creazione di report in Gestione inserzioni è stata integrata, pertanto i dati sui contatti verranno riportati nell'interfaccia utente di Gestione inserzioni.

Esempio di chiamata API per la creazione di un report dell'evento per i contatti in una conversazione:

curl -X POST -H "Content-Type: application/json" -d '{
  "custom_events": [
    {
      "_eventName": "lead_submitted"
    }
  ],
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "page_id": <PAGE_ID>,
  "page_scoped_user_id": <PSID>,
  "logging_source": "messenger_bot",
  "logging_target": "page"
}' https://graph.facebook.com/v21.0/<APP_ID>/page_activities?access_token=<PAGE_ACCESS_TOKEN>

Creazione di report sui contatti utilizzando l'API Ads Insights

L'evento relativo al contatto segnalato può essere visualizzato tramite l'API Ads Insights. Con questa API, puoi creare una dashboard di analisi avanzata che consenta di visualizzare il contatto attribuito alle campagne CTX.

Prerequisiti

Prima di usare l'API, assicurati che l'app sia stata sottoposta al processo di analisi per l'autorizzazione ads_read e verifica di avere ottenuto l'accesso avanzato.

Esecuzione

Segue un esempio di chiamata di insight a livello di campagna:

curl -G \
-d "date_preset=last_7d" \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>/insights"
    

L'API Insight può essere chiamata a livello di account pubblicitario, campagna e gruppo di inserzioni, a seconda del livello di granularità desiderato.

Questa è la chiamata per ottenere il contatto:

• Contatti (attribuiti)

  • /<OBJECT_ID>/insights?fields=actions
  • Nel risultato, action_type=onsite_converstion.lead_grouped

Per una definizione dettagliata dei tipi di azione riportati sopra, puoi consultare il riferimento alle statistiche delle azioni per le inserzioni.

Best practice per classificare i contatti

1. L'inserzionista opera in uno dei settori classici per la generazione di contatti (auto, servizi professionali, servizi finanziari, B2B, istruzione, salute).
2. L'inserzionista chiede informazioni di contatto, come numero di telefono o indirizzo e-mail, e l'utente le fornisce.
3. Le domande relative al numero di telefono o all'indirizzo e-mail sono precedute da una sorta di qualifica (ad esempio una o due domande aggiuntive).
4. Se nella tua app offri modelli di generazione di contatti, aggiungi questo segnale al termine dei flussi di generazione di contatti per impostazione predefinita.

Verifica della registrazione degli eventi

Se sei un amministratore di un'app o di una Pagina, puoi verificare la correttezza della configurazione cercando gli eventi in Gestione inserzioni.

Considerazioni speciali per i dati statistici per Messenger

• Una singola app può registrare le interazioni per più Pagine. In questi casi, gli eventi derivanti dalle interazioni con tutte le Pagine sono visibili nella stessa app.
• È possibile collegare più app a una singola Pagina. In questo caso, quando la Pagina viene bloccata, tutte le app collegate alla Pagina ricevono un evento fb_messenger_bot_stopped.
• Il numero Conversazioni con il bot di Messenger eliminate può essere maggiore di quello Nuova attività degli utenti. Conversazioni con il bot di Messenger eliminate corrisponde al numero di volte in cui un utente elimina una conversazione. La Pagina può avviare un'ulteriore conversazione dopo l'eliminazione di una conversazione da parte di un utente. Le conversazioni aggiuntive possono essere eliminate dagli utenti; tale operazione aumenta il numero di Conversazioni con il bot di Messenger eliminate.

Utilizzo per i provider di piattaforme

Registrazione del target

Le piattaforme che consentono alle persone di creare esperienze su Messenger tramite interfacce visive di solito utilizzano un'app centrale per tutte le relative Pagine collegate. Per consentire ai clienti di visualizzare i propri eventi, devi registrarli nelle apposite Pagine impostando logging_target su page o app_and_page.

Interfaccia utente

Nel contesto di un editor visivo, puoi offrire un blocco trascinabile che consente alle persone di scegliere un evento e di definire parametri aggiuntivi. Ciò consente agli amministratori della Pagina di mappare il flusso di Messenger con eventi idonei. Idealmente, gli utenti dovrebbero essere in grado di selezionare un nome dell'evento standard da un elenco a discesa, poiché solo gli eventi standard vengono riportati in Gestione inserzioni e sono disponibili per l'ottimizzazione e la targetizzazione delle inserzioni (ove disponibile). Se nessun nome dell'evento standard è in linea con l'azione dell'utente e non sono necessari report pubblicitari, puoi prevedere un campo libero per consentire agli utenti di inserire i parametri e un nome dell'evento personalizzato.

Autorizzazioni

L'autorizzazione page_events obbligatoria deve essere ottenuta durante il flusso di Facebook Login dell'app. Devi aggiungerla all'ambito dell'autorizzazione obbligatoria del pulsante Accedi, alla chiamata dell'SDK JavaScript di Facebook o al flusso di accesso creato manualmente come descritto in questa guida.

Risorse aggiuntive

• Guida alle best practice per App Events: include consigli su quali eventi usare nei vari tipi di app.