Integration Options and the Results Page | Yext Hitchhikers Platform

What You’ll Learn

By the end of this unit, you will be able to:

  • List the difference between the two integration options and understand when to use each
  • Create a domain for both the JS Snippet and Subdomain methods
  • Assign a domain to Pages site

Overview

Once you launch an experience to production, you will need to create your results page! The results page is simply a landing page for the search results. It can be hosted through your brand with a JS snippet integration or through Yext on a subdomain. Check out the results page at  search.yext.com below:

Yext Search results page example

The above page can be created through either integration option. There are two main differences between these two options to consider when deciding how to add your results page:

  1. The results page URL format
  2. The header and footer set up and workflow

In this unit, we will walk through these difference more in depth as well as the domain set up and configuration for each one.

light bulb
Note
To add or update to a Yext search bar, you’ll need to make sure there is a results page for the user to land on via the redirectUrl property. As a reminder, this step is required for header search bar integrations and overlay modules that link out to a standalone search results page.

JS Snippet

With the “JS snippet” path, you host the search results page and inject or iFrame the Search experience as a component onto the page using a script tag. The page itself maintains the integrity of a website’s header/footer since it is a page on your site. Any changes made to the header/footer flow separately from changes made to the Search experience.

The Search results page will typically live at brand.com/search.

Subdomain

With the subdomain path, Yext hosts the search results page and thus the header/footer is created using Yext products or by a Yext team. Thus workflow is required with Yext any time the header/footer is updated to ensure changes flow through. To see an example of how to add a header and footer to a subdomain experience, see this reference doc .

The Search results page will typically live at search.brand.com.

You will be able to integrate a Search results page at the above URL once you 1) publish to production and 2) once the the CNAME step has been completed as outlined in the Add a Domain help article and in the Create Search Results guide.

Adding a Domain

Your domain format is dependent on the integration path. Remember, for the client-hosted JS snippet path, we will be injecting the Search experience into an existing CMS page template (e.g., brand.com/search). For the Yext-hosted subdomain path, we will publish directly to a Yext-hosted page (e.g., search.brand.com).

When you are ready to add your domain, navigate to Pages > Domains. To see step by step instructions see the Add a Domain help article.

With the Pages UI, you can publish to staging or production even before you add a domain - your site will automatically receive a placeholder domain until you set your own.

JS Snippet

In order to create a client-hosted JS Snippet to inject into your page, you will add the following domain information to the “Add New Domain” modal:

  • Use this domain for Search? = Yes
  • Integration method = Javascript Snippet
  • Domain Name formatted as search-embed.brand.com (ex: search-embed.turtlehead-tacos.com)

Add Domain Modal select integration method JS Snippet

Add Domain Modal input name JS Snippet

If you navigate back to the Domains tab, you’ll notice that the DNS and SSL statuses are automatically set to “Active”:

DNS and SSL status listed as active for JS Method

Subdomain

In order to use the Yext-hosted subdomain path, you will add the following domain information to the “Add New Domain” modal:

  • Use this domain for Search? = Yes
  • Integration method = Subdomain
  • Domain Name formatted as search.brand.com (ex. search.turtlehead-tacos.com)

Add Domain Modal select integration method Subdomain

Once you input your domain format, you’ll be given a bridge domain to set up the CNAME record.

Add Domain Modal input name Subdomain

The DNS status will remain in “Pending” until you create a CNAME record.

DNS status listed as pending for Subdomain Method

You will be able to publish as soon as the DNS Status switches to “Active” (meaning the CNAME is set up correctly).

light bulb
Note
Unsure of your integration path? That’s okay! When you go to add your domain, just select the “Subdomain and JavaScript Snippet” option when adding your domain. You can always go back to the Domains screen and update your integration option once confirmed.

Assigning a Domain

Once you complete the Add Domain flow, you will need to assign the domain to your site. To do this, navigate to Pages > [[Your Site]].

The steps to assign will then differ based on the type of site you are using:

  • Classic Pages (Legacy) - click the Select Domain dropdown at the top left of the page and select your domain.

    Assign Domain using dropdown in Sites screen

  • Pages - Select Settings for your site in the left navigation. On the Site Settings screen, click the Domain field, open the Select Domain dropdown, and select your domain. Save once completed.

    Assign Domain using dropdown in Site Settings screen

light bulb
Note
You also have the option to create a domain from either of these dropdown sections if you choose to or don’t have a domain set up already. But once you have assigned a domain, you CANNOT change it.

Standing up a Results Page

Once you set up your domain, you are able to add your Search experience to your site.

To make the process quick and seamless for creating your search results page, we’ve added a new Search Snippet Generator that will automatically create the snippets you need to integrate with JS Snippet or Subdomain. For standing up the results page, you will only need the generator for the JS Snippet option.

To use the Snippet Generator, navigate to Search > All Search Experiences > View Experience > Experience Details and select “Integrate Search on Your Site”. In the modal, follow the prompts to select your site and integration method.

Integration module to open Snippet Generator

Snippet Generator Modal with code to add Search Results page

JS Snippet

The “JS Snippet” path utilizes the Javascript snippet below to inject the Search experience onto an existing search results page (see  here  for instructions on how to create a search results page):

<div id="answers-container"></div>
<script src="[production_url]/iframe.js"></script>

Any existing content on the search results page should be removed and the [production_url] parameter should be updated to the Production URL.

The production_url is available in your Pages site once you publish to Production as covered in the Deploy an Experience unit.

Once the developer has added this correctly, you’ll see the Search experience surface on the search results page!

Subdomain

For this path, the client will need to first determine the subdomain (as mentioned above) on which Yext will host the Search experience.

The client will then need to create a CNAME record - they should point this record to something like subdomain.brand.com.pagescdn.com.

Be sure to include the subdomain in its entirety and include the trailing dot (“.”). For example, if the client selected search.[[clientdomain]].com, then the CNAME will point to search.[[clientdomain]].com.pagescdn.com.

You will need to copy the subdomain in its entirety including the trailing dot (“.”). For reference, the trailing dot is required by DNS specification when setting up a CNAME to another domain (pagescdn.com, in this case). There are some DNS providers that handle this automatically. The client will also need to set up the CNAME record on their internal DNS, if they have one. This will ensure the subdomain displays on the client’s internal network.

DNS and SSL status listed as active for Subdomain method

Once the CNAME has been configured properly, you will see the DNS Status and SSL Status update to “Active” on the Domains tab which means you will be able to publish!

unit Quiz
+20 points
Daily Quiz Streak Daily Quiz Streak: 0
Quiz Accuracy Streak Quiz Accuracy Streak: 0
    Error Success Question 1 of 3

    Which URL below is leveraging the Subdomain integration path?

    Error Success Question 2 of 3

    Which integration method would you use if you want the results page to be client-hosted?

    Error Success Question 3 of 3

    Where do you go to assign a domain? (Select all that apply)

    Way to go, you passed! 🏁

    You've already completed this quiz, so you can't earn more points.You completed this quiz in 1 attempt and earned 0 points! Feel free to review your answers and move on when you're ready.
1st attempt
0 incorrect
Feedback