Step 2: Install the Google Business Profile Connector App

Yext has 6 Google Business Profile apps. Each of these connector apps pulls in information for a different entity type: Locations, Restaurants, Hotels, Healthcare Professionals, Healthcare Facilities, and ATMs. These apps pre-transform and map all of your Google business information to Yext fields so that with only a few clicks, you can pull in all of your locations as entities!

Note

During the app installation flow, you’ll need to input a Linked Account ID as well as a GBP Location Group ID. The Linked Account ID is the ID mentioned in Step 5 of the OAuth connection steps on this guide’s overview page. You can find it by navigating to Content > Configuration, selecting Linked Accounts, and clicking on Google. To find your Location Group ID, simply look in the URL when you are viewing your location group in Google Business Profile, e.g., https://mybusinessbusinessinformation.googleapis.com/v1/{location-group-ID}/locations.

Install App

Installing the connector apps is quick and straightforward! Simply follow the four steps below:

1. Navigate to the Apps page in your account and select the Google Business Profile connector you’d like to use based on which entity type you’d like to import.
2. Review the installation instructions and click Install.
3. You will be prompted to enter a Linked Account ID and a Location Group ID. For a refresher on where to find these, see the prerequisite listed at the top of this page.
4. Once you click Continue, you will be redirected to the connector overview page where you can either run your connector now or edit its configuration.
   • Note: If you are using the connector to update entities that are already created in Content, click Edit Configuration and follow the steps below.

Update Existing Entities

In addition to importing net new location entities, you can use the Google Business Profile connectors to update existing entities. You simply have to ensure parity between Entity IDs in Google and Yext. After installing your connector by following the steps listed above, make these edits to update your pre-existing entities:

1. Navigate to Content > Connectors and click on the relevant connector.
2. Click Edit Configuration.
3. Out of the box, the connector maps Google’s “Store Code” field to Entity ID in Yext. Take a look at this selector. If the store codes listed match your entity IDs in Yext, skip to step 5.
4. If the Google store code does not match entity IDs of your Yext locations, look for a selector that does contain your Entity IDs–let’s call this “Field A”.
   • Note: If you are using a single-location SMB account, you can add an “Add Column” transform with a value that matches your location’s entity ID. Let’s call this “Field A” as well.
5. Navigate to the final step of the connector flow and unmap the current Entity ID mapping. Scroll down to Field A and map this field to Entity ID.
6. Unmap any fields that you do not wish to overwrite pre-existing data on your entities. For example, if you do not wish to update store hours through your connector, unmap all of the hours fields for each day of the week.
7. Click Save, and you will be redirected to the Connector Overview page.
8. Click Run Connector, and your existing entities will be updated!

If you’d like to filter or edit the data that these connectors import, proceed to the next step of this guide. If you’re happy with your new entities, your work is done!

If some entities fail after you run your connector, we recommend reading this section of the GBP reference materials, which walks you through troubleshooting methods based on the errors received.