RTB House

Datafly Signal delivers conversion events to RTB House server-to-server for deep learning-powered retargeting, campaign attribution, and personalised ad delivery optimisation.

⚠️

This integration is currently in beta. Configuration and behaviour may change.

Prerequisites

Before configuring RTB House in Signal, you need an RTB House account and credentials provided by your RTB House account manager.

Set Up an RTB House Account

Contact RTB House to set up an advertiser account, or reach out to your existing RTB House account manager.
Complete the onboarding process, which includes providing your website URL and retargeting requirements.
Your account manager will provision your account and provide access to the RTB House panel.

RTB House operates on a managed service model. Account setup and configuration is handled in partnership with your RTB House account manager.

Get Your Tag ID and Region

Ask your RTB House account manager for your Tag ID and assigned Region.
The Tag ID is a unique identifier for your RTB House tracking tag (e.g. abcde12345).
The Region determines which RTB House API endpoint receives your events. Common values include eu, us, and apac.

⚠️

The Tag ID and region are assigned by RTB House. Do not use values from other integrations or guess the region — using incorrect values will result in events being dropped.

Configure in Signal

Now that you have your Tag ID and region from your RTB House account manager, configure the integration in Signal.

Configuration Fields

Field	Required	Description
`tag_id`	Yes	Your RTB House tag ID. Provided by your RTB House account manager.
`region`	Yes	The RTB House API region for your account (e.g. `eu`, `us`, `apac`). Provided by your account manager.

Management UI Setup

Go to Integrations > Add Integration > RTB House.
Enter your tag_id and region.
Select consent categories (typically advertising).
Click Save.

Management API Setup

curl -X POST http://localhost:8084/v1/admin/integrations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "src_abc123",
    "vendor": "rtb_house",
    "name": "RTB House Production",
    "enabled": true,
    "config": {
      "tag_id": "abcde12345",
      "region": "eu"
    },
    "consent_categories": ["advertising"]
  }'

Event Mapping

Datafly Event	RTB House Event	Notes
`page` (page view)	`home` / `visit`	Page type determined by URL context
`Product Viewed`	`offer`	Requires product identifiers
`Product Added`	`basketadd`	Includes product details
`Order Completed`	`conversion`	Requires `value`, `currency`, product list
`Products Searched`	`search`	Includes `search_string`
`Product List Viewed`	`category`	Category page view
Custom events	Passed through	Sent as custom event name

Testing Your Integration

Step 1: Send a Test Event

Trigger a product view or purchase event on your website.
Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.

Step 2: Verify with Your Account Manager

Contact your RTB House account manager to confirm events are being received.
RTB House does not provide a self-service event viewer — your account manager can verify delivery on their side.

Step 3: Validate Retargeting

After events are flowing, your RTB House account manager will confirm that retargeting campaigns can use the event data.
Review campaign performance reports provided by your account manager.

Troubleshooting

Problem	Solution
Events not being received by RTB House	Verify the `tag_id` and `region` are correct. Contact your account manager to confirm.
`Invalid region` error	Ensure you are using the exact region value provided by RTB House (e.g. `eu`, not `europe`).
Product events not mapping correctly	Ensure product identifiers in your Datafly events match those in your RTB House product feed.
Events delayed or missing	Check Signal’s delivery status. If delivery is confirmed, contact your RTB House account manager — the issue may be on their side.

Visit RTB House for more information. For API documentation and integration support, contact your RTB House account manager directly.

Roku Snapchat Ads