Sosyal Akış Blokları: Instagram, YouTube, Google Yorumları

Nerede bulunur: Tema Editörü → sol panel Bileşenler → Sosyal Medya kategorisi · anahtarlar için Entegrasyonlar → Sosyal Medya Kimler için: Instagram paylaşımlarını, YouTube videolarını ya da Google işletme yorumlarını mağaza sayfasına otomatik taşımak isteyenler Kısaca: Üç yeni blok, hesabınıza girdiğiniz anahtarlarla dış servisten içeriği kendisi çeker, önbellekler ve vitrinde çizer. Anahtar girilmeden blok vitrinde görünmez; editörde örnek içerikle gösterilir.

---

Ne işe yarar?

Ziyaretçi mağazanıza geldiğinde canlı bir marka görmek ister: son paylaşımlar, yeni videolar, gerçek müşteri yorumları. Bunları elle kopyalamak sürdürülemez. Sosyal akış blokları bu işi otomatikleştirir: dış servise bir kez bağlanırsınız, blok içeriği kendisi tazeler.

Üç blok vardır; hepsi Sosyal Medya kategorisinde:

Nasıl çalışır? (kısa mimari)

1. Anahtarları Entegrasyonlar sayfasına girersiniz. Jeton ve API anahtarları şifreli saklanır; vitrine hiçbir zaman gönderilmez.
2. Vitrin dış servise gitmez. İçeriği Treyza sunucusu çeker, 30 dakika önbellekler ve vitrine hazır liste olarak verir. Ziyaretçinin tarayıcısı Instagram'a, YouTube API'sine ya da Google'a istek atmaz.
3. Servis cevap vermezse son başarılı sonuç 24 saate kadar gösterilmeye devam eder; hiç sonuç yoksa blok sessizce atlanır.
4. Anahtar yoksa vitrin bloğu hiç çizmez (boş bir bölüm bırakmaz). Editörde ise blok, "örnek" etiketli temsilî içerikle görünür; böylece yerleşimi anahtar girmeden tasarlayabilirsiniz.

Adım adım: bağlantı kurma

Instagram Akışı

Instagram, Aralık 2024'te eski "Basic Display API"yi kapattı. Treyza, Instagram API with Instagram Login (Graph API) ile çalışır; bunun için Instagram hesabınızın profesyonel (işletme ya da içerik üretici) hesap olması gerekir.

1. developers.facebook.com üzerinde bir uygulama oluşturun ve Instagram ürününü ekleyin.
2. Uygulamanın Instagram API setup with Instagram login bölümünden hesabınızı ekleyin ve uzun ömürlü erişim jetonu üretin ("Generate token"). Aynı ekranda Instagram kullanıcı kimliği (yalnız rakamlardan oluşan ID) görünür.
3. Treyza'da Entegrasyonlar → Sosyal Medya → Instagram Akışı'nı açın, jetonu ve kullanıcı kimliğini yapıştırın. İsterseniz Profil Bağlantısı alanına https://www.instagram.com/kullaniciadi yazın; boş bırakırsanız bağlantı kullanıcı adından üretilir.
4. Bağlantı Test Et ile hesabınızın adını görün, ardından entegrasyonu etkinleştirin.

ℹJeton ömrü: Uzun ömürlü jeton 60 gün geçerlidir. Treyza, jeton 30 günü geçince onu kendisi yeniler; sizin yeniden jeton üretmeniz gerekmez. Yenileme başarısız olursa (örneğin uygulama silinmişse) blok son başarılı içeriği gösterir ve panelde blok ayarlarının başındaki durum satırı sizi uyarır.

YouTube Akışı

1. API anahtarı gerekmez. Treyza, kanalın herkese açık RSS akışını okur (son 15 video). Anahtar alanını boş bırakın; yalnız 15'ten eski videoları listelemek isterseniz isteğe bağlı bir Data API v3 anahtarı girin (nasıl alınacağı rehberde).
2. Kanal kimliğinizi bulun: YouTube Studio → Ayarlar → Kanal → Gelişmiş ayarlar'da UC ile başlayan Kanal ID; ya da doğrudan @tanıtıcınızı yazın.
3. Yalnız belirli bir listeyi göstermek isterseniz Oynatma Listesi ID'yi (adres çubuğundaki list= değeri) girin. Kanal ID boş bırakılıp yalnız liste kimliği verilebilir.
4. Entegrasyonlar → Sosyal Medya → YouTube Akışı ekranına kimliği girin, test edin ("RSS, anahtarsız" yazmalı), etkinleştirin.

Google Yorumları

1. Google Cloud Console'da Places API (New)'i etkinleştirin ve bir API anahtarı oluşturun.
2. İşletmenizin Place ID'sini bulun: Google'ın Place ID bulucu sayfasında işletme adınızı aratın; ChIJ ile başlayan kimliği kopyalayın.
3. Entegrasyonlar → Sosyal Medya → Google Yorumları ekranına anahtarı ve Place ID'yi girin, yorum dilini seçin (Türkçe / İngilizce), test edin, etkinleştirin.

Blok ayarları

Üç blokta ortak ayarlar:

Bloğa özel ayarlar:

Vitrinde davranış

• Instagram öğeleri tıklanınca yeni sekmede paylaşıma gider; video ve albüm paylaşımlarının köşesinde küçük bir işaret bulunur.
• YouTube videoları tıklanana kadar yalnız kapak görselidir; tıklanınca gizlilik dostu youtube-nocookie oynatıcısı açılır. Sayfa yüklenirken YouTube'a hiç istek gitmez, bu yüzden sayfa hızı ve çerez uyumu korunur.
• Google yorumları kart olarak çizilir; puan yıldızları, yazar ve "2 hafta önce" gibi göreli tarih yorumla birlikte gelir.
• Blok, önbellekteki veriyle sunucuda çizilir; ziyaretçi sayfayı açtığında içerik hazırdır. Başlık ve altbilgi bölgeleri gibi sunucu beslemesi olmayan yerlerde içerik sayfa açıldıktan hemen sonra tamamlanır.

Sık sorulan

Blok editörde görünüyor ama vitrinde yok. Entegrasyon bağlı ya da etkin değildir; blok ayarlarının en üstündeki durum satırına bakın. Bağlantı yapıldıktan sonra en geç 5 dakika içinde vitrinde görünür.

Yeni paylaşım ne zaman görünür? Önbellek 30 dakikadır; entegrasyon ayarını kaydetmek önbelleği anında temizler.

Instagram jetonunu ben yenilemeli miyim? Hayır. Treyza 30 günü geçen jetonu kendisi yeniler. Jeton geçersiz olduysa (hesap şifresi değişti, uygulama silindi) yeniden jeton üretip aynı ekrana yapıştırmanız yeterlidir.

Hangi kaynaklar eklenmedi? TikTok, Pinterest ve X akışları bu sürümde yoktur; TikTok'un onay süreci ve X'in ücretli API'si nedeniyle ertelendi.