PushizoDocs

Web kişiselleştirme

Web kişiselleştirme — 8 işlem (GET /v1/apps/{appId}/web-personalizations, POST /v1/apps/{appId}/web-personalizations, GET /v1/apps/{appId}/web-personalizations/{personalizationId}, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

Sitedeki öğeleri (CSS seçici) kişiye göre değiştiren deneyimler: metin, görsel, bağlantı, gizle/göster; sayfa koşulları, kitle ve segment hedefleme, A/B (kontrol grubu), dönüşüm hedefi ve günlük rapor. Değişiklikleri Web SDK uygular; HTML yazılmaz. Growth+ planı gerekir.

Taban adres: https://api.pushizo.com · Etiket: web-personalizations · Etkileşimli belge (Scalar)

İşlemler

YöntemYolİşlem
GET/v1/apps/{appId}/web-personalizationsWeb kişiselleştirme deneyimleri
POST/v1/apps/{appId}/web-personalizationsKişiselleştirme deneyimi oluştur (taslak)
GET/v1/apps/{appId}/web-personalizations/{personalizationId}Kişiselleştirme deneyimi detayı ve istatistikleri
PATCH/v1/apps/{appId}/web-personalizations/{personalizationId}Kişiselleştirme deneyimini düzenle
DELETE/v1/apps/{appId}/web-personalizations/{personalizationId}Kişiselleştirme deneyimini sil (olaylarıyla birlikte)
GET/v1/apps/{appId}/web-personalizations/{personalizationId}/reportGünlük seri
POST/v1/apps/{appId}/web-personalizations/{personalizationId}/statusYayınla / duraklat / arşivle
POST/v1/apps/{appId}/web-personalizations/{personalizationId}/winnerA/B kazananını seç (SDK yalnız kazananın değişikliklerini uygular)

Ayrıntılar

Web kişiselleştirme deneyimleri

GET/v1/apps/{appId}/web-personalizationsDene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
limitsorguintegerHayırVarsayılan: 50; Aralık: 1–20050
cursorsorgustringHayırUzunluk: 1–∞"eyJpZCI6Im1zZ18wMUpE…"
statussorguenumHayırDeğerler: "draft", "active", "paused", "archived""draft"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: WebPersonalizationPage

AlanTürZorunluAçıklama
dataarray<object>Evet
data[].idstringEvet
data[].app_idstringEvet
data[].namestringEvet
data[].statusenumEvetDeğerler: "draft", "active", "paused", "archived"
data[].priorityintegerEvet
data[].changesarray<object>Evet
data[].variantsarray<object>Evet
data[].variants[].idstringEvetUzunluk: 1–64
data[].variants[].namestringEvetUzunluk: 1–60
data[].variants[].weight_percentintegerEvetAralık: 1–99
data[].variants[].changesarray<object>EvetÖğe: 0–20
data[].ab_testobjectEvet
data[].ab_test.winner_variant_idstring | nullEvet
data[].ab_test.decided_atstring | nullEvet
data[].ab_test.decided_bystring | nullEvet
data[].conditionsobjectEvet
data[].conditions.url_rulesarray<object>HayırÖğe: 0–10
data[].conditions.utm_rulesarray<object>HayırÖğe: 0–5
data[].conditions.visitsobjectHayır
data[].targetingobjectEvet
data[].targeting.included_segmentsarray<string>HayırÖğe: 0–20
data[].targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
data[].targeting.visitorenumHayırDeğerler: "all", "new", "returning"
data[].targeting.devicesarray<enum>HayırÖğe: 0–3
data[].goalobject | nullEvet
data[].start_atstring | nullEvet
data[].end_atstring | nullEvet
data[].statsobjectEvet
data[].stats.visitorsintegerEvet
data[].stats.conversionsintegerEvet
data[].stats.conversion_ratenumberEvet
data[].variant_statsarray<object>Evet
data[].variant_stats[].visitorsintegerEvet
data[].variant_stats[].conversionsintegerEvet
data[].variant_stats[].conversion_ratenumberEvet
data[].variant_stats[].variant_idstringEvet
data[].variant_significanceobject | nullEvet
data[].created_atstringEvet
data[].updated_atstringEvet
next_cursorstring | nullEvet
has_morebooleanEvet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "status": "draft",
      "id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "priority": 10,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ],
      "variants": [
        {
          "name": "Sipariş bildirimleri",
          "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
          "weight_percent": 1,
          "changes": []
        }
      ],
      "ab_test": {
        "winner_variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
        "decided_at": "örnek",
        "decided_by": "örnek"
      },
      "conditions": {
        "url_rules": [
          {}
        ],
        "utm_rules": [
          {}
        ]
      },
      "targeting": {
        "included_segments": [
          "örnek"
        ],
        "excluded_segments": [
          "örnek"
        ]
      },
      "goal": {
        "type": "event",
        "event": "purchase"
      },
      "start_at": "örnek",
      "end_at": "örnek",
      "stats": {
        "visitors": 1,
        "conversions": 1,
        "conversion_rate": 1.5
      },
      "variant_stats": [
        {
          "visitors": 1,
          "conversions": 1,
          "conversion_rate": 1.5,
          "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
        }
      ],
      "variant_significance": {
        "leader": "örnek",
        "p_value": 149.9,
        "significant": true
      },
      "created_at": "örnek",
      "updated_at": "örnek"
    }
  ],
  "next_cursor": "eyJpZCI6Im1zZ18wMUpE…",
  "has_more": true
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kişiselleştirme deneyimi oluştur (taslak)

