Frequently asked questions

Find the answers here

Sign-up

How is Bibblio’s service packaged?

Bibblio is available as a Self-serve or Enterprise package.

Under Self-serve, you can choose a monthly subscription plan that's sized to suit your catalog and usage needs, starting at $19 per month. You can be up and running in minutes. You can also try Bibblio for free on a starter plan, which will allow you up to 25,000 recommendation calls per month across 500 content items.

The Enterprise package is for those who want to maximize Bibblio's potential by having us work with you in areas such as trial setup, implementation guidance, commercial advice, and UX best practice. In-person support channels and a service-level agreement guarantees a lasting relationship that will pay dividends. It's the whole toolbox with a team behind you!

What are 'content items'?

A content item is any article or page within your catalog that you want to provide recommendations to and from. Sets of metadata are collected for each content item, which is then stored in our Smart Graph.

What are 'recommendation calls'?

A recommendation call happens when a set of recommendations is served to your web page. This is achieved via a request to the discovery endpoint of the Bibblio API.

For Self-serve plans, is there a sign-up cost on top of my monthly fee?

No, there are no hidden costs to sign up.

Which payment methods does Bibblio support?

We accept all major debit and credit cards.

Account

I’ve forgotten my password. How do I retrieve it?

If you have forgotten your password you will need to reset it. You can do so here.

Can I change the email address associated with my account?

Yes, you can. If you’re logged into Bibblio, just select Account and then Edit Personal Details. Your email and other details can be updated there.

There are several people in my organisation who need to use Bibblio. Can we have multiple users on one account?

Not currently, but watch this space.

Integration

How do I get Bibblio on my site?

Once signed up you can get going instantly by adding a code snippet to the pages you wish to recommend from and to. Our snippet wizard lets you choose how you'd like your recommendation module to look and whitelist the domains that house your content.

If you’re on WordPress, you can also get up and running rapidly by using our Wordpress plugin instead.

Alternatively, you can work with the API itself. Our documentation generates basic scaffold code for each endpoint in a wide variety of languages. You can find it by switching to the console mode on an endpoint, calling the resource, clicking Code Example, then selecting your language.

Which spoken languages does Bibblio support?

We can produce recommendations for all languages using the Latin alphabet, and we can generate in-depth semantic analysis for Dutch, English, French, German, Italian, Mandarin, Polish, Portuguese, Russian, Spanish and Swedish.

Which content formats can Bibblio enrich with metadata?

Currently Bibblio can only enrich text, but we’re working on accommodating speech and video in the near future. Get in touch if you would like to be involved in a preliminary speech or video project with us.

How do I need to format content for Bibblio’s API?

At the moment, content needs to be formatted in valid JSON to be pushed to our API, but we’re currently working on tools to help with URL scraping and pulling directly from RSS feeds.

Is there a maximum file size for content?

The maximum size for an individual item of content is currently 200 KB.

I'm getting a 422 error response when I try to ingest. What's going on?

A 422 is often because the payload is invalid. For example, required fields could be omitted or dates might be incorrectly formatted.

If that doesn’t seem to be the case, please get in touch.

Enrichment metadata

What is metadata?

Metadata is data about data. Bibblio’s metadata is split into structural metadata about the data container (the file), and descriptive metadata about the content itself, such as the relevant keywords in an article. Descriptive metadata is what Bibblio creates, and it serves as a factor in our recommendations.

If you want to dig a little deeper, check out the Wikipedia entry on metadata.

Are tags automatically added to my content?

Metadata is automatically added to the content items, but it won’t appear as tags on your web page or platform unless you engineer that.

Will you match the tags you produce to a taxonomy that I’ve created for my content?

In order to make the tags generally applicable, we don’t match tags to individual client taxonomies. Any filtering of Bibblio’s tags based on a pre-existing taxonomy would have to be accomplished through logic on your side.

When I call for the enrichment results from your enrichment endpoint, I get empty arrays for metadata in the response. How can I solve this?

You may not have supplied enough text to derive concepts, keywords, entities and alignments. (Generally, a few lines of text should be sufficient.) Alternatively, the text might be in a language that our enrichment endpoint does not currently support.

When I call for enrichment results, I get an "Unauthorised" response. How can I solve this?

Your access token is probably not valid anymore. We mitigate the risk of exposing user credentials by using a temporary token according to the OAuth2 Bearer Token authentication mechanism. You'll notice an expires_in field in the token response. Clients generally create an authorization wrapper that renews the access token according to the expires_in value provided by the token endpoint. Learn how to get a new token.

If you’re experiencing this problem while using a valid access token, please get in touch.

Content recommendations

What is discovery?

When we speak about discovery, we mean the process through which a user finds and interacts with content, whether that’s by traditional search, on-platform content recommendations, or in the form of a personalized newsletter.

Does Bibblio drop any third-party tracking cookies on my page?

Bibblio does not drop any cookies on the page. All user tracking is carried out from within the related content module itself, or is sent to us directly by our partners.

Do Bibblio recommendations ever include paid-for third-party content?

Not by default, but Bibblio’s technology can be used to recommend sponsored content, if required. Despite being sponsored, it will still only recommend those items that are actually relevant to the article the user is currently reading.

Are Bibblio’s recommendations personalized?

Yes, our recommendations are tailored to the user they’re presented to. We integrate user session data with our in-depth content analysis approach to create a more personalized recommendation experience.

How can I add Bibblio’s pre-built recommendation modules to my content pages?

