Benutzerattribute aktualisieren

Das API-Feature „Benutzerattribute aktualisieren“ ermöglicht das stapelweise Aktualisieren von Benutzerattributen per API. Entwickler:innen können Benutzerattribute flexibel festlegen, um ein besseres Nutzerprofiling und gezieltere Empfehlungen zu ermöglichen. So lassen sich Benutzerattribute effizient aktualisieren und gezielt für individuelle Nutzerinteressen einsetzen.

Anfragemethode

POST

Endpunkt

https://api-${endpoint}.gptbots.ai/v1/property/update

Authentifizierung der Anfrage

Weitere Informationen finden Sie in der Beschreibung zur Authentifizierung in der API-Übersicht.

Anfrage

Beispielanfrage

curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/property/update' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "user_id": "example_user_id", "property_values": [ { "property_name": "example_property_name", "value": "example_value" } ] }'

                      
                      curl -X POST 'https://api-${endpoint}.gptbots.ai/v1/property/update' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "user_id": "example_user_id",
    "property_values": [
        {
            "property_name": "example_property_name",
            "value": "example_value"
        }
    ]
}'

Dieser Codeblock im schwebenden Fenster

Anfrage-Header

Feld	Typ	Beschreibung
Authorization	Bearer ${API Key}	Verwenden Sie Authorization: Bearer ${API Key} zur Authentifizierung. Den API-Schlüssel erhalten Sie auf der API-Key-Seite.
Content-Type	application/json	Datentyp, Wert ist application/json.

Anfrageparameter

Parameter	Typ	Beschreibung	Erforderlich
user_id	string	Benutzer-ID, für die Attribute festgelegt werden sollen	ja
property_values	Liste	Liste der zu aktualisierenden Attribute	ja
property_values.property_name	string	Attributname	ja
property_values.value	Objekt	Attributwert	ja

Antwort

Parameter	Typ	Beschreibung
success_update	Liste	Liste der erfolgreich aktualisierten Benutzerattribute
success_update.propertyName	string	Name des erfolgreich aktualisierten Attributs
success_update.value	Objekt	Wert des erfolgreich aktualisierten Attributs
fail_update	Liste	Liste der Benutzerattribute, deren Aktualisierung fehlgeschlagen ist
fail_update.property_name	string	Name des fehlgeschlagenen Attributs
fail_update.value	Objekt	Wert der fehlgeschlagenen Aktualisierung