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.

The two integration phases affected by the integration option you choose are adding a domain and standing up the results page, both of which we’ll cover below.

Check out the results page at  search.yext.com below:

Yext Search results page example

Integration Options

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 you add a CNAME record as outlined in the Add a Domain guide 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 guide.

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! The Pages deployment UI assigns a placeholder domain as soon as you create your site. You can use this until you decide on your integration path and are ready to add your own domain.

Assigning a Domain

Once you successfully add a domain, 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. Step-by-step guidance can be found in the Creating Search Results Page guide.

To make the process quick and seamless for creating your search results page, the Search snippet generator will automatically create the code snippets you need to integrate. 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="REPLACE_ME_PRODUCTION_URL/iframe.js"></script>

Any existing content on the search results page should be removed and the REPLACE_ME_PRODUCTION_URL parameter should be updated to the production URL.

The production_url is available in your Pages site and is the domain you added above.

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

Modifying the Script Tag to Embed Staging Version of Search

If you want to use the JS Snippet to preview the staging version of your Search experience, you will need to slightly modify the code listed above. It should look something like this:

<div id="answers-container"></div>
<script src="REPLACE_ME_STAGING_URL/iframe-staging.js"></script>

You can learn more about this in the Creating Search Results Page guide .

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)

    A Hitchhiker in the making! 🔥

    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