Customer.io

Friendbuy destination

There are two versions of this integration

You'll see two entries for Friendbuy in our integration catalog, with one labeled Web. We typically recommend that you use the standard integration, the one not labeled "Web" when possible. The web version of this integration only works with our JavaScript client and does not pass data through Customer.io's servers, which can make it hard to debug your integration, capture a history of events sent to the integration, and so on. Learn more about Web integrations.

Getting started

  1. Go to Data & Integrations > Integrations and select the Friendbuy entry in the Directory tab.
  2. (Optional) Select the data sources that you want to connect to your outbound integration. You can always connect data sources later. We'll only show you data sources that work with your integration.
  3. Configure your integration.
    1. Friendbuy MAPI Key: Contact your Friendbuy account manager to generate your Friendbuy MAPI key and secret.
    2. Friendbuy MAPI Secret: See Friendbuy MAPI Key.
  4. Click Enable Destination.

Cloud mode actions

When you're done setting things up, you can go to the Actions tab to see how we map incoming data to your integration.

You may need to add actions for this integration

While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your integration. See our actions page for help setting up actions.

ActionDefault TriggerDescription
Track Customer

Create a new customer profile or update an existing customer profile.

Track Purchase

Record when a customer makes a purchase.

Track Sign Up

Record when a customer signs up for a service.

Track Custom Event

Record when a customer completes any custom event that you define.

Getting started: web integration

  1. Go to Data & Integrations > Integrations and select the Friendbuy entry in the Directory tab.
  2. (Optional) Select the data sources that you want to connect to your outbound integration. You can always connect data sources later. We'll only show you data sources that work with your integration.
  3. Configure your integration.
    1. Friendbuy Merchant ID: Find your Friendbuy Merchant ID by logging in to your [Friendbuy account](https://retailer.friendbuy.io/) and going to Developer Center > Friendbuy Code.
  4. Click Enable Destination.

Web destination actions

When you're done setting things up, you can go to the Actions tab to see how we map incoming data to your integration.

You may need to add actions for this integration

While we often have default triggers for actions, we don't always add those actions as defaults. You may need to add actions to make sure that you're sending all the data that you want to send to your integration. See our actions page for help setting up actions.

ActionDefault TriggerDescription
Track Customertype = "identify"

Create a new customer profile or update an existing customer profile.

Track Purchaseevent = "Order Completed"

Record when a customer makes a purchase.

Track Sign Upevent = "Signed Up"

Record when a customer signs up for a service.

Track Pagetype = "page"

Record when a customer visits a new page. Allow Friendbuy widget targeting by Page Name instead of URL.

Track Custom Event

Record when a customer completes any custom event that you define.