Tags Manager

Tags manager shows you a list of all your tags inventory.
Click on the Tags Manager tab, you will see 2 new tabs: Tags and Groups.

Tags

Tag is an identifier, which may have in itself a set of different apps. The app types that can be included in the tags are web, android and iOS.

Please follow this step by step guide to add a new tag:

First, click on the Add button in the upper right corner.
The fields that need to be filled in when creating a tag are Tag Name, Account and APPs.

Note: When creating a tag, filling in the Tag Name and Account fields is mandatory.

Select

If you want to add an app, you will need to select an app type (web, android and iOS) and fill in the URI.
Clicking on the Confirm button, you successfully created a tag.

Note: You can currently add only one Android/iOS app.

After creating a tag, it will be displayed in the list of tags where you can easily find it using the Search option. The list of created tags provides basic information such as Status (Active, Rejected, Verification, Paused, Inactive, Pending and Disabled), Name, APP, Date Created, Date Modified, Pageviews, Sessions and Users.

Select

To delete a tag, you will need to click on the tag you want to delete and then on the Delete button located in the upper right corner.

There are up to 4 tabs inside the tag:

Overview
Web
Android
iOS

The Overview tab provides basic tag information, such as Tag ID, Account, Create Time, Status, Tag Name, Update Time.
Also, in the lower part of the Overview tab is a list of all apps included in the tag.

Select

Note: By clicking the Edit button, it is possible to edit the Tag Name and Status.

Clicking on the Web tab, on the left side you can see a list of web apps included in the tag. You can easily add new apps to your tag by clicking on the Edit button, then plus button and entering the URI for the new app. Click on the red bin icon deletes a specific app.
Note: Documentation button leads you to a step-by-step guide for Web SDK integration.

Select

On the right side of the Web tab is the Code snippet which is used to add tags to your website. You will need to copy the code snippet and implement it into your website.
The code snippet is automatically changed on your site based on the toggles that are activated, and it is possible to adjust parameters such as Include subdomain, Crashlytics, Analytics, Consent and Push by simply moving the toggle.

Options you can add to code snippet are:

Include subdomain - if the toggle is turned on (green), you will have analytics on all domains that belong to the main domain of your website.
Analytics - analytics of what is happening on your site and platform. If the toggle is turned on (green), you will know how many page views you have, how long the session lasted, how many sessions there were, etc.
Crashlytics - analytics of the crash (for example, if something is not working correctly, you can see exactly where the crash occurred and which moment caused the problem).
Consent - certificates that the application owner must accept in order to use the Code snippet properly and to collect the user data.
Push - if you want to show the prompt (allow/block) on your website and send push notifications, change the toggle to green.

Next to the Code Snippet on the Web tab is a section that allows you to check if the tag is on a particular site. To check it, you should click on the edit button and then add URL of the page you want to check.

Next to the code snippet parameters are Push notification prompts.
By clicking on the button Download SW you will be able do download the .js file, and by clicking on the Add Prompt button you can add custom prompts that will be shown to the user.

Within the Custom Prompt - Configuration you can preview the state of the prompt (options are: Desktop Subscribe or Mobile Subscribe).

It’s necessary to fill in Prompt Name and depending on the Prompt Type (Push slide prompt, Subscribe notification bell, Native prompt, Link and Custom HTML) you’ll have to fill/choose different options:

Push slide prompt

Preview (Subscribe example)
Action message - message that will be shown on the prompt,
Button Subscribe/Unsubscribe,
Image - you can insert an image from the web or choose an image from media library,
On scroll/On click,
Show after - chose after how many seconds your prompt will be shown,
Add Category
Add Filters - you can define filters when the prompt will be shown on your website. Options are: config, url, hostname, query, path, referrer, window.

Config - filters the prompt based on your configuration of your tag (Include Subdomain, Analytics, Crashlytics, Consent and Push). For example, if you set the filter config analytics equal true, the prompt will be shown on your website if the analytics option is included in the tag.

Url - if you, for example choose the option url and insert https://ocamba.com/, the prompt will be shown on the mentioned website.

Hostname - if you, for example choose the option hostname and insert www.ocamba.com, the prompt will be shown on the mentioned website.

Query - if you, for example choose the option query and insert https://ocamba.com/apps?name=adex, the prompt will be shown on the mentioned website.

Path - if you, for example choose the option path and insert https://ocamba.com/apps/adex/, the prompt will be shown on the exact page of the website.

Referrer - if you, for example choose the option referrer and insert https://ocamba.com/, the prompt will be shown on your website if your previously visited the mentioned site.

