Bewertung anmerken

Auf dieser Seite wird erläutert, wie Sie Feedback zur Richtigkeit der von reCAPTCHA Enterprise erstellten Prüfungen geben können. Mit diesen Informationen kann reCAPTCHA Enterprise Ihr websitespezifisches Modell optimieren und die Leistung Ihrer Website im Laufe der Zeit verbessern.

Hinweis

Prüfungen zum Einfügen von Bewertungen

reCAPTCHA Enterprise liefert beim Erstellen einer Bewertung einen Faktor, mit dem Sie das Risiko von Nutzerinteraktionen einschätzen können. Wenn Ihre Website später weitere Informationen zu Nutzerinteraktionen aufweist, können Sie die Bewertung von reCAPTCHA Enterprise prüfen oder korrigieren. Um die Prüfung von reCAPTCHA Enterprise zu bestätigen oder zu korrigieren, können Sie die reCAPTCHA-Bewertungs-IDs als LEGITIMATE oder FRAUDULENT an Google senden. Das Bestätigen oder Korrigieren von reCAPTCHA Enterprise-Prüfungen verbessert die Leistung von reCAPTCHA Enterprise für Ihre Website.

Um die Leistung von reCAPTCHA Enterprise zu verbessern, können Sie die Anmerkungen für true positive und true negative Ergebnisse zusätzlich zu den Annotationen für potenzielle Bewertungsfehler überprüfen. Für einen Nutzer, der sich beispielsweise mit einer Methode für die Bestätigung in zwei Schritten authentifiziert und einen hohen reCAPTCHA-Wert erhalten hat, können Sie die Bewertung als LEGITIMATE annotieren. Wenn der reCAPTCHA-Wert niedrig ist und Ihre Website feststellt, dass die Interaktion betrügerisch oder missbräuchlich ist, können Sie die Bewertung als FRAUDULENT annotieren.

Die folgende Liste enthält zusätzliche Informationen zu einigen Nutzerinteraktionen, die angeben, ob eine Nutzerinteraktion legitim oder betrügerisch ist:

  • Kreditkarten- Rückbuchungen oder andere konkrete Hinweise auf Betrug sind ein Hinweis darauf, dass eine frühere Finanztransaktion betrügerisch war.
  • Wenn Sie ein neues Konto erstellen, das von anderen Nutzern als Spam markierte Nachrichten enthält, könnte das darauf hindeuten, dass die Kontoerstellung falsch war.
  • Wenn ein Nutzer Schwierigkeiten bei der Anmeldung in seinem Konto hat, kann ein Supportfall darauf hinweisen, dass der Anmeldeversuch berechtigt ist.
  • Ein Kauf oder eine Buchung auf einer Website, auf der reCAPTCHA Enterprise für das Scraping verwendet wird, kann ein Hinweis darauf sein, dass der Nutzer legitim ist.

Bewertungs-ID abrufen

Nachdem Sie eine Bewertung erstellt haben, erhalten Sie eine JSON-Antwort, wie im folgenden Beispiel gezeigt.

Wenn Sie eine Prüfung annotieren möchten, rufen Sie die eindeutige Bewertungs-ID aus dem Feld name der JSON-Antwort ab.

{
  'tokenProperties': {
    'valid': True,
    'hostname': 'www.google.com',
    'action': 'homepage',
    'createTime': u'2019-03-28T12:24:17.894Z'
   },
  'riskAnalysis': {
    'score': 0.1,
    'reasons': ['AUTOMATION']
  },
  'event': {
    'token': 'RESPONSE_TOKEN',
    'siteKey': 'SITE_KEY'
   },
  'name': u'ASSESSMENT_ID'
}

Bewertung anmerken

Merken Sie eine Bewertung mit der Methode projects.assessments.annotate an.

Ersetzen Sie diese Werte in den folgenden Anweisungen:

  • ASSESSMENT_ID: Wert des Felds name, das vom Aufruf projects.assessments.create zurückgegeben wurde

HTTP-Methode und URL:

POST https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate

JSON-Text der Anfrage:

{
"annotation": "LEGITIMATE or FRAUDULENT"
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate

PowerShell

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://recaptchaenterprise.googleapis.com/v1/ASSESSMENT_ID:annotate" | Select-Object -Expand Content

Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort erhalten.