{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Creating Custom Events","type":"basic","slug":"setting-custom-events","excerpt":"","body":"[block:callout]\n{\n  \"type\": \"success\",\n  \"body\": \"Please make sure that you're familiar with the [Running the Pulsate SDK](https://pulsate.readme.io/v2.0/docs/running-the-pulsate-sdk-android) tutorial.\"\n}\n[/block]\nPulsate enables you to track actions that your user's have taken within your app by setting custom events. You can use track these custom events to get a better idea of the customer journey within your app and you can also deliver targeted campaigns to users based on their actions within the app.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Custom Event Campaign Example\",\n  \"body\": \"You create a campaign with a coupon for a variety of clothes. You decide to show this campaign on *didPressClothesButton* event trigger. When user clicks on the *Clothes* section button, you send an *didPressClothesButton* event through the SDK. The server will take care of the rest and deliver your campaign to the user.\"\n}\n[/block]\nTo enable Pulsate to track these events, use the *createEvent:* method on the *Pulsate Manager* object:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"manager.createEvent(\\\"didPressClothesButton\\\");\",\n      \"language\": \"java\"\n    }\n  ]\n}\n[/block]\nOnce those custom events have been set, every time a user completes that action, it will be recorded by Pulsate and you can choose those events in the *Targeting Section* when you are building a campaign.","updates":[],"order":19,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5e5019b49e8f240011cc6a68","__v":10,"createdAt":"2015-09-14T09:26:12.801Z","project":"54aa7f773b56130b0056c86e","version":{"version":"2.8","version_clean":"2.8.0","codename":"Android SDK","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5e5019b49e8f240011cc6a47","55781fe35129590d003ff4f9","55781fe35129590d003ff4fa","5e5019b49e8f240011cc6a48","5e5019b49e8f240011cc6a49","5e5019b49e8f240011cc6a4a","5e5019b49e8f240011cc6a4b","5e5019b49e8f240011cc6a4c","565b66c446118c0d00dcb0bb","56898269f8dc340d00308c13","5e5019b49e8f240011cc6a4d","5e5019b49e8f240011cc6a4e","5c73dd27e8fdc000572a206a","5e5019b49e8f240011cc6a4f","5e501b7e7c8bdc00450ea66a","5e53daa9884b750025b5cad4"],"_id":"5e5019b49e8f240011cc6ade","project":"54aa7f773b56130b0056c86e","forked_from":"5e4fbbbda8fb41028f1861fe","__v":2,"createdAt":"2015-06-10T11:30:42.700Z","releaseDate":"2015-06-10T11:30:42.700Z"},"category":{"sync":{"isSync":false,"url":""},"pages":["5e5019b49e8f240011cc6a55","5e5019b49e8f240011cc6a56","5e5019b49e8f240011cc6a57","5e5019b49e8f240011cc6a58","5e5019b49e8f240011cc6a59","5e5019b49e8f240011cc6a5a","5e5019b49e8f240011cc6a5b","5e5019b49e8f240011cc6a5c","5e5019b49e8f240011cc6a5d","5e5019b49e8f240011cc6a5e","5e5019b49e8f240011cc6a68","5e5019b49e8f240011cc6a6b","5e5019b49e8f240011cc6a71","5e5019b49e8f240011cc6a73","5e5019b49e8f240011cc6a7e","5e5019b49e8f240011cc6a80","5e5019b49e8f240011cc6a81","5e5019b49e8f240011cc6a82","5e5019b49e8f240011cc6a84"],"title":"Android SDK","slug":"android-sdk","order":1,"from_sync":false,"reference":false,"_id":"5e5019b49e8f240011cc6a49","version":"5e5019b49e8f240011cc6ade","__v":10,"project":"54aa7f773b56130b0056c86e","createdAt":"2015-01-05T12:44:00.338Z"},"githubsync":"","parentDoc":null,"user":"54aa7f3f9bb00c0b00cb899b"}

Creating Custom Events


[block:callout] { "type": "success", "body": "Please make sure that you're familiar with the [Running the Pulsate SDK](https://pulsate.readme.io/v2.0/docs/running-the-pulsate-sdk-android) tutorial." } [/block] Pulsate enables you to track actions that your user's have taken within your app by setting custom events. You can use track these custom events to get a better idea of the customer journey within your app and you can also deliver targeted campaigns to users based on their actions within the app. [block:callout] { "type": "info", "title": "Custom Event Campaign Example", "body": "You create a campaign with a coupon for a variety of clothes. You decide to show this campaign on *didPressClothesButton* event trigger. When user clicks on the *Clothes* section button, you send an *didPressClothesButton* event through the SDK. The server will take care of the rest and deliver your campaign to the user." } [/block] To enable Pulsate to track these events, use the *createEvent:* method on the *Pulsate Manager* object: [block:code] { "codes": [ { "code": "manager.createEvent(\"didPressClothesButton\");", "language": "java" } ] } [/block] Once those custom events have been set, every time a user completes that action, it will be recorded by Pulsate and you can choose those events in the *Targeting Section* when you are building a campaign.