Attribution Tracking

{
  "type": "PURCHASE",
  "customer_id": "YOUR_TEST_CUSTOMER",
  "brand_id": null,
  "fulfilled": true,
  "currency": "USD",
  "order": {
    "purchase_id": "qa-attribution-order-001",
    "value": 10,
    "payment_method": "CASH",
    "products": [
      { "sku": "YOUR_TEST_SKU", "amount": 1, "value": 10 }
    ]
  },
  "attribution": {
    "utm_source": "braze",
    "utm_medium": "email",
    "utm_campaign": "qa_attribution",
    "utm_content": "button",
    "utm_term": "offer"
  }
}

interface AttributionData {
  tracking_id?: string; // Unique identifier for tracking user sessions
  utm_source?: string; // Traffic source (e.g., "google", "facebook")
  utm_medium?: string; // Marketing medium (e.g., "cpc", "email", "social")
  utm_campaign?: string; // Campaign name (e.g., "summer-sale-2024")
  utm_term?: string; // Paid search keywords
  utm_content?: string; // Ad variation or email version
  utm_referral?: string; // Specific referral source
  gclid?: string;
  gbraid?: string;
  wbraid?: string;
  fbclid?: string;
  ttclid?: string;
  fbc?: string; // Actual Meta _fbc cookie
  fbp?: string; // Actual Meta _fbp cookie
  ttp?: string; // Actual TikTok _ttp cookie
  event_source_url?: string; // URL where this event occurred
}

// This happens automatically in Masivo's deeplink handler
import { v4 as uuidv4 } from "uuid";

const tracking_id = uuidv4(); // e.g., "f47ac10b-58cc-4372-a567-0e02b2c3d479"

// Added to attribution data
const attribution = {
  tracking_id,
  utm_source: "email",
  utm_medium: "newsletter",
  utm_campaign: "spring-collection"
};

// Appended to destination URL
const destinationUrl =
  "https://yourapp.com/products?$tracking_id=f47ac10b-58cc-4372-a567-0e02b2c3d479";

// Mobile app or web application
const extractTrackingId = (url: string): string | null => {
  try {
    const urlObj = new URL(url);
    return urlObj.searchParams.get("$tracking_id");
  } catch (error) {
    console.error("Invalid URL:", error);
    return null;
  }
};

// Usage examples
const tracking_id = extractTrackingId(window.location.href);
// Or from deep link parameters in mobile apps
const tracking_id = extractTrackingId(incomingDeepLink);

// Store for later use in events
if (tracking_id) {
  // Store in session storage, app state, or local storage
  sessionStorage.setItem("masivo_tracking_id", tracking_id);
}

const sendEventWithAttribution = async (eventData: {
  type: string;
  customer_id: string;
  brand_id: string | null;
  [key: string]: any;
}) => {
  // Retrieve stored tracking ID
  const tracking_id = sessionStorage.getItem("masivo_tracking_id");

  const payload = {
    ...eventData,
    attribution: {
      tracking_id,
      // Add other attribution parameters as needed
      utm_source: "mobile_app",
      utm_medium: "push_notification"
    }
  };

  const response = await fetch(
    "https://app.masivo.ai/api/storefront/v1/behavior/events",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify(payload)
    }
  );

  return response.json();
};

// Example: Track purchase with attribution
await sendEventWithAttribution({
  type: "PURCHASE",
  customer_id: "customer-123",
  brand_id: "brand-456",
  order: {
    purchase_id: "order-789",
    value: 99.99,
    products: [
      {
        sku: "PROD-001",
        amount: 1,
        value: 99.99
      }
    ],
    payment_method: "CREDIT"
  }
});

const sendPurchaseWithUTMTracking = async (
  customerId: string,
  orderData: any,
  campaignInfo: {
    source: string;
    medium: string;
    campaign: string;
    term?: string;
    content?: string;
  }
) => {
  const attribution = {
    tracking_id: sessionStorage.getItem("masivo_tracking_id"),
    utm_source: campaignInfo.source,
    utm_medium: campaignInfo.medium,
    utm_campaign: campaignInfo.campaign,
    utm_term: campaignInfo.term,
    utm_content: campaignInfo.content,
    revenue: orderData.total
  };

  const eventData = {
    type: "PURCHASE",
    customer_id: customerId,
    brand_id: orderData.brand_id,
    attribution,
    order: {
      purchase_id: orderData.id,
      value: orderData.total,
      products: orderData.items.map(item => ({
        sku: item.sku,
        amount: item.quantity,
        value: item.price
      })),
      payment_method: orderData.payment_method
    }
  };

  return await fetch(
    "https://app.masivo.ai/api/storefront/v1/behavior/events",
    {
      method: "POST",
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify(eventData)
    }
  );
};

// Usage example
await sendPurchaseWithUTMTracking("customer-123", orderData, {
  source: "google",
  medium: "social",
  campaign: "spring-collection-launch",
  content: "carousel-ad-variant-a"
});

const trackRevenueAttribution = async (
  customerId: string,
  purchaseData: {
    order_value: number;
    acquisition_cost: number;
    campaign_source: string;
  }
) => {
  const attribution = {
    tracking_id: sessionStorage.getItem("masivo_tracking_id"),
    revenue: purchaseData.order_value,
    cost: purchaseData.acquisition_cost,
    utm_source: purchaseData.campaign_source,
    utm_medium: "paid_advertising"
  };

  const eventData = {
    type: "PURCHASE",
    customer_id: customerId,
    brand_id: "your-brand-id",
    attribution,
    order: {
      purchase_id: `order-${Date.now()}`,
      value: purchaseData.order_value,
      products: [
        /* order products */
      ],
      payment_method: "CREDIT"
    }
  };

  return await sendEventWithAttribution(eventData);
};

const trackCampaignCost = async (
  customerId: string,
  action: string,
  campaignCost: number
) => {
  const attribution = {
    tracking_id: sessionStorage.getItem("masivo_tracking_id"),
    cost: campaignCost,
    utm_source: "google_ads",
    utm_medium: "cpc",
    utm_campaign: "holiday-sale-2024"
  };

  const eventData = {
    type: action, // e.g., "ADD_TO_CART", "VIEW_PRODUCT"
    customer_id: customerId,
    brand_id: "your-brand-id",
    attribution
  };

  return await sendEventWithAttribution(eventData);
};