Tourinsoft V5 API - Documentation

Intégration des codes de tracking

1. Récupération des codes de tracking d'une offre touristique

La première étape consiste à récupérer les codes de tracking d'une offre touristique à partir du flux aggrégé d'une syndication.

POST /api/syndications/{{clientId}}/{{syndicationId}}

HTTP

Exemple: 
POST /api/syndications/aquitaine.tourinsoft.com/dd780723-d724-4654-a505-e41bcdd1bfb2 HTTP/1.1
Host: api-v3.tourinsoft.com
Content-Type: application/json

["HOTAQU000V501517"]

Réponse :

On récupère ainsi le contenu de l'offre avec les codes de tracking présent dans la propriété TisTracking. Pour rappel, cette propriété n'est disponible que pour les syndications ayant un flux typé et un tracking actif.

application/json, text/json

Exemple: 
{
    "value": [
        {
            "Structure": {
                "SyndicStructureId": "8fcf1eba-f66d-494d-97da-eebe98784a67",
                "Name": "ADT 79",
                "Email": "tourisme.adt@deux-sevres.fr",
                "EmailName": "Mission Tourisme - Département des Deux-Sèvres",
                "Url": "http://www.tourisme-deux-sevres.com",
                ...
            },
            "TisTracking": {
                "SyndicObjectId": "HOTAQU000V501517",
                "CodeOffre": "22-HOTAQU000V501517-",
                "CodeStructure": "7-",
                "CodeSyndication": "2-188-95213-"
            },
            "SyndicObjectID": "HOTAQU000V501517",
            "Published": "2018-11-29T11:17:27.247",
            "Updated": "2018-11-29T11:17:24.553",
            ...,
            "TIS_TRACKING_OFFRE": "...",
            "TIS_TRACKING_LISTING_OFFRE": "..."
        }
    ]
}

2. Utilisation des codes de tracking pour Google Analytics et Universal Analytics

Pour cette étape, vous pouvez tout simplement réutiliser le code JS présent dans les propriétés TIS_TRACKING_OFFRE et TIS_TRACKING_LISTING_OFFRE. Vous retrouverez plus d'informations sur notre documentation Webmarketing à l'adresse suivante:

http://api-doc.tourinsoft.com/#/syndication-webmarketing

3. Génération de l'événement Google Tag Manager

Grâce au contenu JSON retourné par la requête de l'étape 1, il est possible de réutiliser les codes de tracking présent dans la propriété TisTracking pour générer un événement Google Tag Manager.

Contenu de la propriété TisTracking :

application/json

Exemple: 
"TisTracking": {
    "SyndicObjectId": "HOTAQU000V501517",
    "CodeOffre": "22-HOTAQU000V501517-",
    "CodeStructure": "7-",
    "CodeSyndication": "2-188-95213-"
}

Google Tag Manager :

Le mapping entre les dimensions et les propriétés est le suivant:

  • dimension1: CodeStructure
  • dimension2: CodeSyndication
  • dimension3: CodeOffre
Exemple: 
event: "Nom de l'événement",
eventCategory: "Valeur de la Catégorie",
eventAction: "Valeur de l'Action",
eventLabel: "Valeur du Label",
sheet :  [
    id_sheet: "Identifiant Fiche",
    id_sit: "Identifiant SIT",
    id_reservation: "Identifiant centrale de réservation",
    name: "Nom de la fiche",
    type: "Libellé de bordereau",
    bordereau : "Code du cordereau en 3 lettres",
    city: "Ville de la fiche"
],
tourinsoft: [
    dimension1: "7-",
    dimension2: "2-188-95213-",
    dimension3: "22-HOTAQU000V501517-",
]