Rıza ve gizlilik. Entegrasyonda neye dikkat edilir.

Rıza kipleri

Kip kaynak başına seçilir.

Analitik ve pazarlama rızası

• analytics kalıcı kimliği, tekrar kuyruğunu ve etkileşim yakalamayı açar.
• marketing tıklama kimliklerini (gclid, fbclid/fbc/fbp, li_fat_id, msclkid, ttclid…) ve ilk/son temas bilgisinin ziyaretler arasında kalmasını açar. Pazarlama rızası olmadan tıklama kimliği saklanmaz ve hedeflere gönderilmez.
• Her mesaj context.consent taşır: { "analytics": bool, "marketing": bool }. Sunucudan gönderdiğiniz olaylarda kişinin rızasını aynı alanla iletin.
• respectGpc: true ile tarayıcının Global Privacy Control sinyali pazarlama rızasını kapatır.

Kişisel veri

• userId opak olmalıdır; e-posta, telefon ya da TCKN kullanmayın.
• Tanımsız bir alanda e-posta, telefon, TCKN, IBAN ya da kart numarası bulunursa mesaj pii_detected ile reddedilir.
• Kişisel bir değeri göndermeniz gerekiyorsa (ör. reklam platformu eşleşmesi) özelliği olay şemasında personal sınıfı ve hash eylemiyle tanımlayın; Postlip Metrics özetler, ham değeri saklamaz.
• Tıklama ve reklam kimlikleri bu taramadan muaftır.

Sayfada maskeleme

• data-metrics-ignore: öğe ve içi hiç yakalanmaz (tıklama, düzen, form).
• data-metrics-mask ya da maskSelectors: etiket *** olur.
• Alanlar, metin kutuları, seçimler ve düzenlenebilir bölgeler hiçbir zaman metin vermez.
• Adreslerden stripQueryParams girdileri, hassas anahtarlar (email, token, password…), e-posta ya da telefona benzeyen değerler ve #…=… parçaları ayıklanır; utm_* ve tıklama kimlikleri kalır.

IP adresi ve trafik türleri

• IP adresi saklanmaz. Sunucu kaynağı son kullanıcının IP’sini context.ip ile iletebilir; konum ve iç trafik için kullanılır, sonra atılır.
• Test (test anahtarı ya da test: true), iç trafik (IP aralığı ya da çerez işareti) ve bot trafiği ayrı işaretlenir; ekranlar varsayılan olarak dışlar.

Silme talepleri

Kullanıcınız verisinin silinmesini istediğinde (KVKK) ürününüzün sunucusu Management API’yle bir silme talebi açar. Postlip Metrics talebi dakikalar içinde yürütür ve talebin kaydını silinen satırların sayısıyla birlikte tutar.

• POST /v1/apps/{appId}/privacy/deletion-requests (kapsam management:write) talebi açar: subjectKind kimliğin türü (user_id, anonymous_id ya da person_id), subjectValue değeridir. İsteğe bağlı note alanına destek kaydı numarası gibi bir başvuru yazın, kişisel veri yazmayın.
• GET /v1/apps/{appId}/privacy/deletion-requests/{requestId} (kapsam management:read) talebin durumunu (pending, running, completed, failed, cancelled) ve result içinde türüne göre silinen satır sayılarını döner; nothingFound, kimliğe ait veri bulunmadığını söyler.
• Silinenler: kişi ve onunla birleşmiş bütün kişiler; kimlikleri, olayları, etkileşimleri, oturumları, hesap üyelikleri, talep kutusu kayıtları ve aynı kullanıcı kimliğiyle bağlı Mailing & SMS kişisi (izin kanıtı yasa gereği kör dizinle, yani anahtarlı özetle kalır). Özet sayılar kalan veriden yeniden hesaplanır; talep başladıktan sonra alınan veri talebe girmez.
• Kimliğin değeri yalnız talep bitene kadar tutulur; yanıtlar yalnız son karakterlerini (subjectHint) gösterir.
• Açık talebi olan bir kimlik için yeni talep aynı talebi döndürür; isteği tekrar göndermek güvenlidir.

curl -X POST https://api.<alan>/v1/apps/$APP_ID/privacy/deletion-requests \
  -H "Authorization: Bearer $METRICS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "subjectKind": "user_id",
    "subjectValue": "usr_7c1e",
    "note": "Destek kaydı 4821"
  }'