Reklamlar (kitleler, kampanyalar, atribüsyon)

Reklamlar (kitleler, kampanyalar, atribüsyon) — 23 işlem (GET /v1/apps/{appId}/ads/accounts, GET /v1/apps/{appId}/ads/audiences, POST /v1/apps/{appId}/ads/audiences, …). OpenAPI 3.1.0 sözleşmesinden üretilir.

Meta, Google Ads, TikTok ve LinkedIn reklam hesapları: segmentten reklam kitlesi senkronu (yalnızca reklam kişiselleştirme rızası olan kullanıcılar, SHA-256 ile), lookalike, kampanya/reklam seti listesi, durum ve günlük bütçe, harcama, atribüsyon ve LTV raporları, Conversions API ve bütçe uyarıları. Hesap bağlama (OAuth) panelden yapılır.

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

İşlemler

Yöntem	Yol	İşlem
`GET`	`/v1/apps/{appId}/ads/accounts`	Bağlı reklam hesapları
`GET`	`/v1/apps/{appId}/ads/audiences`	Reklam kitleleri
`POST`	`/v1/apps/{appId}/ads/audiences`	Reklam kitlesi oluştur
`GET`	`/v1/apps/{appId}/ads/audiences/{audienceId}`	Reklam kitlesi ayrıntısı
`PATCH`	`/v1/apps/{appId}/ads/audiences/{audienceId}`	Reklam kitlesini güncelle
`DELETE`	`/v1/apps/{appId}/ads/audiences/{audienceId}`	Reklam kitlesini sil
`POST`	`/v1/apps/{appId}/ads/audiences/{audienceId}/sync`	Senkronu şimdi çalıştır
`GET`	`/v1/apps/{appId}/ads/audiences/{audienceId}/syncs`	Senkron geçmişi
`POST`	`/v1/apps/{appId}/ads/audiences/{audienceId}/lookalikes`	Benzer kitle (lookalike) oluştur
`GET`	`/v1/apps/{appId}/ads/campaigns`	Kampanya / reklam seti / reklam listesi ve metrikler
`GET`	`/v1/apps/{appId}/ads/campaigns/{entityId}`	Kampanya / reklam seti / reklam ayrıntısı
`PATCH`	`/v1/apps/{appId}/ads/campaigns/{entityId}`	Durum ve günlük bütçe değişikliği
`POST`	`/v1/apps/{appId}/ads/accounts/{accountId}/refresh`	Kampanyaları ve metrikleri şimdi yenile
`GET`	`/v1/apps/{appId}/ads/reports/spend`	Harcama ve performans raporu
`GET`	`/v1/apps/{appId}/ads/reports/attribution`	Birleşik atribüsyon raporu (ROAS, CAC)
`GET`	`/v1/apps/{appId}/ads/reports/ltv`	Kohort LTV raporu
`GET`	`/v1/apps/{appId}/ads/conversions-api/configs`	Conversions API yapılandırmaları
`GET`	`/v1/apps/{appId}/ads/conversions-api/deliveries`	Conversions API teslim geçmişi
`GET`	`/v1/apps/{appId}/ads/alert-rules`	Bütçe uyarı kuralları
`POST`	`/v1/apps/{appId}/ads/alert-rules`	Bütçe uyarı kuralı oluştur
`PATCH`	`/v1/apps/{appId}/ads/alert-rules/{ruleId}`	Bütçe uyarı kuralını güncelle
`DELETE`	`/v1/apps/{appId}/ads/alert-rules/{ruleId}`	Bütçe uyarı kuralını sil
`GET`	`/v1/apps/{appId}/ads/alerts`	Tetiklenen bütçe uyarıları

Ayrıntılar

Bağlı reklam hesapları

GET/v1/apps/{appId}/ads/accountsDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdAccountList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].app_id`	`string`	Evet
`data[].platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`
`data[].external_id`	`string`	Evet
`data[].name`	`string`	Evet
`data[].currency`	`string \| null`	Evet
`data[].timezone`	`string \| null`	Evet
`data[].status`	`enum`	Evet	Değerler: `"active"`, `"error"`, `"revoked"`
`data[].scopes`	`array<string>`	Evet
`data[].login_customer_id`	`string \| null`	Evet
`data[].token_expires_at`	`string \| null`	Evet
`data[].last_refreshed_at`	`string \| null`	Evet
`data[].last_error`	`string \| null`	Evet
`data[].last_error_at`	`string \| null`	Evet
`data[].terms_accepted_at`	`string \| null`	Evet
`data[].terms_version`	`string \| null`	Evet
`data[].audiences`	`integer`	Evet
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "status": "active",
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "platform": "meta",
      "external_id": "user_42",
      "currency": "TRY",
      "timezone": "Europe/Istanbul",
      "scopes": [
        "notifications:write"
      ],
      "login_customer_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "token_expires_at": "örnek",
      "last_refreshed_at": "örnek",
      "last_error": "örnek",
      "last_error_at": "örnek",
      "terms_accepted_at": "örnek",
      "terms_version": "örnek",
      "audiences": 1,
      "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/ads/accounts" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Reklam kitleleri

GET/v1/apps/{appId}/ads/audiencesDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`ad_account_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"ada_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdAudienceList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].app_id`	`string`	Evet
`data[].ad_account_id`	`string`	Evet
`data[].platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`
`data[].source`	`enum`	Evet	Değerler: `"segment"`, `"journey"`, `"lookalike"`
`data[].segment_id`	`string \| null`	Evet
`data[].segment_name`	`string \| null`	Evet
`data[].name`	`string`	Evet
`data[].description`	`string \| null`	Evet
`data[].external_id`	`string \| null`	Evet
`data[].status`	`enum`	Evet	Değerler: `"pending"`, `"active"`, `"paused"`, `"error"`
`data[].identifiers`	`array<enum>`	Evet
`data[].sync_interval_minutes`	`integer`	Evet
`data[].next_sync_at`	`string \| null`	Evet
`data[].last_synced_at`	`string \| null`	Evet
`data[].last_sync_status`	`enum \| null`	Evet
`data[].full_reload_requested`	`boolean`	Evet
`data[].member_count`	`integer`	Evet
`data[].estimated_size`	`integer \| null`	Evet
`data[].match_rate`	`number \| null`	Evet
`data[].size_updated_at`	`string \| null`	Evet
`data[].lookalike_source_id`	`string \| null`	Evet
`data[].lookalike_spec`	`object \| null`	Evet
`data[].consecutive_failures`	`integer`	Evet
`data[].last_error`	`string \| null`	Evet
`data[].last_error_at`	`string \| null`	Evet
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "status": "pending",
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "platform": "meta",
      "source": "segment",
      "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "segment_name": "örnek",
      "description": "Sipariş durumu güncellemeleri",
      "external_id": "user_42",
      "identifiers": [
        "email"
      ],
      "sync_interval_minutes": 1,
      "next_sync_at": "örnek",
      "last_synced_at": "örnek",
      "last_sync_status": "succeeded",
      "full_reload_requested": true,
      "member_count": 1,
      "estimated_size": 1,
      "match_rate": 1.5,
      "size_updated_at": "örnek",
      "lookalike_source_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "lookalike_spec": {
        "country": "TR",
        "ratio": 1.5
      },
      "consecutive_failures": 1,
      "last_error": "örnek",
      "last_error_at": "örnek",
      "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/ads/audiences" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Reklam kitlesi oluştur

