IntegrationsAdvertisingYahoo Pixel API

Yahoo Pixel API

Datafly Signal delivers conversion events to Yahoo server-to-server via the Pixel API for campaign attribution, audience measurement, and ad delivery optimisation across Yahoo DSP and native advertising.

Prerequisites

Before configuring Yahoo Pixel API in Signal, you need a Yahoo DSP account with a Dot tag created and API credentials generated.

Create a Yahoo DSP Account

  1. Go to the Yahoo DSP (formerly Verizon Media / Yahoo Native & Display) and contact the sales team or your Yahoo account representative to set up an advertiser account.
  2. Once provisioned, log in to the Yahoo DSP console.
  3. Familiarise yourself with the Measurement section where you will manage tags and pixels.

Yahoo DSP account setup is managed by Yahoo’s sales team. Contact your Yahoo representative if you do not yet have console access.

Create a Dot Tag

  1. In the Yahoo DSP console, navigate to Measurement > Tags in the left sidebar.
  2. Click Create Tag (or New Dot Tag) to set up a new tracking tag.
  3. Name your tag (e.g. “Website Conversions”) and configure the tag type.
  4. Note the Dot Tag ID — you will need this for Signal configuration.

You do not need to install the Yahoo Dot tag JavaScript snippet on your website. Signal replaces the client-side tag with server-side delivery via the Pixel API.

Get Your Pixel ID and API Key

  1. In the Yahoo DSP console, navigate to Pixels > Manage (or Measurement > Pixels).
  2. Note your Pixel ID from the pixel settings page.
  3. Go to Settings > API Access and click Generate API Key.
  4. Copy the API Key immediately — it may only be shown once.
⚠️

Store the API key securely. If you lose it, you will need to generate a new one.

Configure in Signal

Now that you have your Pixel ID, API key, and Dot Tag ID, configure the integration in Signal.

Configuration Fields

FieldRequiredDescription
pixel_idYesYour Yahoo tracking pixel ID. Found in the Yahoo DSP console under Pixels > Manage.
api_keyYesAPI key for authenticating server-side event delivery. Generated in the Yahoo DSP console under Settings > API Access.
dot_tag_idYesYour Yahoo Dot Tag ID for conversion attribution. Found in the Yahoo DSP console under Measurement > Tags.

Management UI Setup

  1. Go to Integrations > Add Integration > Yahoo Pixel API.
  2. Enter your pixel_id, api_key, and dot_tag_id.
  3. Select consent categories (typically advertising).
  4. 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": "yahoo_pixel",
    "name": "Yahoo Pixel API Production",
    "enabled": true,
    "config": {
      "pixel_id": "yahoo-px-12345",
      "api_key": "ak_yahoo_abc123...",
      "dot_tag_id": "dt-yahoo-67890"
    },
    "consent_categories": ["advertising"]
  }'

Event Mapping

Datafly EventYahoo EventNotes
page (page view)pageviewSent for every page view
Order CompletedpurchaseRequires value, currency, order_id
Product AddedaddtocartIncludes product details
Checkout StartedcheckoutIncludes value, currency
Product ViewedviewcontentIncludes content identifiers
Lead GeneratedleadLead form submission
Signed UpsignupUser registration
Products SearchedsearchIncludes search_string
Custom eventsPassed throughSent as custom event name

Testing Your Integration

Step 1: Send a Test Event

  1. Trigger a page view or conversion event on your website.
  2. Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.

Step 2: Verify in Yahoo DSP Console

  1. In the Yahoo DSP console, go to Measurement > Tags > your Dot tag.
  2. Check the tag activity to confirm events are being received.
  3. Navigate to Pixels > your pixel to review pixel-level event data.
  4. Events should appear within a few minutes.

Step 3: Validate Campaign Attribution

  1. Create a test campaign and associate it with your Dot tag.
  2. Confirm that conversion events are attributed correctly in campaign reports.
  3. Review audience measurement data to ensure ad delivery optimisation is working.

Troubleshooting

ProblemSolution
Events not appearing in YahooVerify the pixel_id, api_key, and dot_tag_id are correct. Check that the API key has not been revoked.
Authentication errorsRegenerate the API key in the Yahoo DSP console under Settings > API Access and update Signal.
Invalid dot_tag_id errorVerify the Dot tag exists and is active in the Yahoo DSP console under Measurement > Tags.
Invalid pixel_id errorConfirm the Pixel ID matches your pixel in the Yahoo DSP console under Pixels > Manage.
Events delayedYahoo may take up to 15 minutes to display server-side events. Allow time before investigating further.
Conversions not attributed to campaignsEnsure the Dot tag is associated with the correct campaign. Check attribution window settings in the Yahoo DSP console.

Visit Yahoo Pixel API documentation for full API documentation and credential setup instructions.

XandrGoogle Analytics 4