First Spirit Integration Guide

⌘K

First Spirit Integration Guide

Integration Options

The Adtelligence platform can be flexibly integrated. The type of integration depends on the customer’s set-up and business case and can be specifically adapted to different needs at any time.

1. Easy, risk-free start via JavaScript integration

  • Easy integration with Java Script via copy & paste (as with Web Analytics).
  • JavaScript manages all communication with the Adtelligence platform
  • Hosting of website content either via Adtelligence or customer server

2. Server-side integration for landing pages

  • Integration into the web landscape via new pages to be created, hosted via subdomain
  • Communication with Adtelligence platform via REST API
  • Hosting either via Adtelligence or on customer server

3. Integration into the CMS / portal, Adtelligence acts as the brain of the CMS

  • Deep integration into the customer’s CMS
  • Content can be maintained in the customer’s CMS
  • The Adtelligence platform takes over the playout logic of the website content
  • Hosting remains with the customer
  • Content management in the CMS results in integration with special attention to high IT security specifications

The requirement to manage the content in the FirstSpirit CMS is fulfilled by integration option 3. The special feature of FirstSpirit is that it is an offline CMS. This document describes integration option 3 below, specifically for the FirstSpirit CMS.

Integration of Adtelligence into FirstSpirit CMS

1. Schema

The Schema describes the possible technical setup:

2. Data flow

  • A customer reaches the website.
  • Various page contents and variants are maintained in the CMS FirstSpirit. The CMS holds these variants, and the web browser loads the page content from FirstSpirit. In the following, Adtelligence selects the specific page content for the visitor.
  • The Adtelligence platform knows the available variants and controls the personalization.
  • A request is sent in parallel from the website to the Adtelligence platform, including all available data about the visitor. These are, for example, freely available context data such as time, day of the week, device, browser, or marketing data such as campaign name or keyword. Depending on the setup, the data can vary. The parameters to be used are agreed with the customer and depend on what data the customer can provide. Adtelligence does not bring any data and works strictly in accordance with data protection.
  • The Adtelligence platform decides which CMS website content is displayed to the visitor based on the visitor data.
  • The Adtelligence platform transmits the ID of the page content, the visitor’s web browser displays the selected variant.

The request and decision process occurs in parallel with the page loading with minimal latency within a few milliseconds, so there is no noticeable slowdown in loading times for the visitor due to personalization.

3. Communication flow between browser, web server & Adtelligence platform

The sequence diagram shows the runtime communication that takes place between the browser, the server and the Adtelligence platform.

  1. JavaScript component is loaded
  2. relevant data is read from the URL and the cookies
  3. asynchronous request to Adtelligence platform is started
  4. the rest of the page is loaded in parallel
  5. when the request comes back from the Adtelligence platform with the variant ID, there are two options (design decision is made during the final implementation):
    • the selected variant is already loaded and displayed (no delay, initial data volume higher)
    • the selected variant will be loaded in another request (small delay, initial data volume lower)

4. Hosting & Content Management

The following scheme describes the possible hosting:

  • The customer website and all page variations and content elements are created and managed in FirstSpirit CMS – hosted on the customer server. No content is maintained in the Adtelligence platform.
  • The Adtelligence Platform is hosted on an Adtelligence server in the data center.
  • Every Adtelligence customer receives self-contained data storage in the Adtelligence data center. All servers are located in Germany and offer the latest security certificates, which can be provided upon request. Adtelligence works with anonymized target group segments – no personal data is used for machine learning. No data of two customers is mixed, no customer gets access to data of other customers
    • ISO 27001 certification of the data center
    • All servers offer the latest security certificates
    • Efficient monitoring solutions for compliance with security policies
    • Securing of database queries by Prepared Statements against SQL injection
    • Server protection through latest firewall and IDS technologies
    • Rights/role concepts at application level
    • Regular internal and external training of Adtelligence staff on data protection & IT security

Technical Implementation

The technical implementation of the planned setup is implemented together with the customer’s IT to guarantee a smooth process. It is not necessary for Adtelligence to have access to the CMS.

https

The code snippet for the Adtelligence Platform integration complies with HTTPS as a security standard.

Service Level Agreement

Service Level Agreement: Standard 99.5% uptime guaranteed, increase to 99.9% possible upon request.

 

Wie können wir helfen?