Step 4: Adjust the Connector to Edit Data (Optional)

As with any connector built on top of a native source in Yext, you are welcome to make changes to the configuration so that the correct data enters the platform. Simply head to Content > Connectors. Locate your connector, and click View, and on the next page, Edit Configuration in the top right corner.

From here, you can edit which fields are brought into the platform, apply transforms to change what the data looks like, or even add a custom typescript function that can transform your data beyond the platform’s capabilities.

Be careful when removing transforms that the connectors have pre-installed, however, as many of these are required to keep GBP data in a format that Yext can ingest. For example, the custom convertTime function ensures that your hours are entering the platform properly. If you remove this transform, you will not be able to pull hours from Google Business Profile into the Yext platform.

For more information on editing connectors, visit our guides on using the Google Business Profile Source or creating a generic pull connector .

Here are some common examples of post installation data manipulation we’ve come across:

Change which URL to sync your GBP Website to

  1. Head to your recently installed Connector by navigating to Content > Connectors. Choose your Google Business Profile connector.
  2. Click Edit Configuration.
  3. This will open you to the mapping step of your connector. Find the field that is being mapped to the “Website URL > Display URL” field in your connector.
  4. Click on it and click clear.
  5. Find the custom URL field that you created - it may be named something like “Google Website Override”, and select it.
  6. Click Apply.
  7. Save your connector and re-run it when you’re ready! you would like to map the website to. This might be something like “Google Override URL,” but is dependent on how you created the field.
  8. Click Clear.
  9. Find the name of your Custom URL field and choose it. Click Apply.
  10. Save your connector and re-run it.


Apply Category Overrides

Currently the Google Business Profile connectors does not allow users to employ category overrides upon install. Follow the steps below to add category overrides.

  1. Create a Custom Field named Temp Category Override of the Single Text Type. Add it to the Entity Type that you are creating entities for via the GBP Connector. Follow this help article for how to add custom fields.
  2. Head back to your connector and click on Edit Configuration.
  3. Scroll up and click on the Specify Selectors section. Click Add Selector.
  4. Add a Selector with the following header and JMES Path: JMESpath example
  5. Click Save.
  6. Find the “Find and Replace” transform being used on the Categories column. If you installed one of the connectors it will be the 5th transform. Hover over it and click the pencil icon to edit it.
  7. Add your new column as one of the columns that the transform will act on. Click Save.
  8. Find the “Map Publisher Categories” transform. If you installed one of the connectors it will be the 7th transform. Hover over it and click the pencil icon to edit it.
  9. Add your new column as one of the columns that the transform will act on. Click Save.
  10. Scroll down to the Map Data step.
  11. Find the column you just added by scrolling all the way to the bottom and map it to your Temp Category Override field.
  12. Click Save.
  13. Run your connector again!
  14. Once the connector finishes you can export your and confirm that the Primary Category matches the Google Business Profile Category Name.


Adding an “Opening Soon” field

Each Google connector pulls “Coming Soon” information from GBP in case one of your locations has not opened yet. The Google property contains a date specifying when the location is set to open. Any downloaded connector will have pre-selected and transformed this field, labeled in the connector framework as “Coming Soon”.

If you plan to use this field, add a “Coming Soon” date-type field in Content and map the existing selector in your connector to this field. Then the field will be updated as soon as the connector runs again!


Add more Holiday Hours

Our out-of-the-box only maps ten scheduled Holiday Hours. If your Google Business Profile account has scheduled more than ten upcoming holiday hours, you can add these additional schedules by following these steps:

  1. Look for the four “Split Columns” transforms on the connector, which should be pre-applied to all the “Holiday Hours” fields.
  2. Edit each of these transforms, and click +Add Column for each additional Holiday Hours schedule you’d like to include. For neatness, it may be easiest to label the new columns using the pre-existing convention of HolidayHoursField[x] Split columns to add holiday hours
  3. Once all four of these fields have been edited to include the correct number of holiday schedules, proceed to the final step of the connector, entitled “Map Data”.
  4. Find the new columns you created by editing the Split Columns transform, and map these selectors to their corresponding fields in Yext. An example is shown below. You should map however many new schedules you added, for each field (StartDate, Open Time, Close Time, IsClosed).
  5. Save the connector, and run it immediately if you want the updates now. Otherwise, they will be included the next time the connector is scheduled to run! Example of finished holiday hours
Feedback