What is this?

This package assists with raw server communication for app-boy's API. It is concurrency safe but only provides a very thin layer on-top of the HTTP interface; you should probably have your own way of ensuring reliability by queing or pooling your connections.

Example usage

Example A - Tracking, Add Push Tokens, Removing Tokens

import "gogo_boy"

// Client for an app group
client := gogo_boy.NewClient(appGroupId)

// For applications that have both iOS and android,
// it's probably a good idea to have two of these
// for the seperate app ids
appClient := client.NewAppClient(appId)

// Create a new track request for a user id
track := appClient.NewTrackRequest(userId)

// Set attributes
track.SetFirstName("foo")
track.SetEmail("test@test.com")
track.SetCustomValueAttribute("baz", "bar")

// Add push token
track.AddPushToken("foo")

// Tell app boy to delete a push token
track.RemovePushToken("foo2")

// Post events
e := gogo_boy.NewEvent()
e.SetName("foo")
a.SetTime(time.Now())
track.AddEvent(a)

// Add purchases
pe := gogo_boy.NewPurchaseEvent()
pe.SetProductId("blah")
pe.SetCurrencyUSD()
pe.SetPrice(4.29)
pe.SetQuantity(1)
pe.SetTime(time.Unix(0, 0))
track.AddEvent(pe)

// Post and check for errors
err := track.Post(track)
checkErr(err)

Example B - Trigger a campaign

import "gogo_boy"

// Client for an app group
client := gogo_boy.NewClient(appGroupId)

// Create a new campaign trigger request
ctr := client.NewCampaignTriggerRequest("campaign-id")

// Add 2 recipients with trigger properties of like_count
ctr.addRecipient("<user-id-a>", map[string]interface{}{
  "like_count": 34,
})
ctr.addRecipient("<user-id-b>", map[string]interface{}{
  "like_count": 22,
})

// Post and check for errors
err := ctr.Post(track)
checkErr(err)

Serialization

The track request and campaign triggers ars marshable and unmarshable into json via json.Marshal(). This allows you to save the request(s) and post it at a later time.

Communication

♥ This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

• If you found a bug, open an issue.
• If you have a feature request, open an issue.
• If you want to contribute, submit a pull request.

---

FAQ

Todo

Creator

• Seo Townsend (@seotownsend)

License

lzoned is released under the MIT license. See LICENSE for details.