Bewertung anmerken

Auf dieser Seite wird erläutert, wie Sie Feedback zur Genauigkeit der von reCAPTCHA Enterprise erstellten Bewertungen geben können. Anhand dieser Informationen kann reCAPTCHA das websitespezifische Modell optimieren und mit der Zeit die Leistung Ihrer Website verbessern.

Hinweis

Bewertung erstellen.

Wann Bewertungen annotiert werden sollten

reCAPTCHA Enterprise stellt Ihnen beim Erstellen einer Bewertung eine Punktzahl bereit, die Ihnen hilft, das Risiko von Nutzerinteraktionen zu ermitteln. Wenn auf deiner Website später weitere Informationen zu Nutzerinteraktionen vorliegen, um festzustellen, ob diese legitim oder betrügerisch sind, kannst du die reCAPTCHA Enterprise-Bewertung bestätigen oder korrigieren. Wenn du die reCAPTCHA Enterprise-Bewertung bestätigen oder korrigieren möchtest, kannst du die reCAPTCHA-Prüfungs-IDs an Google mit der Kennzeichnung LEGITIMATE oder FRAUDULENT senden. Durch die Bestätigung oder Korrektur der reCAPTCHA Enterprise-Prüfung wird die Leistung von reCAPTCHA reCAPTCHA für Ihre Website verbessert.

Um die Leistung von reCAPTCHA Enterprise zu verbessern, können Sie die Annotationen für richtig positive und richtig negative Bewertungen zusätzlich zu den Annotationen für potenzielle Bewertungsfehler bestätigen. Beispiel: Sie können die Bewertung für einen Nutzer, der sich erfolgreich mit einer Zwei-Schritte-Bestätigungsmethode authentifiziert und eine hohe reCAPTCHA-Punktzahl erhalten hat, als LEGITIMATE annotieren. Wenn die reCAPTCHA-Punktzahl niedrig war und Ihre Website feststellte, dass die Interaktion betrügerisch oder missbräuchlich war, können Sie die Bewertung als FRAUDULENT annotieren.

Folgende Liste enthält zusätzliche Informationen zu einigen beispielhaften Nutzerinteraktionen, bei denen angeben wird, ob eine Nutzerinteraktion legitim oder betrügerisch war:

  • Kreditkartenrückbuchungen oder andere konkrete Hinweise auf Betrug sind ein Hinweis darauf, dass eine frühere Finanztransaktion betrügerisch war.
  • Ein neues Konto, das Nachrichten sendet, die von anderen Nutzern als Spam markiert wurden, weist möglicherweise darauf hin, dass die Kontoerstellung betrügerisch war.
  • Ein Support-Fall, der eingereicht wird, wenn ein Nutzer Schwierigkeiten beim Einloggen in sein Konto hat, könnte darauf hinweisen, dass der Login-Versuch legitim ist.
  • Ein Kauf oder eine Buchung auf einer Website, die reCAPTCHA Enterprise zum Schutz vor Scraping verwendet, kann darauf hindeuten, dass der Nutzer legitim ist.

Prüfungs-ID wird abgerufen

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

Wenn Sie eine Bewertung anmerken möchten, rufen Sie die eindeutige Bewertungs-ID aus dem Feld name in 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 mit Anmerkungen versehen

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

Bevor Sie eine der Anfragedaten verwenden, nehmen Sie folgende Ersetzungen vor:

  • ASSESSMENT_ID: Wert des name-Felds, der vom projects.assessments.create-Aufruf zurückgegeben wurde
  • ANNOTATION_LABEL: Gibt an, ob die Bewertung rechtmäßig oder betrügerisch ist. Mögliche Werte sind LEGITIMATE oder FRAUDULENT.

HTTP-Methode und URL:

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

JSON-Text der Anfrage:

{
"annotation": "ANNOTATION_LABEL"
}

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.