API Marketing

Test e risoluzione dei problemi

Usa questa API per creare ed eliminare contatti di test.

Utilizzo dello strumento di test

Puoi usare questo strumento per creare ed eliminare contatti di test dai tuoi moduli; tuttavia, non puoi usare lo strumento in modalità sviluppatore.

Puoi creare un contatto di test per ogni modulo. Dovrai eliminare un contatto esistente per crearne uno nuovo.

Debug in tempo reale dell'integrazione dell'aggiornamento

Usa questo strumento per testare se la tua integrazione con Webhooks di Facebook è avvenuta con successo. Di seguito sono riportati i passaggi per usare questo strumento per effettuare il debug della tua integrazione.

I contatti creati usando questo strumento sono contatti organici non associati ad alcuna inserzione. Puoi creare un solo contatto per ciascun modulo. Per ricreare un contatto per lo stesso modulo, clicca su Elimina contatto per eliminare prima il contatto, quindi ricrealo.

  1. Vai allo strumento di test.

    2. Il menu a discesa riporta tutte le pagine alle quali hai accesso come inserzionista.

  2. Seleziona una pagina dal menu a discesa.

  3. Nel menu a discesa Modulo, seleziona un modulo da usare per creare un contatto.

  4. Clicca su Crea contatto per creare un contatto. Come impostazione predefinita, il contatto che viene creato include dati fittizi.

  5. Clicca su Anteprima del modulo per personalizzare i dati da inviare.

  6. Inserisci i dati desiderati nel modulo per creare un contatto con contenuti personalizzati.

  7. Una volta creato il contatto, vedrai apparire il pulsante Monitora lo stato.

  8. Clicca su Monitora lo stato per visualizzare lo stato dei contatti. Per attivare l'RTU nel tuo endpoint occorrono alcuni secondi. Fino ad allora, l'RTU è nello stato in sospeso. Clicca di nuovo su Monitora lo stato fino a che non vedi lo stato cambiare.

Quando il contatto viene inviato al tuo endpoint, il campo dello stato cambia. Se l'RTU è stato attivato con successo, lo stato diventerà riuscito.

Se l'azione è stata eseguita correttamente, vedrai anche il payload nella tabella. Il payload mostrato qui è una copia di quello che Facebook invia al tuo endpoint, quindi dovresti vedere il contenuto e poter gestire il JSON. Se c'è stato un problema durante l'invio dell'RTU, allora lo stato cambia in fallito. In questo caso, la colonna error_code riporterà i dettagli relativi al motivo dell'errore.

Test dei contatti

Puoi testare i tuoi contatti tramite il pulsante Test dopo aver configurato Webhooks per la tua app. Il pulsante si trova nella dashboard di Webhooks per l'app.

Creazione di contatti di test

Puoi creare un contatto di test effettuando una richiesta POST a /{FORM_ID}/test_leads.

Perché la richiesta abbia successo, occorre rispettare i seguenti requisiti:

  • Non devono esserci contatti di test esistenti per il modulo dell'inserzione per acquisizione contatti specificato.
  • Devi avere almeno il ruolo di Advertiser nella pagina sotto la quale è stato creato il modulo.
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Puoi personalizzare i contenuti del contatto di test inserendo i seguenti parametri:

  • field_data: un parametro vettoriale con coppie name e values.
  • custom_disclaimer_responses: un parametro vettoriale con coppie checkbox_key e is_checked.
curl \
  -F "field_data=[{'name': 'favorite_color?', 'values': ['yellow']}, {'name': 'email', 'values': ['test@test.com']}]" \
  -F "custom_disclaimer_responses=[{'checkbox_key': 'my_checkbox', 'is_checked': true}]" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

I contatti creati dalle precedenti chiamate sono fittizi e non sono quindi associati ad alcuna inserzione.

Lettura dei contatti di test

Puoi leggere i contatti di test associati al modulo di un'inserzione per acquisizione contatti effettuando una chiamata GET all'endpoint {FORM_ID}/test_leads.

curl \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Eliminazione dei contatti di test

Se stai testando la tua integrazione, per eliminare un contatto in modo da poterlo inviare di nuovo effettua la seguente chiamata API:

curl -X DELETE \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<LEAD_ID>"

Solo il proprietario del contatto può eliminarlo.