Partnerships

Building an Action Integration for SiteID

8min

It is against Vector's Acceptable Use Policy to whitelabel Vector, SiteID, or any of it's products/features.

⚡️ Powered by Vector

Vector is the world’s most powerful contact-level de-anonymization and intent platform.

We make it easy for you integrate contact-level intent into your app, for your users — without the headache of taking on device fingerprinting, hashed email decryption, publishing network partnerships, pixel deployment, data compliance, or managing infrastructure to handle billions of requests per day.

Common use case

  • You have: a user base of marketing/sales professionals
  • You want: to give them contact or account level insights about their site visitors

How it works

  1. Direct your customers to create a Vector account and install Vector's pixel on their website. This is at no cost to you or your customers through Vector's Free Plan.
  2. Your customer configures the vector integration in the Vector app with a webhook URL you provide
  3. Your app is now available as an Action in the Vector segment builder for our mutual customer to use.

Implementation Steps

Create a Vector Account

Create a Vector Account and install the Vector pixel on a website. This will be the test account for your Integration. It's easiest to use an account attached to a real website so that you will get a reasonable volume of identified site visitors to test with.

Build and Deploy a Webhook Endpoint

The endpoint should be able to handle contact.visited event. We recommend that each of your customers has a separate webhook endpoint. This is best accomplished with a path parameter

Here's an example payload for that event:

JSON


Test Your Webhook Endpoint

There are three ways to test your endpoint -- we will test all of them when we review your integration, so we recommend that you test it both ways too.

First, you can hit your endpoint manually with a tool like Curl, HTTPie, or Postman -- this is the recommended way to test during development

Next, you can connect your endpoint to your Test Account as a webhook integration and send a test event under the Testing tab

Document image


Finally, you can generate some real traffic to your webhook by building a non-empty segment, adding the webhook action, and pressing "Test Run"



Document image


Submit Your Integration

Congrats on getting this far! Now it's time to reach out to us to get your integration listed in our app. Send the following information to [email protected]:

  • The name of your product and a logo
  • A one-line description of what your integration does
  • An account in your product that we can use for testing

We'll get back to you as soon as we can and get you in the platform!

Updated 20 Nov 2024
Doc contributor
Doc contributor
Did this page help you?