Yoking allows you to link two mobile users so that responses by one mobile user can trigger notification initiated sessions (NIS) for the other mobile user. This feature was designed for projects involving couples, parents and children, and other dyads.
Enabling Yoking. To enable yoking, select “Yes” for the "Enable Yoking” field within the LifePak creation/edit modal (see below). Next, you should add the email addresses of the two individuals you want to pair. These email addresses must be the ones participants used when they signed up to use the RealLife Exp app. Additional pairs of users can be yoked by clicking “+Add Pair” and entering their email addresses.
Identifying user email addresses. If a participant cannot remember what email address they used to sign up for the RealLife Exp app, ask them to go to the settings page of the mobile app (click the navigation drawer in the top left corner of the app then select Settings from the menu), and it will show their username and email address (see below).
User without an email address. If a participant does not have an email address listed in the RealLifeExp Settings page that means they registered through Facebook and there is not an email address associated with their Facebook account. They will need to go to their Facebook account and enter a valid email address. Once they have entered an email address in their Facebook account, they should log out of the RealLife Exp app and then log back in using Facebook. The new email address should appear in the RealLife Exp app Settings page.
Yoking participants after a LifePak is published. Pairs of yoked users may need to be established after a LifePak is published and a study is up and running. To do this, go to the LifePak in your LifePak list in the LifePak Creator web app. Click the “Edit Published LifePak” button for the published LifePak. Then, click “+Add Pair” and input email addresses.
Requirements for yoking. For this feature to function, yoking requires both users to 1) be registered for push notifications; 2) have an internet connection; and 3) have the RealLife Exp app open (in the foreground or background) on their device. When a yoked user (User A) responds to a triggering prompt, their response is automatically uploaded to the server and the server sends a silent push notification to the other yoked user (User B). The silent push notification then activates the Triggered Session for that user (B).
Delayed notifications. If either yoked user does not have an internet connection, it will delay delivery of a notification. And if the user who is supposed to receive a triggered session does not have the app running in the foreground or background, that too will delay the notification.
Push notification registration. When mobile users sign up or log in, they should be automatically registered for push notifications, which makes yoking possible. If there is a problem with triggered notifications being sent to a yoked user, make sure that both mobile users are registered for push notifications by accessing the menu in the top left corner of the mobile app. Select Settings>Push Notification Status to determine whether you are registered for push notifications. If not, log out of the mobile app, make sure you have an internet connection, log in again, and you should be registered.
Setting up yoked sessions. To set up questions that will trigger a yoked session, read more about setting up Triggering Questions and Triggered Sessions.