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öntem | Yol | İşlem |
|---|---|---|
GET | /v1/apps/{appId}/web-personalizations | Web kişiselleştirme deneyimleri |
POST | /v1/apps/{appId}/web-personalizations | Kiş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}/report | Günlük seri |
POST | /v1/apps/{appId}/web-personalizations/{personalizationId}/status | Yayınla / duraklat / arşivle |
POST | /v1/apps/{appId}/web-personalizations/{personalizationId}/winner | A/B kazananını seç (SDK yalnız kazananın değişikliklerini uygular) |
Ayrıntılar
Web kişiselleştirme deneyimleri
Kimlik doğrulama: API anahtarı — kapsam analytics:read (admin her kapsamı içerir).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
limit | sorgu | integer | Hayır | Varsayılan: 50; Aralık: 1–200 | 50 |
cursor | sorgu | string | Hayır | Uzunluk: 1–∞ | "eyJpZCI6Im1zZ18wMUpE…" |
status | sorgu | enum | Hayır | Değerler: "draft", "active", "paused", "archived" | "draft" |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: WebPersonalizationPage
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
data | array<object> | Evet | |
data[].id | string | Evet | |
data[].app_id | string | Evet | |
data[].name | string | Evet | |
data[].status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
data[].priority | integer | Evet | |
data[].changes | array<object> | Evet | |
data[].variants | array<object> | Evet | |
data[].variants[].id | string | Evet | Uzunluk: 1–64 |
data[].variants[].name | string | Evet | Uzunluk: 1–60 |
data[].variants[].weight_percent | integer | Evet | Aralık: 1–99 |
data[].variants[].changes | array<object> | Evet | Öğe: 0–20 |
data[].ab_test | object | Evet | |
data[].ab_test.winner_variant_id | string | null | Evet | |
data[].ab_test.decided_at | string | null | Evet | |
data[].ab_test.decided_by | string | null | Evet | |
data[].conditions | object | Evet | |
data[].conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
data[].conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
data[].conditions.visits | object | Hayır | |
data[].targeting | object | Evet | |
data[].targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
data[].targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
data[].targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
data[].targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
data[].goal | object | null | Evet | |
data[].start_at | string | null | Evet | |
data[].end_at | string | null | Evet | |
data[].stats | object | Evet | |
data[].stats.visitors | integer | Evet | |
data[].stats.conversions | integer | Evet | |
data[].stats.conversion_rate | number | Evet | |
data[].variant_stats | array<object> | Evet | |
data[].variant_stats[].visitors | integer | Evet | |
data[].variant_stats[].conversions | integer | Evet | |
data[].variant_stats[].conversion_rate | number | Evet | |
data[].variant_stats[].variant_id | string | Evet | |
data[].variant_significance | object | null | Evet | |
data[].created_at | string | Evet | |
data[].updated_at | string | Evet | |
next_cursor | string | null | Evet | |
has_more | boolean | Evet |
Ö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)
Kimlik doğrulama: API anahtarı — kapsam admin (admin her kapsamı içerir).
Parametreler
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: CreateWebPersonalizationDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | Evet | Uzunluk: 2–100 |
changes | array<object> | Hayır | Öğe: 0–20 |
variants | array<object> | Hayır | Öğe: 0–4 |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
conditions | object | Hayır | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Hayır | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Hayır | |
priority | integer | Hayır | Aralık: 0–100 |
start_at | string (date-time) | null | Hayır | |
end_at | string (date-time) | null | Hayı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
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
app_id | string | Evet | |
name | string | Evet | |
status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
priority | integer | Evet | |
changes | array<object> | Evet | |
variants | array<object> | Evet | |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
ab_test | object | Evet | |
ab_test.winner_variant_id | string | null | Evet | |
ab_test.decided_at | string | null | Evet | |
ab_test.decided_by | string | null | Evet | |
conditions | object | Evet | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Evet | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Evet | |
start_at | string | null | Evet | |
end_at | string | null | Evet | |
stats | object | Evet | |
stats.visitors | integer | Evet | |
stats.conversions | integer | Evet | |
stats.conversion_rate | number | Evet | |
variant_stats | array<object> | Evet | |
variant_stats[].visitors | integer | Evet | |
variant_stats[].conversions | integer | Evet | |
variant_stats[].conversion_rate | number | Evet | |
variant_stats[].variant_id | string | Evet | |
variant_significance | object | null | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Ö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
/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
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
personalizationId | yol | string | Evet | "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: WebPersonalization
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
app_id | string | Evet | |
name | string | Evet | |
status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
priority | integer | Evet | |
changes | array<object> | Evet | |
variants | array<object> | Evet | |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
ab_test | object | Evet | |
ab_test.winner_variant_id | string | null | Evet | |
ab_test.decided_at | string | null | Evet | |
ab_test.decided_by | string | null | Evet | |
conditions | object | Evet | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Evet | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Evet | |
start_at | string | null | Evet | |
end_at | string | null | Evet | |
stats | object | Evet | |
stats.visitors | integer | Evet | |
stats.conversions | integer | Evet | |
stats.conversion_rate | number | Evet | |
variant_stats | array<object> | Evet | |
variant_stats[].visitors | integer | Evet | |
variant_stats[].conversions | integer | Evet | |
variant_stats[].conversion_rate | number | Evet | |
variant_stats[].variant_id | string | Evet | |
variant_significance | object | null | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Ö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
/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
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
personalizationId | yol | string | Evet | "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: UpdateWebPersonalizationDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | Hayır | Uzunluk: 2–100 |
changes | array<object> | Hayır | Öğe: 0–20 |
variants | array<object> | Hayır | Öğe: 0–4 |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
conditions | object | Hayır | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Hayır | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Hayır | |
priority | integer | Hayır | Aralık: 0–100 |
start_at | string (date-time) | null | Hayır | |
end_at | string (date-time) | null | Hayı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
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
app_id | string | Evet | |
name | string | Evet | |
status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
priority | integer | Evet | |
changes | array<object> | Evet | |
variants | array<object> | Evet | |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
ab_test | object | Evet | |
ab_test.winner_variant_id | string | null | Evet | |
ab_test.decided_at | string | null | Evet | |
ab_test.decided_by | string | null | Evet | |
conditions | object | Evet | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Evet | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Evet | |
start_at | string | null | Evet | |
end_at | string | null | Evet | |
stats | object | Evet | |
stats.visitors | integer | Evet | |
stats.conversions | integer | Evet | |
stats.conversion_rate | number | Evet | |
variant_stats | array<object> | Evet | |
variant_stats[].visitors | integer | Evet | |
variant_stats[].conversions | integer | Evet | |
variant_stats[].conversion_rate | number | Evet | |
variant_stats[].variant_id | string | Evet | |
variant_significance | object | null | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Ö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)
/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
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
personalizationId | yol | string | Evet | "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: Ok
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
ok | true | Evet |
Ö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
/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
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
personalizationId | yol | string | Evet | "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
days | sorgu | integer | Hayır | Aralık: 1–365 | 1 |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
Yanıtlar
200 — Başarılı.
Şema: WebPersonalizationReport
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
personalization_id | string | Evet | |
days | integer | Evet | |
daily | array<object> | Evet | |
daily[].date | string | Evet | |
daily[].visitors | integer | Evet | |
daily[].conversions | integer | Evet | |
totals | object | Evet | |
totals.visitors | integer | Evet | |
totals.conversions | integer | Evet | |
totals.conversion_rate | number | Evet |
Ö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
/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
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
personalizationId | yol | string | Evet | "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: WebPersonalizationStatusDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
Örnek:
{
"status": "draft"
}Yanıtlar
200 — Başarılı.
Şema: WebPersonalization
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
app_id | string | Evet | |
name | string | Evet | |
status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
priority | integer | Evet | |
changes | array<object> | Evet | |
variants | array<object> | Evet | |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
ab_test | object | Evet | |
ab_test.winner_variant_id | string | null | Evet | |
ab_test.decided_at | string | null | Evet | |
ab_test.decided_by | string | null | Evet | |
conditions | object | Evet | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Evet | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Evet | |
start_at | string | null | Evet | |
end_at | string | null | Evet | |
stats | object | Evet | |
stats.visitors | integer | Evet | |
stats.conversions | integer | Evet | |
stats.conversion_rate | number | Evet | |
variant_stats | array<object> | Evet | |
variant_stats[].visitors | integer | Evet | |
variant_stats[].conversions | integer | Evet | |
variant_stats[].conversion_rate | number | Evet | |
variant_stats[].variant_id | string | Evet | |
variant_significance | object | null | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Ö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)
/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
| Ad | Konum | Tür | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|---|
personalizationId | yol | string | Evet | "wpz_01JD3W5Q7X9K2M4N6P8R0T1V3W" | |
appId | yol | string | Evet | "app_01JD3W5Q7X9K2M4N6P8R0T1V3W" |
İstek gövdesi (zorunlu)
Şema: WebPersonalizationWinnerDto
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
variant_id | string | Evet | Uzunluk: 1–64 |
Örnek:
{
"variant_id": "var_01JD3W5Q7X9K2M4N6P8R0T1V3W"
}Yanıtlar
200 — Başarılı.
Şema: WebPersonalization
| Alan | Tür | Zorunlu | Açıklama |
|---|---|---|---|
id | string | Evet | |
app_id | string | Evet | |
name | string | Evet | |
status | enum | Evet | Değerler: "draft", "active", "paused", "archived" |
priority | integer | Evet | |
changes | array<object> | Evet | |
variants | array<object> | Evet | |
variants[].id | string | Evet | Uzunluk: 1–64 |
variants[].name | string | Evet | Uzunluk: 1–60 |
variants[].weight_percent | integer | Evet | Aralık: 1–99 |
variants[].changes | array<object> | Evet | Öğe: 0–20 |
ab_test | object | Evet | |
ab_test.winner_variant_id | string | null | Evet | |
ab_test.decided_at | string | null | Evet | |
ab_test.decided_by | string | null | Evet | |
conditions | object | Evet | |
conditions.url_rules | array<object> | Hayır | Öğe: 0–10 |
conditions.url_rules[].op | enum | Evet | Değerler: "equals", "contains", "starts_with", "not_contains", "matches" |
conditions.url_rules[].value | string | Evet | Uzunluk: 1–500 |
conditions.utm_rules | array<object> | Hayır | Öğe: 0–5 |
conditions.utm_rules[].param | enum | Evet | Değerler: "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content" |
conditions.utm_rules[].op | enum | Evet | Değerler: "equals", "contains", "exists" |
conditions.utm_rules[].value | string | Hayır | Uzunluk: 0–200 |
conditions.visits | object | Hayır | |
conditions.visits.op | enum | Evet | Değerler: "gte", "lte", "eq" |
conditions.visits.value | integer | Evet | Aralık: 1–10000 |
targeting | object | Evet | |
targeting.included_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.excluded_segments | array<string> | Hayır | Öğe: 0–20 |
targeting.visitor | enum | Hayır | Değerler: "all", "new", "returning" |
targeting.devices | array<enum> | Hayır | Öğe: 0–3 |
goal | object | null | Evet | |
start_at | string | null | Evet | |
end_at | string | null | Evet | |
stats | object | Evet | |
stats.visitors | integer | Evet | |
stats.conversions | integer | Evet | |
stats.conversion_rate | number | Evet | |
variant_stats | array<object> | Evet | |
variant_stats[].visitors | integer | Evet | |
variant_stats[].conversions | integer | Evet | |
variant_stats[].conversion_rate | number | Evet | |
variant_stats[].variant_id | string | Evet | |
variant_significance | object | null | Evet | |
created_at | string | Evet | |
updated_at | string | Evet |
Ö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"
}'