{"_id":"5798f2a97700d30e00ad2516","parentDoc":null,"user":"560c92f2ac2859170013faa3","category":{"_id":"560dba80373c0e0d0024ff3b","pages":["560dbc6677c8940d001c3bcd","560dbc768e6f870d004e3e6a","560f171e83e4100d00a9851f","56a1574444f3d80d00a2c398"],"project":"560c93ad7e9b9d0d00ca81a2","version":"560c93ae7e9b9d0d00ca81a5","__v":4,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-10-01T22:58:08.137Z","from_sync":false,"order":2,"slug":"setup-guides","title":"Alternate Event and Revenue Tracking"},"githubsync":"","__v":1,"version":{"_id":"560c93ae7e9b9d0d00ca81a5","project":"560c93ad7e9b9d0d00ca81a2","__v":9,"createdAt":"2015-10-01T02:00:14.709Z","releaseDate":"2015-10-01T02:00:14.709Z","categories":["560c93af7e9b9d0d00ca81a6","560c9d9399bb5a0d0044f220","560d76d899bb5a0d0044f307","560d76ee1ec45619006069ed","560d86e099bb5a0d0044f32e","560dba80373c0e0d0024ff3b","57c722ecdf19130e001fba5d","57c743d1b6f94a2200659903","58995ec083f743190077bbe2"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"project":"560c93ad7e9b9d0d00ca81a2","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-27T17:43:05.882Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Before you begin\"\n}\n[/block]\nBefore you begin the Recurly integration, be sure that you have reviewed the <a href=\"https://attribution.readme.io/docs/getting-started\">Getting Started with Attribution</a> guide, and have completed Step 1: Install the Snippet, and Step 2: Identify.\n\nAttribution <b>will not</b> work if you do not have the snippet on every page of your site and if you have not identified your users on sign up or sign in.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Attribution uses Recurly <a href=\\\"https://docs.recurly.com/docs/accounts#section-account-code\\\" target=\\\"_blank\\\">Account Code</a> to map events to your identified users. The **USER_ID** you use for _identify()_ must match Recurly **ACCOUNT CODE** otherwise your Recurly events will not be tracked properly.\"\n}\n[/block]\nIf you are satisfied with the events that are automatically tracked below, you do not need to do complete Step 3: Track Events (that's what the integration is for!).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Capturing Recurly Events in Attribution\"\n}\n[/block]\nYou can easily start tracking events and revenue in Attribution if you are using Recurly.  When you have finished with the simple integration below, the following events will be tracked in Attribution:\n\nNew Account (this creates new user or updates it, fires `identify`)\nClosed Account\nUpdated Billing Information\nReactivated Account\nNew Invoice\nProcessing Invoice\nClosed Invoice\nPast Due Invoice\nNew Subscription\nUpdated Subscription\nCanceled Subscription\nExpired Subscription\nRenewed Subscription\nScheduled Payment \nProcessing Payment\nSuccessful Payment (this is the event that reports revenue)\nFailed Payment\nSuccessful Refund (this will generate negative revenue, reducing overall revenue)\nVoid Payment (the same as \"Successful Refund\")\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Recurly Integration\"\n}\n[/block]\nStep 1: Sign into your Recurly account and visit Developers -> Webhooks.\nStep 2: Click on 'Configure'.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/24b475f-recurly_setup1.png\",\n        \"recurly_setup1.png\",\n        1440,\n        842,\n        \"#4d325f\"\n      ]\n    }\n  ]\n}\n[/block]\nStep 3: Click on 'Configure Endpoint'.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/953be75-recurly_setup2.png\",\n        \"recurly_setup2.png\",\n        1440,\n        686,\n        \"#4d335f\"\n      ]\n    }\n  ]\n}\n[/block]\nStep 4: Enter 'Attribution' in the 'ENDPOINT NAME' field.\n\nStep 5: Enter 'https://track.attributionapp.com/recurly in the 'ENDPOINT URL' field.\n\nStep 6: Sign into Attributionapp.com and visit Settings -> Javascript Settings.  Copy the Project ID key and Paste it in the 'HTTP AUTH USERNAME' field at Recurly.\n\nNOTE: Leave the 'HTTP AUTH PASSWORD' field blank.\n\nStep 7: Click 'Save Changes'\n\nYou're Done!  You should start seeing events in your Attribution Dashboard within 15 minutes!\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/b9b2c25-recurly_setup3.png\",\n        \"recurly_setup3.png\",\n        1440,\n        1341,\n        \"#dce4de\"\n      ],\n      \"sizing\": \"full\",\n      \"border\": false\n    }\n  ]\n}\n[/block]","excerpt":"Attribution has created a Recurly integration that allows you to easily capture events in Attribution.","slug":"recurly","type":"basic","title":"Recurly Attribution"}

Recurly Attribution

Attribution has created a Recurly integration that allows you to easily capture events in Attribution.

[block:api-header] { "type": "basic", "title": "Before you begin" } [/block] Before you begin the Recurly integration, be sure that you have reviewed the <a href="https://attribution.readme.io/docs/getting-started">Getting Started with Attribution</a> guide, and have completed Step 1: Install the Snippet, and Step 2: Identify. Attribution <b>will not</b> work if you do not have the snippet on every page of your site and if you have not identified your users on sign up or sign in. [block:callout] { "type": "warning", "body": "Attribution uses Recurly <a href=\"https://docs.recurly.com/docs/accounts#section-account-code\" target=\"_blank\">Account Code</a> to map events to your identified users. The **USER_ID** you use for _identify()_ must match Recurly **ACCOUNT CODE** otherwise your Recurly events will not be tracked properly." } [/block] If you are satisfied with the events that are automatically tracked below, you do not need to do complete Step 3: Track Events (that's what the integration is for!). [block:api-header] { "type": "basic", "title": "Capturing Recurly Events in Attribution" } [/block] You can easily start tracking events and revenue in Attribution if you are using Recurly. When you have finished with the simple integration below, the following events will be tracked in Attribution: New Account (this creates new user or updates it, fires `identify`) Closed Account Updated Billing Information Reactivated Account New Invoice Processing Invoice Closed Invoice Past Due Invoice New Subscription Updated Subscription Canceled Subscription Expired Subscription Renewed Subscription Scheduled Payment Processing Payment Successful Payment (this is the event that reports revenue) Failed Payment Successful Refund (this will generate negative revenue, reducing overall revenue) Void Payment (the same as "Successful Refund") [block:api-header] { "type": "basic", "title": "Recurly Integration" } [/block] Step 1: Sign into your Recurly account and visit Developers -> Webhooks. Step 2: Click on 'Configure'. [block:image] { "images": [ { "image": [ "https://files.readme.io/24b475f-recurly_setup1.png", "recurly_setup1.png", 1440, 842, "#4d325f" ] } ] } [/block] Step 3: Click on 'Configure Endpoint'. [block:image] { "images": [ { "image": [ "https://files.readme.io/953be75-recurly_setup2.png", "recurly_setup2.png", 1440, 686, "#4d335f" ] } ] } [/block] Step 4: Enter 'Attribution' in the 'ENDPOINT NAME' field. Step 5: Enter 'https://track.attributionapp.com/recurly in the 'ENDPOINT URL' field. Step 6: Sign into Attributionapp.com and visit Settings -> Javascript Settings. Copy the Project ID key and Paste it in the 'HTTP AUTH USERNAME' field at Recurly. NOTE: Leave the 'HTTP AUTH PASSWORD' field blank. Step 7: Click 'Save Changes' You're Done! You should start seeing events in your Attribution Dashboard within 15 minutes! [block:image] { "images": [ { "image": [ "https://files.readme.io/b9b2c25-recurly_setup3.png", "recurly_setup3.png", 1440, 1341, "#dce4de" ], "sizing": "full", "border": false } ] } [/block]