POST/v1/apps/{appId}/web-personalizationsDene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: CreateWebPersonalizationDto

AlanTürZorunluAçıklama
namestringEvetUzunluk: 2–100
changesarray<object>HayırÖğe: 0–20
variantsarray<object>HayırÖğe: 0–4
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
conditionsobjectHayır
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectHayır
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullHayır
priorityintegerHayırAralık: 0–100
start_atstring (date-time) | nullHayır
end_atstring (date-time) | nullHayır

Örnek:

{
  "name": "Sipariş bildirimleri",
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all"
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  }
}

Yanıtlar

201 — Başarılı.

Şema: WebPersonalization

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
namestringEvet
statusenumEvetDeğerler: "draft", "active", "paused", "archived"
priorityintegerEvet
changesarray<object>Evet
variantsarray<object>Evet
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
ab_testobjectEvet
ab_test.winner_variant_idstring | nullEvet
ab_test.decided_atstring | nullEvet
ab_test.decided_bystring | nullEvet
conditionsobjectEvet
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectEvet
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullEvet
start_atstring | nullEvet
end_atstring | nullEvet
statsobjectEvet
stats.visitorsintegerEvet
stats.conversionsintegerEvet
stats.conversion_ratenumberEvet
variant_statsarray<object>Evet
variant_stats[].visitorsintegerEvet
variant_stats[].conversionsintegerEvet
variant_stats[].conversion_ratenumberEvet
variant_stats[].variant_idstringEvet
variant_significanceobject | nullEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "priority": 10,
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "ab_test": {
    "winner_variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "decided_at": "örnek",
    "decided_by": "örnek"
  },
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all",
    "devices": [
      "desktop"
    ]
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  },
  "start_at": "örnek",
  "end_at": "örnek",
  "stats": {
    "visitors": 1,
    "conversions": 1,
    "conversion_rate": 1.5
  },
  "variant_stats": [
    {
      "visitors": 1,
      "conversions": 1,
      "conversion_rate": 1.5,
      "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ],
  "variant_significance": {
    "leader": "örnek",
    "p_value": 149.9,
    "significant": true
  },
  "created_at": "örnek",
  "updated_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all"
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  }
}'

Kişiselleştirme deneyimi detayı ve istatistikleri