The JavaScript and CSS can be installed with Bower by running:

bower install bibblio-related-content-module

Here are further details on how to get started.

Do your modules work on mobile?

They do! Our modules are fully responsive, collapsing gracefully for display on the smallest devices.

Do I have to use your modules?

You can use the recommendations however you like, but our elegantly designed modules are ready to go and fully customisable. For most clients they make getting recommendations a lot more convenient. In addition, we also track user behaviour directly through our module.

Do you offer cross-browser support for your module integration?

We offer support across all major browsers (Chrome, Firefox, Safari etc.).

Is the module asynchronous, or does it block rendering?

The module does not block rendering. The module populates an HTML element of your choice with content. An empty <div> (or any tag) can be rendered quickly, and the module can be initiated to fill it with content at any point during page load, such as page ready. Any delay in loading the module content will not affect the rest of the page in any way.

Does Bibblio use a content delivery network for serving the assets, or would Bibblio be serving them from my server?

We store the source URL and module image URL when you add the content, so we can easily populate the module and don’t double up on server storage. When the user clicks, we simply send the user to the original content URL.

Can I organise and group my content items for discovery?

Content items can be grouped into what we call ‘catalogues,’ which means you can organise your content to ensure that certain topics and genres are only recommended on certain parts of your platform.

How do I manage different sections of my catalogue and exclude content from a particular catalogue from recommendations?

You can learn more about catalogue management here.

Can you recommend content from outside my platform?

We are in the process of enabling 'open catalogues' which means that anyone using Bibblio’s service will be able to access content from our curated open catalogues or from other Bibblio clients who open their catalogues. As a client, you will also be able to distribute your content to other users.

What sort of reporting and tracking of enrichment and recommendation does Bibblio support?

Our dashboard allows you to see how many enriched content items you have stored in Bibblio’s Smart Graph and how many recommendations have been served, both monthly and in total.

Performance

Will querying Bibblio’s service affect the latency of my platform?

The latency of recommendation delivery via our modules is below 400 milliseconds, which is often quicker than the other page elements on our clients’ platforms.

How performant is the API, both for initial data import and recommendations?

On average, you can expect recommendations to take between 150ms and 1000ms, and the response times for content item ingestions are roughly the same (from the UK).

Compliance

How is Bibblio GDPR compliant?

We do not process any personal information from visitors on a customer's page, and we only process personal information from our customers when strictly necessary to provide our services. We are committed to being fully transparent regarding our processing of customers' data. For more information, read our full Privacy Policy.

What data do you collect from your customers?

  • When you register for a Bibblio account, we ask for your contact details and your credit card details if you are on one of our paid plans. We do not collect payment information directly and the processing of such information is made by our trusted third-party service providers.

  • We have access to your user ID and your Explorer page, your content items and the tracking data generated from having the module on your page.

  • The content items you add on Bibblio in order to generate recommendations may contain some personal information (For example, if you submit articles from your personal blog).

  • The anonymized metadata generated from your content gets used by Bibblio to improve our algorithms and for the purposes of fulfilling our obligations under the Terms of Service.

  • When browsing our site (bibblio.org), we collect navigation information and preferences through the use of Cookies.

Does Bibblio collect personal information from visitors on my site?

  • Our module on a customer’s page only collects anonymous data from the visitors. The module tracks data about whether a recommendation has been viewed/clicked but does not link to a specific session. Customers can access this data at any time through their Explorer page.

  • Our module does not drop cookies from a customer’s page during a visitor’s session.

How long do you keep data for?

  • Content items you send are deleted once you deactivate your account.

  • Tracking data about visitors stops as soon as you remove the module from your page.

  • We keep customer data such as purchase history, communication logs, and contact details up to 2 years after you stop being a Bibblio customer, unless you submit a request for deletion. After this date, data is reviewed and if deemed not necessary for any ongoing legitimate business/lawful purposes, we will either delete or anonymize it. Contact us for more detailed information about our data retention policy.

Do you share customer data with anyone?

  • We do not sell your information to anyone.

  • Raw data generated from your use of the Services is only kept to improve our algorithms and isn’t shared with anyone beyond this scope.

  • We use a range of service providers to run our daily operations, which involves handling customer data. We only share personal information with them when strictly necessary for fulfilling our contractual obligations with the customer. Our third-party service providers all operate under a Data Processing Agreement (DPA), meaning that we only work with companies who have provided us with sufficient guarantees that the requirements of the GDPR will be met and the rights of our customers protected. We can provide the full list of service providers upon request or through the Bibblio employee you are usually in contact with.

What measures did you take to secure customer data?

We take several measures to ensure your data is safe with us:

  • Your Explorer page is secured using SSL.

  • Your data is only handled by our personnel and approved processors.

  • Our employees do not keep any customer data outside of a password-protected and/or secured network

  • We haven’t had any data breaches, but if such an incident were to occur you would be informed within 72 hours by telephone or email. Any data breach incident will be documented in our Privacy Policy.

Regarding third party service providers:

  • Our service providers are legally required to disclose any data breach in their system within 72 hours.

  • We use PCI-compliant service providers to process your payment.

  • All transfers involving customer data are encrypted.

Do you transfer data outside of Europe?

  • Your Explorer page is secured using SSL.

  • We mostly rely on cloud services for data hosting, which means data may be transferred outside of countries under GDPR.

  • Using our services means you adhere to your information being transferred outside of your country of residence.

  • When third party service providers are located in the US, they all participate with and adhere to the Privacy Shield framework.

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

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