Google Analytics Management API, Google Analytics'in Verileri İçe Aktarma özelliğine programatik erişim sağlar.
Giriş
Management API'si yüklenen veri kümelerinin yanı sıra yüklenen dosyaları yüklemenize, listelemenize, silmenize ve almanıza olanak tanır. Verileri içe aktarma özelliğinin avantajlarına genel bakış için Verileri İçe Aktarma Hakkında başlıklı makaleyi inceleyin.
Management API'de verileri içe aktarmayı sağlayan iki kaynak vardır:
- Web arayüzünde Veri Kümesi olarak adlandırılan ve yüklediğiniz dosyalar için bir kapsayıcı görevi gören Özel Veri Kaynağı kaynağı. Bir Özel Veri Kaynakları koleksiyonu, bir Google Analytics mülküyle ilişkili tüm veri kümelerini temsil eder.
- Yüklenen bir dosyayı temsil eden Yükleme kaynağı. Yükleme kaynakları koleksiyonu, bir veri kümesine yüklediğiniz tüm dosyaları temsil eder.
Kullanım Alanları
Veri içe aktarma özelliğinin, her biri kendi kullanım alanına sahip üç üst düzey kategorisi vardır. Kuruluş aşağıdaki gibidir:
İsabet verilerini içe aktarma
Geri ödeme verileri
Tamamen veya kısmen geri ödenmiş e-ticaret işlemleri Google Analytics'e yüklenebilir. Bu sayede, Google Analytics e-ticaret raporlarınızdaki verilerle, işlenen geri ödemeler arasında otomatik olarak mutabakat sağlayabilirsiniz.
Geri ödeme verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için Geri Ödeme Verilerini içe aktarma örneği başlıklı makaleyi inceleyin.
Genişletilmiş veri içe aktarma
Kullanıcı verileri
Harici CRM araçlarından kimliği tanımlayabilecek nitelikte olmayan kullanıcı verileri yükleyebilir ve en değerli kullanıcı segmentleriniz için Google Ads yeniden pazarlama kitleleri oluşturabilirsiniz.
Google Ads yeniden pazarlama kitleleri oluşturmak üzere kullanıcı verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için aşağıdaki makalelere bakın:
Kampanya verisi
Kampanya verilerini Google Analytics'e aktararak kampanya performansı analizlerinizi işletmeniz için özelleştirebilirsiniz.
Kampanya verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için Management API'sini kullanarak Kampanya Verilerini İçe Aktarma başlıklı makaleye bakın.
Coğrafi veriler
Coğrafi kimliklerin eşlemelerini bölgelere aktarıp Google Analytics verileriyle ilgili bölgeye özel raporlara izin verebilirsiniz. Örneğin, Amerika Birleşik Devletleri'nde doğu, orta ve batıdaki eyalet gruplarında faaliyet gösterebilirsiniz. Avrupa'da kuzey, merkezi ve güney ülke gruplarında faaliyet gösterebilirsiniz. Verileri içe aktarırken anahtar olarak ga:regionId, ga:cityId, ga:countryIsoCode veya ga:subContinentCode kullanılabilir. Şehir kimlikleri ve ülke kimlikleri Coğrafi Hedefleme tablosunda bulunabilir. Ülke ISO Kodu ve Alt Kıta Kodu, sırasıyla ISO-3166-1 alfa-2 ve UN M.49 tablolarında bulunabilir.
Coğrafi verileri içe aktarma hakkında daha fazla bilgi için Coğrafi Verileri içe aktarma örneğine bakın.
İçerik verileri
Bir web sitesinde yayınlanan makalelerin ayrıntılı analizleri için Google Analytics'ten yararlanmak üzere yazar ve konu gibi içerikle ilgili meta verileri yükleyebilirsiniz.
İçerik verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için İçerik Verilerini içe aktarma örneği başlıklı makaleye bakın.
Ürün verileri
Ürün Verilerini Google Analytics'e aktarmak, sayfa görüntülemeleri ve etkinlikler gibi isabetlerle birlikte göndermeniz gereken e-ticaret verilerini basitleştirir ve azaltır. Raporlarınızdaki ürün boyutlarını ve metriklerini doldurmak için içe aktarılan ürün verilerinizle tek bir ürün kimliği veya SKU birleştirilebilir.
Ürün verilerinizi Google Analytics'e nasıl aktaracağınızı öğrenmek için Management API'sini kullanarak ürün verilerini içe aktarma başlıklı makaleye bakın.
Özet verileri içe aktarma
Maliyet verileri
Google dışı ücretli kampanyalar için maliyet verilerini yükleyip Google Analytics platformundan yararlanarak YG analizi yapabilir, tüm online reklam ve pazarlama yatırımlarınız için kampanya performansını karşılaştırabilirsiniz.
Maliyet verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için Management API'sini kullanarak Maliyet Verilerini İçe Aktarma başlıklı makaleye bakın.
Kavramlar
İşleme Durumu
Bir dosyayı yükledikten sonra, yükleme doğrulanıp işlenene kadar yükleme durumu PENDING olur. İşlem başarılı olursa durum COMPLETED olarak değişir.
İşleme sırasında bir hata oluştu ve yükleme başarılı olmadıysa yüklemenin durumu FAILED olur. Dosyayla ilgili sorunları tanımlamanıza yardımcı olmak için bir hata listesi sağlanır. Aşağıda, doğrulama başarısız olan bir yükleme için örnek yanıt verilmiştir:
{
id: "YU4DersR_ORzyzXC_AoWw",
kind: "analytics#upload",
accountId: "12345",
customDataSourceId: "poaU7EPcR4WGU-dkNghYKQ",
status: "FAILED",
errors:
[
"Invalid cell data 12.99 at row 1 column 6. expected data type LONG.",
"Invalid cell data 12.99 at row 2 column 6. expected data type LONG.",
"Invalid cell data 23.81 at row 3 column 6. expected data type LONG.",
"Invalid cell data 199.99 at row 4 column 6. expected data type LONG."
]
}
Maliyet Verileri Toplama - Üzerine Yazma
Maliyet verileri için Özel Veri Kaynağı / Veri Kümesi oluştururken, yüklenen bir dosyanın mevcut bir satırla eşleşen anahtara (ör. tarih, kaynak, aracı) sahip bir veri satırı içerdiği durumlarda bunu nasıl ele alacağınızı belirtebilirsiniz. Seçenekler şunlardır:
- toplama (varsayılan) - Yeni veriler, daha önceki eşleşen tüm verilere eklenir ve metrikler birlikte toplanır.
- üzerine yaz: Yeni veriler, önceki eşleşen verilerin üzerine yazılır.
Bir veri kümesi için hangi türün ayarlandığını öğrenmek amacıyla importBehavior özelliğinin OVERWRITE veya SUMMATION olarak ayarlanıp ayarlanmadığını kontrol etmek için özel veri kaynağı listesi yöntemini kullanın.
Maliyet verileri satır düzeyi toplamı ile üzerine yazma karşılaştırması
Ayrıca, üstbilgiye ga:importBehavior sütununu ekleyerek yüklediğiniz her dosya için veri kümesi davranışını geçersiz kılma seçeneğiniz vardır. Satır bazında, ga:importBehavior değerini SUMMATION veya OVERWRITE olarak ayarlayabilirsiniz.
Örneğin aşağıdaki dosya Facebook/tbm ve Yahoo/tbm için önceki maliyet verilerinin üzerine yazacaktır ancak Bing/tbm satırı, söz konusu tarih ve kaynak/aracı kombinasyonu için mevcut tüm maliyet verilerine eklenecektir.
ga:date,ga:source, ga:medium,ga:adCost,ga:importBehavior
20140604,facebook,cpc,12.23,OVERWRITE
20140604,bing,cpc,3.23,SUMMATION
20140604,yahoo,cpc,11.23,OVERWRITE
Biçim ve kısıtlamalar
Verilerin Google Analytics'e yüklenmesi için doğru şekilde biçimlendirilmiş bir CSV dosyasında olması gerekir. Bu bölümde, tüm Veri İçe Aktarma türlerine yükleme işlemi için geçerli sayılabilmesi için karşılaması gereken kısıtlamalar açıklanmaktadır.
Aşağıdaki kısıtlamalardan herhangi biri ihlal edilirse veya ayrıştırma hatası varsa hata mesajları kullanıldığında yükleme isteği başarısız olur. API, kullanıcıların geçersiz yükleme sayısını azaltmasına yardımcı olmak için tek bir yanıtta en fazla 10 hata bildirir.
Dosya Kısıtlamaları
- Kodlama: UTF-8
- Dosya boyutu sınırı: 1 GB
Başlık Kısıtlamaları
- İlk satır, sütun başlığı olarak kabul edilir ve zorunludur. Belirli bir sütunun içereceği boyut ve metrikleri tanımlamalıdır.
Satır Kısıtlamaları
- Satır sınırı 1 MB'tır.
Hücre Biçimlendirmesi
- Hücreler en fazla 2048 karakter uzunluğunda olabilir.
- Bir hücrenin başındaki ve sonundaki boşluklar çıkarılır.
- Hücrenin içinde virgül belirtmek için hücrenin değeri çift tırnak içine alınmalıdır. Örnek:
source1,"medium,ether",group1,100- İkinci hücre değeri orta düzeydedir. - Bir hücrede çift tırnak işareti belirtmek için, çift tırnak işaretinin başına ve sonuna ek olarak çift tırnak işaretini başka bir çift tırnak işaretiyle birlikte kullanın. Örnek:
source1,"medium""ether",group1,100- İkinci hücre değerimedium"ether.