diff --git a/404.html b/404.html
index b0b5e39..c65db3c 100644
--- a/404.html
+++ b/404.html
@@ -34,7 +34,7 @@
     
     <a class="navbar-brand me-2" href="https://schochastics.github.io/webtrackR/index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/LICENSE-text.html b/LICENSE-text.html
index 86a286f..dca9f8d 100644
--- a/LICENSE-text.html
+++ b/LICENSE-text.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/LICENSE.html b/LICENSE.html
index aae1979..f778a45 100644
--- a/LICENSE.html
+++ b/LICENSE.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/apple-touch-icon-120x120.png b/apple-touch-icon-120x120.png
index d8b6975..d606d52 100644
Binary files a/apple-touch-icon-120x120.png and b/apple-touch-icon-120x120.png differ
diff --git a/apple-touch-icon-152x152.png b/apple-touch-icon-152x152.png
index 54e19df..b847339 100644
Binary files a/apple-touch-icon-152x152.png and b/apple-touch-icon-152x152.png differ
diff --git a/apple-touch-icon-180x180.png b/apple-touch-icon-180x180.png
index 6730c15..65ded76 100644
Binary files a/apple-touch-icon-180x180.png and b/apple-touch-icon-180x180.png differ
diff --git a/apple-touch-icon-60x60.png b/apple-touch-icon-60x60.png
index 40ff982..ba0a096 100644
Binary files a/apple-touch-icon-60x60.png and b/apple-touch-icon-60x60.png differ
diff --git a/apple-touch-icon-76x76.png b/apple-touch-icon-76x76.png
index 61a3d94..c760371 100644
Binary files a/apple-touch-icon-76x76.png and b/apple-touch-icon-76x76.png differ
diff --git a/apple-touch-icon.png b/apple-touch-icon.png
index 78d4ded..65ded76 100644
Binary files a/apple-touch-icon.png and b/apple-touch-icon.png differ
diff --git a/articles/index.html b/articles/index.html
index 7a34c4b..5396de4 100644
--- a/articles/index.html
+++ b/articles/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/articles/webtrackR.html b/articles/webtrackR.html
index cd755e9..3bed10b 100644
--- a/articles/webtrackR.html
+++ b/articles/webtrackR.html
@@ -36,7 +36,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/authors.html b/authors.html
index 5ab2077..3cdae43 100644
--- a/authors.html
+++ b/authors.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/favicon-16x16.png b/favicon-16x16.png
index 72deb3e..c309dd8 100644
Binary files a/favicon-16x16.png and b/favicon-16x16.png differ
diff --git a/favicon-32x32.png b/favicon-32x32.png
index a3285f2..b6986f5 100644
Binary files a/favicon-32x32.png and b/favicon-32x32.png differ
diff --git a/index.html b/index.html
index 76161a5..82e9755 100644
--- a/index.html
+++ b/index.html
@@ -36,7 +36,7 @@
     
     <a class="navbar-brand me-2" href="index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/news/index.html b/news/index.html
index ac3ee13..d95811c 100644
--- a/news/index.html
+++ b/news/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
@@ -48,7 +48,11 @@
     </div>
 
     <div class="section level2">
-<h2 class="pkg-version" data-toc-text="0.3.0" id="webtrackr-030">webtrackR 0.3.0<a class="anchor" aria-label="anchor" href="#webtrackr-030"></a></h2>
+<h2 class="pkg-version" data-toc-text="0.3.1" id="webtrackr-031">webtrackR 0.3.1<a class="anchor" aria-label="anchor" href="#webtrackr-031"></a></h2>
+<ul><li>fixed CRAN problems with tests</li>
+</ul></div>
+    <div class="section level2">
+<h2 class="pkg-version" data-toc-text="0.3.0" id="webtrackr-030">webtrackR 0.3.0<a class="anchor" aria-label="anchor" href="#webtrackr-030"></a></h2><p class="text-muted">CRAN release: 2024-04-28</p>
 <ul><li>revert back to new version of data.table</li>
 </ul></div>
     <div class="section level2">
diff --git a/pkgdown.yml b/pkgdown.yml
index 6f8f811..34e954b 100644
--- a/pkgdown.yml
+++ b/pkgdown.yml
@@ -3,7 +3,7 @@ pkgdown: 2.0.9
 pkgdown_sha: ~
 articles:
   webtrackR: webtrackR.html
-last_built: 2024-04-28T20:16Z
+last_built: 2024-04-30T11:58Z
 urls:
   reference: https://schochastics.github.io/webtrackR/reference
   article: https://schochastics.github.io/webtrackR/articles
diff --git a/reference/add_duration.html b/reference/add_duration.html
index aacec54..b57356c 100644
--- a/reference/add_duration.html
+++ b/reference/add_duration.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_next_visit.html b/reference/add_next_visit.html
index cb9acb2..7a5d4c3 100644
--- a/reference/add_next_visit.html
+++ b/reference/add_next_visit.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_panelist_data.html b/reference/add_panelist_data.html
index a4b6c22..2db5c30 100644
--- a/reference/add_panelist_data.html
+++ b/reference/add_panelist_data.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_previous_visit.html b/reference/add_previous_visit.html
index 1c1c862..905ab9f 100644
--- a/reference/add_previous_visit.html
+++ b/reference/add_previous_visit.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_referral.html b/reference/add_referral.html
index 3ba8118..07cb72d 100644
--- a/reference/add_referral.html
+++ b/reference/add_referral.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_session.html b/reference/add_session.html
index 90298d8..3542f90 100644
--- a/reference/add_session.html
+++ b/reference/add_session.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/add_title.html b/reference/add_title.html
index 018dd8a..183bec8 100644
--- a/reference/add_title.html
+++ b/reference/add_title.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/atkinson_index.html b/reference/atkinson_index.html
index 0898103..141638e 100644
--- a/reference/atkinson_index.html
+++ b/reference/atkinson_index.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/bakshy.html b/reference/bakshy.html
index cf04a73..4d6046b 100644
--- a/reference/bakshy.html
+++ b/reference/bakshy.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/classify_visits.html b/reference/classify_visits.html
index 188e702..bdc07d2 100644
--- a/reference/classify_visits.html
+++ b/reference/classify_visits.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/create_urldummy.html b/reference/create_urldummy.html
index d5ade1b..6d655ec 100644
--- a/reference/create_urldummy.html
+++ b/reference/create_urldummy.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/deduplicate.html b/reference/deduplicate.html
index a0283f8..68cc8d7 100644
--- a/reference/deduplicate.html
+++ b/reference/deduplicate.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/dissimilarity_index.html b/reference/dissimilarity_index.html
index af2d92b..b6602c6 100644
--- a/reference/dissimilarity_index.html
+++ b/reference/dissimilarity_index.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/domain_list.html b/reference/domain_list.html
index 3e59ff3..1d953f5 100644
--- a/reference/domain_list.html
+++ b/reference/domain_list.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/drop_query.html b/reference/drop_query.html
index 853fe57..435e581 100644
--- a/reference/drop_query.html
+++ b/reference/drop_query.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extract_domain.html b/reference/extract_domain.html
index 27ae262..8fbee46 100644
--- a/reference/extract_domain.html
+++ b/reference/extract_domain.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extract_host.html b/reference/extract_host.html
index 6f61ed5..c523061 100644
--- a/reference/extract_host.html
+++ b/reference/extract_host.html
@@ -18,7 +18,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/extract_path.html b/reference/extract_path.html
index 9cde98d..25b6336 100644
--- a/reference/extract_path.html
+++ b/reference/extract_path.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/fake_tracking.html b/reference/fake_tracking.html
index 796a238..f9c8f5b 100644
--- a/reference/fake_tracking.html
+++ b/reference/fake_tracking.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/index.html b/reference/index.html
index 6a0f609..2df4c52 100644
--- a/reference/index.html
+++ b/reference/index.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/isolation_index.html b/reference/isolation_index.html
index a6a8cc0..6596fe2 100644
--- a/reference/isolation_index.html
+++ b/reference/isolation_index.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/news_types.html b/reference/news_types.html
index 12a5c6e..a75ad04 100644
--- a/reference/news_types.html
+++ b/reference/news_types.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/parse_path.html b/reference/parse_path.html
index db05094..584a235 100644
--- a/reference/parse_path.html
+++ b/reference/parse_path.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/print.wt_dt.html b/reference/print.wt_dt.html
index 6efb86d..4ec3e8b 100644
--- a/reference/print.wt_dt.html
+++ b/reference/print.wt_dt.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sum_activity.html b/reference/sum_activity.html
index 570adc1..6f3dd3c 100644
--- a/reference/sum_activity.html
+++ b/reference/sum_activity.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sum_durations.html b/reference/sum_durations.html
index 7ea8dc5..e4ffad5 100644
--- a/reference/sum_durations.html
+++ b/reference/sum_durations.html
@@ -22,7 +22,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/sum_visits.html b/reference/sum_visits.html
index 522f262..0ea8453 100644
--- a/reference/sum_visits.html
+++ b/reference/sum_visits.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/summary.wt_dt.html b/reference/summary.wt_dt.html
index cdbb153..f5baac4 100644
--- a/reference/summary.wt_dt.html
+++ b/reference/summary.wt_dt.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/testdt_survey_l.html b/reference/testdt_survey_l.html
index 0ede8c8..0ed6d4b 100644
--- a/reference/testdt_survey_l.html
+++ b/reference/testdt_survey_l.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/testdt_survey_w.html b/reference/testdt_survey_w.html
index 220d353..89d97ac 100644
--- a/reference/testdt_survey_w.html
+++ b/reference/testdt_survey_w.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/testdt_tracking.html b/reference/testdt_tracking.html
index 8c151e0..11124de 100644
--- a/reference/testdt_tracking.html
+++ b/reference/testdt_tracking.html
@@ -10,7 +10,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/vars_exist.html b/reference/vars_exist.html
index d8ec8cb..7c8e416 100644
--- a/reference/vars_exist.html
+++ b/reference/vars_exist.html
@@ -14,7 +14,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/webtrackR-package.html b/reference/webtrackR-package.html
index db1a73d..cac9011 100644
--- a/reference/webtrackR-package.html
+++ b/reference/webtrackR-package.html
@@ -16,7 +16,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/reference/wt_dt.html b/reference/wt_dt.html
index ab298a9..2cfa85c 100644
--- a/reference/wt_dt.html
+++ b/reference/wt_dt.html
@@ -12,7 +12,7 @@
     
     <a class="navbar-brand me-2" href="../index.html">webtrackR</a>
 
-    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.0</small>
+    <small class="nav-text text-muted me-auto" data-bs-toggle="tooltip" data-bs-placement="bottom" title="">0.3.1</small>
 
     
     <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbar" aria-controls="navbar" aria-expanded="false" aria-label="Toggle navigation">
