Tag management API

Usage notes

• Scope: You can bind tags to and unbind tags from a device.

• Tag limits: An application can define up to 10,000 tags. Each tag can be up to 128 characters long, where each Chinese character is counted as a single character.

• Effective time: Bind and unbind operations take effect within 10 minutes.

• Performance recommendation: Avoid binding more than 100,000 devices to a single tag, as this can cause long processing times and affect response speed. In such cases, consider using a broadcast or splitting devices into more granular tags and calling the push API multiple times.

• Unbinding tags: Unbinding a tag only removes the association between the device and the tag; it does not delete the tag. The system does not currently support deleting tags.

• Listing tags: You can list the tags currently bound to a device.

Bind tags

Binds one or more tags to a device.

+ (void)bindTag:(int)target
       withTags:(NSArray *)tags
      withAlias:(NSString *)alias
   withCallback:(CallbackHandler)callback;

Unbind tags

Unbinds one or more tags from a device.

+ (void)unbindTag:(int)target
         withTags:(NSArray *)tags
        withAlias:(NSString *)alias
     withCallback:(CallbackHandler)callback;

List tags

Lists the tags bound to a device.

+ (void)listTags:(int)target
    withCallback:(CallbackHandler)callback;

CloudPushSDK.listTags(1) { res in
    if res.success {
        var tags: [String] = []
        if let data = res.data as? String, data.count > 0 {
            tags = data.components(separatedBy: ",")
        }
        print("Successfully listed device tags: \(tags)")
    } else {
        if let error = res.error {
            print("Failed to list device tags: \(error)")
        }
    }
}

[CloudPushSDK listTags:1 withCallback:^(CloudPushCallbackResult *res) {
    if (res.success) {
        NSArray<NSString *> * tags;
        if ([res.data length] > 0) {
             tags = [res.data componentsSeparatedByString:@","];
        }
        NSLog(@"Successfully listed device tags: %@", tags);
    } else {
        NSLog(@"Failed to list device tags: %@", res.error);
    }
}];