add campaign to getShortURlRL methods

Author: ahmednawar

Branch-SDK/Branch-SDK/BNCLinkData.h

@@ -23,6 +23,7 @@ typedef NS_ENUM(NSUInteger, BranchLinkType) {
 - (void)setupChannel:(NSString *)channel;
 - (void)setupFeature:(NSString *)feature;
 - (void)setupStage:(NSString *)stage;
+- (void)setupCampaign:(NSString *)campaign;
 - (void)setupParams:(NSDictionary *)params;
 - (void)setupMatchDuration:(NSUInteger)duration;
 - (void)setupIgnoreUAString:(NSString *)ignoreUAString;

Branch-SDK/Branch-SDK/BNCLinkData.m

@@ -17,6 +17,7 @@ @interface BNCLinkData ()
 @property (strong, nonatomic) NSString *channel;
 @property (strong, nonatomic) NSString *feature;
 @property (strong, nonatomic) NSString *stage;
+@property (strong, nonatomic) NSString *campaign;
 @property (strong, nonatomic) NSDictionary *params;
 @property (strong, nonatomic) NSString *ignoreUAString;
 @property (assign, nonatomic) BranchLinkType type;
@@ -90,6 +91,14 @@ - (void)setupStage:(NSString *)stage {
     }
 }
 
+- (void)setupCampaign:(NSString *)campaign {
+    if (campaign) {
+        _campaign = campaign;
+        
+        self.data[BRANCH_REQUEST_KEY_URL_CAMPAIGN] = campaign;
+    }
+}
+
 - (void)setupIgnoreUAString:(NSString *)ignoreUAString {
     if (ignoreUAString) {
         _ignoreUAString = ignoreUAString;
@@ -116,6 +125,7 @@ - (NSUInteger)hash {
     result = prime * result + [[BNCEncodingUtils md5Encode:self.channel] hash];
     result = prime * result + [[BNCEncodingUtils md5Encode:self.feature] hash];
     result = prime * result + [[BNCEncodingUtils md5Encode:self.stage] hash];
+    result = prime * result + [[BNCEncodingUtils md5Encode:self.campaign] hash];
     result = prime * result + [[BNCEncodingUtils md5Encode:encodedParams] hash];
     result = prime * result + self.duration;
 
@@ -145,6 +155,9 @@ - (void)encodeWithCoder:(NSCoder *)coder {
     if (self.stage) {
         [coder encodeObject:self.stage forKey:BRANCH_REQUEST_KEY_URL_STAGE];
     }
+    if (self.campaign) {
+        [coder encodeObject:self.campaign forKey:BRANCH_REQUEST_KEY_URL_CAMPAIGN];
+    }
     if (self.params) {
         NSString *encodedParams = [BNCEncodingUtils encodeDictionaryToJsonString:self.params];
         [coder encodeObject:encodedParams forKey:BRANCH_REQUEST_KEY_URL_DATA];
@@ -162,6 +175,7 @@ - (id)initWithCoder:(NSCoder *)coder {
         self.channel = [coder decodeObjectForKey:BRANCH_REQUEST_KEY_URL_CHANNEL];
         self.feature = [coder decodeObjectForKey:BRANCH_REQUEST_KEY_URL_FEATURE];
         self.stage = [coder decodeObjectForKey:BRANCH_REQUEST_KEY_URL_STAGE];
+        self.campaign = [coder decodeObjectForKey:BRANCH_REQUEST_KEY_URL_CAMPAIGN];
         self.duration = [[coder decodeObjectForKey:BRANCH_REQUEST_KEY_URL_DURATION] integerValue];
 
         NSString *encodedParams = [coder decodeObjectForKey:BRANCH_REQUEST_KEY_URL_DATA];

Branch-SDK/Branch-SDK/Branch.h

@@ -816,6 +816,22 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
  */
 - (NSString *)getShortUrlWithParams:(NSDictionary *)params andTags:(NSArray *)tags andAlias:(NSString *)alias andChannel:(NSString *)channel andFeature:(NSString *)feature andStage:(NSString *)stage andMatchDuration:(NSUInteger)duration;
 
+
+/**
+ Get a short url with specified params, channel, feature, stage, campaign and match duration. The usage type will default to unlimited.
+ 
+ @param params Dictionary of parameters to include in the link.
+ @param tags An array of tags to associate with this link, useful for tracking.
+ @param alias The alias for a link.
+ @param channel The channel for the link. Examples could be Facebook, Twitter, SMS, etc, depending on where it will be shared.
+ @param feature The feature this is utilizing. Examples could be Sharing, Referring, Inviting, etc.
+ @param stage The stage used for the generated link, indicating what part of a funnel the user is in.
+ @param campaign Use this field to organize the links by actual marketing campaign.
+ @param matchDuration How long to keep an unmatched link click in the Branch backend server's queue before discarding.
+ @warning This method makes a synchronous url request.
+ */
+- (NSString *)getShortUrlWithParams:(NSDictionary *)params andTags:(NSArray *)tags andAlias:(NSString *)alias andChannel:(NSString *)channel andFeature:(NSString *)feature andStage:(NSString *)stage andCampaign:campaign andMatchDuration:(NSUInteger)duration;
+
 #pragma mark - Long Url generation
 
 ///--------------------------
@@ -1026,6 +1042,22 @@ typedef NS_ENUM(NSUInteger, BranchCreditHistoryOrder) {
  */
 - (void)getShortUrlWithParams:(NSDictionary *)params andTags:(NSArray *)tags andAlias:(NSString *)alias andMatchDuration:(NSUInteger)duration andChannel:(NSString *)channel andFeature:(NSString *)feature andStage:(NSString *)stage andCallback:(callbackWithUrl)callback;
 
+/**
+ Get a short url with the specified params, tags, channel, feature, stage, campaign and match duration. The usage type will default to unlimited.
+ 
+ @param params Dictionary of parameters to include in the link.
+ @param channel The channel for the link. Examples could be Facebook, Twitter, SMS, etc, depending on where it will be shared.
+ @param tags An array of tags to associate with this link, useful for tracking.
+ @param feature The feature this is utilizing. Examples could be Sharing, Referring, Inviting, etc.
+ @param stage The stage used for the generated link, indicating what part of a funnel the user is in.
+ @param matchDuration How long to keep an unmatched link click in the Branch backend server's queue before discarding.
+ @param campaign Use this field to organize the links by actual marketing campaign.
+ @param callback Callback called with the url.
+ @param alias The alias for a link.
+ @warning This can fail if the alias is already taken.
+ */
+- (void)getShortUrlWithParams:(NSDictionary *)params andTags:(NSArray *)tags andAlias:(NSString *)alias andMatchDuration:(NSUInteger)duration andChannel:(NSString *)channel andFeature:(NSString *)feature andStage:(NSString *)stage andCampaign:(NSString *)campaign andCallback:(callbackWithUrl)callback;
+
 - (void)getSpotlightUrlWithParams:(NSDictionary *)params callback:(callbackWithParams)callback;
 
 #pragma mark - Content Discovery methods