Quick Start FAQ

Answers to your Quick Start wizard questions

Refer to this FAQ if you're using our Quick Start wizard to generate JavaScript snippets. If you’re using our WordPress plugin, go here. For a classic API integration, check our docs, our GitHub or get in touch.

Design

Can I have a module that is text-only?

The version 4.0 of our module includes two text-only options: a list of 3 and a list of 6 recommendations. To enable this feature, make sure our js and css assets are on 4.0 or above and include the following style classes: bib--txt-3 or bib--txt-6. This should be added instead of any grid ("grd"), row ("row"), or column ("col") style class you may already have in your snippet. 

Can I make Bibblio’s appearance match my theme?

If you wish to use your own fonts, or make any other changes, you can do this within your own stylesheet. Be sure your stylesheet loads after ours, and include !important in the parameter to guarantee you'll override our settings.

Can I choose a thumbnail image, or edit the recommendation's title?

We are working on updating your Bibblio dashboard so you can make edits to the content we have imported. This will include updating thumbnail images, dates, titles, and more so watch this space!

Do you support AMP?

Bibblio is compatible with AMP using an amp-iframe. You will need to have access to your AMP template and use a different snippet available on our GitHub page. You’ll just have to make the following changes:

  • delete the parameter contentItemId=YOUR_CONTENT_ITEM_ID
  • Add the parameter autoIngestion=true

This will ensure we automatically import your articles and retrieve recommendations.

Control

What information am I able to display on the module?

With our current version, you can have the title, excerpt, published date and author displayed. You can also choose to show an information icon at the bottom of your module with a link to help your users understand what these recommendations are.

Can I separate my content into groups?

Yes, you can separate your content into different folders or catalogues. This is helpful if you have different types of content that shouldn’t appear in the same widget, like videos and articles, or French and Italian versions of the same article. Just add data-auto-ingestion-custom-catalogue-id="YOUR_CATALOGUE_NAME" to automatically create and import your content to a catalogue.

Can I influence which recommendations are shown?

By default, your recommendations are influenced not only by how semantically similar they are, but also by how popular they are with your audience. This optimized algorithm learns which recommendations will generate the most clicks for a piece of content by exploring the content space and making predictions based on interaction data.

You can change to a non-optimised algorithm to see more semantically-related items only. We will still collect data for our machine-learning model via this method, so that you can revert to the optimized algorithm once it has enough data to make strong predictions.

This may also be useful if you have more than one Bibblio module on a page - they will show different recommendations, so your readers will be offered more variety.

For more information on how these algorithms work, read how we built it.

Which recency setting should I choose for my site?

You can prioritize recency so that posts published within a chosen time span are more likely to appear as recommendations. (Older articles may still appear, but only if they're extremely relevant.) Factors such as frequency of publication, total volume of articles and value of your historic content can help you determine which setting will work best for you, or whether you need to influence your recommendations with recency at all.

For example, if your content is evergreen (e.g. recipes, DIY tips, arts and crafts etc.), we recommend switching the setting off completely. News-oriented sites with fewer than 5 articles posted a day will be fine with a setting between 14 and 30 days, while sites with highly perishable content might want a more aggressive setting, between 1 and 7 days.

If you’re still not sure, don’t forget that nothing is set in stone - you can adjust the setting at any point in the Content section of your Bibblio account. Changes take 24 hours to come into effect, so we recommend waiting a few days to see how it impacts your site.

Can I hide my module at any time?

Yes, you can. Just add data-hidden=true to the snippet tag. Note that during the installation, a grey box will appear instead of the module with the message “Bibblio is busy indexing content”. If you want to hide this from your users, you can use that parameter. Don’t forget to remove it after 48 hours, at which point we would have generated an initial set of recommendations for your site.

How can I update my module’s parameters and layout?

We do not currently have an interface for updating your module’s design and settings, so you’ll need to generate a new snippet and re-deploy. You can find the module designer that will generate the snippet in your Bibblio dashboard under Quick Start Code.

Performance

Will the snippet slow down my site?

Our JS will only execute once your page has finished loading in order to keep your site fast.

The images we use for the thumbnails are served from your site, so if you are concerned about speed test scores, make sure the first image in your posts is not too heavy and in a next-gen format.

Can I test Bibblio on a staging environment?

You can test us on a staging site as long as it isn’t password-protected and you have whitelisted it on your Bibblio account. Don’t forget to visit the URLs to allow the scraping to kick in. We need a minimum of five URLs to generate recommendations.

How long does it take for the module to appear on my site?

Once you drop the code on your site, we need to scrape your pages and generate recommendations. During the first installation it may take between ten minutes and a couple of hours, depending on your traffic and the size of your corpus. If you have more than a few thousand content items, we recommend importing your posts whilst in hidden mode.

Once the module is live and we have some click data, we will generate a set of popular recommendations across your whole corpus. Any newly published article will show these popular suggestions automatically, while the actual recommendations are being generated, so you’ll never miss out on engagement.

How can I track Bibblio on my analytics platform?

You can add tracking parameters to your snippet using the third step of the wizard. Under Add Tracking,  click Create new tracking parameter. Add a name for the parameter and its value, then click Add to snippet. A line in your snippet will look similar to this:

data-query-string-params="utm_source=Bibblio"

Repeat this process for each parameter you would like added.

Still haven't found what you’re looking for?

Please get in touch. We’ll get back to you as soon as we can.