diff --git a/search.json b/search.json
index 1646316..1c0ae53 100644
--- a/search.json
+++ b/search.json
@@ -1 +1 @@
-[{"path":"https://schochastics.github.io/webtrackR/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2022 webtrackR authors Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"installation","dir":"Articles","previous_headings":"","what":"Installation","title":"webtrackR","text":"can install development version webtrackR GitHub : CRAN version can installed :","code":"# install.packages(\"devtools\") devtools::install_github(\"schochastics/webtrackR\") install.packages(\"webtrackR\")"},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"s3-class-wt_dt","dir":"Articles","previous_headings":"","what":"S3 class wt_dt","title":"webtrackR","text":"package defines S3 class called wt_dt inherits functionality data.frame class. summary print method included package. row web tracking data set represents visit. Raw data need least following variables: panelist_id: individual data collected url: URL visit timestamp: time URL visit function .wt_dt assigns class wt_dt raw web tracking data set. also allows specify name raw variables corresponding panelist_id, url timestamp. Additionally, turns timestamp variable POSIXct format. preprocessing functions check three variables present. Otherwise error thrown.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"preprocessing","dir":"Articles","previous_headings":"","what":"Preprocessing","title":"webtrackR","text":"Several variables can derived raw data following functions: add_duration() adds variable called duration based sequence timestamps. basic logic duration visit set time difference subsequent visit, unless difference exceeds certain value (defined argument cutoff), case duration replaced NA user-defined value (defined replace_by). add_session() adds variable called session, groups subsequent visits session difference next visit exceeds certain value (defined cutoff). extract_host(), extract_domain(), extract_path() extracts host, domain path raw URL adds variables named accordingly. See function descriptions definitions terms. drop_query() lets drop query fragment components raw URL. add_next_visit() add_previous_visit() adds previous next URL, domain, host (defined level) new variable. add_referral() adds new variable indicating whether visit referred social media platform. Follows logic Schmidt et al., (2023). add_title() downloads title website (text within <title> tag web site’s <head>) adds new variable. add_panelist_data(). Joins data set containing information participants survey.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"classification","dir":"Articles","previous_headings":"","what":"Classification","title":"webtrackR","text":"classify_visits() categorizes website visits either extracting URL’s domain host matching list domains hosts, matching list regular expressions visit URL.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"summarizing-and-aggregating","dir":"Articles","previous_headings":"","what":"Summarizing and aggregating","title":"webtrackR","text":"deduplicate() flags drops (defined argument method) consecutive visits URL within user-defined time frame (set argument within). Alternatively dropping flagging visits, function aggregates durations duplicate visits. sum_visits() sum_durations() aggregate number durations visits, participant time period (set argument timeframe). Optionally, function aggregates number / duration visits certain class visits. sum_activity() counts number active time periods (defined timeframe) participant.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"example-code","dir":"Articles","previous_headings":"","what":"Example code","title":"webtrackR","text":"typical workflow including preprocessing, classifying aggregating web tracking data looks like (using -built example data):","code":"library(webtrackR)  # load example data and turn it into wt_dt data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking)  # add duration wt <- add_duration(wt)  # extract domains wt <- extract_domain(wt)  # drop duplicates (consecutive visits to the same URL within one second) wt <- deduplicate(wt, within = 1, method = \"drop\")  # load example domain classification and classify domains data(\"domain_list\") wt <- classify_visits(wt, classes = domain_list, match_by = \"domain\")  # load example survey data and join with web tracking data data(\"testdt_survey_w\") wt <- add_panelist_data(wt, testdt_survey_w)  # aggregate number of visits by day and panelist, and by domain class wt_summ <- sum_visits(wt, timeframe = \"date\", visit_class = \"type\")"},{"path":"https://schochastics.github.io/webtrackR/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"David Schoch. Author, maintainer. Bernhard Clemm von Hohenberg. Author. Frank Mangold. Author. Sebastian Stier. Author.","code":""},{"path":"https://schochastics.github.io/webtrackR/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Schoch, D.; Clemm von Hohenberg, B.; Mangold, F.; Stier, S.   (2023). webtrackR: Preprocessing Analyzing Web Tracking Data","code":"@Manual{,   title = {webtrackR: Preprocessing and Analyzing Web Tracking Data},   author = {David Schoch and Bernhard Clemm {von Hohenberg} and Frank Mangold and Sebastian Stier},   year = {2023}, }"},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"webtrackr-","dir":"","previous_headings":"","what":"Preprocessing and Analyzing Web Tracking Data","title":"Preprocessing and Analyzing Web Tracking Data","text":"webtrackR R package preprocess analyze web tracking data, .e., web browsing histories participants academic study. Web tracking data oftentimes collected analyzed conjunction survey data participants. webtrackR part series R packages analyse webtracking data: webtrackR: preprocess raw webtracking data domainator: classify domains adaR: parse urls","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Preprocessing and Analyzing Web Tracking Data","text":"can install development version webtrackR GitHub : CRAN version can installed :","code":"# install.packages(\"devtools\") devtools::install_github(\"schochastics/webtrackR\") install.packages(\"webtrackR\")"},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"s3-class-wt_dt","dir":"","previous_headings":"","what":"S3 class wt_dt","title":"Preprocessing and Analyzing Web Tracking Data","text":"package defines S3 class called wt_dt inherits functionality data.frame class. summary print method included package. row web tracking data set represents visit. Raw data need least following variables: panelist_id: individual data collected url: URL visit timestamp: time URL visit function .wt_dt assigns class wt_dt raw web tracking data set. also allows specify name raw variables corresponding panelist_id, url timestamp. Additionally, turns timestamp variable POSIXct format. preprocessing functions check three variables present. Otherwise error thrown.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"preprocessing","dir":"","previous_headings":"","what":"Preprocessing","title":"Preprocessing and Analyzing Web Tracking Data","text":"Several variables can derived raw data following functions: add_duration() adds variable called duration based sequence timestamps. basic logic duration visit set time difference subsequent visit, unless difference exceeds certain value (defined argument cutoff), case duration replaced NA user-defined value (defined replace_by). add_session() adds variable called session, groups subsequent visits session difference next visit exceeds certain value (defined cutoff). extract_host(), extract_domain(), extract_path() extracts host, domain path raw URL adds variables named accordingly. See function descriptions definitions terms. drop_query() lets drop query fragment components raw URL. add_next_visit() add_previous_visit() adds previous next URL, domain, host (defined level) new variable. add_referral() adds new variable indicating whether visit referred social media platform. Follows logic Schmidt et al., (2023). add_title() downloads title website (text within <title> tag web site’s <head>) adds new variable. add_panelist_data(). Joins data set containing information participants survey.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"classification","dir":"","previous_headings":"","what":"Classification","title":"Preprocessing and Analyzing Web Tracking Data","text":"classify_visits() categorizes website visits either extracting URL’s domain host matching list domains hosts, matching list regular expressions visit URL.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"summarizing-and-aggregating","dir":"","previous_headings":"","what":"Summarizing and aggregating","title":"Preprocessing and Analyzing Web Tracking Data","text":"deduplicate() flags drops (defined argument method) consecutive visits URL within user-defined time frame (set argument within). Alternatively dropping flagging visits, function aggregates durations duplicate visits. sum_visits() sum_durations() aggregate number durations visits, participant time period (set argument timeframe). Optionally, function aggregates number / duration visits certain class visits. sum_activity() counts number active time periods (defined timeframe) participant.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"example-code","dir":"","previous_headings":"","what":"Example code","title":"Preprocessing and Analyzing Web Tracking Data","text":"typical workflow including preprocessing, classifying aggregating web tracking data looks like (using -built example data):","code":"library(webtrackR)  # load example data and turn it into wt_dt data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking)  # add duration wt <- add_duration(wt)  # extract domains wt <- extract_domain(wt)  # drop duplicates (consecutive visits to the same URL within one second) wt <- deduplicate(wt, within = 1, method = \"drop\")  # load example domain classification and classify domains data(\"domain_list\") wt <- classify_visits(wt, classes = domain_list, match_by = \"domain\")  # load example survey data and join with web tracking data data(\"testdt_survey_w\") wt <- add_panelist_data(wt, testdt_survey_w)  # aggregate number of visits by day and panelist, and by domain class wt_summ <- sum_visits(wt, timeframe = \"date\", visit_class = \"type\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":null,"dir":"Reference","previous_headings":"","what":"Add time spent on a visit in seconds — add_duration","title":"Add time spent on a visit in seconds — add_duration","text":"add_duration() approximates time spent visit based difference two consecutive timestamps, replacing differences exceeding cutoff value defined replace_by.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add time spent on a visit in seconds — add_duration","text":"","code":"add_duration(   wt,   cutoff = 300,   replace_by = NA,   last_replace_by = NA,   device_switch_na = FALSE,   device_var = NULL )"},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add time spent on a visit in seconds — add_duration","text":"wt webtrack data object. cutoff numeric (seconds). duration greater value, reset value defined replace_by. Defaults 300 seconds. replace_by numeric. Determines whether differences greater cutoff set NA, value. Defaults NA. last_replace_by numeric. Determines whether last visit individual set NA, value. Defaults NA. device_switch_na boolean. Relevant data collected multiple devices. visits ordered timestamp sequence, two consecutive visits can come different devices, makes timestamp difference less likely true duration. may preferable set duration visit NA (TRUE) rather difference next timestamp (FALSE). Defaults FALSE. device_var character. Column indicating device. Required 'device_switch_na' set TRUE. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add time spent on a visit in seconds — add_duration","text":"webtrack data.frame columns wt new column called duration.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add time spent on a visit in seconds — add_duration","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- add_duration(wt) # Defining cutoff at 10 minutes, replacing those exceeding cutoff to 5 minutes, # and setting duration before device switch to `NA`: wt <- add_duration(wt,     cutoff = 600, replace_by = 300,     device_switch_na = TRUE, device_var = \"device\" ) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":null,"dir":"Reference","previous_headings":"","what":"Add the next visit as a new column — add_next_visit","title":"Add the next visit as a new column — add_next_visit","text":"add_next_visit() adds subsequent visit, determined order timestamps new column. next visit can added either full URL, extracted host extracted domain, depending level.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add the next visit as a new column — add_next_visit","text":"","code":"add_next_visit(wt, level = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add the next visit as a new column — add_next_visit","text":"wt webtrack data object. level character. Either \"url\", \"host\" \"domain\". Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add the next visit as a new column — add_next_visit","text":"webtrack data.frame columns wt new column called url_next,host_next domain_next.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add the next visit as a new column — add_next_visit","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Adding next full URL as new column wt <- add_next_visit(wt, level = \"url\") # Adding next host as new column wt <- add_next_visit(wt, level = \"host\") # Adding next domain as new column wt <- add_next_visit(wt, level = \"domain\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Add panelist features to tracking data — add_panelist_data","title":"Add panelist features to tracking data — add_panelist_data","text":"Adds information panelists (e.g., survey) tracking data.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add panelist features to tracking data — add_panelist_data","text":"","code":"add_panelist_data(wt, data, cols = NULL, join_on = \"panelist_id\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add panelist features to tracking data — add_panelist_data","text":"wt webtrack data object. data data frame containing panelist data contains columns panelists cols character vector columns add. NULL, columns added. Defaults NULL. join_on columns join . Defaults \"panelist_id\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add panelist features to tracking data — add_panelist_data","text":"webtrack object columns columns data specified cols.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add panelist features to tracking data — add_panelist_data","text":"","code":"if (FALSE) { data(\"testdt_tracking\") data(\"testdt_survey_w\") wt <- as.wt_dt(testdt_tracking) # add survey test data add_panelist_data(wt, testdt_survey_w) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":null,"dir":"Reference","previous_headings":"","what":"Add the previous visit as a new column — add_previous_visit","title":"Add the previous visit as a new column — add_previous_visit","text":"add_previous_visit() adds previous visit, determined order timestamps new column previous visit can added either full URL, extracted host extracted domain, depending level.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add the previous visit as a new column — add_previous_visit","text":"","code":"add_previous_visit(wt, level = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add the previous visit as a new column — add_previous_visit","text":"wt webtrack data object. level character. Either \"url\", \"host\" \"domain\". Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add the previous visit as a new column — add_previous_visit","text":"webtrack data.frame columns wt new column called url_previous,host_previous domain_previous..","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add the previous visit as a new column — add_previous_visit","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Adding previous full URL as new column wt <- add_previous_visit(wt, level = \"url\") # Adding previous host as new column wt <- add_previous_visit(wt, level = \"host\") # Adding previous domain as new column wt <- add_previous_visit(wt, level = \"domain\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":null,"dir":"Reference","previous_headings":"","what":"Add social media referrals as a new column — add_referral","title":"Add social media referrals as a new column — add_referral","text":"Identifies whether visit referred social media adds new column. See details method.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add social media referrals as a new column — add_referral","text":"","code":"add_referral(wt, platform_domains, patterns)"},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add social media referrals as a new column — add_referral","text":"wt webtrack data object. platform_domains character. vector platform domains referrers identified. Order length must correspondent patterns argument patterns character. vector patterns referrers identified. Order length must correspondent platform_domains vector.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add social media referrals as a new column — add_referral","text":"webtrack data.frame columns wt new column called referral, takes NA referral identified, name specified platform_domains referral platform identified","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add social media referrals as a new column — add_referral","text":"identify referrals, rely method described valid Schmidt et al.: domain preceding visit platform question, query string visit's URL contains certain pattern, count referred visit. Facebook, pattern identified Schmidt et al. 'fbclid=', although can change future.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Add social media referrals as a new column — add_referral","text":"Schmidt, Felix, Frank Mangold, Sebastian Stier Roberto Ulloa. \"Facebook Avenue News: Comparison Validation Approaches Identify Facebook Referrals\". Working paper.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add social media referrals as a new column — add_referral","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- add_referral(wt, platform_domains = \"facebook.com\", patterns = \"fbclid=\") wt <- add_referral(wt,     platform_domains = c(\"facebook.com\", \"twitter.com\"),     patterns = c(\"fbclid=\", \"utm_source=twitter\") ) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a session variable — add_session","title":"Add a session variable — add_session","text":"add_session() groups visits \"sessions\", defining session end difference two consecutive timestamps exceeds cutoff.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a session variable — add_session","text":"","code":"add_session(wt, cutoff)"},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a session variable — add_session","text":"wt webtrack data object. cutoff numeric (seconds). difference two consecutive timestamps exceeds value, new browsing session defined.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a session variable — add_session","text":"webtrack data.frame columns wt new column called session.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add a session variable — add_session","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Setting cutoff to 30 minutes wt <- add_session(wt, cutoff = 1800) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and add the ","title":"Download and add the ","text":"Gets title URL accessing web address online adds title new column. See details meaning \"title\". need internet connection run function.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and add the ","text":"","code":"add_title(wt, lang = \"en-US,en-GB,en\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and add the ","text":"wt webtrack data object. lang character (language tag). Language accepted request. Defaults \"en-US,en-GB,en\". Note likely still obtain titles different ones seen originally user, language also depend user's IP device settings.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and add the ","text":"webtrack data.frame columns wt new column called \"title\", NA title retrieved.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and add the ","text":"title website (text within <title> tag web site's <head>) #' text shown \"tab\" looking website browser. can contain useful information URL's content can used, example, classification purposes. Note may take run function large number URLs.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and add the ","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking)[1:2] # Get titles with `lang` set to default English wt_titles <- add_title(wt) # Get titles with `lang` set to German wt_titles <- add_title(wt, lang = \"de\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"Symmetric Atkinson Index calculates symmetric Atkinson index","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"","code":"atkinson_index(grp_a, grp_b)"},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"grp_a vector (usually corresponds column webtrack data frame) indicating number individuals group using website grp_b vector (usually corresponds column webtrack data frame) indicating number individuals group B using website","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"Frankel, David, Oscar Volij. \"Scale Invariant Measures Segregation \"Working Paper, 2008.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"","code":"# perfect score grp_a <- c(5, 5, 0, 0) grp_b <- c(0, 0, 5, 5) atkinson_index(grp_a, grp_b) #> [1] 1  grp_a <- c(5, 5, 5, 5) grp_b <- c(5, 5, 5, 5) atkinson_index(grp_a, grp_b) #> [1] 0"},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":null,"dir":"Reference","previous_headings":"","what":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"Bakshy Top500 Ideological alignment 500 domains based facebook data","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"","code":"bakshy"},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"object class data.table (inherits data.frame) 500 rows 7 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"Bakshy, Eytan, Solomon Messing, Lada . Adamic. \"Exposure ideologically diverse news opinion Facebook.\" Science 348.6239 (2015): 1130-1132.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":null,"dir":"Reference","previous_headings":"","what":"Classify visits by matching to a list of classes — classify_visits","title":"Classify visits by matching to a list of classes — classify_visits","text":"classify_visits() categorizes visits either extracting visit URL's domain host matching list domains hosts; matching list regular expressions visit URL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Classify visits by matching to a list of classes — classify_visits","text":"","code":"classify_visits(   wt,   classes,   match_by = \"domain\",   regex_on = NULL,   return_rows_by = NULL,   return_rows_val = NULL )"},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Classify visits by matching to a list of classes — classify_visits","text":"wt webtrack data object. classes data frame containing classes can matched visits. match_by character. Whether match list entries classes domain visit (\"domain\") host (\"host\") exact match; regular expression whole URL visit (\"regex\"). set \"domain\" \"host\", wt classes need column called accordingly. set \"regex\", url column wt used, need set regex_on column classes pattern matching. Defaults \"domain\". regex_on character. Column classes use pattern matching. Defaults NULL. return_rows_by character. column classes subset returning data. Defaults NULL. return_rows_val character. value columns specified return_rows_by, data returned. example, classes data contains column type, value called \"shopping\", setting return_rows_by \"type\" return_rows_val \"shopping\" return visits classified \"shopping\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Classify visits by matching to a list of classes — classify_visits","text":"webtrack data.frame columns wt column classes except column specified match_by.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Classify visits by matching to a list of classes — classify_visits","text":"","code":"if (FALSE) { data(\"testdt_tracking\") data(\"domain_list\") wt <- as.wt_dt(testdt_tracking) # classify visits via domain wt_domains <- extract_domain(wt) wt_classes <- classify_visits(wt_domains, classes = domain_list, match_by = \"domain\") # classify visits via domain # for the example, just renaming \"domain\" column domain_list$host <- domain_list$domain wt_hosts <- extract_host(wt) wt_classes <- classify_visits(wt_hosts, classes = domain_list, match_by = \"host\") # classify visits with pattern matching # for the example, any value in \"domain\" treated as pattern data(\"domain_list\") regex_list <- domain_list[type == \"facebook\"] wt_classes <- classify_visits(wt[1:5000],     classes = regex_list,     match_by = \"regex\", regex_on = \"domain\" ) # classify visits via domain and only return class \"search\" data(\"domain_list\") wt_classes <- classify_visits(wt_domains,     classes = domain_list,     match_by = \"domain\", return_rows_by = \"type\",     return_rows_val = \"search\" ) }"},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":null,"dir":"Reference","previous_headings":"","what":"Create an urldummy variable — create_urldummy","title":"Create an urldummy variable — create_urldummy","text":"Create urldummy variable","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create an urldummy variable — create_urldummy","text":"","code":"create_urldummy(wt, dummy, name)"},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create an urldummy variable — create_urldummy","text":"wt webtrack data object dummy vector urls dummy coded name name dummy variable create.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create an urldummy variable — create_urldummy","text":"webtrack object columns new column called \"name\" including dummy variable","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create an urldummy variable — create_urldummy","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- extract_domain(wt) code_urls <- \"https://dkr1.ssisurveys.com/tzktsxomta\" create_urldummy(wt, dummy = code_urls, name = \"test_dummy\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":null,"dir":"Reference","previous_headings":"","what":"Deduplicate visits — deduplicate","title":"Deduplicate visits — deduplicate","text":"deduplicate() flags, drops aggregates duplicates, defined consecutive visits URL within certain time frame.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deduplicate visits — deduplicate","text":"","code":"deduplicate(   wt,   method = \"aggregate\",   within = 1,   duration_var = \"duration\",   keep_nvisits = FALSE,   same_day = TRUE,   add_grpvars = NULL )"},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Deduplicate visits — deduplicate","text":"wt webtrack data object. method character. One \"aggregate\", \"flag\" \"drop\". set \"aggregate\", consecutive visits (matter time difference) URL combined duration aggregated. case, duration column must specified via \"duration_var\". set \"flag\", duplicates within certain time frame flagged new column called duplicate. case, within argument must specified. set \"drop\", duplicates dropped. , within argument must specified. Defaults \"aggregate\". within numeric (seconds). method set \"flag\" \"drop\", subsequent visit defined duplicate happening within time difference. Defaults 1 second. duration_var character. Name duration variable. Defaults \"duration\". keep_nvisits boolean. method set \"aggregate\", determines whether number aggregated visits kept variable. Defaults FALSE. same_day boolean. method set \"aggregate\", determines whether count visits consecutive day. Defaults TRUE. add_grpvars vector. method set \"aggregate\", determines whether additional variables included grouping visits therefore kept. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Deduplicate visits — deduplicate","text":"webtrack data.frame columns wt updated duration","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Deduplicate visits — deduplicate","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- add_duration(wt, cutoff = 300, replace_by = 300) # Dropping duplicates with one-second default wt_dedup <- deduplicate(wt, method = \"drop\") # Flagging duplicates with one-second default wt_dedup <- deduplicate(wt, method = \"flag\") # Aggregating duplicates wt_dedup <- deduplicate(wt[1:1000], method = \"aggregate\") # Aggregating duplicates and keeping number of visits for aggregated visits wt_dedup <- deduplicate(wt[1:1000], method = \"aggregate\", keep_nvisits = TRUE) # Aggregating duplicates and keeping \"domain\" variable despite grouping wt <- extract_domain(wt) wt_dedup <- deduplicate(wt, method = \"aggregate\", add_grpvars = \"domain\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Dissimilarity Index — dissimilarity_index","title":"Dissimilarity Index — dissimilarity_index","text":"Dissimilarity Index can interpreted share Group visits need redistributed across media share group uniform across websites.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Dissimilarity Index — dissimilarity_index","text":"","code":"dissimilarity_index(grp_a, grp_b)"},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Dissimilarity Index — dissimilarity_index","text":"grp_a vector (usually corresponds column webtrack data frame) indicating number individuals group using website grp_b vector (usually corresponds column webtrack data frame) indicating number individuals group B using website","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Dissimilarity Index — dissimilarity_index","text":"Cutler, David M., Edward L. Glaeser, Jacob L. Vigdor. \"rise decline American ghetto.\" Journal political economy 107.3 (1999): 455-506.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Dissimilarity Index — dissimilarity_index","text":"","code":"# perfect dissimilarity grp_a <- c(5, 5, 0, 0) grp_b <- c(0, 0, 5, 5) dissimilarity_index(grp_a, grp_b) #> [1] 1  # no dissimilarity grp_a <- c(5, 5, 5, 5) grp_b <- c(5, 5, 5, 5) dissimilarity_index(grp_a, grp_b) #> [1] 0"},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Domain list classification of domains into news,portals, search, and social media — domain_list","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"Domain list classification domains news,portals, search, social media","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"","code":"domain_list"},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"object class data.table (inherits data.frame) 663 rows 2 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"Stier, S., Mangold, F., Scharkow, M., & Breuer, J. (2022). Post Post-Broadcast Democracy? News Exposure Age Online Intermediaries. American Political Science Review, 116(2), 768-774.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":null,"dir":"Reference","previous_headings":"","what":"Drop the query and fragment from URL — drop_query","title":"Drop the query and fragment from URL — drop_query","text":"drop_query() adds URL without query fragment new column. query defined part following \"?\" path. fragement anything following \"#\" query.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Drop the query and fragment from URL — drop_query","text":"","code":"drop_query(wt, varname = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Drop the query and fragment from URL — drop_query","text":"wt webtrack data object. varname character. name column extract host. Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Drop the query and fragment from URL — drop_query","text":"webtrack data.frame columns wt new column called '<varname>_noquery'","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Drop the query and fragment from URL — drop_query","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract URL without query/fragment wt <- drop_query(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract the domain from URL — extract_domain","title":"Extract the domain from URL — extract_domain","text":"extract_domain() adds domain URL new column. \"domain\", mean \"top private domain\", .e., domain public suffix (e.g., \"com\") defined Public Suffix List. See details. Extracts domain urls.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract the domain from URL — extract_domain","text":"","code":"extract_domain(wt, varname = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract the domain from URL — extract_domain","text":"wt webtrack data object. varname character. Name column extract host. Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract the domain from URL — extract_domain","text":"webtrack data.frame columns wt new column called 'domain' (, varname equal 'url', '<varname>_domain')","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Extract the domain from URL — extract_domain","text":"define \"web domain\" common colloquial meaning, , part web address identifies person organization control. google.com. technically, mean \"domain\" \"top private domain\", .e., domain public suffix, defined Public Suffix List. Note definition sometimes leads counterintuitive results public suffixes \"registry suffixes\". , controlled domain name registrar, allow users directly register domain. One example public, non-registry suffix blogspot.com. URL like www.mysite.blogspot.com, function, indeed packages aware , extract domain mysite.blogspot.com, although might think blogspot.com domain. details, see ","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract the domain from URL — extract_domain","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract domain and drop rows without domain wt <- extract_domain(wt) # Extract domain and keep rows without domain wt <- extract_domain(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract the host from URL — extract_host","title":"Extract the host from URL — extract_host","text":"extract_host() adds host URL new column. host defined part following scheme (e.g., \"https://\") preceding subdirectory (anything following next \"/\"). Note URL entries like chrome-extension://soomething http://192.168.0.1/something, result set NA.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract the host from URL — extract_host","text":"","code":"extract_host(wt, varname = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract the host from URL — extract_host","text":"wt webtrack data object. varname character. Name column extract host. Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract the host from URL — extract_host","text":"webtrack data.frame columns wt new column called 'host' (, varname equal 'url', '<varname>_host')","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract the host from URL — extract_host","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract host and drop rows without host wt <- extract_host(wt) # Extract host and keep rows without host wt <- extract_host(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract the path from URL — extract_path","title":"Extract the path from URL — extract_path","text":"extract_path() adds path URL new column. path defined part following host including query (anything \"?\") fragment (anything \"#\").","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract the path from URL — extract_path","text":"","code":"extract_path(wt, varname = \"url\", decode = TRUE)"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract the path from URL — extract_path","text":"wt webtrack data object varname character. name column extract host. Defaults \"url\". decode logical. Whether decode path (see utils::URLdecode()), default TRUE","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract the path from URL — extract_path","text":"webtrack data.frame columns wt new column called 'path' (, varname equal 'url', '<varname>_path')","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract the path from URL — extract_path","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract path wt <- extract_path(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/fake_tracking.html","id":null,"dir":"Reference","previous_headings":"","what":"Fake data — fake_tracking","title":"Fake data — fake_tracking","text":"Small fake webtracking data testing purpose","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/fake_tracking.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fake data — fake_tracking","text":"","code":"fake_tracking"},{"path":"https://schochastics.github.io/webtrackR/reference/fake_tracking.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Fake data — fake_tracking","text":"object class data.frame 500 rows 3 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Isolation Index — isolation_index","title":"Isolation Index — isolation_index","text":"Given two groups (B) individuals, isolation index captures extent group disproportionately visit websites whose visitors also members group .","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Isolation Index — isolation_index","text":"","code":"isolation_index(grp_a, grp_b, adjusted = FALSE)"},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Isolation Index — isolation_index","text":"grp_a vector (usually corresponds column webtrack data frame) indicating number individuals group using website grp_b vector (usually corresponds column webtrack data frame) indicating number individuals group B using website adjusted logical. index adjusted (defaults FALSE)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Isolation Index — isolation_index","text":"numeric value 0 1. 0 indicates isolation 1 perfect isolation","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Isolation Index — isolation_index","text":"value 1 indicates websites visited group group B overlap. value 0 means visit exactly websites","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Isolation Index — isolation_index","text":"Cutler, David M., Edward L. Glaeser, Jacob L. Vigdor. \"rise decline American ghetto.\" Journal political economy 107.3 (1999): 455-506. Gentzkow, Matthew, Jesse M. Shapiro. \"Ideological segregation online offline.\" Quarterly Journal Economics 126.4 (2011): 1799-1839.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Isolation Index — isolation_index","text":"","code":"# perfect isolation grp_a <- c(5, 5, 0, 0) grp_b <- c(0, 0, 5, 5) isolation_index(grp_a, grp_b) #> [1] 1  # perfect overlap grp_a <- c(5, 5, 5, 5) grp_b <- c(5, 5, 5, 5) isolation_index(grp_a, grp_b) #> [1] 0"},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":null,"dir":"Reference","previous_headings":"","what":"News Types — news_types","title":"News Types — news_types","text":"Classification domains different news types","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"News Types — news_types","text":"","code":"news_types"},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"News Types — news_types","text":"object class data.table (inherits data.frame) 690 rows 2 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"News Types — news_types","text":"Stier, S., Mangold, F., Scharkow, M., & Breuer, J. (2022). Post Post-Broadcast Democracy? News Exposure Age Online Intermediaries. American Political Science Review, 116(2), 768-774.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Parse parts of path for text analysis — parse_path","title":"Parse parts of path for text analysis — parse_path","text":"parse_path() parses parts path, .e., anything separated \"/\", \"-\", \"_\" \".\", adds new variable. Parts consist letters , real word, can filtered via argument keep.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parse parts of path for text analysis — parse_path","text":"","code":"parse_path(wt, varname = \"url\", keep = \"letters_only\", decode = TRUE)"},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parse parts of path for text analysis — parse_path","text":"wt webtrack data object varname character. name column extract host. Defaults \"url\". keep character. Defines types path components keep. set \"\", anything kept. \"letters_only\", parts containing letters kept. \"words_only\", parts constituting English words (defined Word Game Dictionary, cf. https://cran.r-project.org/web/packages/words/index.html) kept. Support languages added future. decode logical. Whether decode path (see utils::URLdecode()), default TRUE","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Parse parts of path for text analysis — parse_path","text":"webtrack data.frame columns wt new column called 'path_split'  (, varname equal 'url', '<varname>_path_split') containing parts comma-separated string.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Parse parts of path for text analysis — parse_path","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- parse_path(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":null,"dir":"Reference","previous_headings":"","what":"Print web tracking data — print.wt_dt","title":"Print web tracking data — print.wt_dt","text":"Print web tracking data","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Print web tracking data — print.wt_dt","text":"","code":"# S3 method for wt_dt print(x, ...)"},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Print web tracking data — print.wt_dt","text":"x object class wt_dt ... additional parameters print","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Print web tracking data — print.wt_dt","text":"return value, called side effects","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize activity per person — sum_activity","title":"Summarize activity per person — sum_activity","text":"sum_activity() counts number active time periods (.e., days, weeks, months, years, waves) panelist_id. period counts \"active\" panelist provided least one visit period.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize activity per person — sum_activity","text":"","code":"sum_activity(wt, timeframe = \"date\")"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize activity per person — sum_activity","text":"wt webtrack data object. timeframe character. Indicates time frame aggregate visits. Possible values \"date\", \"week\", \"month\", \"year\" \"wave\". set \"wave\", wt must contain column call wave. Defaults \"date\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize activity per person — sum_activity","text":"data.frame columns panelist_id, column indicating number active time units.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Summarize activity per person — sum_activity","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # summarize activity by day wt_sum <- sum_activity(wt, timeframe = \"date\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize visit duration by person — sum_durations","title":"Summarize visit duration by person — sum_durations","text":"sum_durations() summarizes duration visits person within timeframe, optionally visit_class visit. Note: time frame rows NA duration column, summarized duration time frame NA. rows time frame NA duration column, function ignore NA rows. visits class (.e., value 'visit_class' column) time frame, summarized duration time frame zero; visits, NA duration, summarized duration NA.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize visit duration by person — sum_durations","text":"","code":"sum_durations(wt, var_duration = NULL, timeframe = NULL, visit_class = NULL)"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize visit duration by person — sum_durations","text":"wt webtrack data object. var_duration character. Name duration variable already present. Defaults NULL, case duration approximated add_duration(wt, cutoff = 300, replace_by = \"na\", replace_val = NULL) timeframe character. Indicates time frame aggregate visit durations. Possible values \"date\", \"week\", \"month\", \"year\", \"wave\" NULL. set \"wave\", wt must contain column call wave. Defaults NULL, case output contains duration visits entire time. visit_class character. Column contains classification visits. value column, output column indicating number visits belonging value. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize visit duration by person — sum_durations","text":"data.frame columns panelist_id, column indicating time unit (unless timeframe set NULL), duration_visits indicating duration visits (seconds, whatever unit variable specified var_duration parameter), column value visit_class, specified.","code":""},{"path":[]},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize number of visits by person — sum_visits","title":"Summarize number of visits by person — sum_visits","text":"sum_visits() summarizes number visits person within timeframe, optionally visit_class visit.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize number of visits by person — sum_visits","text":"","code":"sum_visits(wt, timeframe = NULL, visit_class = NULL)"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize number of visits by person — sum_visits","text":"wt webtrack data object. timeframe character. Indicates time frame aggregate visits. Possible values \"date\", \"week\", \"month\", \"year\", \"wave\" NULL. set \"wave\", wt must contain column call wave. Defaults NULL, case output contains number visits entire time. visit_class character. Column contains classification visits. value column, output column indicating number visits belonging value. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize number of visits by person — sum_visits","text":"data.frame columns panelist_id, column indicating time unit (unless timeframe set NULL), n_visits indicating number visits, column value visit_class, specified.","code":""},{"path":[]},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":null,"dir":"Reference","previous_headings":"","what":"Summary function for web tracking data — summary.wt_dt","title":"Summary function for web tracking data — summary.wt_dt","text":"Summary function web tracking data","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summary function for web tracking data — summary.wt_dt","text":"","code":"# S3 method for wt_dt summary(object, ...)"},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summary function for web tracking data — summary.wt_dt","text":"object object class wt_dt ... additional parameters summary","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summary function for web tracking data — summary.wt_dt","text":"return value, called side effects","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_l.html","id":null,"dir":"Reference","previous_headings":"","what":"Test survey — testdt_survey_l","title":"Test survey — testdt_survey_l","text":"randomly generated survey data, one row per person/wave (long format)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_l.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Test survey — testdt_survey_l","text":"","code":"testdt_survey_l"},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_l.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Test survey — testdt_survey_l","text":"object class tbl_df (inherits tbl, data.frame) 15 rows 7 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_w.html","id":null,"dir":"Reference","previous_headings":"","what":"Test survey — testdt_survey_w","title":"Test survey — testdt_survey_w","text":"Randomly generated survey data used illustrative purposes (wide format)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_w.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Test survey — testdt_survey_w","text":"","code":"testdt_survey_w"},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_w.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Test survey — testdt_survey_w","text":"object class data.frame 5 rows 8 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_tracking.html","id":null,"dir":"Reference","previous_headings":"","what":"Test data — testdt_tracking","title":"Test data — testdt_tracking","text":"Sample fully anomymized webtrack data research project US participants","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_tracking.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Test data — testdt_tracking","text":"","code":"testdt_tracking"},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_tracking.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Test data — testdt_tracking","text":"object class data.frame 49612 rows 5 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if columns are present — vars_exist","title":"Check if columns are present — vars_exist","text":"vars_exist() checks columns present webtrack data object. default, checks whether data panelist_id, ulr timestamp column.#'","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if columns are present — vars_exist","text":"","code":"vars_exist(wt, vars = c(\"panelist_id\", \"url\", \"timestamp\"))"},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if columns are present — vars_exist","text":"wt webtrack data object. vars character vector variables. Defaults c(\"panelist_id\", \"url\", \"timestamp\").","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if columns are present — vars_exist","text":"data.table object.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/webtrackR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"webtrackR: Preprocessing and Analyzing Web Tracking Data — webtrackR-package","title":"webtrackR: Preprocessing and Analyzing Web Tracking Data — webtrackR-package","text":"Data structures methods work web tracking data. functions cover data preprocessing steps, enriching web tracking data external information methods analysis digital behavior used several academic papers (e.g., Clemm von Hohenberg et al., 2023 doi:10.17605/OSF.IO/M3U9P ; Stier et al., 2022 doi:10.1017/S0003055421001222 ).","code":""},{"path":[]},{"path":"https://schochastics.github.io/webtrackR/reference/webtrackR-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"webtrackR: Preprocessing and Analyzing Web Tracking Data — webtrackR-package","text":"Maintainer: David Schoch david@schochastics.net (ORCID) Authors: Bernhard Clemm von Hohenberg bernhard.clemm@gesis.org (ORCID) Frank Mangold frank.mangold@gesis.org (ORCID) Sebastian Stier sebastian.stier@gesis.org (ORCID)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":null,"dir":"Reference","previous_headings":"","what":"An S3 class to store web tracking data — wt_dt","title":"An S3 class to store web tracking data — wt_dt","text":"S3 class store web tracking data Convert data.frame containing web tracking data wt_dt object","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"An S3 class to store web tracking data — wt_dt","text":"","code":"as.wt_dt(   x,   timestamp_format = \"%Y-%m-%d %H:%M:%OS\",   tz = \"UTC\",   varnames = c(panelist_id = \"panelist_id\", url = \"url\", timestamp = \"timestamp\") )  is.wt_dt(x)"},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"An S3 class to store web tracking data — wt_dt","text":"x data.frame containing necessary set columns, namely panelist's ID, visit URL visit timestamp. timestamp_format string. Specifies raw timestamp's formatting. Defaults \"%Y-%m-%d %H:%M:%OS\". tz timezone date. defaults UTC varnames Named vector column names, contain panelist's ID (panelist_id), visit's URL (url) visit's timestamp (timestamp).","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"An S3 class to store web tracking data — wt_dt","text":"webtrack data object least columns panelist_id, url timestamp logical. TRUE x webtrack data object FALSE otherwise","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"An S3 class to store web tracking data — wt_dt","text":"wt_dt table data.frame.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"An S3 class to store web tracking data — wt_dt","text":"","code":"data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) is.wt_dt(wt) #> [1] TRUE"},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-030","dir":"Changelog","previous_headings":"","what":"webtrackR 0.3.0","title":"webtrackR 0.3.0","text":"revert back new version data.table","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-020","dir":"Changelog","previous_headings":"","what":"webtrackR 0.2.0","title":"webtrackR 0.2.0","text":"reimplemented base R removing several dependencies fixed #1, #81, #82, #83, #84, #87, #88, #98","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-010","dir":"Changelog","previous_headings":"","what":"webtrackR 0.1.0","title":"webtrackR 0.1.0","text":"CRAN release: 2023-08-31 added preprocessing functions add_session(), extract_host(), extract_domain(), extract_path(), add_next_visit(), add_previous_visit(), add_title(), add_referral() changed example data something realistic added unit tests (#65) added filtering, summarizing, aggregating functions","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-001","dir":"Changelog","previous_headings":"","what":"webtrackR 0.0.1","title":"webtrackR 0.0.1","text":"CRAN release: 2023-03-13 non documented functions","code":""}]
+[{"path":"https://schochastics.github.io/webtrackR/LICENSE.html","id":null,"dir":"","previous_headings":"","what":"MIT License","title":"MIT License","text":"Copyright (c) 2022 webtrackR authors Permission hereby granted, free charge, person obtaining copy software associated documentation files (“Software”), deal Software without restriction, including without limitation rights use, copy, modify, merge, publish, distribute, sublicense, /sell copies Software, permit persons Software furnished , subject following conditions: copyright notice permission notice shall included copies substantial portions Software. SOFTWARE PROVIDED “”, WITHOUT WARRANTY KIND, EXPRESS IMPLIED, INCLUDING LIMITED WARRANTIES MERCHANTABILITY, FITNESS PARTICULAR PURPOSE NONINFRINGEMENT. EVENT SHALL AUTHORS COPYRIGHT HOLDERS LIABLE CLAIM, DAMAGES LIABILITY, WHETHER ACTION CONTRACT, TORT OTHERWISE, ARISING , CONNECTION SOFTWARE USE DEALINGS SOFTWARE.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"installation","dir":"Articles","previous_headings":"","what":"Installation","title":"webtrackR","text":"can install development version webtrackR GitHub : CRAN version can installed :","code":"# install.packages(\"devtools\") devtools::install_github(\"schochastics/webtrackR\") install.packages(\"webtrackR\")"},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"s3-class-wt_dt","dir":"Articles","previous_headings":"","what":"S3 class wt_dt","title":"webtrackR","text":"package defines S3 class called wt_dt inherits functionality data.frame class. summary print method included package. row web tracking data set represents visit. Raw data need least following variables: panelist_id: individual data collected url: URL visit timestamp: time URL visit function .wt_dt assigns class wt_dt raw web tracking data set. also allows specify name raw variables corresponding panelist_id, url timestamp. Additionally, turns timestamp variable POSIXct format. preprocessing functions check three variables present. Otherwise error thrown.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"preprocessing","dir":"Articles","previous_headings":"","what":"Preprocessing","title":"webtrackR","text":"Several variables can derived raw data following functions: add_duration() adds variable called duration based sequence timestamps. basic logic duration visit set time difference subsequent visit, unless difference exceeds certain value (defined argument cutoff), case duration replaced NA user-defined value (defined replace_by). add_session() adds variable called session, groups subsequent visits session difference next visit exceeds certain value (defined cutoff). extract_host(), extract_domain(), extract_path() extracts host, domain path raw URL adds variables named accordingly. See function descriptions definitions terms. drop_query() lets drop query fragment components raw URL. add_next_visit() add_previous_visit() adds previous next URL, domain, host (defined level) new variable. add_referral() adds new variable indicating whether visit referred social media platform. Follows logic Schmidt et al., (2023). add_title() downloads title website (text within <title> tag web site’s <head>) adds new variable. add_panelist_data(). Joins data set containing information participants survey.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"classification","dir":"Articles","previous_headings":"","what":"Classification","title":"webtrackR","text":"classify_visits() categorizes website visits either extracting URL’s domain host matching list domains hosts, matching list regular expressions visit URL.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"summarizing-and-aggregating","dir":"Articles","previous_headings":"","what":"Summarizing and aggregating","title":"webtrackR","text":"deduplicate() flags drops (defined argument method) consecutive visits URL within user-defined time frame (set argument within). Alternatively dropping flagging visits, function aggregates durations duplicate visits. sum_visits() sum_durations() aggregate number durations visits, participant time period (set argument timeframe). Optionally, function aggregates number / duration visits certain class visits. sum_activity() counts number active time periods (defined timeframe) participant.","code":""},{"path":"https://schochastics.github.io/webtrackR/articles/webtrackR.html","id":"example-code","dir":"Articles","previous_headings":"","what":"Example code","title":"webtrackR","text":"typical workflow including preprocessing, classifying aggregating web tracking data looks like (using -built example data):","code":"library(webtrackR)  # load example data and turn it into wt_dt data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking)  # add duration wt <- add_duration(wt)  # extract domains wt <- extract_domain(wt)  # drop duplicates (consecutive visits to the same URL within one second) wt <- deduplicate(wt, within = 1, method = \"drop\")  # load example domain classification and classify domains data(\"domain_list\") wt <- classify_visits(wt, classes = domain_list, match_by = \"domain\")  # load example survey data and join with web tracking data data(\"testdt_survey_w\") wt <- add_panelist_data(wt, testdt_survey_w)  # aggregate number of visits by day and panelist, and by domain class wt_summ <- sum_visits(wt, timeframe = \"date\", visit_class = \"type\")"},{"path":"https://schochastics.github.io/webtrackR/authors.html","id":null,"dir":"","previous_headings":"","what":"Authors","title":"Authors and Citation","text":"David Schoch. Author, maintainer. Bernhard Clemm von Hohenberg. Author. Frank Mangold. Author. Sebastian Stier. Author.","code":""},{"path":"https://schochastics.github.io/webtrackR/authors.html","id":"citation","dir":"","previous_headings":"","what":"Citation","title":"Authors and Citation","text":"Schoch, D.; Clemm von Hohenberg, B.; Mangold, F.; Stier, S.   (2023). webtrackR: Preprocessing Analyzing Web Tracking Data","code":"@Manual{,   title = {webtrackR: Preprocessing and Analyzing Web Tracking Data},   author = {David Schoch and Bernhard Clemm {von Hohenberg} and Frank Mangold and Sebastian Stier},   year = {2023}, }"},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"webtrackr-","dir":"","previous_headings":"","what":"Preprocessing and Analyzing Web Tracking Data","title":"Preprocessing and Analyzing Web Tracking Data","text":"webtrackR R package preprocess analyze web tracking data, .e., web browsing histories participants academic study. Web tracking data oftentimes collected analyzed conjunction survey data participants. webtrackR part series R packages analyse webtracking data: webtrackR: preprocess raw webtracking data domainator: classify domains adaR: parse urls","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"installation","dir":"","previous_headings":"","what":"Installation","title":"Preprocessing and Analyzing Web Tracking Data","text":"can install development version webtrackR GitHub : CRAN version can installed :","code":"# install.packages(\"devtools\") devtools::install_github(\"schochastics/webtrackR\") install.packages(\"webtrackR\")"},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"s3-class-wt_dt","dir":"","previous_headings":"","what":"S3 class wt_dt","title":"Preprocessing and Analyzing Web Tracking Data","text":"package defines S3 class called wt_dt inherits functionality data.frame class. summary print method included package. row web tracking data set represents visit. Raw data need least following variables: panelist_id: individual data collected url: URL visit timestamp: time URL visit function .wt_dt assigns class wt_dt raw web tracking data set. also allows specify name raw variables corresponding panelist_id, url timestamp. Additionally, turns timestamp variable POSIXct format. preprocessing functions check three variables present. Otherwise error thrown.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"preprocessing","dir":"","previous_headings":"","what":"Preprocessing","title":"Preprocessing and Analyzing Web Tracking Data","text":"Several variables can derived raw data following functions: add_duration() adds variable called duration based sequence timestamps. basic logic duration visit set time difference subsequent visit, unless difference exceeds certain value (defined argument cutoff), case duration replaced NA user-defined value (defined replace_by). add_session() adds variable called session, groups subsequent visits session difference next visit exceeds certain value (defined cutoff). extract_host(), extract_domain(), extract_path() extracts host, domain path raw URL adds variables named accordingly. See function descriptions definitions terms. drop_query() lets drop query fragment components raw URL. add_next_visit() add_previous_visit() adds previous next URL, domain, host (defined level) new variable. add_referral() adds new variable indicating whether visit referred social media platform. Follows logic Schmidt et al., (2023). add_title() downloads title website (text within <title> tag web site’s <head>) adds new variable. add_panelist_data(). Joins data set containing information participants survey.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"classification","dir":"","previous_headings":"","what":"Classification","title":"Preprocessing and Analyzing Web Tracking Data","text":"classify_visits() categorizes website visits either extracting URL’s domain host matching list domains hosts, matching list regular expressions visit URL.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"summarizing-and-aggregating","dir":"","previous_headings":"","what":"Summarizing and aggregating","title":"Preprocessing and Analyzing Web Tracking Data","text":"deduplicate() flags drops (defined argument method) consecutive visits URL within user-defined time frame (set argument within). Alternatively dropping flagging visits, function aggregates durations duplicate visits. sum_visits() sum_durations() aggregate number durations visits, participant time period (set argument timeframe). Optionally, function aggregates number / duration visits certain class visits. sum_activity() counts number active time periods (defined timeframe) participant.","code":""},{"path":"https://schochastics.github.io/webtrackR/index.html","id":"example-code","dir":"","previous_headings":"","what":"Example code","title":"Preprocessing and Analyzing Web Tracking Data","text":"typical workflow including preprocessing, classifying aggregating web tracking data looks like (using -built example data):","code":"library(webtrackR)  # load example data and turn it into wt_dt data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking)  # add duration wt <- add_duration(wt)  # extract domains wt <- extract_domain(wt)  # drop duplicates (consecutive visits to the same URL within one second) wt <- deduplicate(wt, within = 1, method = \"drop\")  # load example domain classification and classify domains data(\"domain_list\") wt <- classify_visits(wt, classes = domain_list, match_by = \"domain\")  # load example survey data and join with web tracking data data(\"testdt_survey_w\") wt <- add_panelist_data(wt, testdt_survey_w)  # aggregate number of visits by day and panelist, and by domain class wt_summ <- sum_visits(wt, timeframe = \"date\", visit_class = \"type\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":null,"dir":"Reference","previous_headings":"","what":"Add time spent on a visit in seconds — add_duration","title":"Add time spent on a visit in seconds — add_duration","text":"add_duration() approximates time spent visit based difference two consecutive timestamps, replacing differences exceeding cutoff value defined replace_by.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add time spent on a visit in seconds — add_duration","text":"","code":"add_duration(   wt,   cutoff = 300,   replace_by = NA,   last_replace_by = NA,   device_switch_na = FALSE,   device_var = NULL )"},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add time spent on a visit in seconds — add_duration","text":"wt webtrack data object. cutoff numeric (seconds). duration greater value, reset value defined replace_by. Defaults 300 seconds. replace_by numeric. Determines whether differences greater cutoff set NA, value. Defaults NA. last_replace_by numeric. Determines whether last visit individual set NA, value. Defaults NA. device_switch_na boolean. Relevant data collected multiple devices. visits ordered timestamp sequence, two consecutive visits can come different devices, makes timestamp difference less likely true duration. may preferable set duration visit NA (TRUE) rather difference next timestamp (FALSE). Defaults FALSE. device_var character. Column indicating device. Required 'device_switch_na' set TRUE. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add time spent on a visit in seconds — add_duration","text":"webtrack data.frame columns wt new column called duration.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_duration.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add time spent on a visit in seconds — add_duration","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- add_duration(wt) # Defining cutoff at 10 minutes, replacing those exceeding cutoff to 5 minutes, # and setting duration before device switch to `NA`: wt <- add_duration(wt,     cutoff = 600, replace_by = 300,     device_switch_na = TRUE, device_var = \"device\" ) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":null,"dir":"Reference","previous_headings":"","what":"Add the next visit as a new column — add_next_visit","title":"Add the next visit as a new column — add_next_visit","text":"add_next_visit() adds subsequent visit, determined order timestamps new column. next visit can added either full URL, extracted host extracted domain, depending level.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add the next visit as a new column — add_next_visit","text":"","code":"add_next_visit(wt, level = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add the next visit as a new column — add_next_visit","text":"wt webtrack data object. level character. Either \"url\", \"host\" \"domain\". Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add the next visit as a new column — add_next_visit","text":"webtrack data.frame columns wt new column called url_next,host_next domain_next.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_next_visit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add the next visit as a new column — add_next_visit","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Adding next full URL as new column wt <- add_next_visit(wt, level = \"url\") # Adding next host as new column wt <- add_next_visit(wt, level = \"host\") # Adding next domain as new column wt <- add_next_visit(wt, level = \"domain\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":null,"dir":"Reference","previous_headings":"","what":"Add panelist features to tracking data — add_panelist_data","title":"Add panelist features to tracking data — add_panelist_data","text":"Adds information panelists (e.g., survey) tracking data.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add panelist features to tracking data — add_panelist_data","text":"","code":"add_panelist_data(wt, data, cols = NULL, join_on = \"panelist_id\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add panelist features to tracking data — add_panelist_data","text":"wt webtrack data object. data data frame containing panelist data contains columns panelists cols character vector columns add. NULL, columns added. Defaults NULL. join_on columns join . Defaults \"panelist_id\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add panelist features to tracking data — add_panelist_data","text":"webtrack object columns columns data specified cols.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_panelist_data.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add panelist features to tracking data — add_panelist_data","text":"","code":"if (FALSE) { data(\"testdt_tracking\") data(\"testdt_survey_w\") wt <- as.wt_dt(testdt_tracking) # add survey test data add_panelist_data(wt, testdt_survey_w) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":null,"dir":"Reference","previous_headings":"","what":"Add the previous visit as a new column — add_previous_visit","title":"Add the previous visit as a new column — add_previous_visit","text":"add_previous_visit() adds previous visit, determined order timestamps new column previous visit can added either full URL, extracted host extracted domain, depending level.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add the previous visit as a new column — add_previous_visit","text":"","code":"add_previous_visit(wt, level = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add the previous visit as a new column — add_previous_visit","text":"wt webtrack data object. level character. Either \"url\", \"host\" \"domain\". Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add the previous visit as a new column — add_previous_visit","text":"webtrack data.frame columns wt new column called url_previous,host_previous domain_previous..","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_previous_visit.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add the previous visit as a new column — add_previous_visit","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Adding previous full URL as new column wt <- add_previous_visit(wt, level = \"url\") # Adding previous host as new column wt <- add_previous_visit(wt, level = \"host\") # Adding previous domain as new column wt <- add_previous_visit(wt, level = \"domain\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":null,"dir":"Reference","previous_headings":"","what":"Add social media referrals as a new column — add_referral","title":"Add social media referrals as a new column — add_referral","text":"Identifies whether visit referred social media adds new column. See details method.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add social media referrals as a new column — add_referral","text":"","code":"add_referral(wt, platform_domains, patterns)"},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add social media referrals as a new column — add_referral","text":"wt webtrack data object. platform_domains character. vector platform domains referrers identified. Order length must correspondent patterns argument patterns character. vector patterns referrers identified. Order length must correspondent platform_domains vector.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add social media referrals as a new column — add_referral","text":"webtrack data.frame columns wt new column called referral, takes NA referral identified, name specified platform_domains referral platform identified","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Add social media referrals as a new column — add_referral","text":"identify referrals, rely method described valid Schmidt et al.: domain preceding visit platform question, query string visit's URL contains certain pattern, count referred visit. Facebook, pattern identified Schmidt et al. 'fbclid=', although can change future.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Add social media referrals as a new column — add_referral","text":"Schmidt, Felix, Frank Mangold, Sebastian Stier Roberto Ulloa. \"Facebook Avenue News: Comparison Validation Approaches Identify Facebook Referrals\". Working paper.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_referral.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add social media referrals as a new column — add_referral","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- add_referral(wt, platform_domains = \"facebook.com\", patterns = \"fbclid=\") wt <- add_referral(wt,     platform_domains = c(\"facebook.com\", \"twitter.com\"),     patterns = c(\"fbclid=\", \"utm_source=twitter\") ) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":null,"dir":"Reference","previous_headings":"","what":"Add a session variable — add_session","title":"Add a session variable — add_session","text":"add_session() groups visits \"sessions\", defining session end difference two consecutive timestamps exceeds cutoff.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Add a session variable — add_session","text":"","code":"add_session(wt, cutoff)"},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Add a session variable — add_session","text":"wt webtrack data object. cutoff numeric (seconds). difference two consecutive timestamps exceeds value, new browsing session defined.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Add a session variable — add_session","text":"webtrack data.frame columns wt new column called session.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_session.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Add a session variable — add_session","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Setting cutoff to 30 minutes wt <- add_session(wt, cutoff = 1800) }"},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":null,"dir":"Reference","previous_headings":"","what":"Download and add the ","title":"Download and add the ","text":"Gets title URL accessing web address online adds title new column. See details meaning \"title\". need internet connection run function.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Download and add the ","text":"","code":"add_title(wt, lang = \"en-US,en-GB,en\")"},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Download and add the ","text":"wt webtrack data object. lang character (language tag). Language accepted request. Defaults \"en-US,en-GB,en\". Note likely still obtain titles different ones seen originally user, language also depend user's IP device settings.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Download and add the ","text":"webtrack data.frame columns wt new column called \"title\", NA title retrieved.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Download and add the ","text":"title website (text within <title> tag web site's <head>) #' text shown \"tab\" looking website browser. can contain useful information URL's content can used, example, classification purposes. Note may take run function large number URLs.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/add_title.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Download and add the ","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking)[1:2] # Get titles with `lang` set to default English wt_titles <- add_title(wt) # Get titles with `lang` set to German wt_titles <- add_title(wt, lang = \"de\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"Symmetric Atkinson Index calculates symmetric Atkinson index","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"","code":"atkinson_index(grp_a, grp_b)"},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"grp_a vector (usually corresponds column webtrack data frame) indicating number individuals group using website grp_b vector (usually corresponds column webtrack data frame) indicating number individuals group B using website","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"Frankel, David, Oscar Volij. \"Scale Invariant Measures Segregation \"Working Paper, 2008.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/atkinson_index.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Symmetric Atkinson Index calculates the symmetric Atkinson index — atkinson_index","text":"","code":"# perfect score grp_a <- c(5, 5, 0, 0) grp_b <- c(0, 0, 5, 5) atkinson_index(grp_a, grp_b) #> [1] 1  grp_a <- c(5, 5, 5, 5) grp_b <- c(5, 5, 5, 5) atkinson_index(grp_a, grp_b) #> [1] 0"},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":null,"dir":"Reference","previous_headings":"","what":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"Bakshy Top500 Ideological alignment 500 domains based facebook data","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"","code":"bakshy"},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"object class data.table (inherits data.frame) 500 rows 7 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/bakshy.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Bakshy Top500 Ideological alignment of 500 domains based on facebook data — bakshy","text":"Bakshy, Eytan, Solomon Messing, Lada . Adamic. \"Exposure ideologically diverse news opinion Facebook.\" Science 348.6239 (2015): 1130-1132.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":null,"dir":"Reference","previous_headings":"","what":"Classify visits by matching to a list of classes — classify_visits","title":"Classify visits by matching to a list of classes — classify_visits","text":"classify_visits() categorizes visits either extracting visit URL's domain host matching list domains hosts; matching list regular expressions visit URL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Classify visits by matching to a list of classes — classify_visits","text":"","code":"classify_visits(   wt,   classes,   match_by = \"domain\",   regex_on = NULL,   return_rows_by = NULL,   return_rows_val = NULL )"},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Classify visits by matching to a list of classes — classify_visits","text":"wt webtrack data object. classes data frame containing classes can matched visits. match_by character. Whether match list entries classes domain visit (\"domain\") host (\"host\") exact match; regular expression whole URL visit (\"regex\"). set \"domain\" \"host\", wt classes need column called accordingly. set \"regex\", url column wt used, need set regex_on column classes pattern matching. Defaults \"domain\". regex_on character. Column classes use pattern matching. Defaults NULL. return_rows_by character. column classes subset returning data. Defaults NULL. return_rows_val character. value columns specified return_rows_by, data returned. example, classes data contains column type, value called \"shopping\", setting return_rows_by \"type\" return_rows_val \"shopping\" return visits classified \"shopping\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Classify visits by matching to a list of classes — classify_visits","text":"webtrack data.frame columns wt column classes except column specified match_by.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/classify_visits.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Classify visits by matching to a list of classes — classify_visits","text":"","code":"if (FALSE) { data(\"testdt_tracking\") data(\"domain_list\") wt <- as.wt_dt(testdt_tracking) # classify visits via domain wt_domains <- extract_domain(wt) wt_classes <- classify_visits(wt_domains, classes = domain_list, match_by = \"domain\") # classify visits via domain # for the example, just renaming \"domain\" column domain_list$host <- domain_list$domain wt_hosts <- extract_host(wt) wt_classes <- classify_visits(wt_hosts, classes = domain_list, match_by = \"host\") # classify visits with pattern matching # for the example, any value in \"domain\" treated as pattern data(\"domain_list\") regex_list <- domain_list[type == \"facebook\"] wt_classes <- classify_visits(wt[1:5000],     classes = regex_list,     match_by = \"regex\", regex_on = \"domain\" ) # classify visits via domain and only return class \"search\" data(\"domain_list\") wt_classes <- classify_visits(wt_domains,     classes = domain_list,     match_by = \"domain\", return_rows_by = \"type\",     return_rows_val = \"search\" ) }"},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":null,"dir":"Reference","previous_headings":"","what":"Create an urldummy variable — create_urldummy","title":"Create an urldummy variable — create_urldummy","text":"Create urldummy variable","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Create an urldummy variable — create_urldummy","text":"","code":"create_urldummy(wt, dummy, name)"},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Create an urldummy variable — create_urldummy","text":"wt webtrack data object dummy vector urls dummy coded name name dummy variable create.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Create an urldummy variable — create_urldummy","text":"webtrack object columns new column called \"name\" including dummy variable","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/create_urldummy.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Create an urldummy variable — create_urldummy","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- extract_domain(wt) code_urls <- \"https://dkr1.ssisurveys.com/tzktsxomta\" create_urldummy(wt, dummy = code_urls, name = \"test_dummy\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":null,"dir":"Reference","previous_headings":"","what":"Deduplicate visits — deduplicate","title":"Deduplicate visits — deduplicate","text":"deduplicate() flags, drops aggregates duplicates, defined consecutive visits URL within certain time frame.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Deduplicate visits — deduplicate","text":"","code":"deduplicate(   wt,   method = \"aggregate\",   within = 1,   duration_var = \"duration\",   keep_nvisits = FALSE,   same_day = TRUE,   add_grpvars = NULL )"},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Deduplicate visits — deduplicate","text":"wt webtrack data object. method character. One \"aggregate\", \"flag\" \"drop\". set \"aggregate\", consecutive visits (matter time difference) URL combined duration aggregated. case, duration column must specified via \"duration_var\". set \"flag\", duplicates within certain time frame flagged new column called duplicate. case, within argument must specified. set \"drop\", duplicates dropped. , within argument must specified. Defaults \"aggregate\". within numeric (seconds). method set \"flag\" \"drop\", subsequent visit defined duplicate happening within time difference. Defaults 1 second. duration_var character. Name duration variable. Defaults \"duration\". keep_nvisits boolean. method set \"aggregate\", determines whether number aggregated visits kept variable. Defaults FALSE. same_day boolean. method set \"aggregate\", determines whether count visits consecutive day. Defaults TRUE. add_grpvars vector. method set \"aggregate\", determines whether additional variables included grouping visits therefore kept. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Deduplicate visits — deduplicate","text":"webtrack data.frame columns wt updated duration","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/deduplicate.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Deduplicate visits — deduplicate","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- add_duration(wt, cutoff = 300, replace_by = 300) # Dropping duplicates with one-second default wt_dedup <- deduplicate(wt, method = \"drop\") # Flagging duplicates with one-second default wt_dedup <- deduplicate(wt, method = \"flag\") # Aggregating duplicates wt_dedup <- deduplicate(wt[1:1000], method = \"aggregate\") # Aggregating duplicates and keeping number of visits for aggregated visits wt_dedup <- deduplicate(wt[1:1000], method = \"aggregate\", keep_nvisits = TRUE) # Aggregating duplicates and keeping \"domain\" variable despite grouping wt <- extract_domain(wt) wt_dedup <- deduplicate(wt, method = \"aggregate\", add_grpvars = \"domain\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Dissimilarity Index — dissimilarity_index","title":"Dissimilarity Index — dissimilarity_index","text":"Dissimilarity Index can interpreted share Group visits need redistributed across media share group uniform across websites.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Dissimilarity Index — dissimilarity_index","text":"","code":"dissimilarity_index(grp_a, grp_b)"},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Dissimilarity Index — dissimilarity_index","text":"grp_a vector (usually corresponds column webtrack data frame) indicating number individuals group using website grp_b vector (usually corresponds column webtrack data frame) indicating number individuals group B using website","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Dissimilarity Index — dissimilarity_index","text":"Cutler, David M., Edward L. Glaeser, Jacob L. Vigdor. \"rise decline American ghetto.\" Journal political economy 107.3 (1999): 455-506.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/dissimilarity_index.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Dissimilarity Index — dissimilarity_index","text":"","code":"# perfect dissimilarity grp_a <- c(5, 5, 0, 0) grp_b <- c(0, 0, 5, 5) dissimilarity_index(grp_a, grp_b) #> [1] 1  # no dissimilarity grp_a <- c(5, 5, 5, 5) grp_b <- c(5, 5, 5, 5) dissimilarity_index(grp_a, grp_b) #> [1] 0"},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":null,"dir":"Reference","previous_headings":"","what":"Domain list classification of domains into news,portals, search, and social media — domain_list","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"Domain list classification domains news,portals, search, social media","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"","code":"domain_list"},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"object class data.table (inherits data.frame) 663 rows 2 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/domain_list.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Domain list classification of domains into news,portals, search, and social media — domain_list","text":"Stier, S., Mangold, F., Scharkow, M., & Breuer, J. (2022). Post Post-Broadcast Democracy? News Exposure Age Online Intermediaries. American Political Science Review, 116(2), 768-774.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":null,"dir":"Reference","previous_headings":"","what":"Drop the query and fragment from URL — drop_query","title":"Drop the query and fragment from URL — drop_query","text":"drop_query() adds URL without query fragment new column. query defined part following \"?\" path. fragement anything following \"#\" query.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Drop the query and fragment from URL — drop_query","text":"","code":"drop_query(wt, varname = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Drop the query and fragment from URL — drop_query","text":"wt webtrack data object. varname character. name column extract host. Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Drop the query and fragment from URL — drop_query","text":"webtrack data.frame columns wt new column called '<varname>_noquery'","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/drop_query.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Drop the query and fragment from URL — drop_query","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract URL without query/fragment wt <- drop_query(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract the domain from URL — extract_domain","title":"Extract the domain from URL — extract_domain","text":"extract_domain() adds domain URL new column. \"domain\", mean \"top private domain\", .e., domain public suffix (e.g., \"com\") defined Public Suffix List. See details. Extracts domain urls.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract the domain from URL — extract_domain","text":"","code":"extract_domain(wt, varname = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract the domain from URL — extract_domain","text":"wt webtrack data object. varname character. Name column extract host. Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract the domain from URL — extract_domain","text":"webtrack data.frame columns wt new column called 'domain' (, varname equal 'url', '<varname>_domain')","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Extract the domain from URL — extract_domain","text":"define \"web domain\" common colloquial meaning, , part web address identifies person organization control. google.com. technically, mean \"domain\" \"top private domain\", .e., domain public suffix, defined Public Suffix List. Note definition sometimes leads counterintuitive results public suffixes \"registry suffixes\". , controlled domain name registrar, allow users directly register domain. One example public, non-registry suffix blogspot.com. URL like www.mysite.blogspot.com, function, indeed packages aware , extract domain mysite.blogspot.com, although might think blogspot.com domain. details, see ","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_domain.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract the domain from URL — extract_domain","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract domain and drop rows without domain wt <- extract_domain(wt) # Extract domain and keep rows without domain wt <- extract_domain(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract the host from URL — extract_host","title":"Extract the host from URL — extract_host","text":"extract_host() adds host URL new column. host defined part following scheme (e.g., \"https://\") preceding subdirectory (anything following next \"/\"). Note URL entries like chrome-extension://soomething http://192.168.0.1/something, result set NA.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract the host from URL — extract_host","text":"","code":"extract_host(wt, varname = \"url\")"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract the host from URL — extract_host","text":"wt webtrack data object. varname character. Name column extract host. Defaults \"url\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract the host from URL — extract_host","text":"webtrack data.frame columns wt new column called 'host' (, varname equal 'url', '<varname>_host')","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_host.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract the host from URL — extract_host","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract host and drop rows without host wt <- extract_host(wt) # Extract host and keep rows without host wt <- extract_host(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Extract the path from URL — extract_path","title":"Extract the path from URL — extract_path","text":"extract_path() adds path URL new column. path defined part following host including query (anything \"?\") fragment (anything \"#\").","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Extract the path from URL — extract_path","text":"","code":"extract_path(wt, varname = \"url\", decode = TRUE)"},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Extract the path from URL — extract_path","text":"wt webtrack data object varname character. name column extract host. Defaults \"url\". decode logical. Whether decode path (see utils::URLdecode()), default TRUE","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Extract the path from URL — extract_path","text":"webtrack data.frame columns wt new column called 'path' (, varname equal 'url', '<varname>_path')","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/extract_path.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Extract the path from URL — extract_path","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # Extract path wt <- extract_path(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/fake_tracking.html","id":null,"dir":"Reference","previous_headings":"","what":"Fake data — fake_tracking","title":"Fake data — fake_tracking","text":"Small fake webtracking data testing purpose","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/fake_tracking.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Fake data — fake_tracking","text":"","code":"fake_tracking"},{"path":"https://schochastics.github.io/webtrackR/reference/fake_tracking.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Fake data — fake_tracking","text":"object class data.frame 500 rows 3 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":null,"dir":"Reference","previous_headings":"","what":"Isolation Index — isolation_index","title":"Isolation Index — isolation_index","text":"Given two groups (B) individuals, isolation index captures extent group disproportionately visit websites whose visitors also members group .","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Isolation Index — isolation_index","text":"","code":"isolation_index(grp_a, grp_b, adjusted = FALSE)"},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Isolation Index — isolation_index","text":"grp_a vector (usually corresponds column webtrack data frame) indicating number individuals group using website grp_b vector (usually corresponds column webtrack data frame) indicating number individuals group B using website adjusted logical. index adjusted (defaults FALSE)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Isolation Index — isolation_index","text":"numeric value 0 1. 0 indicates isolation 1 perfect isolation","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"Isolation Index — isolation_index","text":"value 1 indicates websites visited group group B overlap. value 0 means visit exactly websites","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"Isolation Index — isolation_index","text":"Cutler, David M., Edward L. Glaeser, Jacob L. Vigdor. \"rise decline American ghetto.\" Journal political economy 107.3 (1999): 455-506. Gentzkow, Matthew, Jesse M. Shapiro. \"Ideological segregation online offline.\" Quarterly Journal Economics 126.4 (2011): 1799-1839.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/isolation_index.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Isolation Index — isolation_index","text":"","code":"# perfect isolation grp_a <- c(5, 5, 0, 0) grp_b <- c(0, 0, 5, 5) isolation_index(grp_a, grp_b) #> [1] 1  # perfect overlap grp_a <- c(5, 5, 5, 5) grp_b <- c(5, 5, 5, 5) isolation_index(grp_a, grp_b) #> [1] 0"},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":null,"dir":"Reference","previous_headings":"","what":"News Types — news_types","title":"News Types — news_types","text":"Classification domains different news types","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"News Types — news_types","text":"","code":"news_types"},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"News Types — news_types","text":"object class data.table (inherits data.frame) 690 rows 2 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/news_types.html","id":"references","dir":"Reference","previous_headings":"","what":"References","title":"News Types — news_types","text":"Stier, S., Mangold, F., Scharkow, M., & Breuer, J. (2022). Post Post-Broadcast Democracy? News Exposure Age Online Intermediaries. American Political Science Review, 116(2), 768-774.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":null,"dir":"Reference","previous_headings":"","what":"Parse parts of path for text analysis — parse_path","title":"Parse parts of path for text analysis — parse_path","text":"parse_path() parses parts path, .e., anything separated \"/\", \"-\", \"_\" \".\", adds new variable. Parts consist letters , real word, can filtered via argument keep.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Parse parts of path for text analysis — parse_path","text":"","code":"parse_path(wt, varname = \"url\", keep = \"letters_only\", decode = TRUE)"},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Parse parts of path for text analysis — parse_path","text":"wt webtrack data object varname character. name column extract host. Defaults \"url\". keep character. Defines types path components keep. set \"\", anything kept. \"letters_only\", parts containing letters kept. \"words_only\", parts constituting English words (defined Word Game Dictionary, cf. https://cran.r-project.org/web/packages/words/index.html) kept. Support languages added future. decode logical. Whether decode path (see utils::URLdecode()), default TRUE","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Parse parts of path for text analysis — parse_path","text":"webtrack data.frame columns wt new column called 'path_split'  (, varname equal 'url', '<varname>_path_split') containing parts comma-separated string.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/parse_path.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Parse parts of path for text analysis — parse_path","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) wt <- parse_path(wt) }"},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":null,"dir":"Reference","previous_headings":"","what":"Print web tracking data — print.wt_dt","title":"Print web tracking data — print.wt_dt","text":"Print web tracking data","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Print web tracking data — print.wt_dt","text":"","code":"# S3 method for wt_dt print(x, ...)"},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Print web tracking data — print.wt_dt","text":"x object class wt_dt ... additional parameters print","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/print.wt_dt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Print web tracking data — print.wt_dt","text":"return value, called side effects","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize activity per person — sum_activity","title":"Summarize activity per person — sum_activity","text":"sum_activity() counts number active time periods (.e., days, weeks, months, years, waves) panelist_id. period counts \"active\" panelist provided least one visit period.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize activity per person — sum_activity","text":"","code":"sum_activity(wt, timeframe = \"date\")"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize activity per person — sum_activity","text":"wt webtrack data object. timeframe character. Indicates time frame aggregate visits. Possible values \"date\", \"week\", \"month\", \"year\" \"wave\". set \"wave\", wt must contain column call wave. Defaults \"date\".","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize activity per person — sum_activity","text":"data.frame columns panelist_id, column indicating number active time units.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_activity.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"Summarize activity per person — sum_activity","text":"","code":"if (FALSE) { data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) # summarize activity by day wt_sum <- sum_activity(wt, timeframe = \"date\") }"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize visit duration by person — sum_durations","title":"Summarize visit duration by person — sum_durations","text":"sum_durations() summarizes duration visits person within timeframe, optionally visit_class visit. Note: time frame rows NA duration column, summarized duration time frame NA. rows time frame NA duration column, function ignore NA rows. visits class (.e., value 'visit_class' column) time frame, summarized duration time frame zero; visits, NA duration, summarized duration NA.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize visit duration by person — sum_durations","text":"","code":"sum_durations(wt, var_duration = NULL, timeframe = NULL, visit_class = NULL)"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize visit duration by person — sum_durations","text":"wt webtrack data object. var_duration character. Name duration variable already present. Defaults NULL, case duration approximated add_duration(wt, cutoff = 300, replace_by = \"na\", replace_val = NULL) timeframe character. Indicates time frame aggregate visit durations. Possible values \"date\", \"week\", \"month\", \"year\", \"wave\" NULL. set \"wave\", wt must contain column call wave. Defaults NULL, case output contains duration visits entire time. visit_class character. Column contains classification visits. value column, output column indicating number visits belonging value. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_durations.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize visit duration by person — sum_durations","text":"data.frame columns panelist_id, column indicating time unit (unless timeframe set NULL), duration_visits indicating duration visits (seconds, whatever unit variable specified var_duration parameter), column value visit_class, specified.","code":""},{"path":[]},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":null,"dir":"Reference","previous_headings":"","what":"Summarize number of visits by person — sum_visits","title":"Summarize number of visits by person — sum_visits","text":"sum_visits() summarizes number visits person within timeframe, optionally visit_class visit.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summarize number of visits by person — sum_visits","text":"","code":"sum_visits(wt, timeframe = NULL, visit_class = NULL)"},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summarize number of visits by person — sum_visits","text":"wt webtrack data object. timeframe character. Indicates time frame aggregate visits. Possible values \"date\", \"week\", \"month\", \"year\", \"wave\" NULL. set \"wave\", wt must contain column call wave. Defaults NULL, case output contains number visits entire time. visit_class character. Column contains classification visits. value column, output column indicating number visits belonging value. Defaults NULL.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/sum_visits.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summarize number of visits by person — sum_visits","text":"data.frame columns panelist_id, column indicating time unit (unless timeframe set NULL), n_visits indicating number visits, column value visit_class, specified.","code":""},{"path":[]},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":null,"dir":"Reference","previous_headings":"","what":"Summary function for web tracking data — summary.wt_dt","title":"Summary function for web tracking data — summary.wt_dt","text":"Summary function web tracking data","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Summary function for web tracking data — summary.wt_dt","text":"","code":"# S3 method for wt_dt summary(object, ...)"},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Summary function for web tracking data — summary.wt_dt","text":"object object class wt_dt ... additional parameters summary","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/summary.wt_dt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Summary function for web tracking data — summary.wt_dt","text":"return value, called side effects","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_l.html","id":null,"dir":"Reference","previous_headings":"","what":"Test survey — testdt_survey_l","title":"Test survey — testdt_survey_l","text":"randomly generated survey data, one row per person/wave (long format)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_l.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Test survey — testdt_survey_l","text":"","code":"testdt_survey_l"},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_l.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Test survey — testdt_survey_l","text":"object class tbl_df (inherits tbl, data.frame) 15 rows 7 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_w.html","id":null,"dir":"Reference","previous_headings":"","what":"Test survey — testdt_survey_w","title":"Test survey — testdt_survey_w","text":"Randomly generated survey data used illustrative purposes (wide format)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_w.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Test survey — testdt_survey_w","text":"","code":"testdt_survey_w"},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_survey_w.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Test survey — testdt_survey_w","text":"object class data.frame 5 rows 8 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_tracking.html","id":null,"dir":"Reference","previous_headings":"","what":"Test data — testdt_tracking","title":"Test data — testdt_tracking","text":"Sample fully anomymized webtrack data research project US participants","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_tracking.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Test data — testdt_tracking","text":"","code":"testdt_tracking"},{"path":"https://schochastics.github.io/webtrackR/reference/testdt_tracking.html","id":"format","dir":"Reference","previous_headings":"","what":"Format","title":"Test data — testdt_tracking","text":"object class data.frame 49612 rows 5 columns.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":null,"dir":"Reference","previous_headings":"","what":"Check if columns are present — vars_exist","title":"Check if columns are present — vars_exist","text":"vars_exist() checks columns present webtrack data object. default, checks whether data panelist_id, ulr timestamp column.#'","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"Check if columns are present — vars_exist","text":"","code":"vars_exist(wt, vars = c(\"panelist_id\", \"url\", \"timestamp\"))"},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"Check if columns are present — vars_exist","text":"wt webtrack data object. vars character vector variables. Defaults c(\"panelist_id\", \"url\", \"timestamp\").","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/vars_exist.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"Check if columns are present — vars_exist","text":"data.table object.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/webtrackR-package.html","id":null,"dir":"Reference","previous_headings":"","what":"webtrackR: Preprocessing and Analyzing Web Tracking Data — webtrackR-package","title":"webtrackR: Preprocessing and Analyzing Web Tracking Data — webtrackR-package","text":"Data structures methods work web tracking data. functions cover data preprocessing steps, enriching web tracking data external information methods analysis digital behavior used several academic papers (e.g., Clemm von Hohenberg et al., 2023 doi:10.17605/OSF.IO/M3U9P ; Stier et al., 2022 doi:10.1017/S0003055421001222 ).","code":""},{"path":[]},{"path":"https://schochastics.github.io/webtrackR/reference/webtrackR-package.html","id":"author","dir":"Reference","previous_headings":"","what":"Author","title":"webtrackR: Preprocessing and Analyzing Web Tracking Data — webtrackR-package","text":"Maintainer: David Schoch david@schochastics.net (ORCID) Authors: Bernhard Clemm von Hohenberg bernhard.clemm@gesis.org (ORCID) Frank Mangold frank.mangold@gesis.org (ORCID) Sebastian Stier sebastian.stier@gesis.org (ORCID)","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":null,"dir":"Reference","previous_headings":"","what":"An S3 class to store web tracking data — wt_dt","title":"An S3 class to store web tracking data — wt_dt","text":"S3 class store web tracking data Convert data.frame containing web tracking data wt_dt object","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"ref-usage","dir":"Reference","previous_headings":"","what":"Usage","title":"An S3 class to store web tracking data — wt_dt","text":"","code":"as.wt_dt(   x,   timestamp_format = \"%Y-%m-%d %H:%M:%OS\",   tz = \"UTC\",   varnames = c(panelist_id = \"panelist_id\", url = \"url\", timestamp = \"timestamp\") )  is.wt_dt(x)"},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"arguments","dir":"Reference","previous_headings":"","what":"Arguments","title":"An S3 class to store web tracking data — wt_dt","text":"x data.frame containing necessary set columns, namely panelist's ID, visit URL visit timestamp. timestamp_format string. Specifies raw timestamp's formatting. Defaults \"%Y-%m-%d %H:%M:%OS\". tz timezone date. defaults UTC varnames Named vector column names, contain panelist's ID (panelist_id), visit's URL (url) visit's timestamp (timestamp).","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"value","dir":"Reference","previous_headings":"","what":"Value","title":"An S3 class to store web tracking data — wt_dt","text":"webtrack data object least columns panelist_id, url timestamp logical. TRUE x webtrack data object FALSE otherwise","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"details","dir":"Reference","previous_headings":"","what":"Details","title":"An S3 class to store web tracking data — wt_dt","text":"wt_dt table data.frame.","code":""},{"path":"https://schochastics.github.io/webtrackR/reference/wt_dt.html","id":"ref-examples","dir":"Reference","previous_headings":"","what":"Examples","title":"An S3 class to store web tracking data — wt_dt","text":"","code":"data(\"testdt_tracking\") wt <- as.wt_dt(testdt_tracking) is.wt_dt(wt) #> [1] TRUE"},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-031","dir":"Changelog","previous_headings":"","what":"webtrackR 0.3.1","title":"webtrackR 0.3.1","text":"fixed CRAN problems tests","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-030","dir":"Changelog","previous_headings":"","what":"webtrackR 0.3.0","title":"webtrackR 0.3.0","text":"CRAN release: 2024-04-28 revert back new version data.table","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-020","dir":"Changelog","previous_headings":"","what":"webtrackR 0.2.0","title":"webtrackR 0.2.0","text":"reimplemented base R removing several dependencies fixed #1, #81, #82, #83, #84, #87, #88, #98","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-010","dir":"Changelog","previous_headings":"","what":"webtrackR 0.1.0","title":"webtrackR 0.1.0","text":"CRAN release: 2023-08-31 added preprocessing functions add_session(), extract_host(), extract_domain(), extract_path(), add_next_visit(), add_previous_visit(), add_title(), add_referral() changed example data something realistic added unit tests (#65) added filtering, summarizing, aggregating functions","code":""},{"path":"https://schochastics.github.io/webtrackR/news/index.html","id":"webtrackr-001","dir":"Changelog","previous_headings":"","what":"webtrackR 0.0.1","title":"webtrackR 0.0.1","text":"CRAN release: 2023-03-13 non documented functions","code":""}]