Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:survey:quota [01.12.2019 12:04] – admin
+++ de:survey:quota [23.06.2025 14:15] (aktuell) – [Zählung und Screenout] admin
@@ Zeile 1: / Zeile 1: @@
 ====== Quotierung ======
-Bei der [[panels|Zusammenarbeit mit Panel-Anbietern]] werden oft quotierte Stichproben gebucht. Der Fragebogen ist dann für den Quotenstopp verantwortlich: Liegen für eine demografische Gruppe also genug Fragebögen vor, werden weitere Teilnehmer dieser Gruppe an eine Quotafull-Adresse des Panel-Anbieters zurück geschickt.
+Bei der Zusammenarbeit mit Panel-Anbietern werden oft quotierte Stichproben gebucht. Der Fragebogen ist dann für den Quotenstopp verantwortlich: Liegen für eine demografische Gruppe also genug Fragebögen vor, werden weitere Teilnehmer dieser Gruppe an eine QuotaFull-Adresse des Panel-Anbieters zurück geschickt.
 **Hinweis:** Für andere Formen der Rekrutierung ist ein Quotenstopp i.d.R. __nicht__ sinnvoll. Die Folge wäre, dass man die Mehrheit der interessierten Teilnehmer abweist -- zugleich aber noch rekrutieren muss, damit man die fehlenden demografischen Gruppen vervollständigt.
