URL_Suchparameter

URL_Search_Params ist eine Systemvariable, die jeden Parameter enthält, der in der URL vorhanden ist, mit der die Sitzung eines Teilnehmers begonnen hat, automatisch als JSON erfasst. Sie existiert für jede Studie. Die meisten Forscher müssen sie nie direkt anfassen, da Labvanced bereits die Parameter erkennt (Crowdsourcing-IDs, group, session usw.) und in ihre eigenen dedizierten Variablen liest.

Zweck

Crowdsourcing-Plattformen und -Panels senden jeweils ihre eigene lange Liste von URL-Parametern. Einige sind integraler Bestandteil der Funktionsweise der Integration, wie eine Teilnehmer-ID, und Labvanced behandelt diese bereits direkt. Andere sind eher unterstützende Informationen, die in einigen Fällen nützlich sind, aber kein eigenes dediziertes Feld haben, wie ein Zielkriterium oder eine Versuch-ID. URL_Search_Params ist der Auffangbehälter für diese zweite Gruppe: Das gesamte Set von Parametern wird automatisch erfasst, sobald die Sitzung beginnt, ohne dass etwas konfiguriert werden muss, sodass eine neue Integration einfach funktioniert.

Die Idee dahinter ist Einfachheit: Anstatt für jeden Parameter, den eine Plattform jemals senden könnte, eine dedizierte Variable zu benötigen, hält eine Variable alle zusammen. Dies sorgt dafür, dass eine neue Integration ohne zusätzliche Einrichtung funktioniert und gibt Ihnen einen einzigen Ort, um zu überprüfen, ob eine Studie jemals einen Wert benötigt, den sonst niemand verfolgt.

Die Werte selbst stammen vom Crowdsourcing-Anbieter, nicht von Labvanced. Besamples tc wird beispielsweise von Besample erstellt und gesendet; Labvanced liest sie nur vom Link im Rahmen von URL_Search_Params.

Wie es aufgezeichnet wird

Der vollständige Abfrage-String wird einmal gelesen, genau zu dem Zeitpunkt, an dem die Sitzung beginnt, und ab diesem Punkt im URL_Search_Params-globalen Variablen gespeichert. Von dort bleibt er während des gesamten Experiments verfügbar, wie jede andere Variable, bereit, gelesen zu werden, wann immer Ihr Studiendesign es benötigt.

Intern wird der Wert als JSON-String der Form gespeichert:

{"is_truncated": false, "params": {"type": "besample", "battempt": "3", "tc": "276", "tg": "f"}}

Ein wiederholter Parametername hält ein Array seiner Werte. is_truncated ist true nur, wenn der Abfrage-String ungewöhnlich lang ist, über 4096 Zeichen. In diesem Fall werden die Parameter, die ihn über das Limit hinausgeschoben hätten, weggelassen, und alles kürzere wird weiterhin aufgezeichnet.

Aus dem Protokoll ausgeschlossen sind Labvanceds eigene Experiment-ID und jeder crowdsourcing-Plattform-Teilnehmer-identifizierender Parameter, der stattdessen separat in Crowdsourcing_SubjId gespeichert wird (zum Beispiel PROLIFIC_PID für Prolific, bpid für Besample). Einige weitere Parameter werden aus denselben Datenschutzgründen ausgeschlossen, ohne woanders gespeichert zu werden, wie Besamples bnum, ein einmaliger Code, der mit dem Abschluss-Payout eines einzelnen Befragten verknüpft ist.

Wie es verwendet wird

Eine JavaScript-Aktionsausführung ist, wie Sie einen Wert aus URL_Search_Params herausziehen und darauf reagieren. Es ist nicht strikt entweder/oder mit der einfacheren Alternative: Wenn Sie nur einen bestimmten, bereits benannten Wert benötigen, holt eine Aktion zum Abrufen von URL-Parametern ihn ohne JSON oder Code. Greifen Sie auf URL_Search_Params zu, wenn Sie das vollständige Bild davon want, was auf dem Link aufgezeichnet wurde, nicht nur den einen Parameter, den Sie extrahieren wollten, unabhängig davon, ob der Name jedes Parameters bereits bekannt ist.

tc ist Besamples eigener offizieller Parameter für das Ziel-Land des Befragten. Wählen Sie zuerst einen Trigger, z.B. On Frame Start oder einen Button-Klick, was auch immer das Lesen auslösen sollte. Dann verwenden Sie Run JavaScript, um tc aus URL_Search_Params auszulesen und es in eine Variable zu speichern, die Sie erstellen und vollständig kontrollieren, z.B. Target_Country (erstellen Sie es zuerst im Registrierungsbereich):

var urlParams = JSON.parse(getValue("URL_Search_Params"));
setValue("Target_Country", urlParams.params.tc || ""); // ISO 3166-1 numeric country code, empty string if tc isn't on the link

Die || "" ist wichtig: Im Gegensatz zu Get URL Parameter, das automatisch auf einen leeren String zurückgesetzt wird, wenn ein Parameter fehlt, führt ein fehlender Wert hier zu einem Fehler, wenn Sie ihn direkt in setValue ohne Fallback übergeben. Fallen Sie immer auf einen Standardwert zurück, wenn Sie einen Parameter lesen, der möglicherweise nicht vorhanden ist.

Von dort aus verwenden Sie Target_Country wie jede andere Variable. Zum Beispiel:

Trigger: On Frame Start
Aktion: Requirement (If... Then) → linke Seite Variable → Target_Country, Vergleich equal, rechte Seite Constant Value → 276 → Dann: Jump to Next Frame → Ihre länderspezifische Aufgabe

Siehe diese Methode neben Get URL Parameter in einem funktionierenden Beispiel: Benutzerdefiniertes URL aus globaler Variable abrufen, eine Bibliotheksstudie, die denselben URL-Parameter in beide Richtungen liest, damit Sie die Ergebnisse direkt vergleichen können. Kopieren Sie diese URL, um es direkt auszuprobieren:

https://www.labvanced.com/player.html?id=88576&tc=276

Wenn Sie Fragen haben, kontaktieren Sie uns bitte [hier.] (https://www.labvanced.com/contact.html)

FAQ

Weiterführende Literatur

Systemvariablen

Was Systemvariablen als Kategorie sind, einschließlich URL_Suchparameter und wo die vollständige Referenztabelle zu finden ist.

URL-Parameter

Die vollständige Referenz der Parameter, die Labvanced von einem Teilnahme-Link liest, einschließlich wie man benutzerdefinierte Links erstellt.

JavaScript-Aktionsausführung

Wie man Labvanced-Variablen mit benutzerdefiniertem JavaScript liest und setzt, den Mechanismus hinter dem obigen Beispiel.

URL-Parameter-Aktion abrufen

Die einfachere Alternative, wenn Sie bereits den genauen Parameternamen kennen, den Sie benötigen, ohne JSON oder Code.