pirsch_api 0.0.3 → 0.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/Gemfile.lock +1 -1
- data/README.md +25 -23
- data/lib/pirsch_api/client.rb +8 -0
- data/lib/pirsch_api/objects/duration_page.rb +4 -0
- data/lib/pirsch_api/objects/duration_session.rb +4 -0
- data/lib/pirsch_api/resources/statistics/duration_page.rb +11 -0
- data/lib/pirsch_api/resources/statistics/duration_session.rb +11 -0
- data/lib/pirsch_api/version.rb +1 -1
- data/lib/pirsch_api.rb +4 -0
- metadata +6 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 922968a144011f70f78f0e8220f5de11dd2c2abd4ed710a1d82ac9ebfe8b581d
|
4
|
+
data.tar.gz: b296b02a35e78d2997903099c22fab51154775c2930f37875e838909cd52b37f
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: c13b95de3a1dfe8737e7676b91f0762a88975aed761fdb7540f89d349822eb069e7f4b6859bb45b770abd18701b601c7ee2a4b3ac96b80305a796085e3f04312
|
7
|
+
data.tar.gz: f0ee7dcc857538c1fb7023660e9dd55587e27ba4c1238559586184cece0a525598adaca8ce77deb760fdb8a42a85ca87c4ca94afcdab4a9f6ae7a352cc68a406
|
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
@@ -20,67 +20,69 @@ client.valid?
|
|
20
20
|
```
|
21
21
|
|
22
22
|
You will need a `Domain` as a parameter to all the following methods. This parameter could be either
|
23
|
-
a `
|
23
|
+
a `PirschApi::Domain` instance or a simple String containing the `id` of one domain.
|
24
24
|
|
25
25
|
```rb
|
26
26
|
# Get /domains
|
27
27
|
client.domains
|
28
28
|
=> [#<PirschApi::Domain id="0D3a...", user_id="0D3a...", hostname="pirsch.io", subdomain="pirsch", ... >]
|
29
|
-
domain =
|
30
|
-
domain.hostname
|
31
|
-
=> "pirsch.io"
|
32
|
-
domain.id
|
33
|
-
=> "0D3a..."
|
34
|
-
domain.to_s
|
35
|
-
=> "0D3a..."
|
29
|
+
domain = client.domains.first
|
36
30
|
```
|
31
|
+
|
37
32
|
All the following methods receive a `domain` and an optional `filters` hash as a parameter. You can include any filter defined in the official documentation.
|
38
33
|
|
39
34
|
```rb
|
40
35
|
# Get /statistics/visitors
|
41
|
-
client.visitors(domain: domain)
|
36
|
+
client.visitors(domain: domain, filters: filters)
|
42
37
|
|
43
38
|
# Get /statistics/active
|
44
|
-
client.active(domain: domain)
|
39
|
+
client.active(domain: domain, filters: filters)
|
45
40
|
|
46
41
|
# Get /statistics/pages
|
47
|
-
client.pages(domain: domain)
|
42
|
+
client.pages(domain: domain, filters: filters)
|
48
43
|
|
49
44
|
# Get /statistics/referrers
|
50
|
-
client.referrers(domain: domain)
|
45
|
+
client.referrers(domain: domain, filters: filters)
|
51
46
|
|
52
47
|
# Get /statistics/growth
|
53
|
-
client.growth(domain: domain)
|
48
|
+
client.growth(domain: domain, filters: filters)
|
54
49
|
|
55
50
|
# Get /statistics/events
|
56
|
-
client.events(domain: domain)
|
51
|
+
client.events(domain: domain, filters: filters)
|
57
52
|
|
58
53
|
# Get /statistics/utm/source
|
59
|
-
client.utm_source(domain: domain)
|
54
|
+
client.utm_source(domain: domain, filters: filters)
|
60
55
|
|
61
56
|
# Get /statistics/utm/medium
|
62
|
-
client.utm_medium(domain: domain)
|
57
|
+
client.utm_medium(domain: domain, filters: filters)
|
63
58
|
|
64
59
|
# Get /statistics/utm/campaign
|
65
|
-
client.utm_campaign(domain: domain)
|
60
|
+
client.utm_campaign(domain: domain, filters: filters)
|
61
|
+
|
62
|
+
# Get /statistics/duration/session
|
63
|
+
client.duration_session(domain: domain, filters: filters)
|
64
|
+
|
65
|
+
# Get /statistics/duration/page
|
66
|
+
client.duration_page(domain: domain, filters: filters)
|
67
|
+
|
66
68
|
```
|
67
69
|
|
68
70
|
## Examples
|
69
71
|
```rb
|
70
|
-
|
71
|
-
client.visitors(domain: d)
|
72
|
+
client.visitors(domain: domain)
|
72
73
|
=> [#<PirschApi::Visitor day="2021-08-30T00:00:00Z", visitors=87, views=200, sessions=125, bounces=53, bounce_rate=0.6091954022988506>, #<PirschApi::Visitor day="2021-08-31T00:00:00Z", visitors=77, views=159, sessions=113, bounces=49, bounce_rate=0.6363636363636364>, #<PirschApi::Visitor day="2021-09-01T00:00:00Z", visitors=76, views=161, sessions=110, bounces=48, bounce_rate=0.631578947368421>, #<PirschApi::Visitor day="2021-09-02T00:00:00Z", visitors=79, views=152, sessions=130, bounces=52, bounce_rate=0.6582278481012658>, #<PirschApi::Visitor day="2021-09-03T00:00:00Z", visitors=53, views=109, sessions=68, bounces=26, bounce_rate=0.49056603773584906>, #<PirschApi::Visitor day="2021-09-04T00:00:00Z", visitors=54, views=126, sessions=71, bounces=31, bounce_rate=0.5740740740740741>, #<PirschApi::Visitor day="2021-09-05T00:00:00Z", visitors=116, views=202, sessions=131, bounces=84, bounce_rate=0.7241379310344828>, #<PirschApi::Visitor day="2021-09-06T00:00:00Z", visitors=1, views=1, sessions=1, bounces=1, bounce_rate=1>]
|
73
74
|
|
74
|
-
client.visitors(domain:
|
75
|
+
client.visitors(domain: domain, filters: { from: '2021-09-01' })
|
75
76
|
=> [#<PirschApi::Visitor day="2021-09-01T00:00:00Z", visitors=76, views=161, sessions=110, bounces=48, bounce_rate=0.631578947368421>, #<PirschApi::Visitor day="2021-09-02T00:00:00Z", visitors=79, views=152, sessions=130, bounces=52, bounce_rate=0.6582278481012658>, #<PirschApi::Visitor day="2021-09-03T00:00:00Z", visitors=53, views=109, sessions=68, bounces=26, bounce_rate=0.49056603773584906>, #<PirschApi::Visitor day="2021-09-04T00:00:00Z", visitors=54, views=126, sessions=71, bounces=31, bounce_rate=0.5740740740740741>, #<PirschApi::Visitor day="2021-09-05T00:00:00Z", visitors=116, views=202, sessions=131, bounces=84, bounce_rate=0.7241379310344828>, #<PirschApi::Visitor day="2021-09-06T00:00:00Z", visitors=1, views=1, sessions=1, bounces=1, bounce_rate=1>]
|
76
77
|
|
77
|
-
client.visitors(domain:
|
78
|
+
client.visitors(domain: domain, filters: { from: '2021-09-01' }).first.day
|
78
79
|
=> "2021-09-01T00:00:00Z"
|
79
80
|
|
80
81
|
# Get /statistics/active
|
81
|
-
client.active(domain:
|
82
|
+
client.active(domain: domain)
|
82
83
|
=> #<PirschApi::Active stats=nil, visitors=0>
|
83
|
-
|
84
|
+
|
85
|
+
client.active(domain: domain).visitors
|
84
86
|
=> 0
|
85
87
|
```
|
86
88
|
|
data/lib/pirsch_api/client.rb
CHANGED
@@ -57,5 +57,13 @@ module PirschApi
|
|
57
57
|
def utm_campaign(filters: {}, domain:)
|
58
58
|
UtmCampaignResource.new(client: self, filters: filters, domain: domain).run
|
59
59
|
end
|
60
|
+
|
61
|
+
def duration_session(filters: {}, domain:)
|
62
|
+
DurationSessionResource.new(client: self, filters: filters, domain: domain).run
|
63
|
+
end
|
64
|
+
|
65
|
+
def duration_page(filters: {}, domain:)
|
66
|
+
DurationPageResource.new(client: self, filters: filters, domain: domain).run
|
67
|
+
end
|
60
68
|
end
|
61
69
|
end
|
data/lib/pirsch_api/version.rb
CHANGED
data/lib/pirsch_api.rb
CHANGED
@@ -21,6 +21,8 @@ module PirschApi
|
|
21
21
|
autoload :UtmSourceResource, "pirsch_api/resources/statistics/utm_source"
|
22
22
|
autoload :UtmCampaignResource, "pirsch_api/resources/statistics/utm_campaign"
|
23
23
|
autoload :UtmMediumResource, "pirsch_api/resources/statistics/utm_medium"
|
24
|
+
autoload :DurationSessionResource, "pirsch_api/resources/statistics/duration_session"
|
25
|
+
autoload :DurationPageResource, "pirsch_api/resources/statistics/duration_page"
|
24
26
|
|
25
27
|
autoload :Object, "pirsch_api/object"
|
26
28
|
autoload :Token, "pirsch_api/objects/token"
|
@@ -34,4 +36,6 @@ module PirschApi
|
|
34
36
|
autoload :UtmSource, "pirsch_api/objects/utm_source"
|
35
37
|
autoload :UtmCampaign, "pirsch_api/objects/utm_campaign"
|
36
38
|
autoload :UtmMedium, "pirsch_api/objects/utm_medium"
|
39
|
+
autoload :DurationSession, "pirsch_api/objects/duration_session"
|
40
|
+
autoload :DurationPage, "pirsch_api/objects/duration_page"
|
37
41
|
end
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: pirsch_api
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.0.
|
4
|
+
version: 0.0.4
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Gustavo Garcia
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2021-09-
|
11
|
+
date: 2021-09-15 00:00:00.000000000 Z
|
12
12
|
dependencies: []
|
13
13
|
description: A very humble wrapper for the API by Pirsch.io
|
14
14
|
email:
|
@@ -32,6 +32,8 @@ files:
|
|
32
32
|
- lib/pirsch_api/object.rb
|
33
33
|
- lib/pirsch_api/objects/active.rb
|
34
34
|
- lib/pirsch_api/objects/domain.rb
|
35
|
+
- lib/pirsch_api/objects/duration_page.rb
|
36
|
+
- lib/pirsch_api/objects/duration_session.rb
|
35
37
|
- lib/pirsch_api/objects/event.rb
|
36
38
|
- lib/pirsch_api/objects/growth.rb
|
37
39
|
- lib/pirsch_api/objects/page.rb
|
@@ -44,6 +46,8 @@ files:
|
|
44
46
|
- lib/pirsch_api/resources/base.rb
|
45
47
|
- lib/pirsch_api/resources/domain.rb
|
46
48
|
- lib/pirsch_api/resources/statistics/active.rb
|
49
|
+
- lib/pirsch_api/resources/statistics/duration_page.rb
|
50
|
+
- lib/pirsch_api/resources/statistics/duration_session.rb
|
47
51
|
- lib/pirsch_api/resources/statistics/event.rb
|
48
52
|
- lib/pirsch_api/resources/statistics/growth.rb
|
49
53
|
- lib/pirsch_api/resources/statistics/page.rb
|