Push settings
Push notifications reach shoppers on their browser or phone without needing an email address or phone number. Before you can send them, people have to opt in. These settings control the prompt that asks website visitors for permission, and hold the credentials Contlo needs to deliver notifications to your Android and iOS apps.
Les guides sont en anglais.
Before you start
- Open Settings from the account menu in the top bar, then choose Channels. Each installed channel is a card. If Push Notification or Mobile Push isn't listed, install it from the App Market first.
- Web push works on a site that has Contlo web tracking installed. See Install web tracking.
- Mobile push needs the Contlo SDK in your app. See Mobile SDKs.
- If you see "Settings are managed by the account owner", your role doesn't include channel settings. See Team and roles.
Turn on the web push opt-in
Go to Settings → Channels → Push Notification. The page is titled Push Opt-In Settings and configures the permission prompt shown on your store.
- Use the switch at the top right to set the opt-in to Enabled.
- Set the timing and prompt type under Behaviour.
- If you use the custom prompt, style it under Popup Design and write its text under Content.
- Check the result in Preview on the right. It reloads after each change.
There is no save button. Switches, dropdowns and color pickers save immediately, and text and number fields save when you click out of them. You see "Settings saved successfully" each time.
Behaviour
| Setting | What it does |
|---|---|
| Popup Delay (seconds) | How long after the page loads before the prompt appears. A short delay lets visitors see your store before being asked. |
| Opt-In Type | Browser shows the browser's own permission prompt. Custom shows your branded popup, designed in the sections below. New accounts start on Browser. |
| Popup dismissed duration (days) | How many days to wait before asking again after a visitor dismisses the prompt. The default is 30. |
| Upload Icon | An image to show with your prompt, typically your logo. Click Upload Icon and choose an image file. To remove it, click the delete button beside the thumbnail. |
Popup design and content
These settings shape the custom popup.
| Section | Setting | What it controls |
|---|---|---|
| Popup Design | Background | Background color of the popup. |
| Popup Design | Primary Text Color | Color of the title and description. |
| Popup Design | Button Color | Fill color of the main button. |
| Popup Design | Button Text Color | Color of the text on the main button. |
| Popup Design | Title Text Font (px) | Font size of the title, in pixels. |
| Popup Design | Description Text Font (px) | Font size of the description, in pixels. |
| Content | Title | The short line at the top of the popup. |
| Content | Description | The main message. Say what subscribers get, such as early access to sales or back-in-stock alerts. |
| Content | Button Text | The label on the button that accepts, for example "Signup". |
| Content | Close Button Text | The label on the button that declines, for example "No Thanks". |
For each color, type a hex code or pick one with the color picker.
Configure mobile push
Go to Settings → Channels → Mobile Push. The page has an Android tab and an iOS tab. Fill in the tab for each platform your app supports, then click Save Settings on that tab.
Android: Firebase service account
Contlo sends Android notifications through Firebase Cloud Messaging using a service account from your Firebase project. Generate a service account key file in your Firebase project settings, open the downloaded JSON file, and copy each value into the matching field.
| Field in Contlo | Key in the service account JSON |
|---|---|
| Account Type | type |
| Project ID | project_id |
| Private Key ID | private_key_id |
| Private Key | private_key |
| Client Email | client_email |
| Client ID | client_id |
| Auth URI | auth_uri |
| Token URI | token_uri |
| Auth Provider Cert Url | auth_provider_x509_cert_url |
| Client Cert Url | client_x509_cert_url |
Every field is required. Private Key ID and Private Key are masked as you type.
iOS: APNs configuration
Contlo sends iOS notifications through the Apple Push Notification service using an authentication key from your Apple Developer account.
| Field | What to enter |
|---|---|
| APNs Authentication Key | Click Upload and choose your key file. Only .p8 files are supported. The button changes to Uploaded when a key is on file. |
| Key ID | The ID of that authentication key. |
| Team ID | Your Apple Developer team ID. |
| App Bundle ID | The bundle identifier of your iOS app. |
Turn a push channel off
- Web push: set the switch on Push Opt-In Settings to Disabled to stop asking visitors to subscribe.
- Mobile push: on the Mobile Push page, open Actions and choose Uninstall. The channel is removed from your account. Install it again from the App Market when you need it.
Troubleshooting
| Problem | What to check |
|---|---|
| "Unable to save settings" on the Android tab | A required field is empty. All ten fields must be filled in. Copy the values again from one service account JSON file. |
| "Unable to save settings" on the iOS tab | Make sure a .p8 key is uploaded and that the Key ID, Team ID and App Bundle ID are filled in. |
| The key file won't upload | Only files with the .p8 extension are accepted. |
| The opt-in prompt doesn't appear on your store | Confirm the switch shows Enabled, that web tracking is installed on the page, and that you haven't already answered or dismissed the prompt in this browser. A dismissed prompt stays hidden for the number of days set in Popup dismissed duration (days). |
| The preview looks out of date | Click out of the field you just edited so it saves. The preview reloads after each save. |
Once people have opted in, send to them with Push campaigns.
Guides associés
- Push campaignsSend web push and mobile push campaigns: title, message, image, link or deep link, buttons, expiry and test sends.
- Mobile SDKsAdd Contlo to an Android, iOS, React Native or Expo app: install, initialize, identify users, track events and set up push notifications.
- Install web trackingAdd the Contlo tracking snippet to a custom site, see what it records automatically, verify the install and review the cookies it sets.