Manual Server-Side Integration

If you cannot decide for the Google Tag Manager integration, you can still opt for the manual server-side integration. The manual integration of server-side tracking should always be preferred over client-side integration for reliability reasons.

The manual integration requires your shop to identify traffic from us and report direct & post-sales. See explanatory sections at the bottom of this page.

How does it work?

When a user clicks on one of your products on moebel.de, meubles.fr, meubelo.nl, moebel24.at, moebel24.ch, or mobi24.es, our server generates a unique ID (moeclid) which is appended as a query parameter to your landing page URL. Your store shall remember this user by creating a first-party cookie with a lifetime of 90 days that stores the ID that is submitted as the value of the request parameter (moeclid). The ID is required for submitting sales information to us later in the process.

Initalize the placement of the cookie on the server-side to ensure that in any circumstance you can recognize the visitor as a returning visitor in the set timeframe (90 days).

If the user makes a purchase on your site and has the cookie you created when he came to your shop, a conversion event shall be sent to our server including the ID of the moeclid query parameter and further purchase-related data.

Please note that we are requesting unattributed sales data from you. As we utilize this data to promote your products through our algorithm, attributing sales to specific customers or sources may negatively impact the scoring of your products, leading to poorer performance.

Prerequisites

Before you proceed with this integration, make sure the following conditions are met:

  • You have received your Partner ID or dedicated Sales Tracking Key.

Submitting Sales Information

Each of our portals provides a single HTTP endpoint to which sales information should be sent. The only difference between the endpoints per portal is the endpoint URL.

Endpoint URL per Portal

moebel.de Partners

https://redirect.moebel.de/api/1.0/moebel/de/sales?key={{partner_id|sales_tracking_key}}

meubles.fr Partners

https://redirect.meubles.fr/api/1.0/moebel/fr/sales?key={{partner_id|sales_tracking_key}}

meubelo.nl Partners

https://redirect.meubelo.nl/api/1.0/moebel/nl/sales?key={{partner_id|sales_tracking_key}}

moebel24.at Partners

https://redirect.moebel24.at/api/1.0/moebel/at/sales?key={{partner_id|sales_tracking_key}}

moebel24.ch Partners

https://redirect.moebel24.ch/api/1.0/moebel/ch/sales?key={{partner_id|sales_tracking_key}}

mobi24.es Partners

https://redirect.mobi24.es/api/1.0/moebel/es/sales?key={{partner_id|sales_tracking_key}}

Endpoint Communication

Communicating with our tracking service using the endpoint URL requires a few parameters to be added to the endpoint call.

HTTP Method

POST

Query Parameter

Parameter Description Mandatory Data type Example Comment

key

your sales tracking key or partner id

true

string

0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75

provided by your account manager

Body Parameter

Parameter Description Mandatory Field Data type Example Comment

moeclid

unique clickout id from moebel.de

yes

string

0f81f6c0-bee9-420f-8f1f-e9f7f79f5424

value

gross total basket value, without shipping costs, including tax

yes

float

1499.97

2 digits, "." as decimal delimiter, no thousand delimiters

shipping

shipping costs

yes

float

29.99

2 digits, "." as decimal delimiter, no thousand delimiters

type

sales tracking type (s2s, c2s)

yes

string

s2s

for this integration it is always s2s (server-to-server)

items

array of unique items in order

yes

array

items: [ { "item_id": "sp47886359" , "quantity": "1", "price": "899.99" , "item_category": "Möbel"}, { "item_id": "sp31118801" , "quantity": "2", "price": "299.99" , "item_category": "Couches" }, ]

- item_id

your sku ID

yes

string

sp47886359

- quantity

product quantity

yes

integer

1

integer, no delimiter

- price

gross product price

yes

float

299.99

2 digits, "." as decimal delimiter, no thousand delimiters

- item_category

your category name of the item

yes

string

Couches

currency

currency

yes

string

EUR

DIN Norm

order_id

your identifier for the order

no

string

1172210481407

CURL Examples

moebel.de Partners

curl -X 'POST' \
  'https://redirect.moebel.de/api/1.0/moebel/de/sales?key=0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "moeclid": "0f81f6c0-bee9-420f-8f1f-e9f7f79f5424",
  "value": "1499.97",
  "shipping": "29.99",
  "type": "s2s",
  "items": [
    {
      "item_id": "sp47886359",
      "quantity": 1,
      "price": 1499.97,
      "item_category": "Couches"
    }
  ],
  "currency": "EUR",
  "order_id": "1172210481407"
}'