POST/v1/apps/{appId}/ads/audiencesDene

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: CreateAdAudienceDto

Alan	Tür	Zorunlu	Açıklama
`ad_account_id`	`string`	Evet	Uzunluk: 1–64
`source`	`enum`	Evet	Değerler: `"segment"`, `"journey"`
`segment_id`	`string`	Hayır	Uzunluk: 1–64
`name`	`string`	Evet	Uzunluk: 1–120
`description`	`string`	Hayır	Uzunluk: 0–500
`identifiers`	`array<enum>`	Hayır	Öğe: 1–3
`sync_interval_minutes`	`integer`	Hayır	Aralık: 60–360

Örnek:

{
  "name": "Sipariş bildirimleri",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "source": "segment",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "identifiers": [
    "email"
  ],
  "sync_interval_minutes": 60
}

Yanıtlar

201 — Başarılı.

Şema: AdAudience

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`ad_account_id`	`string`	Evet
`platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`
`source`	`enum`	Evet	Değerler: `"segment"`, `"journey"`, `"lookalike"`
`segment_id`	`string \| null`	Evet
`segment_name`	`string \| null`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`external_id`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"pending"`, `"active"`, `"paused"`, `"error"`
`identifiers`	`array<enum>`	Evet
`sync_interval_minutes`	`integer`	Evet
`next_sync_at`	`string \| null`	Evet
`last_synced_at`	`string \| null`	Evet
`last_sync_status`	`enum \| null`	Evet
`full_reload_requested`	`boolean`	Evet
`member_count`	`integer`	Evet
`estimated_size`	`integer \| null`	Evet
`match_rate`	`number \| null`	Evet
`size_updated_at`	`string \| null`	Evet
`lookalike_source_id`	`string \| null`	Evet
`lookalike_spec`	`object \| null`	Evet
`consecutive_failures`	`integer`	Evet
`last_error`	`string \| null`	Evet
`last_error_at`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "pending",
  "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform": "meta",
  "source": "segment",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "segment_name": "örnek",
  "description": "Sipariş durumu güncellemeleri",
  "external_id": "user_42",
  "identifiers": [
    "email"
  ],
  "sync_interval_minutes": 1,
  "next_sync_at": "örnek",
  "last_synced_at": "örnek",
  "last_sync_status": "succeeded",
  "full_reload_requested": true,
  "member_count": 1,
  "estimated_size": 1,
  "match_rate": 1.5,
  "size_updated_at": "örnek",
  "lookalike_source_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "lookalike_spec": {
    "country": "TR",
    "ratio": 1.5
  },
  "consecutive_failures": 1,
  "last_error": "örnek",
  "last_error_at": "örnek",
  "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/ads/audiences" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "source": "segment",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "description": "Sipariş durumu güncellemeleri",
  "identifiers": [
    "email"
  ],
  "sync_interval_minutes": 60
}'

Reklam kitlesi ayrıntısı

GET/v1/apps/{appId}/ads/audiences/{audienceId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`audienceId`	yol	`string`	Evet		`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdAudience

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`ad_account_id`	`string`	Evet
`platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`
`source`	`enum`	Evet	Değerler: `"segment"`, `"journey"`, `"lookalike"`
`segment_id`	`string \| null`	Evet
`segment_name`	`string \| null`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`external_id`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"pending"`, `"active"`, `"paused"`, `"error"`
`identifiers`	`array<enum>`	Evet
`sync_interval_minutes`	`integer`	Evet
`next_sync_at`	`string \| null`	Evet
`last_synced_at`	`string \| null`	Evet
`last_sync_status`	`enum \| null`	Evet
`full_reload_requested`	`boolean`	Evet
`member_count`	`integer`	Evet
`estimated_size`	`integer \| null`	Evet
`match_rate`	`number \| null`	Evet
`size_updated_at`	`string \| null`	Evet
`lookalike_source_id`	`string \| null`	Evet
`lookalike_spec`	`object \| null`	Evet
`consecutive_failures`	`integer`	Evet
`last_error`	`string \| null`	Evet
`last_error_at`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "pending",
  "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform": "meta",
  "source": "segment",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "segment_name": "örnek",
  "description": "Sipariş durumu güncellemeleri",
  "external_id": "user_42",
  "identifiers": [
    "email"
  ],
  "sync_interval_minutes": 1,
  "next_sync_at": "örnek",
  "last_synced_at": "örnek",
  "last_sync_status": "succeeded",
  "full_reload_requested": true,
  "member_count": 1,
  "estimated_size": 1,
  "match_rate": 1.5,
  "size_updated_at": "örnek",
  "lookalike_source_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "lookalike_spec": {
    "country": "TR",
    "ratio": 1.5
  },
  "consecutive_failures": 1,
  "last_error": "örnek",
  "last_error_at": "örnek",
  "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/ads/audiences/adu_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Reklam kitlesini güncelle

PATCH/v1/apps/{appId}/ads/audiences/{audienceId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`audienceId`	yol	`string`	Evet		`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: UpdateAdAudienceDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Hayır	Uzunluk: 1–120
`description`	`string \| null`	Hayır
`segment_id`	`string`	Hayır	Uzunluk: 1–64
`identifiers`	`array<enum>`	Hayır	Öğe: 1–3
`sync_interval_minutes`	`integer`	Hayır	Aralık: 60–360
`status`	`enum`	Hayır	Değerler: `"active"`, `"paused"`

Örnek:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "description": "Sipariş durumu güncellemeleri",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "identifiers": [
    "email"
  ]
}

Yanıtlar

200 — Başarılı.

