Management API'sini kullanarak Maliyet Verilerini İçe Aktarma

Bu kılavuzda, Management API kullanılarak maliyet verilerinin nasıl içe aktarılacağı açıklanmaktadır.

Giriş

Google dışı ücretli kampanyalar için maliyet ve tıklama verilerini içe aktarmak, Google Analytics platformundan yararlanarak YG analizi gerçekleştirmenizi ve tüm online reklam ve pazarlama yatırımlarınız için kampanya performansını karşılaştırmanızı sağlar.

Başlamadan önce

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

Genel bakış

Management API'sini kullanarak Maliyet Verilerini Google Analytics'e aktarmak için aşağıdaki adımları uygulamanız 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'sini kullanarak yükleyin.

Kampanya URL'lerini etiketleme

Ücretli kampanyalar üzerinde YG analizi gerçekleştirmek 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 örnek reklamda hedef URL, kampanya izleme parametreleriyle (utm_campaign, utm_source, utm_medium, utm_term) etiketlenmiştir. Bu, reklam tıklamalarından gelen 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ı web sitesine yönlendirilir ve aşağıdaki değerler, oturum için Google Analytics'te 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 oturumla ilişkili kampanya izleme parametrelerine sahip olmasını 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 bir Veri Kümesi oluşturmanız gerekir. Veri kümesi, Google Analytics'teki 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 sekmesi altında 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 ve bir veya daha fazla görünüm (profil) seçerek raporlarda Maliyet Analizi'ni etkinleştirin 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ı sağlar. İçe aktarma davranışı hakkında daha fazla bilgi edinmek için Verileri İçe Aktarma Geliştirici Kılavuzu'nun Maliyet Verilerini Toplama ve Üzerine Yazma bölümüne göz atın.
  7. Kaydet'i tıklayın.
Şekil 2: Maliyet veri kümesi oluşturma.

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

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

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

  • Sütun başlıklarını, Google Analytics'in tanıdığı başlıkları eşleşecek şekilde yeniden adlandırın. Üstbilgiyi web arayüzündeki veri kümesi ayrıntılar sayfasından alabilirsiniz.
  • Gerekli tüm eksik değerleri girin.
  • 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 CSV dosyası olarak kaydedilir:

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

Ardından CSV dosyası, Google Analytics'in gerektirdiği biçimi karşılayacak ş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 benzemelidir:

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'sini kullanarak maliyet verilerini yükleme

Veri Kümesini oluşturup maliyet verilerinizi CSV biçiminde yüklemeye hazırladıktan sonra, Management API'sini kullanarak veya web arayüzü üzerinden maliyet verilerinizi yüklemeye hazır olursunuz.

Raporlar

Yüklenen maliyet verileri, Google Analytics'teki Edinme bölümünün yanı sıra Core Reporting API'deki Maliyet Analizi raporlarının bir parçası olarak kullanılabilir.