How do I test my connections?

Overview

Segment has a “validator” feature that enables you to test your connections between Segment and your destination. You can access the validator from your Source Debugger, or from your destination settings.

Note: This feature is in private beta. We appreciate your help testing this feature and would appreciate any feedback.

Use Cases

There are two scenarios where you might want to use the Validator:

  • ensuring an event is successfully making it to a specific destination

  • ensuring your new destination is configured correctly

Ensuring an event is successfully making it to a specific destination

1. Choose an event from the Source Debugger that you want to debug and select “Validate”

Go to your Source Debugger, select an event and in the top right hand side of the debugger view, select “Validate”.

2. Choose your destination you want to test with

Select the destination that you want to test this event with. At this time, you can only use the Validator for cloud mode (server side) destinations.

3. Send event to destination

The event payload from your debugger that you just selected will automatically load in the JSON view. You have the option to edit the payload if you want. Assuming it looks good, select “Send Event” at the bottom right of the screen.

4. Ensure you’re happy to send the test event to the destination

This is a real event that will appear in your end tool alongside your existing data. If you’re not comfortable with this, then select “Cancel” and do not send the event.

5. View the Partner API response

On the right hand side of the Validator you will see the response from the partner API. At the top, we provide of summary of the response. Below is the raw response payload we received that you can use for further debugging if necessary.

If you are receiving an error and are unsure how to fix the issue, please visit the partner docs (e.g. https://developers.google.com/analytics/devguides/reporting/core/v3/errors) or reach out to the partner support team.

FAQ

Why can’t I see the Validator when I log into my workspace?

The Validator is only accessible to users with write access in their Segment workspace (read only users will not see the validator in their workspace).

The Validator experienced an error when sending my event. Why did this happen?

The Validator is still in private beta. If you experience an error, let us know and we’ll look into the issue for you.


If you have any questions or see anywhere we can improve our documentation, please let us know or kick off a conversation in the Segment Community!