Shopify mağazasını özel uygulama (Admin API) ile bağlama

Mağazan Shopify'daysa bir özel uygulama oluşturup Admin API erişim anahtarını panele yapıştırarak bağlayabilirsin. Bağlantıdan sonra tam yol eşleşen title ve meta description kuralların ürün, sayfa ve koleksiyonların SEO alanlarına yazılır; içerik stüdyosundaki blog yazıları da mağazanın bloguna makale olarak eklenir.

#Ön koşullar

• Shopify yönetici panelinde uygulama geliştirme izni olan bir hesap.
• Mağazanın my-store.myshopify.com biçimindeki alan adı.
• Blog yayını için mağazada en az bir blog.

#Admin API anahtarı almak

1. Shopify yönetici panelinde Settings → Apps and sales channels → Develop apps yoluna git ve “Allow custom app development” ile özel uygulama geliştirmeyi aç.
2. Create an app'e bas, uygulamaya bir ad ver (örn. SEOAsist) ve Configure Admin API scopes'u aç.
3. Şu izinleri seç: read_products, write_products, read_content, write_content, read_online_store_pages.
4. Install app'e bas, ardından Admin API access token'ı göster ve kopyala (shpat_…). Shopify bu anahtarı yalnızca bir kez gösterir.

#Paneli mağazaya bağlamak

1. Siteler sayfasından siteyi aç ve Düzeltme kanalları sekmesine geç.
2. Shopify kartında Mağaza alan adı alanına my-store.myshopify.com adresini yaz.
3. Admin API erişim anahtarı alanına shpat_ ile başlayan anahtarı yapıştır.
4. Bağla'ya bas. Panel anahtarla mağaza bilgisini çeker; başarılıysa “Shopify bağlandı” bildirimi çıkar ve durum Bağlı olur. Anahtar şifreli saklanır.

#SEO kurallarını mağazaya yazmak

1. Önce Pixel kurallarında title ya da meta description kuralını Tam yol eşleşme türüyle tanımla: /products/…, /pages/… veya /collections/….
2. Shopify kartındaki SEO kurallarını gönder bölümünde uygun kural sayısını kontrol et.
3. SEO kurallarını gönder'e bas. Panel ürünleri, sayfaları ve koleksiyonları handle'larına göre eşleştirir ve değerleri Shopify'ın SEO metafield'larına (global.title_tag / global.description_tag) yazar.
4. Bildirimde kaç kaynağın tarandığını ve kaç kuralın uygulandığını görürsün.

#Blog yazısı yayınlamak

İçerik stüdyosunda bir blog yazısında Kanal olarak Shopify'ı seçip yayınla. Yazı mağazanın ilk bloguna makale olarak eklenir (taslak veya yayında). Başlık, içerik, özet, etiketler, öne çıkan görsel ile meta title ve meta description birlikte gider.

#Doğrulama

• Kartta durum Bağlı görünmeli; yanında mağaza adı, alan adı, Shopify planı ve ana dil yer alır.
• SEO kurallarını gönder'den sonra “son gönderim” tarihi güncellenir.
• Shopify'da ilgili ürünün Search engine listing bölümünde yeni title ve description'ı görebilirsin.

#Sık sorulanlar

#“Mağaza alan adı my-store.myshopify.com biçiminde olmalı” hatası alıyorum, neden?

Panel yalnızca .myshopify.com ile biten alan adını kabul eder. Kendi alan adını (örn. www.magazam.com) değil, Shopify'ın verdiği myshopify.com adresini gir.

#“Geçersiz anahtar” uyarısı ne demek?

Yapıştırdığın değer bir özel uygulama Admin API anahtarı gibi görünmüyor. Anahtar shpat_ ile başlar; API key veya API secret değerini değil, Admin API access token'ı kopyala.

#Bağlanırken HTTP 401 ya da 403 hatası alıyorum, ne yapmalıyım?

Anahtar geçersiz ya da uygulamada gereken izinler yok. Uygulamanın Admin API izinlerini yukarıdaki listeyle karşılaştır, uygulamayı yeniden kur ve yeni anahtarla Anahtarı yenile / yeniden bağla üzerinden tekrar bağlan.

#Kuralı gönderdim ama “0 kural uygulandı” diyor, neden?

Kuralın yolu mağazadaki bir ürün, sayfa veya koleksiyonun handle'ıyla birebir eşleşmiyor olabilir ya da kural tam yol yerine başka bir eşleşme türünde tanımlı olabilir. Yolun /products/handle biçiminde ve kuralın etkin olduğundan emin ol.

#Blog yazısı yayınlarken “the store has no blog” hatası alıyorum, ne yapmalıyım?

Mağazanda hiç blog yok. Shopify'da Online Store → Blog posts altından bir blog oluştur ve yayını tekrar dene.

#Bağlantıyı kesersem mağazaya yazılan SEO alanları silinir mi?

Hayır. Bağlantıyı kes yalnızca bağlantıyı kaldırır; mağazaya yazılmış SEO alanları olduğu gibi kalır.