Kaynaklar · Geliştiriciler

Server Events APIPOST /v1/events

Kendi yazılımınızı Data4Ad pipeline'ına bağlayın; Meta CAPI veya Google Ads API dokümantasyonunu okuyup entegre etmenize benzer bir deneyim.

AuthBearer key

PIISHA-256

Versiyon/v1/

API anahtarı al Güvenlik

Endpoint

POST /v1/events

Auth

Bearer store key

PII

Hash only

Endpoint

POST https://api.data4ad.com/v1/events

Üretim ortamında API adresi api.data4ad.com olabilir; panel ve eklenti yapılandırmanızdaki base URL'yi kullanın.

Kimlik doğrulama

Authorization: Bearer <store_api_key>
Content-Type: application/json

API anahtarı panelden mağaza oluşturduktan sonra bir kez gösterilir. store_id body'de gönderilmez; anahtardan çözümlenir.

event_name

İzin verilen değerler:

PageViewLeadAddToCartInitiateCheckoutPurchaseRefund

Body şeması

JSON

{
  "event_name": "Purchase",
  "event_id": "d4a_evt_...",
  "event_time": "2026-07-25T10:15:00Z",
  "visitor_id": "d4a_vis_...",
  "order": {
    "external_order_id": "12345",
    "order_status": "completed",
    "currency": "TRY",
    "value": 1499.90,
    "items": [
      {
        "external_id": "sku-001",
        "name": "Ürün adı",
        "quantity": 1,
        "unit_price": 1499.90
      }
    ]
  },
  "customer": {
    "email_hash": "sha256...",
    "phone_hash": "sha256...",
    "external_id": "wc_customer_42"
  },
  "consent": {
    "ad_storage": "granted",
    "analytics_storage": "granted"
  },
  "source_platform": "woocommerce",
  "recovery_source": "webhook"
}

PII: E-posta ve telefon yalnızca SHA-256 hash (64 hex karakter) olarak kabul edilir. Ham PII API sınırında reddedilir.
event_id: Yoksa sunucu üretir; d4a.js ile paylaşılıyorsa aynı değer kullanılmalı (Meta dedup).
source_platform: String: woocommerce, shopify, custom vb.
recovery_source: webhook (varsayılan) veya reconciliation.

Örnekler

curl -X POST https://api.data4ad.com/v1/events \
  -H "Authorization: Bearer d4a_pk_YOUR_STORE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_name": "Purchase",
    "event_id": "d4a_evt_checkout_abc123",
    "event_time": "2026-07-25T10:15:00Z",
    "visitor_id": "d4a_vis_xyz789",
    "order": {
      "external_order_id": "12345",
      "order_status": "completed",
      "currency": "TRY",
      "value": 1499.90
    },
    "customer": {
      "email_hash": "64_char_sha256_hex_here",
      "phone_hash": "64_char_sha256_hex_here"
    },
    "consent": {
      "ad_storage": "granted",
      "analytics_storage": "granted"
    },
    "source_platform": "custom"
  }'

Hata kodları

400

Doğrulama hatası

Geçersiz body şeması, eksik zorunlu alan veya hash formatı hatası (email_hash / phone_hash 64 karakter SHA-256 hex olmalı; ham PII kabul edilmez).

401

Yetkisiz

Geçersiz veya eksik Authorization: Bearer <store_api_key> başlığı.

409

event_id çakışması

Aynı event_id bu mağazada farklı bir sipariş veya durum için zaten kullanılmış. Her event_id benzersiz bir olayı temsil etmeli; aynı sipariş tekrarı idempotency ile otomatik yönetilir.

429

Rate limit

Mağaza API anahtarı başına istek kotası aşıldı. Bir anahtarın kötüye kullanımı diğer mağazaları etkilememesi için limit uygulanır.

API versiyonu /v1/ altındadır. Geriye dönük uyumluluk taahhüdü destek yükü getirir; entegrasyonunuzda versiyonu sabitleyin.

Hemen başlayın

Meta satışlarını 14 gün ücretsiz artırın.

Mağazanızı yalnızca 10 dakika içerisinde bağlayarak, bugünden itibaren daha fazla kazanmaya başlayın.

Ücretsiz dene Entegrasyonlar