-**Tipp:** Verwenden Sie den Debug-Modus und sehen Sie die Debug-Informationen an, um die Funktion des Quotenstopps zu prüfen und wenn dieser im Test (z.b. mit sehr kleinen Quoten) nicht sofort funktioniert ([[:de:create:filter-solving]]).
+===== Übersicht =====
+  - Erstellen Sie einen Baustein "Panel-Redirects" und tragen Sie dort die Redirect-URLs ein, die Sie vom Panel-Anbieter bekommen haben, mindestens eine URL für //QuotaFull// und eine für //Complete// ([[:de:create:tasks:panel-redirects]]).
+  - Falls Sie die Merkmale für die Quotierung zunächst umkodieren müssen (z.B. eine offene Eingabe des Alters in Kategorien umkodieren), erstellen Sie einen Baustein "Antworten unmkodieren" und tragen Sie dort die Original-Variablen und die Regeln für das Umkodieren ein.
+  - Erstellen Sie einen Baustein "Quotierung", wählen Sie dort die Merkmale aus, welche für die Quotierung herangezogen werden sollen und tragen Sie nach dem Speichern die Quoten pro Quota-Gruppe ein. Lassen Sie Die Anzahl frei, wenn Personen in der entsprechenden Quota-Gruppe direkt abgewiesen werden sollen (//Screenout//).
+  - Ziehen Sie den Baustein "Panel-Redirects" unter **Fragebogen zusammenstellen** auf die erste Seite des Fragebogens, den Baustein "Quotierung" (ggf. auch Bausteine zum Umkodieren der Antworten) auf die früheste Seite, auf welcher Teilnehmer:innen abgewiesen werden sollen, wenn die Quota-Gruppe voll ist.
+  - Fügen Sie vor der "Letzten Seite" des Fragebogens eine zusätzliche Seite ein, ziehen Sie ein Element "PHP-Code" in die Seite und schreiben Sie den folgenden PHP-Code hinein: ''%%setStatus('complete');%%''
+  - Veröffentlichen Sie den Fragebogen ([[:de:survey:publish]]) und öffnen Sie den anfangs erstellen "Panel-Redirects" Baustein. Sehen Sie in diesem Baustein nach, wie der "Link für das Panel" lautet (inkl. der Parameter für die Panel-ID) und teilen Sie dem Panel-Anbieter diesen Link mit.
+  - Öffnen Sie den Baustein zur Quotierung, setzen Sie dort die Zählung für die Quoten ggf. auf 0 zurück (rechte Spalte). In diesem Baustein können Sie im Lauf der Erhebung auch nachsehen, wie viele Personen pro Quota-Gruppe den Fragebogen bereits bearbeitet haben.
-===== Funktionsweise=====
+**Wichtig:** Der Screenout für ungeeignete Teilnehmer:innen funktioniert nur dann, wenn Sie in den "Panel-Redirects" eine Screenout-URL eingetragen oder einen Text für den Screenout ausgewählt haben.
-Die Quotierung erfolgt in folgenden Schritten:
-  - Abfrage der Quoten-Merkmale einer Person mittels ''[[:de:create:functions:value]]''.
+===== Zählung und Screenout =====
-  - Zählung, wie viele Personen mit dieser Merkmalsausprägung bzw. mit dieser Kombination von Merkmalsausprägungen bereits befragt wurden, mittels ''[[:de:create:functions:statistic]]''.
-  - Vergleich der Zählung mit einer Quotentabelle, wie viele Personen pro demografischer Zelle benötigt werden.
-  - Abweisen von Personen, wenn für eine demografische Zelle bereits ausreichend Fälle vorliegen, mittels ''[[:de:create:functions:redirect]]''.
-Mit "demografische Zelle" oder "demografische Gruppe" ist jeweils eine Kombination der zu quotierenden Merkmale gemeint (z.B. "männliche Teilnehmer zwischen 15 und 25 Jahre", wenn Alter und Geschlecht quotiert werden).
+Wenn Ihre Abfrage des Quoten-Merkmals eine Option "keine Antwort" erlaubt, dann können Sie im Quotierungs-Baustein auch dafür eine Anzahl eintragen.
-Prinzipiell kann man unverbundene und verbundenen Quoten prüfen. Bei der unverbundenen Quotierung werden die Merkmale einzeln nacheinander geprüft ("Liegen schon genug Fragebögen von männlichen Teilnehmern vor?" "Liegen schon genug Fragebögen von jungen Teilnehmern vor?"). Hier werden die Randsummen der Verteilung überprüft. Entsprechend wäre es bei der unverbundenen Quotierung möglich, die Quoten mit jungen Frauen und alten Männer zu füllen -- ganz ohne junge Männer.
+  * Wenn Sie eine Zahl eintragen, kann die entsprechende Anzahl Teilnehmer:innen, die "keine Antwort" auswählen, teilnehmen.
+  * Wenn Sie keine Zahl eintragen, dann erfolgt ein Screenout. Das heißt, es wird der Screenout-Redirect verwendet, der im [[:de:create:tasks:panel-redirects|Panel-Redirects]]-Baustein angegeben wurde oder der Screenout-Text gezeigt, der dort ausgewählt wurde.
-Bei der verbundenen Quotierung werden die demografischen Zellen überprüft ("Liegen schon genug Fragebögen von jungen männlichen Teilnehmen vor?"). Die verbundene Quotierung ist damit weniger anfällig für systematische Verzerrungen (Konfundierung zwischen den demografischen Merkmalen) -- allerdings werden auch mehr potenzielle Teilnehmer abgewiesen.
+Für die Quotierung gezählt werden alle Fälle, bei denen (a) der Quotierungs-Baustein verwendet wurde und (b) die den Status (''STATUS'') COMPLETE oder FINISHED (und keinen ''STATUS'') haben.
-Beim Zusammenspiel von ''statistic()'' und ''redirect()'' zu beachten: Der Befehl ''redirect()'' markiert die Fragebögen von abgewiesenen Teilnehmern als "abgeschlossen" (FINISHED=1), sodass sie von ''statistic()'' gezählt werden. Um falsche Zählungen zu vermeiden, werden nicht direkt die Variablen gezählt, welche im Fragebogen abgefragt wurden: Stattdessen werden beim Complete-Redirect die Quotenmerkmale mittels ''[[:de:create:functions:put]]'' in [[:de:create:questions:internal|interne Variablen]] kopiert, die dann gezählt werden können. Für die Quotierung sind demnach 2 getrennte PHP-Codes erforderlich.
+  * Wenn Sie in unterschiedlichen Fragebogen separate Quote zählen möchten, dann legen Sie für jeden Fragebogen einen eigenen Baustein "Quotierung" an.
+  * Falls Sie die Quotierung nachträglich einfügen, werden nur die Fälle ab diesem Zeitpunkt gezählt - passen Sie die Zählung im Baustein bei Bedarf manuell an.
-  - Nach Abfrage der Quotenmerkmale (auf der darauf folgenden Seite) wird die vom Teilnehmer angegeben Ausprägung gegen die Anzahl vorhandener Fälle geprüft.
+Wenn Sie mehrere Fragebögen mittels [[:de:create:multilevel]] oder ''[[:de:create:functions:gotoquestionnaire]]'' verknüpfen, sind die "Panel-Redirects" und die "Quotierung" nur einmal erforderlich, üblicherweise im übergeordneten/ersten Fragebogen. Der Aufruf von ''setStatus()'' funktioniert dann auch in einem unter-/nachgeordneten Fragebogen.
-  - Direkt vor dem Complete-Redirect wird die Ausprägung des Quoten-Merkmals in eine interne Variable kopiert.
-Sofern das Quotenmerkmal zunächst umkodiert werden muss, wird dieser PHP-Code in beiden Teilen verwendet.
-===== Technische Umsetzung (unverbundene Quoten) =====
+===== Unabhängige und verbundene Quoten =====
-Die technische Umsetzung erfolgt mittels [[:de:create:php]] und umfasst mehrere Schritte. Diese werden hier zunächst für die Überprüfung von unverbundenen Quoten erklärt.
+Wenn Sie mehr als ein Merkmal zur Quotierung heranziehen, gibt es zwei Möglichkeiten: Sie können entweder für jedes Merkmal getrennte (unabhängige) Quoten definieren oder Sie können für alle möglichen Kombinationen aus den Ausprägungen der beiden Merkmale Quoten definieren (verbundene Quoten).
-Im folgenden werden exemplarisch zwei Merkmale quotiert: Alter (offen abgefragt in Variable "SD01_01") und das Geschlecht (geschlossen abgefragt in Variable "SD02"). Es ist zweckmäßig, Qutotenfragen als [[:de:create:checks#antwortzwang|Pflichtfragen]] zu definieren.
+Wenn Sie in dem Baustein "Quotierung" mehrere Merkmale definieren, werden verbundene Quoten überprüft.
+Wenn Sie mehrere Bausteine "Quotierung" erstellen, und darin jeweils ein Merkmal auswählen, werden die Quoten der Merkmale unabhängig voneinander überprüft. In dem Fall platzieren Sie unter **Fragebogen zusammenstellen** alle Quotierungs-Bausteine (einen pro Merkmal) im Fragebogen.
-==== Definition der Quoten ====
+**Zur Orientierung:** Bei zwei Merkmalen ist die verbundene Quotierung in aller Regel sinnvoll, bei drei oder mehr Merkmalen sind verbundene Quoten eventuell nur schwer zu erfüllen. Klären sie mit dem Panel-Anbieter vorab, was Sie brauchen und wofür Sie zahlen.
-Zunächst wird eine Liste ([[:de:create:array|Array]]) benötigt, welches für jede Ausprägung des Merkmals die gewünschte Teilnehmerzahl vorgibt. Bei unverbundenen Quoten ist eine Quotentabelle pro Merkmal erforderlich.
+===== Vollständigkeitsprüfung =====
-Im folgenden Beispiel wird der Screenout direkt in der Quotenprüfung integriert. Es wäre aber genauso ein vorgelagerter Screenout möglich.
+Standardmäßig werden Fälle für die Quotierung gezählt, wenn der Befehl ''%%setStatus('complete')%%'' aufgerufen wird, also am Ende des Interviews.
-<code php>
+Wenn viele Teilnehmer:innen den Fragebogen gleichzeitig ausfüllen, kann es passieren, dass zunächst alle zugelassen werden, weil die Quoten ja noch nicht gezählt wurden, und die Quoten überschritten werden, wenn die Personen das Ende des Fragebogens erreichen. Allerdings haben die Panel-Anbieter normalerweise genug Erfahrung, um solche Situationen zu vermeiden.
-$quotaAge = [
-=> 200,  // 200 Personen in Altersgruppe 2 (18-30 Jahre)
-=> 250,  // 250 Personen in Altersgruppe 3 (31-50 Jahre)
-=> 150   // 150 Personen in Altersgruppe 4 (51-68 Jahre)
-];
-$quotaGender = [
-=> 300,  // 300 Frauen (Code 1)
-=> 300   // 300 Männer (Code 2)
-];
-</code>
-Beachten Sie, dass für die Altersgruppen 1 (Personen unter 18 Jahre) und 5 (Peronen älter als 68 Jahre) keine Einträge in der Tabelle vorliegen. Ebenso für das Geschlecht 3 (Personen, sie sich einem sonstigen Geschlecht zuordnen). Dies wird im Screenout (unten) durch die Funktion ''[[https://www.php.net/manual/de/function.array-key-exists.php|array_key_exists()]]'' abgebildet.
+==== Vorzeitige Zählung ====
-==== Merkmale auslesen und umkodieren ====
+Sie können die Zählung bereits auf einer früheren Seite auslösen, indem Sie dort folgenden PHP-Code platzieren.
-Die Merkmalsausprägung des aktuellen Teilnehmers wird mittels ''value()'' ausgelesen und bei Bedarf mit einer [[:de:create:php-filters#das_schluesselwort_if|IF-Konstruktion]] umkodiert. Im vorliegenden Fall muss das Alter (offene Eingabe) umkodiert werden.
 <code php>
-// Geschlecht wird direkt ausgelesen
+setStatus('quota count');
-$gender = value('SD02');
-// Das Alter wird umkodiert
-$age = value('SD01_01');
-if ($age < 18) {
-  $ageGroup = 1;
-} elseif ($age <= 30) {
-  $ageGroup = 2;
-} elseif ($age <= 50) {
-  $ageGroup = 3;
-} elseif ($age <= 68) {
-  $ageGroup = 4;
-} else {
-  $ageGroup = 5;
-}
 </code>
-==== Zählung der vorliegenden Fälle ====
+==== Ungültige Fälle aussortieren ====
-Nun wird mitels ''statistic()'' überprüft, wie viele Datensätze mit der Ausprägung der Quotenmerkmale bereits im Datensatz vorliegen. Dieser Wert wird dann mit den oben definierten Quoten verglichen.
+Eventuell möchten Sie Teilnehmer:innen nicht zählen, deren Antworten bestimmte Kriterien nicht erfüllen. Im Idealfall sollten sie vom Panel-Anbieter einen "Low Quality" oder "Quality Fail" Redirect für solche Teilnehmer:innen bekommen und bei den "Panel-Redirects" eingetragen haben.
-**Wichtig:** Damit der PHP-Code korrekt funktioniert, müssen alle Teile im selben PHP-Code Block stehen. [[:de:create:variables#php-variablen|PHP-Variablen]] wie ''$quotaAge'' und ''$ageGroup'' sind nur jeweils innerhalb eines Code-Blocks gültig.
+Platzieren Sie an geeigneter Stelle (z.B. auf der Seite mit einer Kontrollfrage in dem Bereich "Verarbeitung der Antworten mittels PHP" oder auf der nächsten Seite ganz oben als "PHP-Code") etwa folgenden PHP-Code, um Fälle auszufiltern, in denen das Instructed-Response Item SK01_04 nicht mit dem Wert 1 oder das Item SK03_05 nicht mit dem Wert 5 beantwortet wurde.
-Im folgenden Code werden __nicht__ die Variablen gezählt, mit denen die Quotenmerkmale abgefragt wurden ("SD01_01" und "SD02"), sondern interne Variablen ("SD03_01" und "SD03_02").
-**Wichtig:** Die [[:de:create:questions:internal|interne Variablen]] müssen im **Fragenkatalog** vorab manuell angelegt werden.
 <code php>
-// Abruf der vorliegenden Fälle für diese Merkmalsausprägung
+if (
-$casesAge    = statistic('count', 'SD03_01', $ageGroup);
+  (value('SK01_04') != 1) ||
-$casesGender = statistic('count', 'SD03_02', $gender);
+  (value('SK03_05') != 5)
+) {
-// Screenout
+  setStatus('quality fail');
-if (!array_key_exists($ageGroup, $quotaAge) || !array_key_exists($gender, $quotaGender)) {
-  redirect('https://www.panelanbieter.de/?xyz=screenoutGHIJKI&uid=%reference%');
-}
-// Auslesen der Quoten für die angegeben Merkmale
-$maxPerAge    = $quotaAge[$ageGroup];
-$maxPerGender = $quotaGender[$gender];
-// Quotenstopp
-if (($casesAge >= $maxPerAge) || ($casesGender >= $maxPerGender)) {
-  redirect('https://www.panelanbieter.de/?xyz=quotaABCDEF&uid=%reference%');
 }
 </code>
-Der Bool'sche Operator ''||'' ist eine ODER-Verknüpfung zwischen den zwei Bedingungen. Wenn also entweder genug Fälle für das Alter vorliegen __oder__ genug Fälle für das Geschlecht, dann erfolgt ein QuotaFull-Redirect.
+Um Fälle abzuweisen, die den Fragebogen in welcher als 5 Minuten (300 Sekunden) durchgeklickt haben, würden Sie folgenden PHP-Code oberhalb des ''%%setStatus('complete')%%'' platzieren.
-Den Redirect-Link erhalten Sie vom Panel-Anbieter. Wichtig ist, dass Sie die Teilnehmer-ID übermitteln. Im Beispiel kommt der Platzhalter ''%reference%'' zum Einsatz. Details dazu lesen Sie hier: [[:de:survey:panels]].
-**Wichtig:** Die Antwort des Teilnehmers wird erst zum Server übermittelt, wenn sie der Teilnehmer mittels "Weiter" abgeschickt hat. Wenn die Fragen "SD01" und "SD02" auf Seite 2 des Fragebogens steht, kann ''value()'' und damit der obigen PHP-Code frühestens auf Seite 3 platziert werden.
-==== Kopieren der Quotenmerkmale ====
-Zuletzt müssen die Quoten-Merkmale noch in die internen Variablen kopiert werden. Das heißt, direkt vor dem Complete-Redirect, welches üblicherweise auf der vorletzten Seite des Fragebogen platziert wird.
-Hierzu benötigen Sie __erneut__ den PHP-Code aus dem Abschnitt [[#Merkmale_auslesen_und_umkodieren|Merkmale auslesen und umkodieren]] (oben) und im selben PHP-Code Block direkt darunter die Funktion ''[[:de:create:functions:put]]'' zum Setzen der internen Variablen.
-<code php>
-put('SD03_01', $ageGroup);
-put('SD03_02', $gender);
-</code>
-Danach folgt üblicherweise der Complete-Redirect.
-<code php>
-redirect('https://www.panelanbieter.de/?xyz=completeDEFGHI&uid=%reference%');
-</code>
-===== Verbundene Quoten =====
-==== Quotenprüfung zu Beginn ====
-Wenn Sie mit verbundenen Quoten arbeiten, müssen Sie eine größere Anzahl an Quoten definieren: Ein Grenzwert pro demografischer Zelle. Bei 3 Ausprägungen für das Alter und 2 Ausprägungen für das Geschlecht sind das insgesamt 6 Quoten.
-Im folgenden PHP-Code wird eine demografische Zelle durch einen Code aus Altersgruppe (2-4) und Geschlecht (1-2) definiert. Die 6 Quoten sind der Übersichtlichkeit halber in 3 Zeilen mit jeweils 2 Quoten notiert -- technisch macht es keinen Unterschied, ob nach dem Komma ein Zeilenumbruch folgt.
-<code php>
-$quota = [
-  '2-1' => 100, '2-2' => 100,  // 100 Personen pro Geschlecht für die Altersgruppe 1
-  '3-1' => 125, '3-2' => 125,  // 125 Personen pro Geschlecht für die Altersgruppe 2
-  '4-1' => 75,  '4-2' => 75    //  75 Personen pro Geschlecht für die Altersgruppe 3
-];
-</code>
-Das Auslesen der quotenrelevanten Ausprägungen und das Umkodieren erfolgt zunächst genauso wie bei den unverbundenen Quoten.
 <code php>
-// Geschlecht wird direkt ausgelesen
+if (caseTime('hitherto') < 300) {
-$gender = value('SD02');
+  setStatus('quality fail');
-// Das Alter wird umkodiert
-$age = value('SD01_01');
-if ($age < 18) {
-  $ageGroup = 1;
-} elseif ($age <= 30) {
-  $ageGroup = 2;
-} elseif ($age <= 50) {
-  $ageGroup = 3;
-} elseif ($age <= 68) {
-  $ageGroup = 4;
-} else {
-  $ageGroup = 5;
 }
 </code>
-Allerdings wird zusätzlich noch eine Variable definiert, welche den Code der demografischen Zelle beinhaltet. Der Punkt (''.'') dient in PHP zum Aneinanderfügen von Texten (Verketten von Strings).
-<code php>
+===== Bereinigte Quotierung =====
-// Definition einer Variable mit Altesgruppe und Geschlecht
-// Aus 3 und 2 wird hier '3-2'
-$demGroup = $ageGroup.'-'.$gender;
-</code>
-Die Quotenprüfung erfolgt nun für dieses (kombinierte) Merkmal. Erneut wird eine interne Variable (SD04_01) verwendet, die vorab im **Fragenkatalog** definiert werden muss.
+Nicht alle Befragten füllen den Fragebogen ordentlich aus. Hier wird erklärt, wie Sie die Quoten manuell nachjustieren.
-<code php>
+Sie finden im Datensatz unter der Kennung des Quotierungs-Bausteins eine Variable ''_GRP''. Wenn Ihr Baustein die Kennung ''QT01'' hat, heißt die Variable z.B. ''QT01_GRP''. Hier wird eine Zahl oder ein Kürzel für die Quota-Gruppe gespeichert.
-// Abruf der vorliegenden Fälle für diese Merkmalsausprägung
-$cases = statistic('count', 'SD04_01', $demGroup);
-// Screenout
+  - Laden Sie den Datensatz herunter.
-if (!array_key_exists($demGroup, $quota)) {
+  - Bereinigen Sie den Datensatz.
-  redirect('https://www.panelanbieter.de/?xyz=screenoutGHIJKI&uid=%reference%');
+  - Erstellen Sie eine Häufigkeitsstatistik für die oben genannte Variable.
-}
+  - Tragen Sie im Quotierungs-Baustein ein, wie viele gültige Fälle für jede Quota-Gruppe vorliegen.
-// Auslesen der Quote für die demografische Gruppe
-$maxPerGroup = $quota[$demGroup];
-// Quotenstopp
-if ($cases >= $maxPerGroup) {
-  redirect('https://www.panelanbieter.de/?xyz=quotaABCDEF&uid=%reference%');
-}
-</code>
-==== Speicherung des Zellen-Codes ====
-Vor dem Complete-Redirect muss der Code für die demografische Zelle in die interne Variable gespeichert werden.
-<code php>
-// Speichern der Gruppenzugehörigkeit in der internen Variable SD04_01
-put('SD04_01', $demGroup);
-</code>
-Damit dieser Code funktioniert, müssen auch hier die Quotenausprägungen abgerufen und umkodiert werden. Und natürlich müssen sie zum Zellen-Code ''$demGroup'' verkettet werden. Der vollständige Code für die vorletzte Fragebogen-Seite einschließlich Complete-Redirect sieht demnach wie folgt aus.
-<code php>
-// Geschlecht wird direkt ausgelesen
-$gender = value('SD02');
-// Das Alter wird umkodiert
-$age = value('SD01_01');
-if ($age < 18) {
-  $ageGroup = 1;
-} elseif ($age <= 30) {
-  $ageGroup = 2;
-} elseif ($age <= 50) {
-  $ageGroup = 3;
-} elseif ($age <= 68) {
-  $ageGroup = 4;
-} else {
-  $ageGroup = 5;
-}
-// Definition einer Variable mit Altesgruppe und Geschlecht
-// Aus 3 und 2 wird hier '3-2'
-$demGroup = $ageGroup.'-'.$gender;
-// Speichern der Gruppenzugehörigkeit in der internen Variable SD04_01
-put('SD04_01', $demGroup);
-// Complete-Redirect
-redirect('https://www.panelanbieter.de/?xyz=completeDEFGHI&uid=%reference%');
-</code>