Quickstart: Send your first search events with the Events API

<?php
// Make sure to include the Composer autoloader
require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

// --- Configuration ---
$trackerId = "YOUR_TRACKER_ID";
$apiEndpoint = "https://api.luigisbox.com/";
$clientId = 6667519810961010000;

// --- Helper Function to Generate UUID v4 ---
// (Same guidv4 function as before)
function guidv4($data = null) {
    $data = $data ?? random_bytes(16);
    assert(strlen($data) == 16);
    $data[6] = chr(ord($data[6]) & 0x0f | 0x40);
    $data[8] = chr(ord($data[8]) & 0x3f | 0x80);
    return vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($data), 4));
}

// --- Helper Function using Guzzle ---
function sendLuigisBoxEvent($url, $payload) {
    // Create a new Guzzle client
    $client = new Client();

    try {
        // Make the POST request
        $response = $client->request('POST', $url, [
            'json' => $payload // 'json' option automatically encodes body and sets headers
        ]);

        echo "Response Code: " . $response->getStatusCode() . "\n";
        echo "Response Body: " . $response->getBody()->getContents() . "\n";
    } catch (RequestException $e) {
        echo "Error sending event: " . $e->getMessage() . "\n";
        if ($e->hasResponse()) {
            echo "Error Response Body: " . $e->getResponse()->getBody()->getContents() . "\n";
        }
    }
}

// --- Search View Event Data ---
$searchQueryTerm = "white shirt";
$searchResultsItems = [
    ["title" => "White shirt v-neck", "type" => "item", "url" => "39818", "position" => 1, "price" => 19],
    ["title" => "Another white shirt", "type" => "item", "url" => "39819", "position" => 2, "price" => 25]
];

$searchViewPayload = [
    "id" => guidv4(),
    "type" => "event",
    "tracker_id" => $trackerId,
    "client_id" => $clientId,
    "lists" => [
        "Search Results" => [
            "query" => ["string" => $searchQueryTerm],
            "items" => $searchResultsItems
        ]
    ],
    "platform" => "backend-php-guzzle"
];

// --- Send the Event ---
echo "Sending Search View Event...\n";
sendLuigisBoxEvent($apiEndpoint, $searchViewPayload);
?>

const axios = require('axios');
const { v4: uuidv4 } = require('uuid'); // For generating unique event IDs

// --- Configuration ---
const TRACKER_ID = "YOUR_TRACKER_ID";
const API_ENDPOINT = "https://api.luigisbox.com/";
// In a real app, client_id would come from the user's session or device
const CLIENT_ID = 6667519810961010000; // Example client_id

// --- Helper Function to Send Event ---
async function sendLuigisBoxEvent(payload) {
  try {
    const response = await axios.post(API_ENDPOINT, payload, {
      headers: {
        'Content-Type': 'application/json'
      }
    });
    console.log(`Response Code: ${response.status}`);
    console.log('Response Body:', response.data);
    // Add error handling based on response.status if needed
  } catch (error) {
    if (error.response) {
      // The request was made and the server responded with a status code
      // that falls out of the range of 2xx
      console.error(`Error sending event: ${error.response.status}`, error.response.data);
    } else if (error.request) {
      // The request was made but no response was received
      console.error('Error sending event: No response received', error.request);
    } else {
      // Something happened in setting up the request that triggered an Error
      console.error('Error sending event:', error.message);
    }
  }
}

// --- Search View Event Data ---
const searchQueryTerm = "white shirt";
const searchResultsItems = [
  {
    title: "White shirt v-neck",
    type: "item",
    url: "39818", // Unique ID matching your catalog
    position: 1,
    price: 19
  },
  {
    title: "Another white shirt",
    type: "item",
    url: "39819",
    position: 2,
    price: 25
  }
];

const searchViewPayload = {
  id: uuidv4(), // Generate a unique ID for this event
  type: "event",
  tracker_id: TRACKER_ID,
  client_id: CLIENT_ID,
  lists: {
    "Search Results": { // This exact name is critical
      query: {
        string: searchQueryTerm
      },
      items: searchResultsItems
      // Optional: filters: { "brand": "MyBrand" }
    }
  },
  platform: "backend-nodejs" // Optional
};

// --- Send the Event ---
(async () => {
  console.log("Sending Search View Event...");
  await sendLuigisBoxEvent(searchViewPayload);
})();

<?php
// (Continuing from the PHP example above, assuming sendLuigisBoxEvent, guidv4 and config are defined)

// --- Click Event Data ---
$clickedItemId = "39818";

$clickPayload = [
    "id" => guidv4(),
    "type" => "click",
    "tracker_id" => $trackerId,
    "client_id" => $clientId,
    "action" => [
        "type" => "click",
        "resource_identifier" => $clickedItemId
    ],
    "platform" => "backend-php-guzzle"
];

// --- Send the Event ---
echo "Sending Click Event...\n";
sendLuigisBoxEvent($apiEndpoint, $clickPayload);
?>

// (Continuing from the NodeJS example above, assuming sendLuigisBoxEvent, uuidv4 and config are defined)

// --- Click Event Data ---
const clickedItemId = "39818"; // ID of the item that was clicked

const clickPayload = {
  id: uuidv4(),
  type: "click",
  tracker_id: TRACKER_ID,
  client_id: CLIENT_ID,
  action: {
    type: "click",
    resource_identifier: clickedItemId
  },
  platform: "backend-nodejs"
};

// --- Send the Event ---
(async () => {
  console.log("Sending Click Event...");
  await sendLuigisBoxEvent(clickPayload);
})();