Şema: AdAudience

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`ad_account_id`	`string`	Evet
`platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`
`source`	`enum`	Evet	Değerler: `"segment"`, `"journey"`, `"lookalike"`
`segment_id`	`string \| null`	Evet
`segment_name`	`string \| null`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`external_id`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"pending"`, `"active"`, `"paused"`, `"error"`
`identifiers`	`array<enum>`	Evet
`sync_interval_minutes`	`integer`	Evet
`next_sync_at`	`string \| null`	Evet
`last_synced_at`	`string \| null`	Evet
`last_sync_status`	`enum \| null`	Evet
`full_reload_requested`	`boolean`	Evet
`member_count`	`integer`	Evet
`estimated_size`	`integer \| null`	Evet
`match_rate`	`number \| null`	Evet
`size_updated_at`	`string \| null`	Evet
`lookalike_source_id`	`string \| null`	Evet
`lookalike_spec`	`object \| null`	Evet
`consecutive_failures`	`integer`	Evet
`last_error`	`string \| null`	Evet
`last_error_at`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "pending",
  "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform": "meta",
  "source": "segment",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "segment_name": "örnek",
  "description": "Sipariş durumu güncellemeleri",
  "external_id": "user_42",
  "identifiers": [
    "email"
  ],
  "sync_interval_minutes": 1,
  "next_sync_at": "örnek",
  "last_synced_at": "örnek",
  "last_sync_status": "succeeded",
  "full_reload_requested": true,
  "member_count": 1,
  "estimated_size": 1,
  "match_rate": 1.5,
  "size_updated_at": "örnek",
  "lookalike_source_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "lookalike_spec": {
    "country": "TR",
    "ratio": 1.5
  },
  "consecutive_failures": 1,
  "last_error": "örnek",
  "last_error_at": "örnek",
  "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/ads/audiences/adu_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "description": "Sipariş durumu güncellemeleri",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "identifiers": [
    "email"
  ]
}'

Reklam kitlesini sil

DELETE/v1/apps/{appId}/ads/audiences/{audienceId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`audienceId`	yol	`string`	Evet		`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`delete_on_platform`	sorgu	`enum`	Hayır	Değerler: `"true"`, `"false"`	`"true"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdOk

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/ads/audiences/adu_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Senkronu şimdi çalıştır

POST/v1/apps/{appId}/ads/audiences/{audienceId}/syncDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`audienceId`	yol	`string`	Evet		`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: SyncAdAudienceDto

Alan	Tür	Zorunlu	Açıklama
`full`	`boolean`	Hayır

Örnek:

{
  "full": true
}

Yanıtlar

202 — Başarılı.

Şema: AdAudienceSyncQueued

Alan	Tür	Zorunlu	Açıklama
`queued`	`true`	Evet
`next_sync_at`	`string`	Evet
`mode`	`enum`	Evet	Değerler: `"incremental"`, `"full"`

Örnek yanıt:

{
  "queued": true,
  "next_sync_at": "örnek",
  "mode": "incremental"
}

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/ads/audiences/adu_01JD3W5Q7X9K2M4N6P8R0T1V3W/sync" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "full": true
}'

Senkron geçmişi

GET/v1/apps/{appId}/ads/audiences/{audienceId}/syncsDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`audienceId`	yol	`string`	Evet		`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`limit`	sorgu	`integer`	Hayır	Aralık: 1–100	`50`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdAudienceSyncList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].audience_id`	`string`	Evet
`data[].trigger`	`enum`	Evet	Değerler: `"schedule"`, `"manual"`, `"journey"`
`data[].mode`	`enum`	Evet	Değerler: `"incremental"`, `"full"`
`data[].status`	`enum`	Evet	Değerler: `"running"`, `"succeeded"`, `"partial"`, `"failed"`
`data[].added`	`integer`	Evet
`data[].removed`	`integer`	Evet
`data[].failed`	`integer`	Evet
`data[].skipped_no_consent`	`integer`	Evet
`data[].skipped_no_identifier`	`integer`	Evet
`data[].batches`	`integer`	Evet
`data[].retries`	`integer`	Evet
`data[].error`	`string \| null`	Evet
`data[].started_at`	`string`	Evet
`data[].finished_at`	`string \| null`	Evet
`data[].duration_ms`	`integer \| null`	Evet

Örnek yanıt:

{
  "data": [
    {
      "status": "running",
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "audience_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "trigger": "schedule",
      "mode": "incremental",
      "added": 1,
      "removed": 1,
      "failed": 1,
      "skipped_no_consent": 1,
      "skipped_no_identifier": 1,
      "batches": 1,
      "retries": 1,
      "error": "örnek",
      "started_at": "örnek",
      "finished_at": "örnek",
      "duration_ms": 1
    }
  ]
}

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/ads/audiences/adu_01JD3W5Q7X9K2M4N6P8R0T1V3W/syncs?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Benzer kitle (lookalike) oluştur

