{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Getting Started with Attribution App","type":"basic","slug":"getting-started","excerpt":"This page will help you get started with Attribution. You'll be up and running in a jiffy!","body":"The tracking snippet is used to track visits to your webpages. It is important to install the snippet on all of your webpages between the <head></head> HTML. \n\nIf you plan to integrate with Shopify, Segment, Shopify, or Wordpress you will not need to install any tracking snippet. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"1. Install the Snippet\"\n}\n[/block]\nPlace this tracking code on between the <head></head> HTML on your pages. The code below is an example, but you can find your team's tracking snippet by going to the [settings page here](https://dashboard.attributionapp.com/v1/#!/settings) \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"<script type=\\\"text/javascript\\\">\\nwindow.Attribution=window.Attribution||[];window.Attribution.methods=[\\\"trackSubmit\\\",\\\"trackClick\\\",\\\"trackLink\\\",\\\"trackForm\\\",\\\"pageview\\\",\\\"identify\\\",\\\"group\\\",\\\"track\\\",\\\"ready\\\",\\\"alias\\\",\\\"page\\\",\\\"once\\\",\\\"off\\\",\\\"on\\\"];window.Attribution.factory=function(e){return function(){var t=Array.prototype.slice.call(arguments);t.unshift(e);window.Attribution.push(t);return window.Attribution}};for(var i=0;i<window.Attribution.methods.length;i++){var key=window.Attribution.methods[i];window.Attribution[key]=window.Attribution.factory(key)}window.Attribution.load=function(e){if(document.getElementById(\\\"attribution-js\\\"))return;var t=document.createElement(\\\"script\\\");t.type=\\\"text/javascript\\\";t.id=\\\"attribution-js\\\";t.async=true;t.src=\\\"//scripts.attributionapp.com/attribution.js\\\";var n=document.getElementsByTagName(\\\"script\\\")[0];n.parentNode.insertBefore(t,n)};window.Attribution.load();\\nwindow.Attribution.projectId=\\\"[[app:key]]\\\";\\nwindow.Attribution.page();\\n</script> \",\n      \"language\": \"html\"\n    },\n    {\n      \"code\": \"window.Attribution=window.Attribution||[];window.Attribution.methods=[\\\"trackSubmit\\\",\\\"trackClick\\\",\\\"trackLink\\\",\\\"trackForm\\\",\\\"pageview\\\",\\\"identify\\\",\\\"group\\\",\\\"track\\\",\\\"ready\\\",\\\"alias\\\",\\\"page\\\",\\\"once\\\",\\\"off\\\",\\\"on\\\"];window.Attribution.factory=function(e){return function(){var t=Array.prototype.slice.call(arguments);t.unshift(e);window.Attribution.push(t);return window.Attribution}};for(var i=0;i<window.Attribution.methods.length;i++){var key=window.Attribution.methods[i];window.Attribution[key]=window.Attribution.factory(key)}window.Attribution.load=function(e){if(document.getElementById(\\\"attribution-js\\\"))return;var t=document.createElement(\\\"script\\\");t.type=\\\"text/javascript\\\";t.id=\\\"attribution-js\\\";t.async=true;t.src=\\\"//scripts.attributionapp.com/attribution.js\\\";var n=document.getElementsByTagName(\\\"script\\\")[0];n.parentNode.insertBefore(t,n)};window.Attribution.load();\\nwindow.Attribution.projectId=\\\"YOUR_PROJECT_ID\\\";\\nwindow.Attribution.page();\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\nWhen you paste the snippet, you'll need to change YOUR_APP_KEY to the project id listed in the [settings](https://dashboard.attributionapp.com/#!/settings) page.\n\nThe snippet will create an anonymous_id for the visitor and use this to continue tracking until the visitor identifies themselves. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"2. Identify Users\"\n}\n[/block]\n`identify` is used to link a users actions and pageviews to a recognizable name or email address. You'll need to identify whenever a user identifies themselves, this includes sign up, log in, subscribe etc. \n\nWhen calling identify() you should pass in a userid field from your universal database. Then you can  provide email address, name, and anything else you'd like as a trait.  You can provide as many customer traits as you'd like to save.\n\nBe sure to include 'createdAt' as a trait so you can later distinguish between new and existing users. \n\nIf you **do not have a universal userid** you should omit the userid field and provide name and email as traits. \n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Attribution.identify('00812938', {\\n  name: 'Bob Slydell', \\n  email: 'bob:::at:::initech.co'\\n  createdAt: new Date()\\n});\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"3. Track Events\"\n}\n[/block]\nTrack is used to record events. You should use this method to record each step of your conversion funnel. These events should describe the action taken in a way that would be recognizable to anyone in your company. Here's some good examples of funnel events:\n\nSAAS Funnel: Created Account, Completed Account Setup, Entered Credit Card, Purchased Subscription.\n\nShopping Cart Funnel: Added Item to Cart, Viewed Cart, Entered Credit Card, Completed Purchase.\n\nAttribution app recognizes the revenue property on the track event and stores it in a special way. Here's an example of an event with the revenue property:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"Attribution.track('Credit Card Charged', {\\n  revenue: '79.99'\\n});\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"4. Congratulate Yourself!\"\n}\n[/block]\nThat's it! We sync data to our reporting databases every hour so it won't take long to start seeing customer data on your dashboard.","updates":[],"order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"560c93b07e9b9d0d00ca81a8","githubsync":"","project":"560c93ad7e9b9d0d00ca81a2","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["560c93af7e9b9d0d00ca81a6","560c9d9399bb5a0d0044f220","560d76d899bb5a0d0044f307","560d76ee1ec45619006069ed","560d86e099bb5a0d0044f32e","560dba80373c0e0d0024ff3b","57c722ecdf19130e001fba5d","57c743d1b6f94a2200659903","58995ec083f743190077bbe2"],"_id":"560c93ae7e9b9d0d00ca81a5","project":"560c93ad7e9b9d0d00ca81a2","createdAt":"2015-10-01T02:00:14.709Z","releaseDate":"2015-10-01T02:00:14.709Z","__v":9},"parentDoc":null,"__v":10,"category":{"sync":{"isSync":false,"url":""},"pages":["560c93b07e9b9d0d00ca81a8"],"title":"Documentation","slug":"documentation","order":0,"from_sync":false,"reference":false,"_id":"560c93af7e9b9d0d00ca81a6","version":"560c93ae7e9b9d0d00ca81a5","__v":1,"createdAt":"2015-10-01T02:00:15.249Z","project":"560c93ad7e9b9d0d00ca81a2"},"createdAt":"2015-10-01T02:00:16.038Z","user":"560c92f2ac2859170013faa3"}

Documentation

JavaScript API (client-side)

HTTP API (server-side)

Spend Tracking Integrations

Alternate Event and Revenue Tracking

Attribution Models Explained

Attribution Model Examples

Integration Partners

Getting Started with Attribution App

This page will help you get started with Attribution. You'll be up and running in a jiffy!
The tracking snippet is used to track visits to your webpages. It is important to install the snippet on all of your webpages between the <head></head> HTML. If you plan to integrate with Shopify, Segment, Shopify, or Wordpress you will not need to install any tracking snippet. [block:api-header] { "type": "basic", "title": "1. Install the Snippet" } [/block] Place this tracking code on between the <head></head> HTML on your pages. The code below is an example, but you can find your team's tracking snippet by going to the [settings page here](https://dashboard.attributionapp.com/v1/#!/settings) [block:code] { "codes": [ { "code": "<script type=\"text/javascript\">\nwindow.Attribution=window.Attribution||[];window.Attribution.methods=[\"trackSubmit\",\"trackClick\",\"trackLink\",\"trackForm\",\"pageview\",\"identify\",\"group\",\"track\",\"ready\",\"alias\",\"page\",\"once\",\"off\",\"on\"];window.Attribution.factory=function(e){return function(){var t=Array.prototype.slice.call(arguments);t.unshift(e);window.Attribution.push(t);return window.Attribution}};for(var i=0;i<window.Attribution.methods.length;i++){var key=window.Attribution.methods[i];window.Attribution[key]=window.Attribution.factory(key)}window.Attribution.load=function(e){if(document.getElementById(\"attribution-js\"))return;var t=document.createElement(\"script\");t.type=\"text/javascript\";t.id=\"attribution-js\";t.async=true;t.src=\"//scripts.attributionapp.com/attribution.js\";var n=document.getElementsByTagName(\"script\")[0];n.parentNode.insertBefore(t,n)};window.Attribution.load();\nwindow.Attribution.projectId=\"[[app:key]]\";\nwindow.Attribution.page();\n</script> ", "language": "html" }, { "code": "window.Attribution=window.Attribution||[];window.Attribution.methods=[\"trackSubmit\",\"trackClick\",\"trackLink\",\"trackForm\",\"pageview\",\"identify\",\"group\",\"track\",\"ready\",\"alias\",\"page\",\"once\",\"off\",\"on\"];window.Attribution.factory=function(e){return function(){var t=Array.prototype.slice.call(arguments);t.unshift(e);window.Attribution.push(t);return window.Attribution}};for(var i=0;i<window.Attribution.methods.length;i++){var key=window.Attribution.methods[i];window.Attribution[key]=window.Attribution.factory(key)}window.Attribution.load=function(e){if(document.getElementById(\"attribution-js\"))return;var t=document.createElement(\"script\");t.type=\"text/javascript\";t.id=\"attribution-js\";t.async=true;t.src=\"//scripts.attributionapp.com/attribution.js\";var n=document.getElementsByTagName(\"script\")[0];n.parentNode.insertBefore(t,n)};window.Attribution.load();\nwindow.Attribution.projectId=\"YOUR_PROJECT_ID\";\nwindow.Attribution.page();", "language": "javascript" } ] } [/block] When you paste the snippet, you'll need to change YOUR_APP_KEY to the project id listed in the [settings](https://dashboard.attributionapp.com/#!/settings) page. The snippet will create an anonymous_id for the visitor and use this to continue tracking until the visitor identifies themselves. [block:api-header] { "type": "basic", "title": "2. Identify Users" } [/block] `identify` is used to link a users actions and pageviews to a recognizable name or email address. You'll need to identify whenever a user identifies themselves, this includes sign up, log in, subscribe etc. When calling identify() you should pass in a userid field from your universal database. Then you can provide email address, name, and anything else you'd like as a trait. You can provide as many customer traits as you'd like to save. Be sure to include 'createdAt' as a trait so you can later distinguish between new and existing users. If you **do not have a universal userid** you should omit the userid field and provide name and email as traits. [block:code] { "codes": [ { "code": "Attribution.identify('00812938', {\n name: 'Bob Slydell', \n email: '[email protected]'\n createdAt: new Date()\n});", "language": "javascript" } ] } [/block] [block:api-header] { "type": "basic", "title": "3. Track Events" } [/block] Track is used to record events. You should use this method to record each step of your conversion funnel. These events should describe the action taken in a way that would be recognizable to anyone in your company. Here's some good examples of funnel events: SAAS Funnel: Created Account, Completed Account Setup, Entered Credit Card, Purchased Subscription. Shopping Cart Funnel: Added Item to Cart, Viewed Cart, Entered Credit Card, Completed Purchase. Attribution app recognizes the revenue property on the track event and stores it in a special way. Here's an example of an event with the revenue property: [block:code] { "codes": [ { "code": "Attribution.track('Credit Card Charged', {\n revenue: '79.99'\n});", "language": "javascript" } ] } [/block] [block:api-header] { "type": "basic", "title": "4. Congratulate Yourself!" } [/block] That's it! We sync data to our reporting databases every hour so it won't take long to start seeing customer data on your dashboard.