In-App Content

Preview self-contained experiences in your app, like a video, photo set, or standalone experience with In-App Content. In-App Content may be shown in Explore if the post matches a user's interests. In-App Content will be surfaced in Oculus Search. We can show users your In-App Content post in Oculus Explore if you provide a trailer video for the post.

Note: These posts are only shown to English speaking users at this time.

Create an In-App Content Post

To create an In-App Content post, go to your app's Oculus dashboard in the Developer Center and select Discoverability / In-App Content.

Enter the following information to create your announcement or story.

  1. Tagline - A 2-5 word sentence about your In-App Content post.
  2. Description - A longer form detail about the content. The description should be 2-3 sentences about your post and cannot include HTML or other markup. This should be specific to your story content, and not just a copy of your app description.
  3. Image - Image for the content. This should be different than your cover art. It should reflect your story and should be 16:9 Aspect Ratio and a 2560 x 1440 24-bit .png file.
  4. Facebook Trailer Video URL (optional, recommended) - After uploading a 2D or 360 video (preferred) to your Facebook page, copy and paste the video URL and provide it here. Details about creating the trailer can be found in the 'Create a Trailer Video' section below. This video is optional for In-App Content.
  5. Start Time - The time you would like your story to start showing up in Oculus Explore.
  6. Deeplink Message - A string that you create that will be provided as a parameter in the app launch intent. If a user does not have your app installed when clicking on the deep-link, we will prompt them to purchase your app. Deeplink messages are required for In-App Content posts.

Integrate In-App Content

Integrating deeplink support is required to create an In-App Content post.

You'll integrate a hook into your app that listens for a specific launch detail when the app is started, ovrLaunchType_Deeplink on Native Android and Launchtype.Deeplink on Unity. When you see these details in the launch event, your app will retrieve the deeplink that you defined to direct the user to the appropriate location in your app.

For example, on Native Android:

ovrLaunchDetailsHandle handle = ovr_ApplicationLifecycle_GetLaunchDetails();
if (ovr_LaunchDetails_GetLaunchType(handle) == ovrLaunchType_Deeplink) {
 string deeplink = ovr_LaunchDetails_GetDeeplinkMessage(handle);

On Unity:

using Oculus.Platform.Models;
LaunchDetails launchDetails = new LaunchDetails(CAPI.
ovr_ApplicationLifecycle_GetLaunchDetails());
if (launchDetails.LaunchType == LaunchType.Deeplink) {
 String deeplinkMessage = launchDetails.DeeplinkMessage;
 ...
}

Create a Trailer Video

A 2D video trailer is recommended for In-App Content. If you do not provide a Facebook 2D video for an In-App Content, we will not be able to show your story or event in Oculus Explore.

You can publish a 2D video to FB as a 'Secret' video and use that for your story if you don't want to share the video outside the Oculus environment.

  1. Go to Publishing Tools / Video Library. Information about this process can be found in the Facebook Publishing FAQ.
  2. Select the video.
  3. In the Video Details dialog box, click Create Post With Video.
  4. Select the Advanced tab.
  5. Change Distribution to Custom.
  6. Select Add as secret video.

Then, once you've created the video, retrieve the URL.

  1. Go to Publishing Tools / Video Library.
  2. Select the video.
  3. In the Video Details dialog box, select the post you just created (at the bottom).
  4. Click View Permalink.

Content Review

All posts and stories will reviewed by the Oculus team for content approval and compliance with the Oculus Code of Conduct. If the submission does not comply, it will be rejected.