Nutzer:innen löschen

Verwenden Sie diesen Endpunkt, um ein beliebiges Nutzerprofil zu löschen, indem Sie einen bekannten Bezeichner für die Nutzer:innen angeben.

In einer einzigen Anfrage können bis zu 50 external_ids, user_aliases, braze_ids, email_addresses oder phone_numbers enthalten sein. Dabei kann pro Anfrage nur einer der Typen external_ids, user_aliases, braze_ids, email_addresses oder phone_numbers verwendet werden.

Wenn Sie einen Anwendungsfall haben, der sich nicht mit der Massenlöschung von Nutzer:innen über die API lösen lässt, wenden Sie sich an das Braze-Support-Team.

Warnung

Das Löschen von Nutzerprofilen kann nicht rückgängig gemacht werden. Beim Löschen werden Nutzer:innen dauerhaft entfernt, was zu Abweichungen in Ihren Daten führen kann. Weitere Informationen finden Sie im Abschnitt Auswirkungen des Löschens von Nutzerprofilen in der Referenz zu diesem Endpunkt.

Fehlerbehebung

Es wurde eine Erfolgsantwort zurückgegeben, aber der:die Nutzer:in wird weiterhin angezeigt

Eine erfolgreiche Antwort bestätigt, dass die Anfrage in die Warteschlange gestellt wurde, nicht dass die Löschung abgeschlossen ist. Die Löschung ist in der Regel in weniger als einer Sekunde abgeschlossen, es kann jedoch bis zu fünf Minuten dauern, bis die Änderung in allen Caches übernommen wurde. Wenn Sie unmittelbar danach im Dashboard nach dem:der Nutzer:in suchen oder deren Daten über die API exportieren, sehen Sie während dieses Zeitraums möglicherweise noch Ergebnisse.

Wenn der:die Nutzer:in nach einigen Minuten weiterhin existiert, überprüfen Sie, ob der Bezeichner in Ihrer Anfrage mit dem tatsächlichen Profil des:der Nutzer:in übereinstimmt:

• external_ids-Array: Stellen Sie sicher, dass jeder Wert exakt mit der externen ID eines:einer Nutzer:in übereinstimmt.
• braze_id: Sie finden die braze_id eines:einer Nutzer:in, indem Sie deren Daten mit dem Endpunkt /users/export/ids exportieren oder indem Sie ein Segment als CSV exportieren (dort erscheint die braze_id als „Appboy ID“).
• Profile nur mit Alias oder nur mit E-Mail: Wenn das Profil keine external_id hat, erstellen Sie ein Segment mit dem Filter External User ID is blank in Kombination mit der bekannten E-Mail-Adresse oder Telefonnummer und exportieren Sie es anschließend als CSV, um die braze_id abzurufen.

Um zu überprüfen, ob ein:e Nutzer:in gelöscht wurde, rufen Sie den Endpunkt /users/export/ids mit demselben Bezeichnertyp auf, den Sie in der Löschanfrage verwendet haben (zum Beispiel, indem Sie den Wert in external_ids, braze_id oder user_aliases angeben). Wenn der:die Nutzer:in nicht mehr existiert, enthält die Antwort "users": [] und kann "invalid_user_ids" mit diesem Bezeichner enthalten.

Sie können das OpenAPI-Dokument herunterladen und es zur Validierung von Schemas verwenden. Wie das geht, erfahren Sie unter OpenAPI-Schemas für die Validierung von Anfragen verwenden.