@Nullable public static String getDimension(TrackMe trackMe, int dimensionId) { return trackMe.get(formatDimensionId(dimensionId)); }
@Nullable public static String getDimension(TrackMe trackMe, int dimensionId) { return trackMe.get(formatDimensionId(dimensionId)); }
/** * This method sets a tracking API parameter dimension%dimensionId%=%dimensionValue%. * Eg dimension1=foo or dimension2=bar. * So the tracking API parameter starts with dimension followed by the set dimensionId. * <p> * Requires <a href="https://plugins.matomo.org/CustomDimensions">Custom Dimensions</a> plugin (server-side) * * @param trackMe into which the data should be inserted * @param dimensionId accepts values greater than 0 * @param dimensionValue is limited to 255 characters, you can pass null to delete a value * @return true if the value was valid */ public static boolean setDimension(@NonNull TrackMe trackMe, int dimensionId, @Nullable String dimensionValue) { if (dimensionId < 1) { Timber.tag(TAG).e("dimensionId should be great than 0 (arg: %d)", dimensionId); return false; } if (dimensionValue != null && dimensionValue.length() > 255) { dimensionValue = dimensionValue.substring(0, 255); Timber.tag(TAG).w("dimensionValue was truncated to 255 chars."); } if (dimensionValue != null && dimensionValue.length() == 0) { dimensionValue = null; } trackMe.set(formatDimensionId(dimensionId), dimensionValue); return true; }
/** * This method sets a tracking API parameter dimension%dimensionId%=%dimensionValue%. * Eg dimension1=foo or dimension2=bar. * So the tracking API parameter starts with dimension followed by the set dimensionId. * <p> * Requires <a href="https://plugins.matomo.org/CustomDimensions">Custom Dimensions</a> plugin (server-side) * * @param trackMe into which the data should be inserted * @param dimensionId accepts values greater than 0 * @param dimensionValue is limited to 255 characters, you can pass null to delete a value * @return true if the value was valid */ public static boolean setDimension(@NonNull TrackMe trackMe, int dimensionId, @Nullable String dimensionValue) { if (dimensionId < 1) { Timber.tag(TAG).e("dimensionId should be great than 0 (arg: %d)", dimensionId); return false; } if (dimensionValue != null && dimensionValue.length() > 255) { dimensionValue = dimensionValue.substring(0, 255); Timber.tag(TAG).w("dimensionValue was truncated to 255 chars."); } if (dimensionValue != null && dimensionValue.length() == 0) { dimensionValue = null; } trackMe.set(formatDimensionId(dimensionId), dimensionValue); return true; }