Classes

Methods

constructor

For a complete configuration of the Mapp Intelligence Hybrid please check Configuration.

/**
 * @param config Mapp Intelligence configuration
 */
MappIntelligenceHybrid mappIntelligenceHybrid = new MappIntelligenceHybrid(MappIntelligenceConfig config);

track

Reads all query parameters from the current request URL and saves the request in the internal queues and sent at defined intervals or via flush call.

mappIntelligenceHybrid.track();

/**
 * @param rURL request url with query parameters
 */
mappIntelligenceHybrid.track(String rURL);

flush

Here you can explicitly tell to send the data to the Mapp tracking servers.

/**
 *
 */
mappIntelligenceHybrid.flush();

setOnFlushComplete

Here you can define a callback method that is automatically called after each flush. The first argument is the status of the request dispatch. The second argument specifies which queue was involved.

/**
 * @param callback Callback for complete flushing
 */
mappIntelligenceHybrid.setOnFlushComplete(BiConsumer<Boolean, Integer> callback);

getResponseAsString

As response, the method returns a 1x1px transparent gif, which you then returned to the client.

/**
 * @return Returns a 1x1px transparent gif as string.
 */
String imageString = mappIntelligenceHybrid.getResponseAsString();

getResponseAsBytes

As response, the method returns a 1x1px transparent gif, which you then returned to the client.

/**
 * @return Returns a 1x1px transparent gif as byte array.
 */
byte[] imageBytes = mappIntelligenceHybrid.getResponseAsBytes();

Example

package demo.servlets;
import com.mapp.intelligence.tracking.MappIntelligence;
import com.mapp.intelligence.tracking.MappIntelligenceCookie;
import com.mapp.intelligence.tracking.config.MappIntelligenceConfig;
import com.mapp.intelligence.tracking.core.MappIntelligenceHybrid;

import javax.imageio.ImageIO;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.Cookie;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.awt.image.BufferedImage;
import java.io.ByteArrayInputStream;
import java.io.IOException;
import java.io.OutputStream;

@WebServlet("/pix/*")
public class TrackingServlet extends HttpServlet {
    public TrackingServlet() {
        super();
    }

    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // set tracking configuration
		MappIntelligenceConfig mappConfig = new MappIntelligenceConfig()
            .setTrackId("111111111111111")
            .setTrackDomain("analytics01.wt-eu02.net")
            .setReferrerURL(request.getHeader("Referer"))
            .setRequestURL(request.getRequestURL().toString())
            .setRemoteAddress(request.getRemoteAddr())
            .setUserAgent(request.getHeader("User-Agent"));

		// read out all client cookies and add them to the configuration
        Cookie[] cookies = request.getCookies();
        if (cookies != null) {
            for (Cookie cookie : cookies) {
                mappConfig.addCookie(cookie.getName(), cookie.getValue());
            }
        }
        mappIntelligenceHybrid mappHybrid = new mappIntelligenceHybrid(mappConfig);

		// writes the incoming request to the Mapp Intelligence request queue
        mappHybrid.track();
        // sends the request directly to the Mapp Intelligence server
        mappHybrid.flush();

		// set content-type and length
        response.setContentType("image/gif");
        response.setContentLength(43);

		// read out the existing Mapp Intelligence user cookie
        MappIntelligenceCookie mappUserCookie = mappHybrid.getUserIdCookie(MappIntelligence.SMART, MappIntelligence.CLIENT_SIDE_COOKIE);
        if (mappUserCookie != null) {
			// create an cookie
            Cookie mappUserCookieResponse = new Cookie(mappUserCookie.getName(), mappUserCookie.getValue());
            mappUserCookieResponse.setHttpOnly(mappUserCookie.isHttpOnly());
            mappUserCookieResponse.setSecure(mappUserCookie.isSecure());
            mappUserCookieResponse.setDomain(mappUserCookie.getDomain());
            mappUserCookieResponse.setPath(mappUserCookie.getPath());
            mappUserCookieResponse.setMaxAge(mappUserCookie.getMaxAge());
			// add the cookie to the response
            response.addCookie(mappUserCookieResponse);
        }

		// send an 1x1 pixel transparent gif back to the client
        byte[] imgBytes = mappHybrid.getResponseAsBytes();
        OutputStream out = response.getOutputStream();
        BufferedImage bufImg = ImageIO.read(new ByteArrayInputStream(imgBytes));
        ImageIO.write(bufImg, "gif", out);
    }

    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        this.doGet(request, response);
    }
}