Looker Studio

Rixe'nin Looker Studio bağlayıcısı günlük görünürlüğünüzü, ses payınızı ve kaynak gösterilen siteleri, CSV dışa aktarmaya gerek kalmadan zaten orada hazırladığınız raporlara getirir. Bu bir Google Apps Script "topluluk bağlayıcısıdır" (community connector) ve REST API'yi bir API anahtarıyla okur; dolayısıyla arkasındaki API gibi salt okunurdur.

Bağlayıcı Looker Studio galerisinde listelenmez. Betiğimizden kendi kopyanızı kendi Google hesabınızla yayınlarsınız. API anahtarı o hesapta kalır, araya üçüncü bir taraf girmez ve anahtarı Rixe'de iptal ettiğiniz anda raporun bağlantısı kesilir.

#Başlamadan önce

• API anahtarı oluşturabilen bir paket. Ayrıntılar: Paketler ve limitler.
• Anahtarı oluşturacak bir sahip ya da yönetici.
• Apps Script ve Looker Studio kullanabilen bir Google hesabı.

#Kurulum

1. API anahtarı oluşturun. Rixe'de kenar çubuğunun altındaki kullanıcı menüsünü açın, Ayarlar › Geliştirici bölümüne gidin, API anahtarı ekle'ye tıklayın, adını "Looker Studio" koyun ve read:scores ile read:sources kapsamlarını işaretleyin. Anahtar üret'e tıklayıp anahtarı kopyalayın; yalnızca bir kez gösterilir. API anahtarları kartındaki Looker Studio bağlayıcısı bağlantısı da bu sayfaya getirir.
2. Betiği kopyalayın. Bağlayıcı betiğini açın (düz metin olarak, Code.gs adıyla gelir), tamamını seçip kopyalayın.
3. Bir Apps Script projesi oluşturun. script.google.com adresine gidin, New project seçin ve projeye "Rixe connector" adını verin.
4. Kodu ve manifesti yapıştırın. Code.gs içeriğini betikle değiştirin. Project settings altında Show "appsscript.json" manifest file in editor seçeneğini açın, ardından appsscript.json içeriğini aşağıdaki manifestle değiştirin.
5. Looker Studio bağlayıcısı olarak yayınlayın. Deploy › Test deployments yolunu izleyin, Looker Studio'yu seçin ve Apps Script'in gösterdiği bağlantıyı açın.
6. Looker Studio sorduğunda API anahtarınızı yapıştırın.
7. Bir çalışma alanı ve veri kümesi seçin. Workspace alanında bir çalışma alanı (ya da anahtarın eriştiği tüm çalışma alanlarını birleştiren All workspaces) ve Data set alanında Daily visibility ya da Cited sources seçin. Connect'e tıklayın.

Bağlayıcının kendi ekranları ve alan adları İngilizcedir; aşağıdaki tablolarda Türkçe karşılıklarıyla açıklanıyor.

#Manifest (appsscript.json)

{
  "timeZone": "Etc/UTC",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "urlFetchWhitelist": ["https://api.rixe.ai/"],
  "dataStudio": {
    "name": "Rixe AI Visibility",
    "logoUrl": "https://app.rixe.ai/logo.png",
    "company": "Rixe",
    "companyUrl": "https://rixe.ai",
    "addonUrl": "https://developers.rixe.ai/developers/looker-studio",
    "supportUrl": "https://developers.rixe.ai/developers/looker-studio",
    "description": "Daily AI search visibility per brand and engine, share of voice and cited sources from your Rixe workspaces.",
    "sources": ["RIXE"],
    "shortDescription": "AI visibility scores, share of voice and citations",
    "authType": ["KEY"],
    "feeType": ["FREE"]
  }
}

#Alanlar: Daily visibility (günlük görünürlük)

Gün, marka ve motor başına bir satır; GET /v1/daily-scores uç noktasından okunur. Pencereyi raporun tarih aralığı denetimi belirler; her yenilemede en fazla 20.000 satır okunur.

Rakip satırlarında Brand alanında rakibin adı ve Is competitor = true bulunur. Rakibin skoru da aynı Visibility score alanındadır; böylece Brand'e göre kırılmış tek bir grafik sizi rakiplerinizle yan yana gösterir.

Bir dönemin doğru görünürlük skoru için Visibility score ortalaması yerine SUM(Mentions) / SUM(Measurements) hesaplanmış alanını kullanın. Günlük oranların ortalaması, sakin bir günle yoğun bir güne aynı ağırlığı verir.

#Alanlar: Cited sources (kaynak gösterilen siteler)

GET /v1/citations uç noktasından okunur. Bu veri kümesi güncel kaynak istatistiklerinin anlık görüntüsüdür; tarih aralığı denetimi buna uygulanmaz.

Sayılar motor ve ay bazında tutulduğundan aynı alan adı birkaç satırda görünebilir. Boyut olarak Domain'i kullanın; ölçüleri Looker Studio toplasın.

#Yenileme sıklığı

Ölçüm günlük yapılır; bundan daha sık çekilecek yeni bir şey yoktur. Veri kaynağının data freshness (veri tazeliği) ayarını 12 saat yapın. API dakikada 1.200 isteğe izin verir; bir rapor "Rate limit reached" diyorsa grafik sayısını değil, tazelik sıklığını düşürün.

#Bağlayıcıyı güncelleme

Betiği değiştirdiğimizde bağlayıcı betiği yeni sürümü verir. Eski Code.gs dosyanızın üzerine yapıştırıp yeniden yayınlayın.

#Sorun giderme

#İlgili sayfalar

• REST API
• Raporlar ve panolar
• Görünürlük skoru
• Kaynaklar