Google Analytics Yönetim API'sı, Google Analytics'in Verileri İçe Aktarma özelliğine program kullanarak erişim sağlar.
Giriş
Management API'si veri kümelerinin yanı sıra yüklenen dosyaları yüklemenize, listelemenize, silmenize ve almanıza da olanak tanır. Verileri İçe Aktarma özelliğinin avantajlarına genel bir bakış için Verileri İçe Aktarma Hakkında başlıklı Yardım Merkezi makalesini inceleyebilirsiniz.
Yönetim API'sında bulunan ve Verileri İçe Aktarma özelliğini etkinleştiren iki kaynak şunlardır:
- Web arayüzünde Veri Kümesi olarak adlandırılan ve yüklediğiniz dosyalar için kapsayıcı görevi gören Özel Veri Kaynağı kaynağı. Ö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ükle kaynağı. Yükleme kaynakları koleksiyonu, bir veri kümesine yüklediğiniz tüm dosyaları temsil eder.
Kullanım Alanları
Verileri içe aktarma özelliğinde, her birinin kendi kullanım alanı olan üç üst düzey kategori vardır. Kuruluş aşağıdaki şekildedir:
İsabet verilerini içe aktarma
Geri ödeme verileri
Tamamen veya kısmen geri ödemesi yapılmış e-ticaret işlemleri Google Analytics'e yüklenebilir. Bu, Google Analytics e-ticaret raporlarınızdaki verilerin işlenmiş geri ödemelerle otomatik olarak bağdaştırılmasını kolaylaştırır.
Geri ödeme verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için Geri Ödeme Verilerini içe aktarma örneğini inceleyin.
Genişletilmiş veri içe aktarma
Kullanıcı verileri
Harici CRM araçlarından kimliği tanımlayabilecek nitelikte olmayan kullanıcı verilerini 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 amacıyla kullanıcı verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için aşağıdaki makaleleri inceleyin:
Kampanya verisi
Kampanya verilerini Google Analytics'e aktararak kampanya performansı analizinizi işletmeniz için özelleştirebilirsiniz.
Kampanya verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için Yönetim API'sını Kullanarak Kampanya Verilerini İçe Aktarma başlıklı makaleyi inceleyin.
Coğrafi veriler
Coğrafi kimlik eşlemelerini bölgelere aktararak özel bölgeye göre Google Analytics verileriyle ilgili raporlara izin verebilirsiniz. Örneğin, ABD'de doğu, orta ve batı eyaletlerinde, Avrupa'da ise kuzey, orta ve güney ülke gruplarında faaliyet gösterebilirsiniz. Verileri içe aktarırken ga:regionId
, ga:cityId
, ga:countryIsoCode
veya ga:subContinentCode
tuşlarını anahtar olarak kullanabilirsiniz. Şehir ve ülke kimlikleri Coğrafi Hedefleme tablosunda listelenmektedir. Ülke ISO Kodu ve Alt Kıta Kodu sırasıyla ISO-3166-1 alpha-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ğini inceleyin.
İçerik verileri
Bir web sitesinde yayınlanan makalelerin ayrıntılı analizini yapmak üzere Google Analytics'ten yararlanmak için yazar ve konu gibi içerikle ilgili meta verileri yükleyebilirsiniz.
İçerik verilerinin Google Analytics'e nasıl aktarılacağını öğrenmek için İçerik Verilerini içe aktarma örneği başlıklı makaleyi inceleyin.
Ürün verileri
Ürün Verilerini Google Analytics'e aktarmak, isabetlerle birlikte göndermeniz gereken e-ticaret verilerini (sayfa görüntülemeleri ve etkinlikler gibi) 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 Yönetim API'sını Kullanarak Ürün Verilerini İçe Aktarma başlıklı makaleyi inceleyin.
Özet verileri içe aktarma
Maliyet verileri
Google dışındaki ücretli kampanyalar için maliyet verilerini yükleyebilir ve YG analizi yapmak ve tüm çevrimiçi reklamcılık ve pazarlama yatırımları için kampanya performansını karşılaştırmak üzere Google Analytics platformundan yararlanabilirsiniz.
Maliyet verilerini Google Analytics'e nasıl aktaracağınızı öğrenmek için Yönetim API'sını Kullanarak Maliyet Verilerini İçe Aktarma başlıklı makaleyi inceleyin.
Kavramlar
İşleme Durumu
Bir dosya yükledikten sonra, yükleme doğrulanıp işlenene kadar yüklemenin durumu PENDING
olur. İşlem başarılı olursa durum COMPLETED
olarak değişir.
İşleme sırasında bir hata oluşursa ve yükleme başarısız olursa yüklemenin durumu FAILED
olur. Dosyadaki sorunları tanımlamanıza yardımcı olacak bir hata listesi sağlanır. Aşağıda, doğrulaması 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 Toplamı - Ü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 bir anahtarı (ör. tarih, kaynak, aracı) içeren bir veri satırı içerdiği durumların nasıl ele alınacağını belirtebilirsiniz. Seçenekler şunlardır:
- summation (varsayılan) - Yeni veriler, önceki eşleşen 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 üzere özel veri kaynağı listesi yöntemini kullanarak importBehavior
özelliğinin OVERWRITE
veya SUMMATION
olarak ayarlanıp ayarlanmadığını kontrol edin.
Maliyet verileri satır düzeyinde toplama / üzerine yazma karşılaştırması
Ayrıca, başlığa ga:importBehavior
sütununu ekleyerek, yüklediğiniz her dosya için veri kümesi davranışını geçersiz kılma seçeneğiniz de vardır. Satır başına satır temelinde 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 yazılır, ancak Bing/tbm satırı, söz konusu tarih ve kaynak/aracı kombinasyonuna ilişkin mevcut maliyet verilerine eklenir.
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 sınırlamalar
Verilerin Google Analytics'e yüklenebilmesi için doğru biçimlendirilmiş bir CSV dosyasında olması gerekir. Bu bölümde, verilerin tüm Veri İçe Aktarma türlerine yükleme için geçerli olarak kabul edilebilmesi 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 yükleme isteği başarısız olur ve hata mesajları gösterilir. 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 boyutları ve metrikleri tanımlamalıdır.
Satır Kısıtlamaları
- 1 MB'lık bir satır sınırı vardır.
Hücre Biçimlendirmesi
- Hücreler en fazla 2048 karakter uzunluğunda olabilir.
- Hücrenin başındaki ve sonundaki boşluklar çıkarılır.
- Bir hücre içinde virgül belirtmek için hücre değerinin çift tırnak içinde olması gerekir. Örnek:
source1,"medium,ether",group1,100
- İkinci hücre değeri ortadır (ether). - Bir hücre içinde çift tırnak işareti belirtmek için, başlangıç ve bitiş çift tırnaklarına ek olarak, çift tırnak işaretini başka bir çift tırnak işareti içine alın. Örnek:
source1,"medium""ether",group1,100
: İkinci hücre değerimedium"ether
.