SDK Reference
Add Genuin's social experiences to your site or app, on the web, iOS, Android, React Native, and Flutter. Pick your technology, then the experience: social standard sizes, custom sizes, IAB-compatible sizes, or a landing page you own and control.
Pick your technology and experience
Choose what you build with and what you want to add. Each answer shows what you get, a first snippet, and the full guides.
Feeds, carousels, standard walls, and grids, with the video aspect ratio you pick in your Business Account.
Add a feed, carousel, standard wall, or grid to any page. Create an embed or a placement in your Business Account under Grow > On Site, pick its layout and video aspect ratio, then add a container and the Web SDK script. One script runs every embed on the page.
Sizes: Feed, carousel, standard wall, and grid layouts, with video tiles at 9:16 by default, or 1:1, 2:3, 3:2, 16:9, 4:3, 3:4, 3:5, or 2:1
<div id="gen-sdk" class="gen-sdk-class" style="width: 100%; height: 600px;"></div>
<script src="https://media.begenuin.com/sdk/2.0.6/gen_sdk.min.js"></script>
<script>
window.genuin.init({
embed_id: "{{EMBED_ID}}",
api_key: "<<YOUR_API_KEY>>",
});
</script>Genuin Experiences
Embed the Genuin Web SDK on your website
Render your brand, community, and group feeds on your own pages with Web SDK 2.0.6, from one script tag to several embeds, sign-in, page context, and events.
Add a Genuin placement to your website
Render a placement with Web SDK 2.0.6 so each page gets the videos its context calls for, in the layout you manage from your Business Account.
Integrate the Genuin iOS SDK
Add Genuin embeds, placements, single sign-on, deep links, and push notifications to an iOS app with SDK 2.1.5.
Integrate the Genuin Android SDK
Add Genuin embeds, placements, single sign-on, deep links, and push notifications to an Android app with SDK 2.1.5.
Integrate the Genuin SDK with React Native apps
Add Genuin carousels, standard walls, full-screen feeds, single sign-on, deep links, and push notifications to a React Native app with genuin-react-native 3.0.3.
Integrate the Genuin SDK with Flutter apps
Add the genuin_sdk plugin to a Flutter project and configure the Android and iOS hosts it needs.
Initialize the Genuin SDK and load a feed in Flutter
Initialize genuin_sdk on each platform, render carousel, feed, and standard wall embeds, and connect sign-in, deep links, and push notifications.
IAB Standard Size Experience
Go live with monetization in your feeds, apps, and partner pages
Earn from your feeds, your app, and partner pages: let Genuin place sponsored and programmatic video in your feeds, show an IAB Standard Size Experience from a tag in your app, or run your posts on a partner page.
Create an ad creative for partner pages
Package up to 10 approved posts as a 300×600 or 300×250 HTML5 ad unit with a call to action and tracking, then hand the code to a media partner or ad server.
Add IAB Standard Size Experiences to an iOS app
Show tag-driven IAB banner, medium rectangle, half-page, interstitial, and collapsible ads in an iOS app with the IAB Standard Size Experience SDK 0.0.5.
Add IAB Standard Size Experiences to an Android app
Show tag-driven IAB ad slots in an Android app with the IAB Standard Size Experience SDK 0.v3.11.
Add IAB Standard Size Experiences to a React Native app
Render Genuin IAB ad slots in a React Native Android app with genuin-react-native-ads-v3 1.4.0.
Works on every platform
Deliver contextual feeds with page, user, and location context
Pass what a visitor is looking at, who they are, and where they are to an embed or a placement. Learn how Genuin turns those signals into a ranked feed.
Customize the Genuin video player
Set the size, tile layout, profile menu, onboarding prompts, and deep-link behaviour of Genuin carousels, standard walls, and full-screen feeds on every SDK.
Sign members out and handle expired sessions
End a member's Genuin session when they sign out of your app, keep the SDK in step with your own sign-in state, and recover when a Genuin session expires.
Pause and resume Genuin feeds with your app lifecycle
Stop Genuin video when an embed scrolls away, your screen changes, or your app goes to the background, and start it again when the viewer comes back.
Handle Genuin deep links in your app
Open shared Genuin video, community, group, and profile links inside your app instead of the browser, on Android, iOS, React Native, Flutter, and the web.
Set up push notifications in the Genuin SDK
Register device tokens with the Genuin SDK and open the right community, group, or post when a member taps a Genuin notification.
Camera and video creation in the Genuin SDK
Record, import, edit, and post video from inside your app with the Genuin camera modules, and control who can create from your Business Account.
Request camera, microphone, and photo library permissions
Declare the access your Genuin features use, and let the SDK ask members at the moment they record, upload, or save.
Receive engagement events in your own analytics
Capture what members watch and do inside Genuin views as events in your own analytics: live from the SDKs, and in batches to your warehouse.
How it works
Choose how members sign in to the Genuin SDK
Compare Genuin's built-in sign-in, single sign-on through your identity provider, and Auto Login with a token from your backend, and pick the one that fits your app.
How Auto Login works
Learn how the Genuin SDK turns a token from your backend into a signed-in member, from the first request to session refresh.
How contextual feeds choose videos
Learn how Genuin turns the context a page sends into the videos an embed or a placement shows, and how often that result changes.
In-app notifications in the Genuin SDK
Learn where signed-in members see their Genuin notifications inside your app, and how the unread badge and read state work.
Search in the Genuin SDK
Learn what members can search for inside the Genuin SDK, where the search screen opens, and what your app needs for it to appear.
Edit videos in the Genuin SDK
See which editing tools the Genuin camera gives members on each platform, what each tool does, and which effects come from your Business Account instead.
How the Genuin SDK places ads in a feed
Learn how a Genuin feed turns a monetization preset into ad slots and in-stream breaks, which sources fill a slot, and what happens when none can.