GET/v1/apps/{appId}/web-personalizations/{personalizationId}Dene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
personalizationIdyolstringEvet"wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: WebPersonalization

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
namestringEvet
statusenumEvetDeğerler: "draft", "active", "paused", "archived"
priorityintegerEvet
changesarray<object>Evet
variantsarray<object>Evet
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
ab_testobjectEvet
ab_test.winner_variant_idstring | nullEvet
ab_test.decided_atstring | nullEvet
ab_test.decided_bystring | nullEvet
conditionsobjectEvet
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectEvet
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullEvet
start_atstring | nullEvet
end_atstring | nullEvet
statsobjectEvet
stats.visitorsintegerEvet
stats.conversionsintegerEvet
stats.conversion_ratenumberEvet
variant_statsarray<object>Evet
variant_stats[].visitorsintegerEvet
variant_stats[].conversionsintegerEvet
variant_stats[].conversion_ratenumberEvet
variant_stats[].variant_idstringEvet
variant_significanceobject | nullEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "priority": 10,
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "ab_test": {
    "winner_variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "decided_at": "örnek",
    "decided_by": "örnek"
  },
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all",
    "devices": [
      "desktop"
    ]
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  },
  "start_at": "örnek",
  "end_at": "örnek",
  "stats": {
    "visitors": 1,
    "conversions": 1,
    "conversion_rate": 1.5
  },
  "variant_stats": [
    {
      "visitors": 1,
      "conversions": 1,
      "conversion_rate": 1.5,
      "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ],
  "variant_significance": {
    "leader": "örnek",
    "p_value": 149.9,
    "significant": true
  },
  "created_at": "örnek",
  "updated_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations/wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kişiselleştirme deneyimini düzenle

PATCH/v1/apps/{appId}/web-personalizations/{personalizationId}Dene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
personalizationIdyolstringEvet"wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: UpdateWebPersonalizationDto

AlanTürZorunluAçıklama
namestringHayırUzunluk: 2–100
changesarray<object>HayırÖğe: 0–20
variantsarray<object>HayırÖğe: 0–4
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
conditionsobjectHayır
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectHayır
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullHayır
priorityintegerHayırAralık: 0–100
start_atstring (date-time) | nullHayır
end_atstring (date-time) | nullHayır

Örnek:

{
  "name": "Sipariş bildirimleri",
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all"
  }
}

Yanıtlar

200 — Başarılı.

Şema: WebPersonalization

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
namestringEvet
statusenumEvetDeğerler: "draft", "active", "paused", "archived"
priorityintegerEvet
changesarray<object>Evet
variantsarray<object>Evet
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
ab_testobjectEvet
ab_test.winner_variant_idstring | nullEvet
ab_test.decided_atstring | nullEvet
ab_test.decided_bystring | nullEvet
conditionsobjectEvet
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectEvet
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullEvet
start_atstring | nullEvet
end_atstring | nullEvet
statsobjectEvet
stats.visitorsintegerEvet
stats.conversionsintegerEvet
stats.conversion_ratenumberEvet
variant_statsarray<object>Evet
variant_stats[].visitorsintegerEvet
variant_stats[].conversionsintegerEvet
variant_stats[].conversion_ratenumberEvet
variant_stats[].variant_idstringEvet
variant_significanceobject | nullEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "priority": 10,
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "ab_test": {
    "winner_variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "decided_at": "örnek",
    "decided_by": "örnek"
  },
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all",
    "devices": [
      "desktop"
    ]
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  },
  "start_at": "örnek",
  "end_at": "örnek",
  "stats": {
    "visitors": 1,
    "conversions": 1,
    "conversion_rate": 1.5
  },
  "variant_stats": [
    {
      "visitors": 1,
      "conversions": 1,
      "conversion_rate": 1.5,
      "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ],
  "variant_significance": {
    "leader": "örnek",
    "p_value": 149.9,
    "significant": true
  },
  "created_at": "örnek",
  "updated_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X PATCH "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations/wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all"
  }
}'

Kişiselleştirme deneyimini sil (olaylarıyla birlikte)

DELETE/v1/apps/{appId}/web-personalizations/{personalizationId}Dene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
personalizationIdyolstringEvet"wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: Ok

AlanTürZorunluAçıklama
oktrueEvet