POST/v1/apps/{appId}/ads/audiences/{audienceId}/lookalikesDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`audienceId`	yol	`string`	Evet		`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: CreateLookalikeDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Hayır	Uzunluk: 1–120
`country`	`string`	Evet
`ratio`	`number`	Evet	Aralık: 0.01–0.2

Örnek:

{
  "country": "TR",
  "ratio": 0.2,
  "name": "Sipariş bildirimleri"
}

Yanıtlar

201 — Başarılı.

Şema: AdAudience

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`ad_account_id`	`string`	Evet
`platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`
`source`	`enum`	Evet	Değerler: `"segment"`, `"journey"`, `"lookalike"`
`segment_id`	`string \| null`	Evet
`segment_name`	`string \| null`	Evet
`name`	`string`	Evet
`description`	`string \| null`	Evet
`external_id`	`string \| null`	Evet
`status`	`enum`	Evet	Değerler: `"pending"`, `"active"`, `"paused"`, `"error"`
`identifiers`	`array<enum>`	Evet
`sync_interval_minutes`	`integer`	Evet
`next_sync_at`	`string \| null`	Evet
`last_synced_at`	`string \| null`	Evet
`last_sync_status`	`enum \| null`	Evet
`full_reload_requested`	`boolean`	Evet
`member_count`	`integer`	Evet
`estimated_size`	`integer \| null`	Evet
`match_rate`	`number \| null`	Evet
`size_updated_at`	`string \| null`	Evet
`lookalike_source_id`	`string \| null`	Evet
`lookalike_spec`	`object \| null`	Evet
`consecutive_failures`	`integer`	Evet
`last_error`	`string \| null`	Evet
`last_error_at`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "pending",
  "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform": "meta",
  "source": "segment",
  "segment_id": "seg_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "segment_name": "örnek",
  "description": "Sipariş durumu güncellemeleri",
  "external_id": "user_42",
  "identifiers": [
    "email"
  ],
  "sync_interval_minutes": 1,
  "next_sync_at": "örnek",
  "last_synced_at": "örnek",
  "last_sync_status": "succeeded",
  "full_reload_requested": true,
  "member_count": 1,
  "estimated_size": 1,
  "match_rate": 1.5,
  "size_updated_at": "örnek",
  "lookalike_source_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "lookalike_spec": {
    "country": "TR",
    "ratio": 1.5
  },
  "consecutive_failures": 1,
  "last_error": "örnek",
  "last_error_at": "örnek",
  "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/ads/audiences/adu_01JD3W5Q7X9K2M4N6P8R0T1V3W/lookalikes" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "country": "TR",
  "ratio": 0.2,
  "name": "Sipariş bildirimleri"
}'

Kampanya / reklam seti / reklam listesi ve metrikler

GET/v1/apps/{appId}/ads/campaignsDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`ad_account_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"ada_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`level`	sorgu	`enum`	Hayır	Değerler: `"campaign"`, `"ad_set"`, `"ad"`	`"campaign"`
`parent_id`	sorgu	`string`	Hayır	Uzunluk: 1–100	`"adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`status`	sorgu	`enum`	Hayır	Değerler: `"active"`, `"paused"`, `"pending"`, `"rejected"`, `"archived"`, `"deleted"`, `"unknown"`	`"active"`
`q`	sorgu	`string`	Hayır	Uzunluk: 0–100	`"ayse"`
`from`	sorgu	`string`	Hayır		`"2026-10-01T00:00:00Z"`
`to`	sorgu	`string`	Hayır		`"2026-10-17T00:00:00Z"`
`limit`	sorgu	`integer`	Hayır	Aralık: 1–500	`50`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdEntityList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].app_id`	`string`	Evet
`data[].ad_account_id`	`string`	Evet
`data[].platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`
`data[].level`	`enum`	Evet	Değerler: `"campaign"`, `"ad_set"`, `"ad"`
`data[].external_id`	`string`	Evet
`data[].campaign_external_id`	`string`	Evet
`data[].ad_set_external_id`	`string \| null`	Evet
`data[].name`	`string`	Evet
`data[].status`	`enum`	Evet	Değerler: `"active"`, `"paused"`, `"pending"`, `"rejected"`, `"archived"`, `"deleted"`, `"unknown"`
`data[].platform_status`	`string \| null`	Evet
`data[].objective`	`string \| null`	Evet
`data[].optimization_goal`	`string \| null`	Evet
`data[].currency`	`string \| null`	Evet
`data[].daily_budget`	`string \| null`	Evet
`data[].lifetime_budget`	`string \| null`	Evet
`data[].start_at`	`string \| null`	Evet
`data[].end_at`	`string \| null`	Evet
`data[].audience_external_ids`	`array<string>`	Evet
`data[].creative`	`object \| null`	Evet
`data[].budget_editable`	`boolean`	Evet
`data[].created_by_pushizo`	`boolean`	Evet
`data[].last_seen_at`	`string \| null`	Evet
`data[].platform_url`	`string`	Evet
`data[].metrics`	`object \| null`	Evet
`data[].updated_at`	`string`	Evet
`from`	`string`	Evet
`to`	`string`	Evet
`accounts`	`array<object>`	Evet
`accounts[].id`	`string`	Evet
`accounts[].campaigns_synced_at`	`string \| null`	Evet
`accounts[].insights_synced_at`	`string \| null`	Evet
`accounts[].campaigns_sync_error`	`string \| null`	Evet
`accounts[].insights_sync_error`	`string \| null`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "status": "active",
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "platform": "meta",
      "level": "campaign",
      "external_id": "user_42",
      "campaign_external_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "ad_set_external_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "platform_status": "örnek",
      "objective": "örnek",
      "optimization_goal": "örnek",
      "currency": "TRY",
      "daily_budget": "örnek",
      "lifetime_budget": "örnek",
      "start_at": "örnek",
      "end_at": "örnek",
      "audience_external_ids": [
        "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"
      ],
      "creative": {
        "title": "Siparişiniz yola çıktı",
        "body": "Takip bağlantısı içeride",
        "description": "Sipariş durumu güncellemeleri",
        "link_url": "https://example.com/orders/1001",
        "image_url": "https://example.com/orders/1001",
        "call_to_action": "örnek"
      },
      "budget_editable": true,
      "created_by_pushizo": true,
      "last_seen_at": "örnek",
      "platform_url": "https://example.com/orders/1001",
      "metrics": {
        "impressions": 1.5,
        "clicks": 1.5,
        "spend": 1.5,
        "conversions": 1.5,
        "conversion_value": 149.9,
        "ctr": 1.5,
        "cpc": 1.5,
        "roas": 1.5
      },
      "updated_at": "örnek"
    }
  ],
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-17T00:00:00Z",
  "accounts": [
    {
      "id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "campaigns_synced_at": "örnek",
      "insights_synced_at": "örnek",
      "campaigns_sync_error": "örnek",
      "insights_sync_error": "ö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/ads/campaigns?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kampanya / reklam seti / reklam ayrıntısı

GET/v1/apps/{appId}/ads/campaigns/{entityId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`entityId`	yol	`string`	Evet		`"ade_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdEntity

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`ad_account_id`	`string`	Evet
`platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`
`level`	`enum`	Evet	Değerler: `"campaign"`, `"ad_set"`, `"ad"`
`external_id`	`string`	Evet
`campaign_external_id`	`string`	Evet
`ad_set_external_id`	`string \| null`	Evet
`name`	`string`	Evet
`status`	`enum`	Evet	Değerler: `"active"`, `"paused"`, `"pending"`, `"rejected"`, `"archived"`, `"deleted"`, `"unknown"`
`platform_status`	`string \| null`	Evet
`objective`	`string \| null`	Evet
`optimization_goal`	`string \| null`	Evet
`currency`	`string \| null`	Evet
`daily_budget`	`string \| null`	Evet
`lifetime_budget`	`string \| null`	Evet
`start_at`	`string \| null`	Evet
`end_at`	`string \| null`	Evet
`audience_external_ids`	`array<string>`	Evet
`creative`	`object \| null`	Evet
`budget_editable`	`boolean`	Evet
`created_by_pushizo`	`boolean`	Evet
`last_seen_at`	`string \| null`	Evet
`platform_url`	`string`	Evet
`metrics`	`object \| null`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "id": "ade_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform": "meta",
  "level": "campaign",
  "external_id": "user_42",
  "campaign_external_id": "ade_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_set_external_id": "ade_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform_status": "örnek",
  "objective": "örnek",
  "optimization_goal": "örnek",
  "currency": "TRY",
  "daily_budget": "örnek",
  "lifetime_budget": "örnek",
  "start_at": "örnek",
  "end_at": "örnek",
  "audience_external_ids": [
    "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"
  ],
  "creative": {
    "title": "Siparişiniz yola çıktı",
    "body": "Takip bağlantısı içeride",
    "description": "Sipariş durumu güncellemeleri",
    "link_url": "https://example.com/orders/1001",
    "image_url": "https://example.com/orders/1001",
    "call_to_action": "örnek"
  },
  "budget_editable": true,
  "created_by_pushizo": true,
  "last_seen_at": "örnek",
  "platform_url": "https://example.com/orders/1001",
  "metrics": {
    "impressions": 1.5,
    "clicks": 1.5,
    "spend": 1.5,
    "conversions": 1.5,
    "conversion_value": 149.9,
    "ctr": 1.5,
    "cpc": 1.5,
    "roas": 1.5
  },
  "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/ads/campaigns/ade_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Durum ve günlük bütçe değişikliği

PATCH/v1/apps/{appId}/ads/campaigns/{entityId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`entityId`	yol	`string`	Evet		`"ade_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: UpdateAdCampaignDto

Alan	Tür	Zorunlu	Açıklama
`status`	`enum`	Hayır	Değerler: `"active"`, `"paused"`
`daily_budget`	`string \| number`	Hayır

Örnek:

{
  "status": "active",
  "daily_budget": "değer"
}

Yanıtlar

200 — Başarılı.

Şema: AdEntity

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`ad_account_id`	`string`	Evet
`platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`
`level`	`enum`	Evet	Değerler: `"campaign"`, `"ad_set"`, `"ad"`
`external_id`	`string`	Evet
`campaign_external_id`	`string`	Evet
`ad_set_external_id`	`string \| null`	Evet
`name`	`string`	Evet
`status`	`enum`	Evet	Değerler: `"active"`, `"paused"`, `"pending"`, `"rejected"`, `"archived"`, `"deleted"`, `"unknown"`
`platform_status`	`string \| null`	Evet
`objective`	`string \| null`	Evet
`optimization_goal`	`string \| null`	Evet
`currency`	`string \| null`	Evet
`daily_budget`	`string \| null`	Evet
`lifetime_budget`	`string \| null`	Evet
`start_at`	`string \| null`	Evet
`end_at`	`string \| null`	Evet
`audience_external_ids`	`array<string>`	Evet
`creative`	`object \| null`	Evet
`budget_editable`	`boolean`	Evet
`created_by_pushizo`	`boolean`	Evet
`last_seen_at`	`string \| null`	Evet
`platform_url`	`string`	Evet
`metrics`	`object \| null`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "status": "active",
  "id": "ade_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform": "meta",
  "level": "campaign",
  "external_id": "user_42",
  "campaign_external_id": "ade_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "ad_set_external_id": "ade_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "platform_status": "örnek",
  "objective": "örnek",
  "optimization_goal": "örnek",
  "currency": "TRY",
  "daily_budget": "örnek",
  "lifetime_budget": "örnek",
  "start_at": "örnek",
  "end_at": "örnek",
  "audience_external_ids": [
    "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W"
  ],
  "creative": {
    "title": "Siparişiniz yola çıktı",
    "body": "Takip bağlantısı içeride",
    "description": "Sipariş durumu güncellemeleri",
    "link_url": "https://example.com/orders/1001",
    "image_url": "https://example.com/orders/1001",
    "call_to_action": "örnek"
  },
  "budget_editable": true,
  "created_by_pushizo": true,
  "last_seen_at": "örnek",
  "platform_url": "https://example.com/orders/1001",
  "metrics": {
    "impressions": 1.5,
    "clicks": 1.5,
    "spend": 1.5,
    "conversions": 1.5,
    "conversion_value": 149.9,
    "ctr": 1.5,
    "cpc": 1.5,
    "roas": 1.5
  },
  "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/ads/campaigns/ade_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "daily_budget": "değer"
}'

Kampanyaları ve metrikleri şimdi yenile

POST/v1/apps/{appId}/ads/accounts/{accountId}/refreshDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`accountId`	yol	`string`	Evet		`"ada_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

202 — Başarılı.

Şema: AdRefreshQueued

Alan	Tür	Zorunlu	Açıklama
`queued`	`true`	Evet
`next_sync_at`	`string`	Evet

Örnek yanıt:

{
  "queued": true,
  "next_sync_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/ads/accounts/ada_01JD3W5Q7X9K2M4N6P8R0T1V3W/refresh" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Harcama ve performans raporu

GET/v1/apps/{appId}/ads/reports/spendDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`from`	sorgu	`string`	Evet		`"2026-10-01T00:00:00Z"`
`to`	sorgu	`string`	Evet		`"2026-10-17T00:00:00Z"`
`currency`	sorgu	`string`	Hayır		`"TRY"`
`group_by`	sorgu	`enum`	Hayır	Değerler: `"day"`, `"platform"`, `"account"`, `"campaign"`, `"ad_set"`	`"day"`
`ad_account_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"ada_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`campaign_id`	sorgu	`string`	Hayır	Uzunluk: 1–100	`"ade_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdSpendReport

Alan	Tür	Zorunlu	Açıklama
`from`	`string`	Evet
`to`	`string`	Evet
`currency`	`string`	Evet
`group_by`	`string`	Evet
`rows`	`array<object>`	Evet
`rows[].key`	`string`	Evet
`rows[].label`	`string`	Evet
`rows[].platform`	`string \| null`	Evet
`rows[].impressions`	`number`	Evet
`rows[].clicks`	`number`	Evet
`rows[].spend`	`number`	Evet
`rows[].conversions`	`number`	Evet
`rows[].conversion_value`	`number`	Evet
`rows[].ctr`	`number \| null`	Evet
`rows[].cpc`	`number \| null`	Evet
`rows[].cpa`	`number \| null`	Evet
`rows[].roas`	`number \| null`	Evet
`totals`	`object`	Evet
`totals.impressions`	`number`	Evet
`totals.clicks`	`number`	Evet
`totals.spend`	`number`	Evet
`totals.conversions`	`number`	Evet
`totals.conversion_value`	`number`	Evet
`totals.ctr`	`number \| null`	Evet
`totals.cpc`	`number \| null`	Evet
`totals.cpa`	`number \| null`	Evet
`totals.roas`	`number \| null`	Evet
`fx_missing`	`array<string>`	Evet
`store`	`enum`	Evet	Değerler: `"postgres"`, `"clickhouse"`

Örnek yanıt:

{
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-17T00:00:00Z",
  "currency": "TRY",
  "group_by": "örnek",
  "rows": [
    {
      "key": "key-2026-10",
      "label": "external_id",
      "platform": "örnek",
      "impressions": 1.5,
      "clicks": 1.5,
      "spend": 1.5,
      "conversions": 1.5,
      "conversion_value": 149.9,
      "ctr": 1.5,
      "cpc": 1.5,
      "cpa": 1.5,
      "roas": 1.5
    }
  ],
  "totals": {
    "impressions": 1.5,
    "clicks": 1.5,
    "spend": 1.5,
    "conversions": 1.5,
    "conversion_value": 149.9,
    "ctr": 1.5,
    "cpc": 1.5,
    "cpa": 1.5,
    "roas": 1.5
  },
  "fx_missing": [
    "örnek"
  ],
  "store": "postgres"
}

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/ads/reports/spend?from=2026-10-01T00%3A00%3A00Z&to=2026-10-17T00%3A00%3A00Z" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Birleşik atribüsyon raporu (ROAS, CAC)

GET/v1/apps/{appId}/ads/reports/attributionDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`from`	sorgu	`string`	Evet		`"2026-10-01T00:00:00Z"`
`to`	sorgu	`string`	Evet		`"2026-10-17T00:00:00Z"`
`model`	sorgu	`enum`	Hayır	Değerler: `"last_click"`, `"first_click"`, `"linear"`, `"time_decay"`	`"last_click"`
`window_days`	sorgu	`integer`	Hayır	Aralık: 1–90	`1`
`half_life_days`	sorgu	`integer`	Hayır	Aralık: 1–30	`1`
`currency`	sorgu	`string`	Hayır		`"TRY"`
`group_by`	sorgu	`enum`	Hayır	Değerler: `"channel"`, `"campaign"`, `"ad_set"`	`"channel"`
`conversion_events`	sorgu	`string`	Hayır	Uzunluk: 0–1000	`"örnek"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdAttributionReport

Alan	Tür	Zorunlu	Açıklama
`from`	`string`	Evet
`to`	`string`	Evet
`model`	`enum`	Evet	Değerler: `"last_click"`, `"first_click"`, `"linear"`, `"time_decay"`
`window_days`	`integer`	Evet
`half_life_days`	`integer`	Evet
`currency`	`string`	Evet
`group_by`	`string`	Evet
`conversion_events`	`array<string>`	Evet
`rows`	`array<object>`	Evet
`rows[].key`	`string`	Evet
`rows[].channel`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`, `"linkedin"`, `"microsoft"`, `"other_paid"`, `"utm"`, `"push"`, `"email"`, `"sms"`, `"whatsapp"`, `"rcs"`, `"direct"`
`rows[].label`	`string`	Evet
`rows[].paid`	`boolean`	Evet
`rows[].conversions`	`number`	Evet
`rows[].revenue`	`number`	Evet
`rows[].new_customers`	`number`	Evet
`rows[].spend`	`number \| null`	Evet
`rows[].roas`	`number \| null`	Evet
`rows[].cac`	`number \| null`	Evet
`totals`	`object`	Evet
`totals.conversions`	`number`	Evet
`totals.revenue`	`number`	Evet
`totals.spend`	`number`	Evet
`totals.new_customers`	`number`	Evet
`totals.roas`	`number \| null`	Evet
`totals.platform_roas`	`number \| null`	Evet
`totals.cac`	`number \| null`	Evet
`totals.paid_cac`	`number \| null`	Evet
`truncated`	`boolean`	Evet
`fx_missing`	`array<string>`	Evet

Örnek yanıt:

{
  "from": "2026-10-01T00:00:00Z",
  "to": "2026-10-17T00:00:00Z",
  "model": "last_click",
  "window_days": 1,
  "half_life_days": 1,
  "currency": "TRY",
  "group_by": "örnek",
  "conversion_events": [
    "örnek"
  ],
  "rows": [
    {
      "channel": "meta",
      "key": "key-2026-10",
      "label": "external_id",
      "paid": true,
      "conversions": 1.5,
      "revenue": 149.9,
      "new_customers": 1.5,
      "spend": 1.5,
      "roas": 1.5,
      "cac": 1.5
    }
  ],
  "totals": {
    "conversions": 1.5,
    "revenue": 149.9,
    "spend": 1.5,
    "new_customers": 1.5,
    "roas": 1.5,
    "platform_roas": 1.5,
    "cac": 1.5,
    "paid_cac": 1.5
  },
  "truncated": true,
  "fx_missing": [
    "ö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/ads/reports/attribution?from=2026-10-01T00%3A00%3A00Z&to=2026-10-17T00%3A00%3A00Z" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Kohort LTV raporu

GET/v1/apps/{appId}/ads/reports/ltvDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`months`	sorgu	`integer`	Hayır	Aralık: 1–24	`1`
`cohorts`	sorgu	`integer`	Hayır	Aralık: 1–12	`1`
`currency`	sorgu	`string`	Hayır		`"TRY"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdLtvReport

Alan	Tür	Zorunlu
`currency`	`string`	Evet
`months`	`integer`	Evet
`conversion_events`	`array<string>`	Evet
`cohorts`	`array<object>`	Evet
`cohorts[].cohort`	`string`	Evet
`cohorts[].size`	`integer`	Evet
`cohorts[].revenue`	`array<number>`	Evet
`cohorts[].ltv`	`array<number>`	Evet
`average`	`array<number \| null>`	Evet
`fx_missing`	`array<string>`	Evet

Örnek yanıt:

{
  "currency": "TRY",
  "months": 1,
  "conversion_events": [
    "örnek"
  ],
  "cohorts": [
    {
      "cohort": "örnek",
      "size": 1,
      "revenue": [
        149.9
      ],
      "ltv": [
        1.5
      ]
    }
  ],
  "average": [
    1.5
  ],
  "fx_missing": [
    "ö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/ads/reports/ltv" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Conversions API yapılandırmaları

GET/v1/apps/{appId}/ads/conversions-api/configsDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdCapiConfigList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].app_id`	`string`	Evet
`data[].platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`
`data[].name`	`string`	Evet
`data[].ad_account_id`	`string \| null`	Evet
`data[].enabled`	`boolean`	Evet
`data[].settings`	`object`	Evet
`data[].settings.pixel_id`	`string \| null`	Evet
`data[].settings.customer_id`	`string \| null`	Evet
`data[].settings.login_customer_id`	`string \| null`	Evet
`data[].settings.pixel_code`	`string \| null`	Evet
`data[].event_mappings`	`array<object>`	Evet
`data[].event_mappings[].event_name`	`string`	Evet
`data[].event_mappings[].platform_event`	`string`	Evet
`data[].event_mappings[].value_property`	`string \| null`	Evet
`data[].event_mappings[].currency_property`	`string \| null`	Evet
`data[].test_event_code`	`string \| null`	Evet
`data[].test_mode`	`boolean`	Evet
`data[].action_source`	`enum`	Evet	Değerler: `"website"`, `"app"`
`data[].default_currency`	`string`	Evet
`data[].has_access_token`	`boolean`	Evet
`data[].last_sent_at`	`string \| null`	Evet
`data[].last_error`	`string \| null`	Evet
`data[].last_error_at`	`string \| null`	Evet
`data[].stats`	`object`	Evet
`data[].stats.pending`	`integer`	Evet
`data[].stats.sent`	`integer`	Evet
`data[].stats.failed`	`integer`	Evet
`data[].stats.skipped`	`integer`	Evet
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "enabled": true,
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "platform": "meta",
      "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "settings": {
        "pixel_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
        "customer_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
        "login_customer_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
        "pixel_code": "örnek"
      },
      "event_mappings": [
        {
          "event_name": "purchase",
          "platform_event": "örnek",
          "value_property": "örnek",
          "currency_property": "örnek"
        }
      ],
      "test_event_code": "örnek",
      "test_mode": true,
      "action_source": "website",
      "default_currency": "örnek",
      "has_access_token": true,
      "last_sent_at": "örnek",
      "last_error": "örnek",
      "last_error_at": "örnek",
      "stats": {
        "pending": 1,
        "sent": 1,
        "failed": 1,
        "skipped": 1
      },
      "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/ads/conversions-api/configs" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Conversions API teslim geçmişi

GET/v1/apps/{appId}/ads/conversions-api/deliveriesDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`config_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"cac_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`status`	sorgu	`enum`	Hayır	Değerler: `"pending"`, `"sent"`, `"failed"`, `"skipped"`	`"pending"`
`limit`	sorgu	`integer`	Hayır	Aralık: 1–200	`50`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdCapiDeliveryList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].config_id`	`string`	Evet
`data[].platform`	`enum`	Evet	Değerler: `"meta"`, `"google"`, `"tiktok"`
`data[].event_id`	`string`	Evet
`data[].event_name`	`string`	Evet
`data[].platform_event`	`string`	Evet
`data[].dedup_id`	`string`	Evet
`data[].user_id`	`string \| null`	Evet
`data[].value`	`number \| null`	Evet
`data[].currency`	`string \| null`	Evet
`data[].status`	`enum`	Evet	Değerler: `"pending"`, `"sent"`, `"failed"`, `"skipped"`
`data[].skip_reason`	`string \| null`	Evet
`data[].attempts`	`integer`	Evet
`data[].next_attempt_at`	`string \| null`	Evet
`data[].last_error`	`string \| null`	Evet
`data[].test`	`boolean`	Evet
`data[].event_occurred_at`	`string`	Evet
`data[].sent_at`	`string \| null`	Evet
`data[].created_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "status": "pending",
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "config_id": "cac_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "platform": "meta",
      "event_id": "evt_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "event_name": "purchase",
      "platform_event": "örnek",
      "dedup_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "user_id": "usr_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "value": 149.9,
      "currency": "TRY",
      "skip_reason": "örnek",
      "attempts": 1,
      "next_attempt_at": "örnek",
      "last_error": "örnek",
      "test": true,
      "event_occurred_at": "örnek",
      "sent_at": "örnek",
      "created_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/ads/conversions-api/deliveries?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Bütçe uyarı kuralları

GET/v1/apps/{appId}/ads/alert-rulesDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdBudgetAlertRuleList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].app_id`	`string`	Evet
`data[].name`	`string`	Evet
`data[].kind`	`enum`	Evet	Değerler: `"daily_spend"`, `"roas_drop"`, `"budget_depletion"`
`data[].ad_account_id`	`string \| null`	Evet
`data[].campaign_external_id`	`string \| null`	Evet
`data[].threshold`	`number`	Evet
`data[].window_days`	`integer`	Evet
`data[].recipients`	`array<string>`	Evet
`data[].enabled`	`boolean`	Evet
`data[].last_value`	`number \| null`	Evet
`data[].last_evaluated_at`	`string \| null`	Evet
`data[].last_triggered_on`	`string \| null`	Evet
`data[].created_at`	`string`	Evet
`data[].updated_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "name": "Sipariş bildirimleri",
      "enabled": true,
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "kind": "daily_spend",
      "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "campaign_external_id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "threshold": 1.5,
      "window_days": 1,
      "recipients": [
        "örnek"
      ],
      "last_value": 149.9,
      "last_evaluated_at": "örnek",
      "last_triggered_on": "örnek",
      "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/ads/alert-rules" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Bütçe uyarı kuralı oluştur

POST/v1/apps/{appId}/ads/alert-rulesDene

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: CreateBudgetAlertRuleDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Evet	Uzunluk: 1–120
`kind`	`enum`	Evet	Değerler: `"daily_spend"`, `"roas_drop"`, `"budget_depletion"`
`ad_account_id`	`string \| null`	Hayır
`campaign_external_id`	`string \| null`	Hayır
`threshold`	`number`	Evet	Aralık: −∞–1000000000000
`window_days`	`integer`	Hayır	Aralık: 1–30
`recipients`	`array<string (email)>`	Hayır	Öğe: 0–20
`enabled`	`boolean`	Hayır

Örnek:

{
  "name": "Sipariş bildirimleri",
  "kind": "daily_spend",
  "threshold": 1.5,
  "enabled": true,
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "campaign_external_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "window_days": 1,
  "recipients": [
    "ayse@example.com"
  ]
}

Yanıtlar

201 — Başarılı.

Şema: AdBudgetAlertRule

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`kind`	`enum`	Evet	Değerler: `"daily_spend"`, `"roas_drop"`, `"budget_depletion"`
`ad_account_id`	`string \| null`	Evet
`campaign_external_id`	`string \| null`	Evet
`threshold`	`number`	Evet
`window_days`	`integer`	Evet
`recipients`	`array<string>`	Evet
`enabled`	`boolean`	Evet
`last_value`	`number \| null`	Evet
`last_evaluated_at`	`string \| null`	Evet
`last_triggered_on`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "kind": "daily_spend",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "campaign_external_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "threshold": 1.5,
  "window_days": 1,
  "recipients": [
    "örnek"
  ],
  "last_value": 149.9,
  "last_evaluated_at": "örnek",
  "last_triggered_on": "örnek",
  "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/ads/alert-rules" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "kind": "daily_spend",
  "threshold": 1.5,
  "enabled": true,
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "campaign_external_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "window_days": 1,
  "recipients": [
    "ayse@example.com"
  ]
}'

Bütçe uyarı kuralını güncelle

PATCH/v1/apps/{appId}/ads/alert-rules/{ruleId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`ruleId`	yol	`string`	Evet		`"bar_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

İstek gövdesi (zorunlu)

Şema: UpdateBudgetAlertRuleDto

Alan	Tür	Zorunlu	Açıklama
`name`	`string`	Hayır	Uzunluk: 1–120
`ad_account_id`	`string \| null`	Hayır
`campaign_external_id`	`string \| null`	Hayır
`threshold`	`number`	Hayır	Aralık: −∞–1000000000000
`window_days`	`integer`	Hayır	Aralık: 1–30
`recipients`	`array<string (email)>`	Hayır	Öğe: 0–20
`enabled`	`boolean`	Hayır

Örnek:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "campaign_external_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "threshold": 1.5
}

Yanıtlar

200 — Başarılı.

Şema: AdBudgetAlertRule

Alan	Tür	Zorunlu	Açıklama
`id`	`string`	Evet
`app_id`	`string`	Evet
`name`	`string`	Evet
`kind`	`enum`	Evet	Değerler: `"daily_spend"`, `"roas_drop"`, `"budget_depletion"`
`ad_account_id`	`string \| null`	Evet
`campaign_external_id`	`string \| null`	Evet
`threshold`	`number`	Evet
`window_days`	`integer`	Evet
`recipients`	`array<string>`	Evet
`enabled`	`boolean`	Evet
`last_value`	`number \| null`	Evet
`last_evaluated_at`	`string \| null`	Evet
`last_triggered_on`	`string \| null`	Evet
`created_at`	`string`	Evet
`updated_at`	`string`	Evet

Örnek yanıt:

{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "app_id": "app_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "kind": "daily_spend",
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "campaign_external_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "threshold": 1.5,
  "window_days": 1,
  "recipients": [
    "örnek"
  ],
  "last_value": 149.9,
  "last_evaluated_at": "örnek",
  "last_triggered_on": "örnek",
  "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/ads/alert-rules/bar_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sipariş bildirimleri",
  "enabled": true,
  "ad_account_id": "ada_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "campaign_external_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
  "threshold": 1.5
}'

Bütçe uyarı kuralını sil

DELETE/v1/apps/{appId}/ads/alert-rules/{ruleId}Dene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`ruleId`	yol	`string`	Evet		`"bar_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdOk

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/ads/alert-rules/bar_01JD3W5Q7X9K2M4N6P8R0T1V3W" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Tetiklenen bütçe uyarıları

GET/v1/apps/{appId}/ads/alertsDene

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

Parametreler

Ad	Konum	Tür	Zorunlu	Açıklama	Örnek
`rule_id`	sorgu	`string`	Hayır	Uzunluk: 1–64	`"bar_01JD3W5Q7X9K2M4N6P8R0T1V3W"`
`limit`	sorgu	`integer`	Hayır	Aralık: 1–200	`50`
`appId`	yol	`string`	Evet		`"app_01JD3W5Q7X9K2M4N6P8R0T1V3W"`

Yanıtlar

200 — Başarılı.

Şema: AdBudgetAlertList

Alan	Tür	Zorunlu	Açıklama
`data`	`array<object>`	Evet
`data[].id`	`string`	Evet
`data[].rule_id`	`string`	Evet
`data[].rule_name`	`string`	Evet
`data[].kind`	`enum`	Evet	Değerler: `"daily_spend"`, `"roas_drop"`, `"budget_depletion"`
`data[].day`	`string`	Evet
`data[].value`	`number`	Evet
`data[].threshold`	`number`	Evet
`data[].details`	`map<string, any>`	Evet
`data[].emailed`	`integer`	Evet
`data[].created_at`	`string`	Evet

Örnek yanıt:

{
  "data": [
    {
      "id": "adu_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "rule_id": "bar_01JD3W5Q7X9K2M4N6P8R0T1V3W",
      "rule_name": "örnek",
      "kind": "daily_spend",
      "day": "örnek",
      "value": 149.9,
      "threshold": 1.5,
      "details": {
        "key": "örnek"
      },
      "emailed": 1,
      "created_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/ads/alerts?limit=50" \
  -H "Authorization: Bearer $PUSHIZO_API_KEY"

Reklamlar (kitleler, kampanyalar, atribüsyon)

İşlemlerBağlantıyı kopyala

AyrıntılarBağlantıyı kopyala

Bağlı reklam hesaplarıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Reklam kitleleriBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Reklam kitlesi oluşturBağlantıyı kopyala

201 — Başarılı.Bağlantıyı kopyala

Reklam kitlesi ayrıntısıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Reklam kitlesini güncelleBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Reklam kitlesini silBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Senkronu şimdi çalıştırBağlantıyı kopyala

202 — Başarılı.Bağlantıyı kopyala

Senkron geçmişiBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Benzer kitle (lookalike) oluşturBağlantıyı kopyala

201 — Başarılı.Bağlantıyı kopyala

Kampanya / reklam seti / reklam listesi ve metriklerBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Kampanya / reklam seti / reklam ayrıntısıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Durum ve günlük bütçe değişikliğiBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Kampanyaları ve metrikleri şimdi yenileBağlantıyı kopyala

202 — Başarılı.Bağlantıyı kopyala

Harcama ve performans raporuBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Birleşik atribüsyon raporu (ROAS, CAC)Bağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Kohort LTV raporuBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Conversions API yapılandırmalarıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Conversions API teslim geçmişiBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Bütçe uyarı kurallarıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Bütçe uyarı kuralı oluşturBağlantıyı kopyala

201 — Başarılı.Bağlantıyı kopyala

Bütçe uyarı kuralını güncelleBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Bütçe uyarı kuralını silBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Tetiklenen bütçe uyarılarıBağlantıyı kopyala

200 — Başarılı.Bağlantıyı kopyala

Bu sayfada

İşlemler

Ayrıntılar

Bağlı reklam hesapları

200 — Başarılı.

Reklam kitleleri

200 — Başarılı.

Reklam kitlesi oluştur

201 — Başarılı.

Reklam kitlesi ayrıntısı

200 — Başarılı.

Reklam kitlesini güncelle

200 — Başarılı.

Reklam kitlesini sil

200 — Başarılı.

Senkronu şimdi çalıştır

202 — Başarılı.

Senkron geçmişi

200 — Başarılı.

Benzer kitle (lookalike) oluştur

201 — Başarılı.

Kampanya / reklam seti / reklam listesi ve metrikler

200 — Başarılı.

Kampanya / reklam seti / reklam ayrıntısı

200 — Başarılı.

Durum ve günlük bütçe değişikliği

200 — Başarılı.

Kampanyaları ve metrikleri şimdi yenile

202 — Başarılı.

Harcama ve performans raporu

200 — Başarılı.

Birleşik atribüsyon raporu (ROAS, CAC)

200 — Başarılı.

Kohort LTV raporu

200 — Başarılı.

Conversions API yapılandırmaları

200 — Başarılı.

Conversions API teslim geçmişi

200 — Başarılı.

Bütçe uyarı kuralları

200 — Başarılı.

Bütçe uyarı kuralı oluştur

201 — Başarılı.

Bütçe uyarı kuralını güncelle

200 — Başarılı.

Bütçe uyarı kuralını sil

200 — Başarılı.

Tetiklenen bütçe uyarıları

200 — Başarılı.