Segment.io Integration

If you already use Segment inside your application and want to integrate Pointzi data with your segment data, then please follow the below instructions to ensure the Segment ID is linked to the Pointzi InstallID.

NOTE: Pointzi will store Segment's "Identify" Traits only, please filter out other events such as "Track". Pointzi supports Traits of the following types: String, Numeric, Datetime (a string in ISO-8601 format), These types map directly to Pointzi's Tags. Pointzi will ignore structures.

IOS

Swift

After Segment initialisation, simply pass segment anonymousId into Pointzi/Streethawk register function

let segmentId = SEGAnalytics.shared()?.getAnonymousId()
        Pointzi.sharedInstance().registerInstall(forApp: <appKey>, segmentId: segmentId, withDebugMode: false) {
            SEGAnalytics.shared()?.identify(segmentId, traits: [
                "sh_cuid": "myuser@streethawk",
                "email": "myuser@acme.com",
                "gender": "male",
                "phone": "+14088123123"
            ])
        }

Objective-C

1.After Segment initialisation, simply pass segment anonymousId into Pointzi/Streethawk register function

[StreetHawk registerInstallForApp:<appKey> segmentId:[[SEGAnalytics sharedAnalytics] getAnonymousId] withDebugMode:YES];

2.Pointzi/StreetHawk provides a SHInstallRegistrationSuccessNotification to inform notification center about initialisation of SDK is done. Therefore, please register a notification as

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(installRegisterSuccessHandler:) name:SHInstallRegistrationSuccessNotification object:nil];

3.Please call segment api such as sending traits in the callback function installRegisterSuccessHandler

- (void)installRegisterSuccessHandler:(NSNotification *)notification
{
   //Sample code to send segment traits after Streethawk is ready
                     traits:@{
                          @"sh_cuid": @"myuser@streethawk",
                          @"email": @"myuser@acme.com",
                          @"gender": @"male",
                          @"phone": @"+14088123123"
                      }];
}

Android

1.After Segment initialisation, simply pass segment anonymousId into Pointzi/Streethawk register function

Pointzi.INSTANCE.init(getApplication, <appKey>,  "anonymousID");

Note to get your anonymousID you can do:

 com.segment.analytics.Analytics.with(MyActivity.this)
                .getAnalyticsContext()
                .traits()
                .anonymousId()

2.Pointzi/StreetHawk provides a ISHEventObserver to inform notification center about initialisation of SDK is done. Therefore, please register a notification as

public class MyActivity .... implements ISHEventObserver {
.......
Pointzi.INSTANCE.init(getApplication, "MyAppKey",  "anonymousID", this);
.......

@Override
public void onInstallRegistered(String installId){
}

@Override
public void onInstallRegisterError(String errorMsg) {
}

3.Please call segment api such as sending traits in the callback function onInstallRegistered

@Override
public void onInstallRegistered(String installId){
    com.segment.analytics.Analytics.with(MainActivity.this).identify(
            new com.segment.analytics.Traits().putName("Michael Bolton"));
}

Segment Destination Webhook

1.Go to your Segment Dashboard

2.Please add the below webhook URL in your segment destinations

    https://bison.streethawk.com/v3/hooks/segment/?app_key="Your Pointzi App Key"

3.Then add "Pointzi Auth Token" to Header as below

NOTE: To get the "Pointzi Auth Token" and "Pointzi App Key" go to the Pointzi Dashboard Settings and choose from the API Tab

You can find more auth token information at the following link https://dashboard.pointzi.com/docs/authentication/