Yönetim API'sini kullanarak Maliyet Verilerini içe aktarma

Bu kılavuzda, Management API'yi kullanarak maliyet verilerini nasıl içe aktarabileceğiniz açıklanmaktadır.

Giriş

Google dışındaki ücretli kampanyaların maliyet ve tıklama verilerini içe aktarmak, Google Analytics platformundan yararlanarak tüm dijital reklamcılık ve pazarlama yatırımlarınızın YG analizini yapmanıza ve kampanya performansını karşılaştırmanıza olanak tanır.

Başlamadan önce

Geliştiriciler bu kılavuza başlamadan önce aşağıdakileri yapmalıdır:

Genel bakış

Yönetim API'sini kullanarak Maliyet Verilerini Google Analytics'e aktarmak için aşağıdaki adımların uygulanması gerekir:

  1. Kampanya URL'lerini etiketleyin.
  2. Veri kümesi oluşturun.
  3. Maliyet verileri CSV dosyasını yükleme için hazırlayın.
  4. Maliyet verilerini Management API'yi kullanarak yükleme.

Kampanya URL'lerini etiketleyin

Ücretli kampanyalarda YG analizi yapmak için harici kaynaklardan gelen maliyet verileri, kullandığınız Google dışı reklam sistemindeki tüm hedef URL'lere kampanya izleme parametreleri eklenerek Google Analytics'teki oturum verileriyle birleştirilebilir.

Örnek

Aşağıdaki reklam örneğinde hedef URL, kampanya izleme parametreleriyle (utm_campaign, utm_source, utm_medium, utm_term) etiketlenmiştir. Bu, reklam tıklamalarından web sitesine yapılan ziyaretlerin Google Analytics'teki yaz indirimi kampanyasıyla ilişkilendirilmesini sağlar.

Şekil 1: Reklam Örneği.

Evcil hayvan mağazası bu reklam için aşağıdaki hedef URL'yi kullandı:

http://www.examplepetstore.com?utm_campaign=Summer%2BSale&utm_source=ad%2Bnetwork&utm_medium=cpc&utm_term=dogbone

Kullanıcı reklamı tıkladığında evcil hayvan mağazasının web sitesine yönlendirilir ve oturum için Google Analytics'te aşağıdaki değerler ayarlanır:

Google Analytics Web Arayüzündeki Boyut Adı Kampanya izleme parametresi Google Analytics'te ayarlanan değer
Kampanya Adı utm_campaign Yaz İndirimi
Kaynak utm_source reklam ağı
Aracı utm_medium tbm
Keyword utm_term köpek kemiği

Bu, Google Analytics'in kampanya izleme parametrelerini oturumla ilişkilendirmesini ve Google Analytics verilerinin harici maliyet verileri kaynağıyla birleştirilebilmesini sağlar.

Veri kümesi oluşturma

Maliyet verilerinizi içe aktarmak için Veri Kümesi oluşturmanız gerekir. Veri kümesi, Google Analytics'te bir veya daha fazla harici veri kaynağını temsil etmek için kullanılır. Veri kümesi yalnızca web arayüzü üzerinden oluşturulabilir.

Yönetici sayfasının mülk sekmesinde aşağıdaki adımları uygulayın:

  1. Verileri İçe Aktarma sekmesini seçin.
  2. Yeni Veri Kümesi düğmesini tıklayın.
  3. Tür için Maliyet Verileri'ni seçin ve Sonraki Adım'ı tıklayın.
  4. Veri kümesine bir ad verin, raporlarda Maliyet Analizi'ni etkinleştirmek için bir veya daha fazla görünüm (profil) seçin ve Sonraki Adım'ı tıklayın.
  5. Yüklemeyi düşündüğünüz Boyutları ve Metrikleri seçin.
  6. İstediğiniz İçe Aktarma Davranışı'nı seçin.
    • Bu ayar, yinelenen anahtarın bulunduğu durumlarda maliyet verilerinin üzerine yazılmasını veya toplanmasını kontrol eder. İçe aktarma davranışı hakkında daha fazla bilgi edinmek için Verileri İçe Aktarma Geliştirici Kılavuzu'nun Maliyet Verileri Toplamı ve Üzerine Yazma bölümüne bakın.
  7. Kaydet'i tıklayın.
Şekil 2: Maliyet verileri kümesi oluşturma.

Maliyet verileri CSV dosyasını yükleme için hazırlama

Google Analytics, maliyet verilerinin belirli bir biçimde ve belirli değerlerle yüklenmesini bekler. Yüklemeden önce, harici bir kaynaktan dışa aktarılan maliyet verilerinin bu gereksinimleri karşıladığından emin olmanız gerekir.

CSV dosyasında yapmanız gereken başlıca değişiklikler ve doğrulamalar şunlardır:

  • Sütun başlıklarını Google Analytics tarafından tanınan başlıklarla eşleşecek şekilde yeniden adlandırın. Üstbilgiyi, web arayüzündeki veri kümesi ayrıntıları sayfasından alabilirsiniz.
  • Gerekli olup eksik olan tüm değerleri ekleyin.
  • Uygun olduğunda, CSV dosyasındaki değerler kampanya izleme parametreleri için kullanılan değerlerle eşleşmelidir.

Örnek

Evcil hayvan mağazası örneğinde, veriler toplu olarak dışa aktarılır ve bir CSV dosyası olarak kaydedilir:

Şekil 3: Dışa aktarılan maliyet verileri CSV dosyası.

CSV dosyası daha sonra Google Analytics'in gerektirdiği biçime uyacak şekilde değiştirilir:

Şekil 4: Biçimlendirilmiş maliyet verileri CSV dosyası.

CSV dosyasını hazırladıktan sonra, biçim aşağıdaki örneğe benzer olacaktır:

ga:date,ga:source,ga:medium,ga:campaign,ga:keyword,ga:impressions,ga:adClicks,ga:adCost
20140615,ad network,cpc,Summer Sale,dogbone,9387,288,100.3
20140615,ad network,cpc,Summer Sale,dog treat,1684,52,19.35
20140615,ad network,cpc,Summer Sale,pet store,3187,143,76.23
20140616,ad network,cpc,Summer Sale,dogbone,8754,188,86.21

Genel dosya biçimi kısıtlamaları için Verileri İçe Aktarma Geliştirici Kılavuzu'na bakın.

Management API'yi kullanarak maliyet verilerini yükleme

Veri Kümesini oluşturup maliyet verilerinizi CSV biçiminde yüklemek üzere hazırladıktan sonra Manage API'yi veya web arayüzü üzerinden maliyet verilerinizi yüklemeye hazır olursunuz.

Raporlar

Yüklenen maliyet verileri, Temel Raporlama API'sinin yanı sıra Google Analytics'te Edinme bölümündeki Maliyet Analizi raporlarının bir parçası olarak kullanılabilir.