Pixel Tracking API

Le Pixel Tracking, également connu sous le nom de 1x1 gifs, ou clear gifs, vous permet d'enregistrer des données depuis n'importe quel site web (ou application) où JavaScript ou les requêtes POST ne sont pas autorisés, mais où vous pouvez insérer une image (alias hit GET)

Lorsqu'une requête POST est possible, veuillez préférer le http tracking API, plus pratique à utiliser.

Appel d'événement basique

Pour envoyer un appel d'événement basique en utilisant le pixel tracking, construisez une requête GET vers l'URL du point de collecte avec les paramètres de requête nécessaires. L'exemple suivant illustre un appel d'événement basique pour le suivi d'une vue de page :

GET  https://collect.commander1.com/events?tc_s={siteId}&token={yourSourceKey}&event_name=page_view&prop1=value1

Dans l'exemple ci-dessus, remplacez {siteId} par l'ID de votre site (alias workspace), {yourSourceKey} par votre clé source spécifique, et value1 par la valeur souhaitée pour prop1. N'oubliez pas d'encoder URL les valeurs de type chaîne, en particulier si elles contiennent des caractères spéciaux ou des espaces.

Appel d'événement avec objets et tableaux

Le pixel tracking permet des structures de données plus complexes comme des objets et des tableaux. Pour les inclure dans vos appels d'événements, vous pouvez imbriquer les paramètres en indiquant les objets et leurs propriétés avec des crochets pour les objets et les tableaux. Les noms de propriétés sont placés entre crochets et les propriétés imbriquées sont elles-mêmes placées dans leur propre série de crochets. L'exemple suivant montre un appel d'événement avec objets et tableaux :

{
  "event_name": "page_view",
  "tc_s": "1234",
  "token": "abcdef",
  "page_type": "product_list",
  "page_name": "Best sellers",
  "user": {
    "id": "12356",
    "email": "[email protected]",
    "consent_categories": [
      "1",
      "3"
    ]
  }
}

Pour transformer l'appel d'événement JSON ci‑dessus en forme de paramètres d'URL, suivez ces étapes :

1. Commencez avec une chaîne vide pour la forme des paramètres d'URL.

2. Copiez les paires clé-valeur au niveau supérieur de l'objet JSON (event_name, tc_s, token, page_type, page_name) telles quelles, en les séparant par des esperluettes (&).

3. Pour les objets imbriqués comme user, représentez-les dans la forme de paramètres d'URL en ajoutant la clé imbriquée en utilisant des crochets ([]).

4. Pour les valeurs de type tableau comme user[consent_categories], ajoutez [] à la clé pour indiquer un paramètre de type tableau.

5. Incluez chaque élément du tableau comme une paire clé-valeur distincte, en ajoutant également la notation entre crochets à la clé.

6. Encodez URL les valeurs de type chaîne, comme remplacer l'espace dans Best sellers avec %20 et le @ le symbole dans l'adresse e-mail par %40.

La forme transformée en paramètres d'URL pour l'appel d'événement JSON serait :

GET  https://collect.commander1.com/events?tc_s=1234&token=abcdef&event_name=page_view&page_type=product_list&page_name=Best%20sellers&user[id]=12356&user[email]=toto%40domain.fr&user[consent_categories][]=1&user[consent_categories][]=3

Gérer un tableau d'objets (ex : items)

Les tableaux d'objets peuvent également être traités dans les appels d'événements en pixel tracking. Cela vous permet d'inclure plusieurs items au sein d'un seul événement, comme un événement d'achat. Considérons un exemple de gestion d'un tableau d'objets pour les items d'un événement d'achat :

{
  "id": "O_12345",
  "revenue": 16.00,
  "value": 22.53,
  "shipping_amount": 3.33,
  "tax_amount": 3.20,
  "currency": "EUR",
  "user": {
    "id": "12356",
    "email": "[email protected]"
  },
  "items": [
    {
      "id": "SKU_12345",
      "quantity": 1,
      "product": {
        "id": "12345",
        "name": "Trex tshirt",
        "category_1": "clothes",
        "colors": ["red"],
        "price": 9.99
      }
    },
    {
      "id": "SKU_12346",
      "quantity": 1,
      "price": 9.99,
      "product": {
        "id": "12346",
        "name": "Heart tshirt",
        "colors": ["blue", "white"],
        "price": 9.99
      }
    }
  ]
}

Pour inclure le tableau d'objets dans l'appel d'événement, suivez ces étapes :

1. Incluez les paires clé-valeur au niveau supérieur de l'objet JSON comme d'habitude (id, revenue, valeur, shipping_amount, tax_amount, currency, user).

2. Pour le tableau d'objets, spécifiez la clé (par ex., items) et utilisez des crochets ([]) pour indiquer un paramètre de type tableau.

3. Incluez chaque objet du tableau comme un ensemble distinct de paires clé-valeur, en préservant la structure des objets.

4. Si nécessaire, imbriquez d'autres objets ou tableaux au sein des objets du tableau.

Exemple de transformation de l'appel d'événement JSON en forme de paramètres d'URL :

id=O_12345&revenue=16.00&value=22.53&shipping_amount=3.33&tax_amount=3.20&currency=EUR&user[id]=12356&user[email]=toto%40domain.fr&items[0][id]=SKU_12345&items[0][quantity]=1&items[0][product][id]=12345&items[0][product][name]=Trex%20tshirt&items[0][product][category_1]=clothes&items[0][product][colors][]=red&items[0][product][price]=9.99&items[1][id]=SKU_12346&items[1][quantity]=1&items[1][price]=9.99&items[1][product][id]=12346&items[1][product][name]=Heart%20tshirt&items[1][product][colors][]=blue&items[1][product][colors][]=white&items[1][product][price]=9.99

Dans la forme transformée en paramètres d'URL, chaque item du tableau est représenté par son index, suivi des clés et des valeurs de l'objet imbriqué.