Customer Tags

Use these APIs to attach or remove tags from customers, helping categorize and personalize customer profiles. Tags allow for better targeting of rewards, engagement, and marketing efforts.

Available APIs


POST - Attach Customers Tags

https://api.gameball.co/api/v4/integrations/customers/{customerId}/tags

The API call attach tags to a customer identified by customerId. This helps categorize and personalize customer profiles for more targeted engagement and marketing strategies.

Security: Requires webkey and secretkey headers.

Channel Merging Available If your system uses different customer IDs across multiple channels (e.g., online and offline), Gameball's channel merging feature helps unify customer profiles. By including the customer’s mobile number or email (based on your merging configuration) with each request, Gameball will combine activities into a single profile.For more information, head to the Channel Merging Guide.

Request

Path Parameters

customerId string Required Unique identifier for the customer that you can reference across the customer’s whole lifetime. Could be a database ID, random string, email, or anything that uniquely identifies the customer.


Body

application/json

tags string Required A list of tags or labels associated with the customer. These tags are used to categorize customers for personalized marketing campaigns, rewards, and tailored communications. Tags can represent customer preferences, behaviors, or any other custom categories relevant to your business.


Sample Request

{
    "tags": "gamer, loyal"
}

DELETE - Remove Customers Tags

https://api.gameball.co/api/v4/integrations/customers/{customerId}/tags

The API call removes tags from the customer identified by customerId. This allows for updating customer categorization by de-attaching tags no longer relevant for engagement or marketing purposes.

Security: Requires webkey and secretkey headers.

Channel Merging Available If your system uses different customer IDs across multiple channels (e.g., online and offline), Gameball's channel merging feature helps unify customer profiles. By including the customer’s mobile number or email (based on your merging configuration) with each request, Gameball will combine activities into a single profile.For more information, head to the Channel Merging Guide.

Request

Path Parameters

customerId string Required Unique identifier for the customer that you can reference across the customer’s whole lifetime. Could be a database ID, random string, email, or anything that uniquely identifies the customer.


Body

application/json

tags string Required A list of tags or labels associated with the customer. These tags are used to categorize customers for personalized marketing campaigns, rewards, and tailored communications. Tags can represent customer preferences, behaviors, or any other custom categories relevant to your business.


Sample Request

{
    "tags": "gamer, loyal"
}

Last updated