Window - if you, for example choose the option window, the prompt will be shown on your website if the configuration of your website (script params) matches the values you inserted in the filter.

Select

Subscription notification bell

Preview (Never subscribed, Subscribed, Blocked, Opted Out, Subscribing, Resubscribing and Unsubscribing),
Location toggle button (left/right),
Size (small, medium, large),
Visibility toggle button,
On scroll/on click,
Offset in px (Bottom/Left/Right),
Colors (State Subscribed, State Unsubscribed, State Blocked, Accent).
Advanced options (Tooltips, Messages, Dialogs, Text Color, Tooltip Color, Messages Color and Dialog Color)
Add Filters - you can define filters when the prompt will be shown on your website. Options are: config, url, hostname, query, path, referrer, window.

Url - if you, for example choose the option url and insert https://ocamba.com/, the prompt will be shown on the mentioned website.

Hostname - if you, for example choose the option hostname and insert www.ocamba.com, the prompt will be shown on the mentioned website.

Query - if you, for example choose the option query and insert https://ocamba.com/apps?name=adex, the prompt will be shown on the mentioned website.

Path - if you, for example choose the option path and insert https://ocamba.com/apps/adex/, the prompt will be shown on the exact page of the website.

Referrer - if you, for example choose the option referrer and insert https://ocamba.com/, the prompt will be shown on your website if your previously visited the mentioned site.

Window - if you, for example choose the option window, the prompt will be shown on your website if the configuration of your website (script params) matches the values you inserted in the filter.

Select

Link prompt

Preview (Subscribed, Not Subscribed)
Code - example of the code which has to be added to the site’s markup
Style (toggle - link or button)
Color (Additional Description, Text and Button)
Size (small, medium or large)
Subscribed/Unsubscribed/Additional description
Allow unsubscribe toggle button
Add Filters - you can define filters when the prompt will be shown on your website. Options are: config, url, hostname, query, path, referrer, window.

Url - if you, for example choose the option url and insert https://ocamba.com/, the prompt will be shown on the mentioned website.

Hostname - if you, for example choose the option hostname and insert www.ocamba.com, the prompt will be shown on the mentioned website.

Query - if you, for example choose the option query and insert https://ocamba.com/apps?name=adex, the prompt will be shown on the mentioned website.

Path - if you, for example choose the option path and insert https://ocamba.com/apps/adex/, the prompt will be shown on the exact page of the website.

Referrer - if you, for example choose the option referrer and insert https://ocamba.com/, the prompt will be shown on your website if your previously visited the mentioned site.

Window - if you, for example choose the option window, the prompt will be shown on your website if the configuration of your website (script params) matches the values you inserted in the filter.

Select

Native prompt

Preview (Chrome, Firefox, Safari),
On scroll/on click,
Show after,
Add Filters - you can define filters when the prompt will be shown on your website. Options are: config, url, hostname, query, path, referrer, window.

Url - if you, for example choose the option url and insert https://ocamba.com/, the prompt will be shown on the mentioned website.

Hostname - if you, for example choose the option hostname and insert www.ocamba.com, the prompt will be shown on the mentioned website.

Query - if you, for example choose the option query and insert https://ocamba.com/apps?name=adex, the prompt will be shown on the mentioned website.

Path - if you, for example choose the option path and insert https://ocamba.com/apps/adex/, the prompt will be shown on the exact page of the website.

Referrer - if you, for example choose the option referrer and insert https://ocamba.com/, the prompt will be shown on your website if your previously visited the mentioned site.

Window - if you, for example choose the option window, the prompt will be shown on your website if the configuration of your website (script params) matches the values you inserted in the filter.

Select

Custom HTML

Preview (Custom HTML),
Code - example of the code which has to be added to the site’s markup,
Custom HTML - here you can design your own custom prompt,
On scroll/on click,
Show after,
Add Filters - you can define filters when the prompt will be shown on your website. Options are: config, url, hostname, query, path, referrer, window.

Url - if you, for example choose the option url and insert https://ocamba.com/, the prompt will be shown on the mentioned website.

Hostname - if you, for example choose the option hostname and insert www.ocamba.com, the prompt will be shown on the mentioned website.

Query - if you, for example choose the option query and insert https://ocamba.com/apps?name=adex, the prompt will be shown on the mentioned website.

Path - if you, for example choose the option path and insert https://ocamba.com/apps/adex/, the prompt will be shown on the exact page of the website.

