Tracking

Visite (GET)

Endpoint

GET https://api.mediego.com/1.0/track/visit

Paramètres

Identification du client

Les paramètres suivants sont fournis par Mediego.

Nom Description
engine Identifiant du client
debug (optionel) Définit si la requête sert seulement au debug et ne doit donc pas être enregistrée

Identification de l'utilisateur

One of the following parameter is necessary to idenfity the user.

Nom Description
euid Identifiant de l'utilisateur du client
muid Identifiant Mediego de l'utilisateur

Identification de l'item

Un des paramètres suivants est nécessaire pour identifier l'item que l'utilisateur est en train de visiter. Un item peut être une page web, un article ou un produit.

Nom Description
referrer URL de la page visitée
eiid Identifiant client de l'item
miid Identifiant Mediego de l'item

Réponse

Succès

{
    "muid": string, // Identifiant utilisateur généré par Mediego
    "timestamp": string, // Timestamp de la requête
    "display_type": "defaut" | "prestashop", // Mode d'affichage pour les recommandations web
    "requires_segmentation": boolean // Définit si une requête de segmentation devrait être envoyée à la suite de cette requête
}

Erreur

{
    "error": string // Description de l'erreur
}

Visit (POST)

Endpoint

POST https://api.mediego.com/1.0/track/visit

Parameters

The parameters are the same as the GET version. However, they are sent as a JSON object in the body of the request.

{
  "engine": string,
  "debug": boolean,
  
  "euid": string,
  "muid": string,
  
  "referrer": string,
  "eiid": string,
  "miid": string
}

Response

Success

{
    "muid": string, // User ID generated by Mediego
    "timestamp": string, // Timestamp of the request
    "display_type": "defaut" | "prestashop", // Display mode for Web recommendations
    "requires_segmentation": boolean // Defines if a segmentation request should be sent
}

Error

{
    "error": string // Description of the error    
}

Click

Endpoint

GET https://api.mediego.com/1.0/track/click

Parameters

Name Description
ruuid Recommendation ID (defined in the result of a recommendation request)
debug (optional) Specify if the request is only for debug and thus should not be recorded

Response

Success

{
    "success": string, // Message describing the recorded click
}

Error

{
    "error": string // Description of the error    
}