meubles.fr Partners

curl -X 'POST' \
  'https://redirect.meubles.fr/api/1.0/moebel/fr/sales?key=0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "moeclid": "0f81f6c0-bee9-420f-8f1f-e9f7f79f5424",
  "value": "1499.97",
  "shipping": "29.99",
  "type": "s2s",
  "items": [
    {
      "item_id": "sp47886359",
      "quantity": 1,
      "price": 1499.97,
      "item_category": "Couches"
    }
  ],
  "currency": "EUR",
  "order_id": "1172210481407"
}'

meubelo.nl Partners

curl -X 'POST' \
  'https://redirect.meubelo.nl/api/1.0/moebel/nl/sales?key=0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "moeclid": "0f81f6c0-bee9-420f-8f1f-e9f7f79f5424",
  "value": "1499.97",
  "shipping": "29.99",
  "type": "s2s",
  "items": [
    {
      "item_id": "sp47886359",
      "quantity": 1,
      "price": 1499.97,
      "item_category": "Couches"
    }
  ],
  "currency": "EUR",
  "order_id": "1172210481407"
}'

moebel24.at Partners

curl -X 'POST' \
  'https://redirect.moebel24.at/api/1.0/moebel/at/sales?key=0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "moeclid": "0f81f6c0-bee9-420f-8f1f-e9f7f79f5424",
  "value": "1499.97",
  "shipping": "29.99",
  "type": "s2s",
  "items": [
    {
      "item_id": "sp47886359",
      "quantity": 1,
      "price": 1499.97,
      "item_category": "Couches"
    }
  ],
  "currency": "EUR",
  "order_id": "1172210481407"
}'

moebel24.ch Partners

curl -X 'POST' \
  'https://redirect.moebel24.ch/api/1.0/moebel/ch/sales?key=0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "moeclid": "0f81f6c0-bee9-420f-8f1f-e9f7f79f5424",
  "value": "1499.97",
  "shipping": "29.99",
  "type": "s2s",
  "items": [
    {
      "item_id": "sp47886359",
      "quantity": 1,
      "price": 1499.97,
      "item_category": "Couches"
    }
  ],
  "currency": "EUR",
  "order_id": "1172210481407"
}'

mobi24.es Partners

curl -X 'POST' \
  'https://redirect.mobi24.es/api/1.0/moebel/es/sales?key=0a7b3e5a-3748-4f2c-9874-9cb05e9a2c75' \
  -H 'accept: */*' \
  -H 'Content-Type: application/json' \
  -d '{
  "moeclid": "0f81f6c0-bee9-420f-8f1f-e9f7f79f5424",
  "value": "1499.97",
  "shipping": "29.99",
  "type": "s2s",
  "items": [
    {
      "item_id": "sp47886359",
      "quantity": 1,
      "price": 1499.97,
      "item_category": "Couches"
    }
  ],
  "currency": "EUR",
  "order_id": "1172210481407"
}'

Identify Traffic From Us

Communicate only sales and turnover based on traffic from one of our portals (moebel.de, meubles.fr, meubelo.nl, moebel24.at, moebel24.ch, or mobi24.es).

Through an Existing Query Parameter

Each user who comes to your shop from one of our portals will have an additional query parameter called moeclid attached to the URL. You can check for the existence of this query parameter to identify that this user was sent to you by us.

Through Your Own Query Parameter

When submitting your product catalog to us, you have the option to add parameters to the product deep links leading to each product’s detail page. This will enable you to determine if the user accessed the page through one of our portals.

https://www.your-shop.de/sofa-nespolo-3-sitzer-echtleder-dunkelbraun-1?referrer=moebel
Option 1

When submitting your product catalog, add a query parameter to each product url / deep link.

Option 2

You can configure a query parameter in the Partner Portal, which will be automatically added to each link to your products.

Report Direct and Post-Sales

We require that any purchase made within 90 days by a visitor who was referred to your store through one of our portals be reported to us using sales tracking.

By identifying traffic originating from one of our portals, you can create a cookie for those visitors that is valid for 90 days. During the checkout process of your store, you can check for the presence of the cookie and report the sales data accordingly. This allows you to track sales generated by visitors we referred to your store within the past 90 days.

If you have a mobile version of your store that is optimized for smartphones, it is important to ensure that it behaves in the same way as the desktop version.