Render RSOC blocks

After Install, call _raasCsa("relatedsearch", pageOptions, block1, …) from an inline script. The _raasCsa stub in <head> queues the call until the bundle is ready.

Example

<head> same as Install. <body>: pageOptions, block object(s), then _raasCsa.

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>Related search on content</title>

    <script type="text/javascript" charset="utf-8">
      (function (g, o) {
        g[o] =
          g[o] ||
          function () {
            (g[o].q = g[o].q || []).push(arguments);
          };
        g[o].t = Date.now();
      })(window, "_raasCsa");
    </script>

    <script
      async
      src="https://cdn.ace1m.com/raas/v1/raas.global.js"
      data-tenant-id="YOUR_ACE1M_TENANT_ID"
      data-tenant-key="YOUR_ACE1M_TENANT_KEY"
      data-allocated-channels='["ch1","ch2","ch3","ch4","ch5"]"
      data-verbose="false"
    ></script>
  </head>
  <body>
    <p>Page content</p>

    <div id="afscontainer1"></div>

    <script type="text/javascript" charset="utf-8">
      var pageOptions = {
        pubId: "your-client-id",
        styleId: "1234567890",
        relatedSearchTargeting: "content", // required for RSOC (Related Search on Content) blocks
        resultsPageBaseUrl: "https://www.example.com/search",
        resultsPageQueryParam: "q",
        hl: "en",
      };

      var rsblock1 = {
        container: "afscontainer1",
        relatedSearches: 6,
      };

      _raasCsa("relatedsearch", pageOptions, rsblock1);
    </script>

    <p>More page content</p>
  </body>
</html>

For the full list of page-level and unit-level fields for pageOptions and each block, see the Google CSA reference.

Key `pageOptions` fields

Field	Required	Why it matters
`pubId`	Yes	Your CSA client id.
`styleId`	No	Custom style id for related-search units. If omitted, Google uses a system default style.
`relatedSearchTargeting`	Yes	Must be `"content"` for RSOC pages.
`resultsPageBaseUrl`	Yes	Base URL for the search results page users land on after clicking a term.
`resultsPageQueryParam`	No	Query param name on that results page (default is `q`).

Key block fields

Field	Required	Why it matters
`container`	Yes	Target element id where the unit renders.
`relatedSearches`	No	Number of related terms to request.
`adLoadedCallback`	No	Optional callback for load/impression handling.

`adLoadedCallback` example

Test your callback logic and handle errors so it never breaks page rendering.

var rsblock1 = {
  container: "afscontainer1",
  relatedSearches: 6,
  adLoadedCallback: function (
    containerName,
    adsLoaded,
    isExperimentVariant,
    callbackOptions,
  ) {
    if (adsLoaded) {
      try {
        console.log(
          "RS loaded",
          containerName,
          isExperimentVariant,
          callbackOptions,
        );
      } catch (e) {
        console.error("Error in adLoadedCallback", e);
      }
      return;
    }

    console.log("There is no RS coverage from Google");
  },
};

For all other fields and edge-case behavior, use the Google CSA reference.

Example​

Key pageOptions fields​

Key block fields​

adLoadedCallback example​

Example

Key `pageOptions` fields

Key block fields

`adLoadedCallback` example