{"_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","metadata":{"title":"","description":"","image":[]},"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 app</a> guide, and have completed Step 1: Install the Snippet, and Step 2: Identify.\n\nAttribution app <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 app 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 app\"\n}\n[/block]\nYou can easily start tracking events and revenue in Attribution app if you are using Recurly.  When you have finished with the simple integration below, the following events will be tracked in Attribution app:\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 app 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 app has created a Recurly integration that allows you to easily capture events in Attribution app.","slug":"recurly","type":"basic","title":"Recurly & Attribution app"}

Recurly & Attribution app

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

[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 app</a> guide, and have completed Step 1: Install the Snippet, and Step 2: Identify. Attribution app <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 app 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 app" } [/block] You can easily start tracking events and revenue in Attribution app if you are using Recurly. When you have finished with the simple integration below, the following events will be tracked in Attribution app: 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 app 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]