How to Build a Segment Server-Side Using Postbacks

You may wish to create a segment server-side from a postback. Common use cases in-app are for excluding users who have installed the app, retargeting installed users for in-app events, or encouraging new sessions of lapsed users.  A common use case in desktop is to add users to segments without needing to tag your website.

This postback tag will be the URL of a  Segment Tag with the additional below parameters.  You would replace [USER_ID] with the actual user ID of the respective type being noted in the value of user_id_type parameter.

For segmenting on in-app events, you would need to ensure your postback vendor can also fire additional postbacks to the conversion or event postback fired at the time of the event.  

For Android:

&user_id=[USER_ID]&user_id_type=AD_ID

For iOS:

&user_id=[USER_ID]&user_id_type=IDFA

For Desktop or Mobile Web (Note: this would require a  cookie sync in place with Beeswax):

&user_id=[USER_ID]&user_id_type=BEESWAX

For IP addresses:

&user_id=[USER_ID]&user_id_type=ip_address

For example, the original segment URL looks like this: 

https://segment.prod.bidr.io/associate-segment?buzz_key=buzzubzz&segment_key=buzzbuzz-43

And the postback URL for segments will look like this (iOS is being used in this example):

https://segment.prod.bidr.io/associate-segment?buzz_key=buzzbuzz&segment_key=buzzbuzz-43&user_id=ABCD-1234-BNGM-5678&user_id_type=IDFA

If you operate in more than one region (NAM, EMEA, or APAC), you will need to dictate which data center the user should be stored in. You will need to augment the URL to also include the region--otherwise the user will get stored in the data center closest to the server from which you did the postback. 

Below are examples of how the server side segment postback should look when dictating the data center:

https://emea.segment.prod.bidr.io/associate-segment?buzz_key=buzzbuzz&segment_key=buzzbuzz-43&user_id=ABCD-1234-BNGM-5678&user_id_type=IDFA

https://nam.segment.prod.bidr.io/associate-segment?buzz_key=buzzbuzz&segment_key=buzzbuzz-43&user_id=ABCD-1234-BNGM-5678&user_id_type=IDFA

https://apac.segment.prod.bidr.io/associate-segment?buzz_key=buzzbuzz&segment_key=buzzbuzz-43&user_id=ABCD-1234-BNGM-5678&user_id_type=IDFA
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us