İçeriğe geç
ceaksan
PREMIUM shopify

Shopify Markets Cookie Bridge: Consent-Aware Storefront-Pixel Veri Köprüsü

Shopify storefront event'lerinde eksik olan market verisini theme app extension ile cookie'ye yazıp, custom pixel sandbox'ından browser.cookie API'si ile okuyarak event'leri zenginleştirme. Shopify customerPrivacy API entegrasyonu, SameSite attribute'ları ve cross-subdomain cookie yapısı dahil.

2 Nis 2026
TL;DR

Shopify storefront event'leri localization verisi taşımaz, ancak theme app extension (app embed) Liquid localization objesini okuyup document.cookie ile yazabilir. Custom pixel sandbox'ı browser.cookie.get() ile bu cookie'ye async erişir. Consent gate olarak Shopify customerPrivacy API'sinin analyticsProcessingAllowed() metodu kullanılır. Cookie'de SameSite=Lax; Secure; path=/ attribute'ları ve cross-subdomain için domain parametresi gerekir.

Üyelik Gerekli

Bu içeriğe erişmek için giriş yapmanız ve Premium aboneliğine sahip olmanız gerekmektedir.

Önemli Noktalar
  • 01 App embed Liquid localization objesini serialize edip document.cookie ile yazar; pixel browser.cookie.get() ile async okur
  • 02 Cookie yazımı Shopify.customerPrivacy.analyticsProcessingAllowed() ile gate'lenir; consent revoke edildiğinde cookie silinir
  • 03 SameSite=Lax, Secure, path=/ ve cross-subdomain için domain=.example.com attribute'ları zorunludur
  • 04 İlk sayfa yüklemesinde cookie henüz yazılmamış olabilir; retry veya init event'inden shop verisi fallback stratejisi gerekir
  • 05 Checkout event'lerinde native localization objesi mevcut olduğundan cookie'ye gerek yoktur; cookie yalnızca storefront event'leri için kullanılır
Sık Sorulan Sorular (FAQ)
+ Custom pixel sandbox'ı cookie'lere erişebilir mi?

Evet. Shopify Web Pixels API, sandbox içinde browser.cookie objesi sağlar. browser.cookie.get(name) ve browser.cookie.set(name, value) metotları async çalışır ve top frame'deki cookie'lere erişir. Bu, storefront'ta document.cookie ile yazılan cookie'lerin pixel tarafından okunabilmesini sağlar.

+ Market cookie'si hangi consent kategorisine girer?

Analytics kategorisi. Market cookie'si kullanıcı kimliği taşımaz; ülke, dil ve market handle gibi coğrafi context bilgisi içerir. Shopify customerPrivacy API'sinde analyticsProcessingAllowed() ile kontrol edilir.

+ Cross-subdomain market'lerde cookie paylaşımı nasıl sağlanır?

Cookie domain attribute'ü .example.com olarak ayarlanır. Bu sayede de.example.com'da yazılan cookie, fr.example.com'dan okunabilir. Alt klasör yapısında (example.com/de) domain attribute'üne gerek yoktur.

+ İlk sayfa yüklemesinde cookie yoksa ne olur?

Theme app extension cookie'yi yazmadan pixel event'i tetiklenebilir (race condition). Bu durumda init event'indeki data.shop verisi (countryCode, currencyCode) fallback olarak kullanılır. Bu veriler store varsayılanlarıdır, market'e özgü değildir, ancak hiç veri olmamasından iyidir.