{"_id":"56d1f33a00a2a70b00b365aa","__v":29,"category":{"_id":"56d1f33900a2a70b00b36593","__v":2,"project":"5526c95cf69851170038b48f","version":"56d1f33700a2a70b00b3658e","pages":["56d1f33a00a2a70b00b365aa","56d1f33a00a2a70b00b365ab","56d1f33a00a2a70b00b365ac","56d1f33a00a2a70b00b365ad","56d1f33a00a2a70b00b365ae","56d1f33a00a2a70b00b365af","56d1f33a00a2a70b00b365b0","56d1f33a00a2a70b00b365b1","56d1f33a00a2a70b00b365b2","56d1f33a00a2a70b00b365b3","56d1f33a00a2a70b00b365b4","56d1f33a00a2a70b00b365b5","56d1f33a00a2a70b00b365b6","56d1f33a00a2a70b00b365b7","56d1f33a00a2a70b00b365b8","56d1f33a00a2a70b00b365b9","56d1f33a00a2a70b00b365ba","56d1f33a00a2a70b00b365bb","56d1f33a00a2a70b00b365bc","56d1f33a00a2a70b00b365bd","56d1f33a00a2a70b00b365be","56d1f33a00a2a70b00b365bf","56d1f33a00a2a70b00b365c0","56d31b848161a00b00dc458a"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-04-10T15:00:49.659Z","from_sync":false,"order":3,"slug":"ionic-push","title":"Ionic Push"},"parentDoc":null,"project":"5526c95cf69851170038b48f","user":"5526ca4cf69851170038b496","version":{"_id":"56d1f33700a2a70b00b3658e","project":"5526c95cf69851170038b48f","__v":2,"createdAt":"2016-02-27T19:04:23.946Z","releaseDate":"2016-02-27T19:04:23.946Z","categories":["56d1f33900a2a70b00b3658f","56d1f33900a2a70b00b36590","56d1f33900a2a70b00b36591","56d1f33900a2a70b00b36592","56d1f33900a2a70b00b36593","56d1f33900a2a70b00b36594","56d1f33900a2a70b00b36595","56d1f33900a2a70b00b36596","56d1f33900a2a70b00b36597","56d1f33900a2a70b00b36598","56d1f33900a2a70b00b36599","56d1f33900a2a70b00b3659a","571f9497ada30c34003b7cee"],"is_deprecated":false,"is_hidden":false,"is_beta":true,"is_stable":true,"codename":"beta","version_clean":"2.0.0-beta","version":"2.0.0-beta"},"updates":["55c9af4724722f3700ce148c","57a791e0c71b2f1700db429c"],"next":{"pages":[],"description":""},"createdAt":"2015-07-24T14:51:01.946Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Push notifications are an essential part of every great app, enticing users to re-engage with the app even when they’re away from it.\n\nIonic Push lets you create targeted push notifications through a simple dashboard that will be sent automatically when users match specific criteria, and offers a simple API to send push notifications from your own servers.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/DwctiXvRQKWoXT0Ma5xI_send-push-diagram.png\",\n        \"send-push-diagram.png\",\n        \"2075\",\n        \"772\",\n        \"#4181b1\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\nThe concept of push is fairly straightforward. You typically want to let users of your application know *something*. That something varies greatly from app to app, but the core concept remains the same: deliver a notification to the user's device.\n\nBoth Android and iOS devices have bare-bones services they provide to do just that. They are called  [GCM](https://developers.google.com/cloud-messaging/) (Google Cloud Messaging) and [APNs](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ApplePushService.html) (Apple Push Notification Service) respectively. Each of these systems require varying amounts of setup and configuration. They also differ in functionality and usage. \n\nIonic Push acts as a middleman between APNs, GCM, and your app. We provide a common API for you to use, reports on notifications, storage for device information, and other added features that you can't get directly with APNs and GCM.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Getting Started\"\n}\n[/block]\n## Limited Push\n\nWhen you initial create an app, we set a configuration option called `dev_push` to `true`. This push mode bypasses the typical setup for APNs, GCM, and Security Profiles which greatly reduces the steps needed to see a push notification on your app (it also has the added benefit of working in a browser or emulator).\n\nWe typically recommend starting with this mode to make sure your app is setup correctly before worrying about other configuration, but it should be noted that this mode has very *limited* functionality and will not behave like a real push sent with APNs / GCM. \n\nIf you've never used push before, start with this mode and make sure you can get basic pushes sent to your device before you move on to full push.\n\nStart with the [Limited Setup](doc:push-limited-setup).\n\n## Full Push\n\nOnce you have limited push working, or feel confident about diving right into APNs and GCM setup, you can head over to the in-depth [Full Setup](doc:push-full-setup) guide.","excerpt":"Information about the Ionic Push service","slug":"push-overview","type":"basic","title":"Overview"}

Overview

Information about the Ionic Push service

Push notifications are an essential part of every great app, enticing users to re-engage with the app even when they’re away from it. Ionic Push lets you create targeted push notifications through a simple dashboard that will be sent automatically when users match specific criteria, and offers a simple API to send push notifications from your own servers. [block:image] { "images": [ { "image": [ "https://files.readme.io/DwctiXvRQKWoXT0Ma5xI_send-push-diagram.png", "send-push-diagram.png", "2075", "772", "#4181b1", "" ] } ] } [/block] The concept of push is fairly straightforward. You typically want to let users of your application know *something*. That something varies greatly from app to app, but the core concept remains the same: deliver a notification to the user's device. Both Android and iOS devices have bare-bones services they provide to do just that. They are called [GCM](https://developers.google.com/cloud-messaging/) (Google Cloud Messaging) and [APNs](https://developer.apple.com/library/ios/documentation/NetworkingInternet/Conceptual/RemoteNotificationsPG/Chapters/ApplePushService.html) (Apple Push Notification Service) respectively. Each of these systems require varying amounts of setup and configuration. They also differ in functionality and usage. Ionic Push acts as a middleman between APNs, GCM, and your app. We provide a common API for you to use, reports on notifications, storage for device information, and other added features that you can't get directly with APNs and GCM. [block:api-header] { "type": "basic", "title": "Getting Started" } [/block] ## Limited Push When you initial create an app, we set a configuration option called `dev_push` to `true`. This push mode bypasses the typical setup for APNs, GCM, and Security Profiles which greatly reduces the steps needed to see a push notification on your app (it also has the added benefit of working in a browser or emulator). We typically recommend starting with this mode to make sure your app is setup correctly before worrying about other configuration, but it should be noted that this mode has very *limited* functionality and will not behave like a real push sent with APNs / GCM. If you've never used push before, start with this mode and make sure you can get basic pushes sent to your device before you move on to full push. Start with the [Limited Setup](doc:push-limited-setup). ## Full Push Once you have limited push working, or feel confident about diving right into APNs and GCM setup, you can head over to the in-depth [Full Setup](doc:push-full-setup) guide.