Marketing API

Testen und Problembehebung

Verwende diese API und lösche Test-Leads.

Verwenden des Test-Tools

Mit diesem Tool kannst du Test-Leads für deine Formulare erstellen und löschen. Du kannst das Tool jedoch nicht im Entwicklermodus verwenden.

Du kannst einen Test-Lead pro Formular erstellen. Du musst einen vorhandenen Lead löschen, um einen neuen zu erstellen.

Debuggen in Echtzeit bei Update-Integration

Mit diesem Tool testest du, ob deine Integration mit Webhooks von Facebook erfolgreich war. Führe die folgenden Schritte aus, um deine Integration mit diesem Tool zu debuggen.

Die mit diesem Tool erstellten Leads sind organische Leads, die keiner Anzeige zugewiesen sind. Pro Formular kann nur ein Lead erstellt werden. Wenn du einen Lead für dasselbe Formular noch einmal erstellen möchtest, klicke zunächst auf Lead löschen, um den Lead zu löschen, und erstelle den Lead anschließend neu.

  1. Gehe zum Test-Tool.

    2. In der Dropdown-Liste werden alle Seiten aufgeführt, auf die du als Werbetreibender Zugriff hast.

  2. Wähle eine Seite aus der Dropdown-Liste aus.

  3. Wähle aus der Dropdown-Liste Formular das Formular aus, mit dem der Lead erstellt werden soll.

  4. Klicke auf Lead erstellen, um einen Lead zu erstellen. Standardmäßig enthält der erstellte Lead Pseudodaten.

  5. Klicke auf Formularvorschau, um die Daten, die gesendet werden, zu personalisieren.

  6. Gib die gewünschten Daten auf der Formularebene ein, um einen Lead mit benutzerdefiniertem Inhalt zu erstellen.

  7. Nachdem der Lead erstellt wurde, erscheint der Button Status verfolgen.

  8. Klicke auf Status verfolgen, um den Status der Leads anzuzeigen. Es dauert ein paar Sekunden, bis die RTU an deinen Endpunkt feuert. Bis es soweit ist, hat die RTU den Status ausstehend. Klicke erneut auf Status verfolgen, bis du siehst, dass sich der Status ändert.

Sobald der Lead deinen Endpunkt erreicht, ändert sich das Statusfeld. Wenn die RTU erfolgreich gefeuert hat, ändert sich der Status zu Erfolg.

Im Falle eines Erfolgs siehst du in der Tabelle auch die Nutzdaten. Die hier gezeigten Nutzdaten stellen eine Kopie der Daten dar, die Facebook an deinen Endpunkt sendet, damit du den Inhalt siehst und das JSON-Objekt verarbeiten kannst. Wenn beim Senden der RTU ein Fehler aufgetreten ist, ändert sich der Status zu fehlgeschlagen. In solchen Fällen zeigt die Spalte „error_code“ Einzelheiten zur Ursache des Fehlers an.

Lead-Tests

Du kannst deine Leads mit dem Button „Test“ testen, nachdem du Webhooks für deine App eingerichtet hast. Der Button befindet sich im Webhooks-Dashboard für die App.

Erstellen von Test-Leads

Du kannst einen Test-Lead erstellen, indem du eine POST-Anfrage an /{FORM_ID}/test_leads realisierst.

Folgende Voraussetzungen müssen erfüllt sein, damit diese Anfrage erfolgreich ist:

  • Du solltest keine bestehenden Test-Leads für das angegebene Lead Ad-Formular haben.
  • Du musst die SeitenrolleAdvertiser oder höher auf der Seite haben, für die das Formular erstellt wurde.
curl \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/API_VERSION/FORM_ID/test_leads"

Du kannst den Inhalt des Test-Leads personalisieren, indem du die folgenden Parameter nutzt:

  • field_data: Ein Vektorparameter mit Paaren aus name und values.
  • custom_disclaimer_responses: Ein Vektorparameter mit Paaren aus checkbox_key und 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"

Die Leads, die bei den oben aufgeführten Aufrufen erstellt werden, sind fingierte Leads und deshalb keinen Anzeigen zugewiesen.

Lesen von Test-Leads

Du kannst die mit einem Lead Ads-Formular verbundenen Test-Leads lesen, indem du einen GET-Aufruf an den Endpunkt {FORM_ID}/test_leads sendest.

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

Löschen von Test-Leads

Wenn du beim Testen deiner Integration einen Lead löschen möchtest, damit du ihn neu erstellen kannst, erreichst du dies über folgenden API-Aufruf:

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

Nur der Eigentümer des Leads kann den Lead löschen.