واجهات API التسويقية للمتاجر الإلكترونية

POST /api/v3/customers
{
  "customer_id": "cust_12345",
  "email": "customer@example.com",
  "phone": "+1234567890",
  "attributes": {
    "total_orders": 15,
    "total_spent": 1250.00,
    "favorite_category": "electronics",
    "last_order_date": "2024-05-15"
  }
}

POST /api/v3/events
{
  "customer_id": "cust_12345",
  "event": "product_viewed",
  "attributes": {
    "product_id": "prod_789",
    "product_name": "Wireless Headphones",
    "price": 89.99,
    "category": "electronics",
    "timestamp": "2024-05-17T10:30:00Z"
  }
}

POST /api/v3/campaigns/trigger
{
  "campaign_id": "cart_abandonment_series",
  "customer_id": "cust_12345",
  "data": {
    "cart_items": [
      {
        "product_name": "Wireless Headphones",
        "price": 89.99,
        "image_url": "https://..."
      }
    ],
    "cart_total": 89.99,
    "recovery_link": "https://store.com/cart/recover/abc123"
  }
}

POST /api/v3/products
{
  "product_id": "prod_789",
  "name": "Wireless Headphones",
  "price": 89.99,
  "original_price": 129.99,
  "in_stock": true,
  "stock_quantity": 47,
  "category": "electronics",
  "image_url": "https://...",
  "product_url": "https://store.com/products/headphones"
}

// Track a custom event from any platform
await fetch("https://api.pushwoosh.com/v3/events", {
  method: "POST",
  headers: { "Authorization": `Bearer ${API_KEY}` },
  body: JSON.stringify({
    customer_id: customerId,
    event: "order_completed",
    attributes: orderAttributes
  })
});

// iOS: track checkout flow
Pushwoosh.sharedInstance().registerForPushNotifications()

PWInAppManager.shared().postEvent("checkout_started",
  withAttributes: [
    "cart_total": 89.99,
    "item_count": 2
  ])

await pushwoosh.trackEvent(customerId, "add_to_cart", {
  product_id: "prod_789",
  product_name: "سماعات لاسلكية",
  price: 89.99,
  cart_total: 89.99
});

if (!await orderCompleted(customerId)) {
  const cartItems = await getCartItems(customerId);

  await pushwoosh.triggerCampaign({
    campaign: "cart_abandonment_email",
    customer_id: customerId,
    data: {
      cart_items: cartItems,
      cart_total: calculateTotal(cartItems),
      recovery_link: generateRecoveryLink(customerId)
    }
  });
}

await pushwoosh.triggerCampaign({
  campaign: "order_confirmation",
  customer_id: customerId,
  channels: ["email", "whatsapp"],
  data: {
    order_number: "ORD-12345",
    order_total: 89.99,
    order_items: orderItems,
    estimated_delivery: "May 20-22"
  }
});

await pushwoosh.triggerCampaign({
  campaign: "order_shipped",
  customer_id: customerId,
  channels: ["push", "sms"],
  data: {
    order_number: "ORD-12345",
    tracking_number: "1Z999AA10123456784",
    carrier: "UPS"
  }
});

await pushwoosh.trackEvent(customerId, "product_viewed", {
  product_id: "prod_789",
  category: "electronics",
  price: 89.99
});

const recommendations = await getRecommendations(customerId, {
  based_on: ["browsing_history", "purchase_history"],
  limit: 4
});

await pushwoosh.sendEmail({
  customer_id: customerId,
  template: "personalized_recommendations",
  subject: "Products you might love",
  data: {
    recommendations: recommendations.map(p => ({
      name: p.name,
      price: p.price,
      image_url: p.image_url,
      product_url: p.url
    }))
  }
});

await pushwoosh.createAlert({
  customer_id: customerId,
  product_id: "prod_789",
  channels: ["email", "push"],
  created_at: new Date()
});

app.post("/webhooks/product-restocked", async (req, res) => {
  const { product_id } = req.body;
  const alerts = await pushwoosh.getAlerts({ product_id });

  for (const alert of alerts) {
    await pushwoosh.triggerCampaign({
      campaign: "back_in_stock",
      customer_id: alert.customer_id,
      channels: alert.channels,
      data: {
        product_name: product.name,
        product_price: product.price,
        product_url: product.url
      }
    });
  }
});

await pushwoosh.registerCustomer({
  customer_id: customerId,
  email: email,
  attributes: {
    signup_date: new Date(),
    acquisition_source: "organic"
  }
});

await pushwoosh.addToJourney(customerId, "welcome_series");

const customerValue = await getCustomerLTV(customerId);
if (customerValue > 500) {
  await pushwoosh.addToSegment(customerId, "vip_customers");
  await pushwoosh.triggerCampaign({
    campaign: "vip_welcome",
    customer_id: customerId,
    data: {
      vip_benefits: ["Free shipping", "Early access", "Exclusive deals"]
    }
  });
}

GET /api/v3/analytics/campaigns/{campaign_id}

{
  "sent": 50000,
  "delivered": 48500,
  "opened": 21825,
  "clicked": 6557,
  "conversions": 784,
  "revenue": 68992.00,
  "avg_order_value": 87.99,
  "roi": 12.5
}

GET /api/v3/segments/{segment_id}/analytics

{
  "total_customers": 15000,
  "avg_ltv": 245.50,
  "avg_order_value": 82.00,
  "purchase_frequency": 3.2,
  "churn_rate": 0.08
}

GET /api/v3/analytics/products

{
  "products": [
    {
      "product_id": "prod_789",
      "views": 12500,
      "add_to_cart_rate": 0.15,
      "purchase_rate": 0.08,
      "revenue": 89990.00
    }
  ]
}