Skip to main content

Bold Penguin SDK Source Attribution

Bold Penguin SDK customers utilizing the Bold Penguin Storefront product can add a source parameter to their unique Storefront URL.

When combining the Storefront Source Attribution feature with your existing Storefront and our available webhooks, you can more accurately measure webpage performance and direct customers to specific webpages based on attributes such as categories. When you add the source parameter to your Storefront URL we will return the passed source as the value of the mqs_customer_metadata answer via application_form events.

Configuration​

As part of your onboarding experience Bold Penguin will set up your Storefront and provide you with your own unique URL. With the URL received from Bold Penguin, you can add an arbitrary value as the query parameter to the end of the URL and all new customers using the specific URL will have the attribute field attached.

Example:​

https://storefront.boldpenguin.com/<AgencyName>?source=<YourSource>

Usage with Webhooks​

The specified parameter in the Storefront URL will be added to your webhooks payload.

{
  "id": "1fb718d9-7819-4f2d-bda9-2e0645c0f94a",
  "owner_id": "46912066-9be9-4a04-97ea-5505a1acde",
  "parent_id": null,
  "locked": false,
  "state": "quoted",
  "reference_id": "ABC-789-JKL",
  "owner_is_guest": false,
  "quote_requests_count": 2,
  "finished_quote_requests_count": 2,
  "created_at": "2019-11-21 13:44:02 -0500",
  "updated_at": "2019-11-21 13:46:23 -0500",
  "cloned": false,
  "inactive": false,
  "tenant": "ABC Brokerage",
  "parent_tenant": "Commercial Insurance Center",
  "routing_outcome": "boldpenguin",
  "owner": {
    "id": "46912066-9be9-4a04-97ea-5505a1acde0e",
    "first_name": "First",
    "last_name": "Last",
    "email": "sales@boldpenguin.com",
    "phone": "555-444-3333",
    "auth_uid": "e700e280-db75-43fa-b2dd-d16adb2fecef",
    "is_guest": "false",
  },
  ...
  "answers": [
  {
      "alias": {
        "storefront_source": "YourSource"
      },
      "answer_pool_id": null,
      "code": "mqs_customer_metadata",
      "parent_answer_pool_id": null,
      "question_text": "Customer Metadata",
      "value": {
        "storefront_source": "YourSource"
      }
    },
]
...payload continues...

Additional information about webhooks and event payloads can be found here: Webhook Event Payloads.