Örnek yanıt:

{
  "ok": true
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X DELETE "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations/wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Günlük seri

GET/v1/apps/{appId}/web-personalizations/{personalizationId}/reportDene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
personalizationIdyolstringEvet"wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W"
dayssorguintegerHayırAralık: 1–3651
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

Yanıtlar

200 — Başarılı.

Şema: WebPersonalizationReport

AlanTürZorunluAçıklama
personalization_idstringEvet
daysintegerEvet
dailyarray<object>Evet
daily[].datestringEvet
daily[].visitorsintegerEvet
daily[].conversionsintegerEvet
totalsobjectEvet
totals.visitorsintegerEvet
totals.conversionsintegerEvet
totals.conversion_ratenumberEvet

Örnek yanıt:

{
  "personalization_id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "days": 1,
  "daily": [
    {
      "date": "örnek",
      "visitors": 1,
      "conversions": 1
    }
  ],
  "totals": {
    "visitors": 1,
    "conversions": 1,
    "conversion_rate": 1.5
  }
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X GET "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations/wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W/report" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Yayınla / duraklat / arşivle

POST/v1/apps/{appId}/web-personalizations/{personalizationId}/statusDene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
personalizationIdyolstringEvet"wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: WebPersonalizationStatusDto

AlanTürZorunluAçıklama
statusenumEvetDeğerler: "draft", "active", "paused", "archived"

Örnek:

{
  "status": "draft"
}

Yanıtlar

200 — Başarılı.

Şema: WebPersonalization

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
namestringEvet
statusenumEvetDeğerler: "draft", "active", "paused", "archived"
priorityintegerEvet
changesarray<object>Evet
variantsarray<object>Evet
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
ab_testobjectEvet
ab_test.winner_variant_idstring | nullEvet
ab_test.decided_atstring | nullEvet
ab_test.decided_bystring | nullEvet
conditionsobjectEvet
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectEvet
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullEvet
start_atstring | nullEvet
end_atstring | nullEvet
statsobjectEvet
stats.visitorsintegerEvet
stats.conversionsintegerEvet
stats.conversion_ratenumberEvet
variant_statsarray<object>Evet
variant_stats[].visitorsintegerEvet
variant_stats[].conversionsintegerEvet
variant_stats[].conversion_ratenumberEvet
variant_stats[].variant_idstringEvet
variant_significanceobject | nullEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "priority": 10,
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "ab_test": {
    "winner_variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "decided_at": "örnek",
    "decided_by": "örnek"
  },
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all",
    "devices": [
      "desktop"
    ]
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  },
  "start_at": "örnek",
  "end_at": "örnek",
  "stats": {
    "visitors": 1,
    "conversions": 1,
    "conversion_rate": 1.5
  },
  "variant_stats": [
    {
      "visitors": 1,
      "conversions": 1,
      "conversion_rate": 1.5,
      "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ],
  "variant_significance": {
    "leader": "örnek",
    "p_value": 149.9,
    "significant": true
  },
  "created_at": "örnek",
  "updated_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations/wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W/status" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "draft"
}'

A/B kazananını seç (SDK yalnız kazananın değişikliklerini uygular)

POST/v1/apps/{appId}/web-personalizations/{personalizationId}/winnerDene (etkileşimli API belgesi, yeni sekme)

Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).

Parametreler

AdKonumTürZorunluAçıklamaÖrnek
personalizationIdyolstringEvet"wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W"
appIdyolstringEvet"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"

İstek gövdesi (zorunlu)

Şema: WebPersonalizationWinnerDto

AlanTürZorunluAçıklama
variant_idstringEvetUzunluk: 1–64

Örnek:

{
  "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
}

Yanıtlar

200 — Başarılı.

Şema: WebPersonalization

AlanTürZorunluAçıklama
idstringEvet
app_idstringEvet
namestringEvet
statusenumEvetDeğerler: "draft", "active", "paused", "archived"
priorityintegerEvet
changesarray<object>Evet
variantsarray<object>Evet
variants[].idstringEvetUzunluk: 1–64
variants[].namestringEvetUzunluk: 1–60
variants[].weight_percentintegerEvetAralık: 1–99
variants[].changesarray<object>EvetÖğe: 0–20
ab_testobjectEvet
ab_test.winner_variant_idstring | nullEvet
ab_test.decided_atstring | nullEvet
ab_test.decided_bystring | nullEvet
conditionsobjectEvet
conditions.url_rulesarray<object>HayırÖğe: 0–10
conditions.url_rules[].openumEvetDeğerler: "equals", "contains", "starts_with", "not_contains", "matches"
conditions.url_rules[].valuestringEvetUzunluk: 1–500
conditions.utm_rulesarray<object>HayırÖğe: 0–5
conditions.utm_rules[].paramenumEvetDeğerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"
conditions.utm_rules[].openumEvetDeğerler: "equals", "contains", "exists"
conditions.utm_rules[].valuestringHayırUzunluk: 0–200
conditions.visitsobjectHayır
conditions.visits.openumEvetDeğerler: "gte", "lte", "eq"
conditions.visits.valueintegerEvetAralık: 1–10000
targetingobjectEvet
targeting.included_segmentsarray<string>HayırÖğe: 0–20
targeting.excluded_segmentsarray<string>HayırÖğe: 0–20
targeting.visitorenumHayırDeğerler: "all", "new", "returning"
targeting.devicesarray<enum>HayırÖğe: 0–3
goalobject | nullEvet
start_atstring | nullEvet
end_atstring | nullEvet
statsobjectEvet
stats.visitorsintegerEvet
stats.conversionsintegerEvet
stats.conversion_ratenumberEvet
variant_statsarray<object>Evet
variant_stats[].visitorsintegerEvet
variant_stats[].conversionsintegerEvet
variant_stats[].conversion_ratenumberEvet
variant_stats[].variant_idstringEvet
variant_significanceobject | nullEvet
created_atstringEvet
updated_atstringEvet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "draft",
  "id": "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "priority": 10,
  "changes": [
    {
      "action": "text",
      "selector": "değer",
      "text": {
        "tr": "Siparişiniz yola çıktı",
        "en": "Your order has shipped"
      }
    }
  ],
  "variants": [
    {
      "name": "Sipariş bildirimleri",
      "id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "weight_percent": 1,
      "changes": [
        {
          "action": "text",
          "selector": "değer",
          "text": {}
        }
      ]
    }
  ],
  "ab_test": {
    "winner_variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W",
    "decided_at": "örnek",
    "decided_by": "örnek"
  },
  "conditions": {
    "url_rules": [
      {
        "op": "equals",
        "value": "user_42"
      }
    ],
    "utm_rules": [
      {
        "param": "utm_source",
        "op": "equals",
        "value": "user_42"
      }
    ],
    "visits": {
      "op": "gte",
      "value": 150
    }
  },
  "targeting": {
    "included_segments": [
      "örnek"
    ],
    "excluded_segments": [
      "örnek"
    ],
    "visitor": "all",
    "devices": [
      "desktop"
    ]
  },
  "goal": {
    "type": "event",
    "event": "purchase"
  },
  "start_at": "örnek",
  "end_at": "örnek",
  "stats": {
    "visitors": 1,
    "conversions": 1,
    "conversion_rate": 1.5
  },
  "variant_stats": [
    {
      "visitors": 1,
      "conversions": 1,
      "conversion_rate": 1.5,
      "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
    }
  ],
  "variant_significance": {
    "leader": "örnek",
    "p_value": 149.9,
    "significant": true
  },
  "created_at": "örnek",
  "updated_at": "örnek"
}

Hata yanıtları ortak zarfla döner (error.code, message, details, request_id): hata kataloğu. Tüm yanıtlar X-RateLimit-* başlıklarını taşır (hız sınırları).

Örnekler

curl -X POST "https://api.pushizo.com/v1/apps/app_01JD3W5Q7X9K2M4N6P8R0T1V3W/web-personalizations/wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W/winner" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
}'

Bu sayfada