Manually Initiating a User Sync

In some cases, you may want to manually trigger a user sync without waiting for the automatic flow. This can be useful if you want to ensure that your users have the appropriate ID mappings early in their session.

To manually initiate a user sync with Gamoshi's platform, you can load the following iframe:

<iframe
  src="https://resources.gamoshi.io/user_sync/load-cookie.html"
  style="display:none;"
  width="0"
  height="0">
</iframe>

How it Works

• Loading this iframe will trigger the user sync process and set or refresh the user ID (UID) cookies.
• The iframe is invisible to the user (width="0" height="0" and display:none styling).
• This method is safe to call early in the page lifecycle, for example, immediately after the page loads.

Optional Parameters

You can customize the behavior of the user sync by passing optional URL parameters when constructing the iframe src URL.

Note: You do not need to specify an endpoint — the endpoint is already fixed to https://resources.gamoshi.io/user_sync/load-cookie.html.

Example Usage with Parameters

HTML Example

<iframe
  src="https://resources.gamoshi.io/user_sync/load-cookie.html?bidder=33across,adform,ix&gdpr=1&gdpr_consent=CONSENT_STRING_HERE"
  style="display:none;"
  width="0"
  height="0">
</iframe>

Dynamic JavaScript Example

(function() {
  var iframe = document.createElement('iframe');
  iframe.style.display = 'none';
  iframe.width = '0';
  iframe.height = '0';
  iframe.src = 'https://resources.gamoshi.io/user_sync/load-cookie.html?bidder=33across,adform,ix&gdpr=1&gdpr_consent=CONSENT_STRING_HERE';
  document.body.appendChild(iframe);
})();

When to Use It

• To proactively ensure that a user has an up-to-date ID mapping.
• If you are integrating Gamoshi services into a page that doesn't automatically perform a sync.
• In environments where Prebid.js is not managing user syncs for you.

Important Notes

• Frequency: You generally don't need to call this iframe more than once per page load.
• Privacy Compliance: Ensure that any user sync actions comply with applicable privacy regulations (e.g., GDPR, CCPA, GPP).
• Consent Strings: Always pass real consent values when required to respect user privacy choices.

Supported Bidders

When using the bidder parameter, you can choose from the following supported bidder codes:

Note: For the full bidder list, please refer to the complete documentation or contact Gamoshi support or check out this list Bidders.