com.segment.analytics.integrations.BasePayload Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of analytics Show documentation
The hassle-free way to add analytics to your Android app.
There is a newer version: 4.11.3
/*
 * The MIT License (MIT)
 *
 * Copyright (c) 2014 Segment, Inc.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

package com.segment.analytics.integrations;

import com.segment.analytics.AnalyticsContext;
import com.segment.analytics.Options;
import com.segment.analytics.ValueMap;
import java.util.Date;
import java.util.UUID;

import static com.segment.analytics.internal.Utils.isNullOrEmpty;
import static com.segment.analytics.internal.Utils.toISO8601Date;

/**
 * A payload object that will be sent to the server. Clients will not decode instances of this
 * directly, but through one if it's subclasses.
 */
// This ignores projectId, receivedAt and version that are set by the server.
// sentAt is set on SegmentClient#BatchPayload
public abstract class BasePayload extends ValueMap {
  private static final String TYPE_KEY = "type";
  private static final String ANONYMOUS_ID_KEY = "anonymousId";
  private static final String CHANNEL_KEY = "channel";
  private static final String MESSAGE_ID = "messageId";
  private static final String CONTEXT_KEY = "context";
  private static final String INTEGRATIONS_KEY = "integrations";
  /** The timestamp when the message took place. This should be an ISO-8601-formatted string. */
  private static final String TIMESTAMP_KEY = "timestamp";
  protected static final String USER_ID_KEY = "userId";

  public BasePayload(Type type, AnalyticsContext context, Options options) {
    AnalyticsContext contextCopy = context.unmodifiableCopy();
    put(MESSAGE_ID, UUID.randomUUID().toString());
    put(TYPE_KEY, type);
    put(CHANNEL_KEY, Channel.mobile);
    put(CONTEXT_KEY, contextCopy);
    put(ANONYMOUS_ID_KEY, contextCopy.traits().anonymousId());
    String userId = contextCopy.traits().userId();
    if (!isNullOrEmpty(userId)) {
      put(USER_ID_KEY, userId);
    }
    put(TIMESTAMP_KEY, toISO8601Date(new Date()));
    put(INTEGRATIONS_KEY, options.integrations()); // uses a copy
  }

  /** The type of message. */
  public Type type() {
    return getEnum(Type.class, TYPE_KEY);
  }

  /**
   * The user ID is an identifier that unique identifies the user in your database. Ideally it
   * should not be an email address, because emails can change, whereas a database ID can't.
   */
  public String userId() {
    return getString(USER_ID_KEY);
  }

  /**
   * The anonymous ID is an identifier that uniquely (or close enough) identifies the user, but
   * isn't from your database. This is useful in cases where you are able to uniquely identifier
   * the user between visits before they signup thanks to a cookie, or session ID or device ID. In
   * our mobile and browser libraries we will automatically handle sending the anonymous ID.
   */
  public String anonymousId() {
    return getString(ANONYMOUS_ID_KEY);
  }

  /** A randomly generated unique id for this message. */
  public String messageId() {
    return getString(MESSAGE_ID);
  }

  /**
   * A dictionary of integration names that the message should be proxied to. 'All' is a special
   * name that applies when no key for a specific integration is found, and is case-insensitive.
   */
  public ValueMap integrations() {
    return getValueMap(INTEGRATIONS_KEY);
  }

  /**
   * The context is a dictionary of extra information that provides useful context about a message,
   * for example ip address or locale. This dictionary is loosely speced, but you can also add your
   * own context, for example app.name or app.version. Check out the existing spec'ed properties in
   * the context before adding your own.
   */
  public AnalyticsContext context() {
    return getValueMap(CONTEXT_KEY, AnalyticsContext.class);
  }

  @Override public BasePayload putValue(String key, Object value) {
    super.putValue(key, value);
    return this;
  }

  /** @see #TYPE_KEY */
  public enum Type {
    alias, group, identify, screen, track
  }

  /**
   * The channel where the request originated from: server, browser or mobile. In the future we may
   * add additional channels as we add libraries, for example console.
   * 
   * This is always {@link Channel#mobile} for us.
   */
  public enum Channel {
    browser, mobile, server
  }
}