Aller au contenu
Contlo by QuestionPro
Parcourir la documentation

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.

Settings → Channels → Push Notification / Mobile PushWeb push opt-in promptAndroid (Firebase) and iOS (APNs)Saves as you edit

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.

  1. Use the switch at the top right to set the opt-in to Enabled.
  2. Set the timing and prompt type under Behaviour.
  3. If you use the custom prompt, style it under Popup Design and write its text under Content.
  4. 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

SettingWhat 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 TypeBrowser 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 IconAn 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.

SectionSettingWhat it controls
Popup DesignBackgroundBackground color of the popup.
Popup DesignPrimary Text ColorColor of the title and description.
Popup DesignButton ColorFill color of the main button.
Popup DesignButton Text ColorColor of the text on the main button.
Popup DesignTitle Text Font (px)Font size of the title, in pixels.
Popup DesignDescription Text Font (px)Font size of the description, in pixels.
ContentTitleThe short line at the top of the popup.
ContentDescriptionThe main message. Say what subscribers get, such as early access to sales or back-in-stock alerts.
ContentButton TextThe label on the button that accepts, for example "Signup".
ContentClose Button TextThe 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 ContloKey in the service account JSON
Account Typetype
Project IDproject_id
Private Key IDprivate_key_id
Private Keyprivate_key
Client Emailclient_email
Client IDclient_id
Auth URIauth_uri
Token URItoken_uri
Auth Provider Cert Urlauth_provider_x509_cert_url
Client Cert Urlclient_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.

FieldWhat to enter
APNs Authentication KeyClick Upload and choose your key file. Only .p8 files are supported. The button changes to Uploaded when a key is on file.
Key IDThe ID of that authentication key.
Team IDYour Apple Developer team ID.
App Bundle IDThe 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

ProblemWhat to check
"Unable to save settings" on the Android tabA 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 tabMake 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 uploadOnly files with the .p8 extension are accepted.
The opt-in prompt doesn't appear on your storeConfirm 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 dateClick 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

Vous ne trouvez pas quelque chose ? Nous écrire