Przejdź do treści

Meta. Event Purchase. Parametry value, currency i contents w CAPI ecommerce.

Na czym to polega w sklepie

Event Purchase raportuje zakończony zakup. W CAPI w polu custom_data przekazujesz value, currency, order_id oraz contents (tablica produktów: id, quantity, item_price). To podstawa optymalizacji kampanii pod wartość koszyka.

Przykład ze sklepu internetowego

Sklep wysyła purchase po potwierdzeniu płatności z backendu:

POST /{pixel-id}/events
{
  "data": [{
    "event_name": "Purchase",
    "event_time": 1710000123,
    "action_source": "website",
    "event_id": "ORD-9912",
    "user_data": {
      "em": ["7b17fb0bd7f3515c055bf12b4aec26fd3da328203679f26d06cc8932c9093d6c"],
      "client_ip_address": "203.0.113.1",
      "client_user_agent": "Mozilla/5.0...",
      "fbc": "fb.1.1710000000.AbCdEf",
      "fbp": "fb.1.1710000000.1234567890"
    },
    "custom_data": {
      "value": 449.97,
      "currency": "PLN",
      "order_id": "ORD-9912",
      "contents": [
        { "id": "SKU-42", "quantity": 2, "item_price": 149.99 },
        { "id": "SKU-7",  "quantity": 1, "item_price": 149.99 }
      ]
    }
  }]
}

Co zrobić po stronie biznesu

  • value = przychód brutto zamówienia zgodny z backendem - inaczej ROAS w Meta jest fałszywy.
  • content_ids muszą odpowiadać feedowi katalogowemu (SKU).
  • action_source: website | app | phone_call - wybierz zgodnie z kanałem.

W skrócie

Purchase w CAPI wymaga spójnych wartości finansowych i produktowych. Mapuj pola 1:1 z systemu zamówień sklepu.