Rakuten Conversions

Send conversion and transaction data to Rakuten Advertising for affiliate attribution, publisher commissions, and campaign analytics.

Prerequisites

Complete these steps in the Rakuten Advertising dashboard before configuring Signal.

Create a Rakuten Advertising account

Find your Advertiser ID

Navigate to Account > Account Summary in the Rakuten dashboard. Your Advertiser ID is displayed in the account details section. This identifies your advertiser programme.

Find your Merchant ID (MID)

Your Merchant ID (MID) is shown alongside your Advertiser ID in the account details. In some Rakuten interfaces, it appears under Account > Tracking Settings or is provided by your Rakuten account manager.

Generate an API key

Go to Account > API Access (or Tools > API Credentials) in the Rakuten dashboard. Generate or copy your API Key. This key authenticates server-to-server conversion tracking calls.

Configure commission structures

Navigate to Offers > Commission and ensure your commission structures are defined. Server-tracked conversions will be attributed using these commission rules, so they must be in place before sending events.

Verify tracking link parameters

Ensure your Rakuten affiliate links include the standard tracking parameters. Server-to-server conversions require a valid click reference (typically the ranMID, ranEAID, and ranSiteID parameters) for attribution.

Configuration

Field	Type	Required	Description
`advertiser_id`	string	Yes	Your Rakuten Advertising advertiser ID.
`api_key`	secret	Yes	Your Rakuten API key for authenticating server-to-server calls.
`mid`	string	Yes	The Rakuten merchant ID (MID) associated with your advertiser account.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Rakuten Conversions or filter by Attribution.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default blueprint.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/rakuten/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rakuten Conversions",
    "variant": "default",
    "config": {
      "advertiser_id": "12345",
      "api_key": "your_api_key",
      "mid": "67890"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

Signal events are mapped to Rakuten server-to-server conversions via your blueprint. Common mappings include:

Signal Event	Rakuten Mapping	Notes
`purchase`	Sale conversion	Requires `orderId`, `amount`, `currency`, and `mid`
`lead`	Lead conversion	Map to a lead-type commission structure
`sign_up`	Registration conversion	Useful for pay-per-registration affiliate programmes

Rakuten requires the ranSiteID (publisher site ID) and click tracking parameters to attribute conversions to the correct publisher. Ensure your site captures these values from landing page URLs and includes them in Signal events.

Testing

Generate a test click through a Rakuten affiliate tracking link.
Complete a test conversion on your site that triggers a Signal event.
Send a test event through Signal using the Test Event button on the integration detail page.
In the Rakuten dashboard, navigate to Reports > Transaction Detail to verify the test conversion (allow up to 30 minutes for processing).
Check Live Logs in Signal to confirm delivery returned 200 OK.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid API key	Verify `api_key` in Rakuten Account > API Access and update Signal.
`400 Bad Request`	Missing required fields	Ensure `orderId`, `amount`, and `mid` are mapped in the blueprint.
Conversions not appearing	Missing click tracking parameters	Rakuten tracking parameters (`ranSiteID`, etc.) must be captured and forwarded.
Wrong merchant	Incorrect `mid`	Verify the Merchant ID matches your advertiser account in Rakuten.
Commission not calculated	Commission structure not configured	Set up commission structures in Offers > Commission before sending conversions.

Visit Rakuten Advertising documentation for full API reference and credential setup instructions.

Kochava IdentityLink Ringier Axel Springer Poland