pushwoosh/com.pushwoosh.tags/TagsBundle/Builder

Builder

open class Builder

Builder for constructing TagsBundle instances using the Builder pattern.

The Builder allows efficient, fluent construction of tag collections through method chaining. All tag additions are stored client-side until build is called to create an immutable TagsBundle. The actual synchronization with Pushwoosh servers happens when you call sendTags.

Thread Safety: This builder uses ConcurrentHashMap internally, making it safe to add tags from multiple threads during construction.

Batching Best Practice: When setting multiple tags, always use a single Builder instance and one sendTags call instead of multiple individual tag operations. This reduces network requests and improves performance.

Usage Example (Fitness App):


	TagsBundle userProfile = new TagsBundle.Builder()
	    // Demographics
	    .putInt("age", 28)
	    .putString("gender", "female")
	    .putString("fitness_level", "intermediate")
	
	    // Activity tracking
	    .putInt("workouts_completed", 45)
	    .putDate("last_workout", new Date())
	    .putList("favorite_activities", Arrays.asList("yoga", "running", "cycling"))
	
	    // Subscription status
	    .putBoolean("premium_member", true)
	    .putLong("subscription_end", System.currentTimeMillis() + 30L * 24 * 60 * 60 * 1000)
	
	    // Preferences
	    .putBoolean("push_workouts", true)
	    .putBoolean("push_achievements", true)
	    .build();
	
	// Send all tags in one request
	Pushwoosh.getInstance().sendTags(userProfile);