Referrer - if you, for example choose the option referrer and insert https://ocamba.com/, the prompt will be shown on your website if your previously visited the mentioned site.

Window - if you, for example choose the option window, the prompt will be shown on your website if the configuration of your website (script params) matches the values you inserted in the filter.

Select

To save prompt click on the confirm button. Prompts that have been previously made can be edited by clicking on the settings button, and deleted by clicking on red bin icon.

Clicking on the Android tab, on the left side you can see a list of android mobile apps included in the tag.

Select

Within the Android tab, you can configure apps by uploading Firebase Admin SDK JSON and implementing the code snippet to your android app.

Also, you can easily add new apps to your tag by clicking on the plus button and entering the URI for the new app. Click on the red bin icon deletes a specific app.

Note: Documentation button leads you to a step-by-step guide for Android SDK integration.
Firebase documentation button leads you to a step-by-step guide for FCM implementation.

Clicking on the iOS tab, on the left side you can see a list of iOS mobile apps included in the tag.

Select

Within the iOS tab, you can configure apps by uploading a .p12 File, a private key password for your .p12 File, Environment (Sendbox or Production) and implementing the code snippet to your iOS app.

Also, you can easily add new apps to your tag by clicking on the plus button and entering the URI for the new app. Click on the red bin icon deletes a specific app.

Note: Documentation button leads you to a step-by-step guide for iOS SDK integration.
Push certificate button leads you to a step-by-step guide for certificate implementation.

Service Worker Configuration - You can define a (custom) service worker path within this space. The service worker path allows you to define the folder path within which an Ocamba service worker is located so that users can successfully subscribe to it.
Displaying the prompt does not depend on the service worker but on whether a tag code snippet was inserted into your website. When creating a tag, the default for the service worker path is /sw.js - if you change and rename it within your website folder, you must also change it within the service worker path field.

Select

The Push key is required for the manual setup of the service worker. If you want to manually set the code snippet to your website, follow the steps on the link: https://docs.ocamba.com/apps/hood/sdk/web/messaging/
Note: When configuring the push notifications, you will need to insert the Push Key provided by Ocamba.

Integration

Wordpress integration

Please follow this step-by-step guide for Ocamba integration into your WordPress site:

1. Log in to Word Press, and download the plugin - File Manager. When the plugin is activated, we can see our file structure within it. It is also possible to change and add files within the File Manager.

2. You need to create a Hood tag within Tags Manager and add an app as well as a prompt.

3. In the code editor, inside the head tag, add the code snippet, save, and close.

4. After that, download the SDK file and insert it into the root within the File Manager.

5. A prompt pops up by visiting the page, and after clicking on it, a native prompt pops up where we can choose to allow or block it.

Note: It is important to put sw.js in the root. If you want that script tag on other pages, you must copy it and put it inside them. A script must be entered separately for each page - otherwise, it will not work.
If you decide to change one of the toggle buttons or add a new prompt, you do not need to re-enter the code snippet; because everything changes in the background.

Groups

Groups are a standardized way of targeting.

When you click on the Groups option, you will be presented with Tags tab and Applications tab. Within Tags tab you can see a list of all your tag groups, while within Applications tab you can see a list of all your applications groups. In this list, you can preview, edit, customize and remove groups.

Select

The difference between the mentioned tabs is that you can sort your tags within Tags group by status and name.

Select

Delete a Group - click on the red bin icon next to it.

Search through Groups - click on the magnifying glass icon.

Edit Groups - click on the Edit button in the upper right corner.

Add a Group

Please follow this step by step guide for creating new group:

1. Go to the Tags Manager/Groups and click on the Add button in the upper right corner.

2. Create a name for your group and keep in mind it should be meaningful and easy for you to remember and find.

3. Customize the group by choosing its colour from the pre-set group of colours or pick a custom colour from the customer colour picker option.

4. Assign tags to your group.

5. When you are done click on the confirm button.

Select

Note: If you forgot to add an tag or you have created a new one in the mid-time, you can easily add them to the group by clicking on the Assign tags button.

Edit a Group

We have created a group in the next section as an example.

Select

If you forgot to add the Tag or you have created a new one in the mid-time, you can easily add them to the group by clicking on the Assign tags button.

When you have selected the Tags you want to add to the group click on the confirm button.

If you did it by mistake, click on the cancel button.

To unassign the tag click on the Bulk option and selected the tags you want to unassign.

Once you’ve selected all the tags you want to unassign click on the unassign button from the drop-down menu in the Bulk.

Did you find this doc useful?

Your feedback helps us improve our docs.