chiu
/
impressionist
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

readme for params feature

This commit is contained in:
asharma-ror 2015-04-21 15:55:37 +05:30
parent 2e72b5aefa
commit 9d997bc600
1 changed files with 12 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
README.md
View File

@ -55,6 +55,7 @@ The following fields are provided in the migration:
t.string "request_hash" # unique ID per request, in case you want to log multiple impressions and group them t.string "request_hash" # unique ID per request, in case you want to log multiple impressions and group them
t.string "session_hash" # logs the rails session t.string "session_hash" # logs the rails session
t.string "ip_address" # request.remote_ip t.string "ip_address" # request.remote_ip
t.text "params" # request.params, except action name, controller name and resource id
t.string "referrer" # request.referer t.string "referrer" # request.referer
t.string "message" # custom message you can add t.string "message" # custom message you can add
t.datetime "created_at" # I am not sure what this is.... Any clue? t.datetime "created_at" # I am not sure what this is.... Any clue?
@ -114,7 +115,12 @@ Usage
@widget.impressionist_count(:filter=>:ip_address) @widget.impressionist_count(:filter=>:ip_address)
7. Get the unique impression count from a model filtered by session hash. Same 7. Get the unique impression count from a model filtered by params. This
in turn will give you impressions with unique params.
@widget.impressionist_count(:filter => :params)
8. Get the unique impression count from a model filtered by session hash. Same
as #6 regarding request hash. This may be more desirable than filtering by as #6 regarding request hash. This may be more desirable than filtering by
IP address depending on your situation, since filtering by IP may ignore IP address depending on your situation, since filtering by IP may ignore
visitors that use the same IP. The downside to this filtering is that a visitors that use the same IP. The downside to this filtering is that a
@ -122,12 +128,12 @@ Usage
@widget.impressionist_count(:filter=>:session_hash) @widget.impressionist_count(:filter=>:session_hash)
8. Get total impression count. This may return more than 1 impression per http 9. Get total impression count. This may return more than 1 impression per http
request, depending on how you are logging impressions request, depending on how you are logging impressions
@widget.impressionist_count(:filter=>:all) @widget.impressionist_count(:filter=>:all)
9. Get impression count by message. This only counts impressions of the given message. 10. Get impression count by message. This only counts impressions of the given message.
@widget.impressionist_count(:message=>"pageview", :filter=>:all) @widget.impressionist_count(:message=>"pageview", :filter=>:all)
@ -183,6 +189,9 @@ impressions in your controller:
# only record impression if session is unique # only record impression if session is unique
impressionist :unique => [:session_hash] impressionist :unique => [:session_hash]
# only record impression if param is unique
impressionist :unique => [:params]
Or you can use the `impressionist` method directly: Or you can use the `impressionist` method directly:
impressionist(impressionable, "some message", :unique => [:session_hash]) impressionist(impressionable, "some message", :unique => [:session_hash])