Geliştirilmiş e-ticaret

analytics.js için geliştirilmiş e-ticaret eklentisi, kullanıcının alışveriş deneyimi genelinde e-ticaret web sitelerinde ürünlerle ilgili kullanıcı etkileşimlerinin ölçülmesini sağlar. Örnek olarak şunlar verilebilir: ürün gösterimleri, ürün tıklamaları, ürün ayrıntılarını görüntüleme, alışveriş sepetine ürün ekleme, ödeme işlemini başlatma, işlemler ve geri ödemeler.

E-ticaret Eklentisiyle (ecommerce.js) Taşıma ve Uyumluluk

E-ticaret ölçümünü zaten uyguladıysanız ve Geliştirilmiş E-ticaret'i kullanmaya başlamak istiyorsanız başlıca iki seçeneğiniz vardır:

Yeni bir mülk kullanma

Yeni oluşturulan bir mülk için ek bir izleyici ekleyebilir ve yeni mülk için Geliştirilmiş E-ticaret etiketini etiketleyebilir/etkinleştirebilirsiniz. Tek bir sayfadan birden fazla mülke veri göndermeyle ilgili ayrıntılar için Birden Fazla İzleme Nesnesi ile Çalışma bölümüne bakın.

Mevcut bir mülkü taşıma

E-ticaret eklentisinden geliştirilmiş e-ticaret eklentisine geçmek için mevcut analytics.js kullanıcılarının referansları kaldırması ve geliştirilmiş e-ticaret koduyla değiştirmesi gerekir.

Şu anda ga.js kullanıyorsanız gelişmiş e-ticaret eklentisini kullanmadan önce ilk olarak analytics.js'ye geçmeniz gerekir.

ecommerce.js eklentisi kullanılarak daha önce toplanan işlem ve öğe verileri taşıma işleminden etkilenmez. Bu veriler, başlangıçta gönderildikleri mülklerde ve profillerde kullanılabilir durumda kalır.

Geliştirilmiş E-ticaret Veri Türleri ve İşlemleri

Gönderebileceğiniz birden çok e-ticaret verisi türü vardır:

Gösterim Verileri

Görüntülenen bir ürünle ilgili bilgileri temsil eder. impressionFieldObject olarak anılır ve aşağıdaki değerleri içerir:

Anahtar Değer Türü Zorunlu Açıklama
id kısa mesaj *Evet

Ürün kimliği veya SKU (ör. P67890).

* id veya namelerden biri ayarlanmalıdır.

name kısa mesaj *Evet

Ürünün adı (ör. Android Tişörtü).

* id veya namelerden biri ayarlanmalıdır.

list kısa mesaj Hayır Ürünün ait olduğu liste veya koleksiyon (ör. Arama Sonuçları)
list_name kısa mesaj Hayır Ürünün ait olduğu liste veya koleksiyon (ör. Arama Sonuçları)
brand kısa mesaj Hayır Ürünle ilişkili marka (ör. Google).
category kısa mesaj Hayır Ürünün ait olduğu kategori (ör. Giyim). En fazla 5 hiyerarşi düzeyini (ör. Giyim/Erkek/Tişört) belirtmek için sınırlayıcı olarak / kullanın.
variant kısa mesaj Hayır Ürünün varyantı (ör. Siyah).
position tam sayı Hayır Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).
list_position tam sayı Hayır Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).
price number (sayı) Hayır Ürünün fiyatı (ör. 29,20).

Ürün Verileri

Ürün verileri görüntülenen, alışveriş sepetine eklenen vb. ürünleri tek tek temsil eder. productFieldObject olarak ifade edilir ve aşağıdaki değerleri içerir:

Anahtar Değer Türü Zorunlu Açıklama
id kısa mesaj *Evet

Ürün kimliği veya SKU (ör. P67890).

* Kimlik veya name değerlerinden biri ayarlanmalıdır.

name kısa mesaj *Evet

Ürünün adı (ör. Android Tişörtü).

* Kimlik veya name değerlerinden biri ayarlanmalıdır.

brand kısa mesaj Hayır Ürünle ilişkili marka (ör. Google).
category kısa mesaj Hayır Ürünün ait olduğu kategori (ör. Giyim). En fazla 5 hiyerarşi düzeyini belirtmek için sınırlayıcı olarak / kullanın (ör. Giyim/Erkek/Tişörtler).
variant kısa mesaj Hayır Ürünün varyantı (ör. Siyah).
price number (sayı) Hayır Ürünün fiyatı (ör. 29,20).
quantity tam sayı Hayır Ürünün miktarı (ör. 2).
coupon kısa mesaj Hayır Bir ürünle ilişkili kupon kodu (ör. SUMMER_SALE13).
position tam sayı Hayır Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).
list_position tam sayı Hayır Ürünün bir listedeki veya koleksiyondaki konumu (ör. 2).

Promosyon Verileri

Görüntülenen bir promosyonla ilgili bilgileri temsil eder. Bir promoFieldObject olarak adlandırılır ve aşağıdaki değerleri içerir:

Anahtar Değer Türü Zorunlu Açıklama
id kısa mesaj *Evet

Promosyon kodu (ör. PROMO_1234).

* id veya namelerden biri ayarlanmalıdır.

name kısa mesaj *Evet

Promosyonun adı (ör. Yaz İndirimi).

* id veya namelerden biri ayarlanmalıdır.

creative kısa mesaj Hayır Tanıtımla ilişkili reklam öğesi (ör. yaz_banner2).
creative_name kısa mesaj Hayır Reklam öğesinin adı (ör. yaz_banner2).
position kısa mesaj Hayır Reklam öğesinin konumu (ör. banner_slot_1).
creative_slot kısa mesaj Hayır Reklam alanının adı (ör. banner_slot_1).

İşlem Verileri

E-ticaretle ilgili olarak gerçekleşen bir işlem hakkındaki bilgileri temsil eder. actionFieldObject olarak anılır ve aşağıdaki değerleri içerir:

Anahtar Değer Türü Zorunlu Açıklama
id kısa mesaj *Evet

İşlem kimliği (ör. T1234).

* İşlem türü purchase veya refund ise gereklidir

affiliation kısa mesaj Hayır Bu işlemin gerçekleştiği mağaza veya satış ortağı (ör. Google Store).
revenue number (sayı) Hayır

İşlemle ilişkili toplam geliri veya genel toplamı belirtir (ör. 11,99). Bu değer, gönderim bedelini, vergi maliyetlerini veya gelir hesaplamalarınızın bir parçası olarak dahil etmek istediğiniz toplam gelirde yapılan diğer düzenlemeleri içerebilir.

value number (sayı) Hayır Etkinlikle ilişkili değer (ör. gelir).
tax number (sayı) Hayır İşlemle ilişkili toplam vergi.
shipping number (sayı) Hayır İşlemle ilişkilendirilen gönderim maliyeti.
coupon kısa mesaj Hayır İşlemde kullanılan işlem kuponu.
list kısa mesaj Hayır İlişkili ürünlerin ait olduğu liste. İsteğe bağlı.
items dizi Hayır İlişkilendirilmiş ürünleri içeren dizi.
step tam sayı Hayır Ödeme işlemindeki bir adımı temsil eden sayı. "Ödeme" işlemlerinde isteğe bağlıdır.
checkout_step tam sayı Hayır Ödeme işlemindeki bir adımı temsil eden sayı.
option kısa mesaj Hayır checkout ve checkout_option işlemleri için ödeme sayfasındaki seçenek bilgilerini (ör. seçili ödeme yöntemi) açıklayabilecek ek alan.
checkout_option kısa mesaj Hayır Ödeme seçeneği (yani seçilen ödeme yöntemi).

Ürün ve Promosyon İşlemleri

İşlemler, Google Analytics'e gönderdiğiniz ürün ve promosyon verilerinin nasıl yorumlanacağını belirtir.

İşlem Etkinlik Açıklama
click Bir veya daha fazla ürün için bir ürünün ya da ürün bağlantısının tıklanması.
detail Ürün ayrıntılarının görünümü.
add Bir alışveriş sepetine bir veya daha fazla ürün ekleme.
remove Bir veya daha fazla ürünü alışveriş sepetinden çıkarma.
checkout Bir veya daha fazla ürün için ödeme işlemini başlatma.
checkout_option Belirli bir ödeme adımı için seçenek değeri gönderme.
purchase Bir veya daha fazla ürünün satışı.
refund Bir veya daha fazla ürünün geri ödemesi.
promo_click Dahili tanıtımın tıklanması.
add_to_cart Bir kullanıcının alışveriş sepetine bir veya daha fazla ürün eklemesi.
begin_checkout Kullanıcı, bir veya daha fazla ürün için ödeme işlemini başlatır.
checkout_progress Kullanıcı ilk adımı tamamladıktan sonra ödeme adımlarını tamamlar.
purchase Kullanıcı bir satın alma işlemini tamamlar.
refund Kullanıcıya bir veya daha fazla ürün için geri ödeme yapılır.
remove_from_cart Bir kullanıcı, alışveriş sepetindeki bir veya daha fazla ürünü kaldırır.
select_content Kullanıcı bir ürünü veya ürün bağlantısını tıklar.
set_checkout_option Kullanıcının tamamlamakta olduğu ödeme adımı.
view_item Kullanıcı bir ürünün ayrıntılarını görüntüler.
view_item_list Kullanıcı bir veya daha fazla ürünün listesini görüntüler.
view_promotion Kullanıcı dahili bir promosyonu tıklar.
view_refund Kullanıcı, bir veya daha fazla ürün için geri ödeme görüntüleyebilir.

Uygulama

Aşağıdaki bölümlerde, bir web sitesindeki analytics.js kitaplığıyla e-ticaret etkinliğini ölçmek için geliştirilmiş e-ticaret eklentisinin nasıl uygulanacağı anlatılmaktadır.

E-ticaret Eklentisi'ni yükleme

analytics.js kitaplığının boyutunu küçültmek için varsayılan e-ticaret, geliştirilmiş kitaplıkta sağlanmaz. Bunun yerine, kullanılmadan önce yüklenmesi gereken bir eklenti modülü olarak sağlanır.

Geliştirilmiş e-ticaret eklentisini yüklemek için aşağıdaki komutu kullanın:

ga('require', 'ec');

Bu komut, izleyici nesnenizi oluşturduktan sonra ve geliştirilmiş e-ticarete özgü işlevleri kullanmadan önce gerçekleşmelidir.

Geliştirilmiş E-ticaret Verileri Gönderme

Yükleme işlemi tamamlandığında, varsayılan izleyiciye geliştirilmiş e-ticarete özel birkaç yeni komut eklenir. E-ticaret verileri göndermeye başlayabilirsiniz.

E-ticaret Etkinliklerini Ölçme

Tipik bir geliştirilmiş e-ticaret uygulaması, ürün gösterimlerini ve aşağıdaki işlemlerden herhangi birini ölçer:

  • Bir ürün bağlantısının tıklanma sayısı.
  • Ürün ayrıntıları görüntüleniyor.
  • Dahili tanıtımların gösterimleri ve tıklamaları.
  • Alışveriş sepetine ürün ekleme/kaldırma.
  • Bir ürün için ödeme işlemi başlatma.
  • Satın alma ve geri ödeme işlemleri.

Gösterimleri Ölçme

Ürün gösterimleri, ec:addImpression komutu kullanılarak ölçülür. Ürünle ilgili ayrıntılar bir impressionFieldObjectda eklenir.

Örneğin, aşağıdaki kod, arama sonuçları listesindeki bir ürünün gösterimini ölçer:

ga('ec:addImpression', {            // Provide product details in an impressionFieldObject.
  'id': 'P12345',                   // Product ID (string).
  'name': 'Android Warhol T-Shirt', // Product name (string).
  'category': 'Apparel/T-Shirts',   // Product category (string).
  'brand': 'Google',                // Product brand (string).
  'variant': 'Black',               // Product variant (string).
  'list': 'Search Results',         // Product list (string).
  'position': 1,                    // Product position (number).
  'dimension1': 'Member'            // Custom dimension (string).
});

impressionFieldObject, name veya id değerine sahip olmalıdır. Diğer tüm değerler isteğe bağlıdır ve belirlenmeleri gerekmez.

İşlemleri Ölçme

İşlemler, ürün ayrıntıları eklemek için productFieldObject ile ec:addProduct komutu ve yapılan işlem için ec:setAction komutu kullanılarak ölçülür.

Örneğin, aşağıdaki kod, arama sonuçları listesinde görüntülenen bir ürün bağlantısının tıklanma sayısını ölçer:

ga('ec:addProduct', {               // Provide product details in a productFieldObject.
  'id': 'P12345',                   // Product ID (string).
  'name': 'Android Warhol T-Shirt', // Product name (string).
  'category': 'Apparel',            // Product category (string).
  'brand': 'Google',                // Product brand (string).
  'variant': 'Black',               // Product variant (string).
  'position': 1,                    // Product position (number).
  'dimension1': 'Member'            // Custom dimension (string).
});

ga('ec:setAction', 'click', {       // click action.
  'list': 'Search Results'          // Product list (string).
});

productFieldObject, name veya id değerine sahip olmalıdır. Diğer tüm değerler isteğe bağlıdır ve belirlenmeleri gerekmez.

Gösterimleri ve İşlemleri Birleştirme

Hem ürün gösteriminizin hem de işleminizin olduğu durumlarda, bunu tek bir isabette birleştirip ölçebilirsiniz.

Aşağıdaki örnekte, ilgili ürün bölümü ile ürün ayrıntıları görünümünün nasıl ölçüleceği gösterilmektedir:

// The impression from a Related Products section.
ga('ec:addImpression', {            // Provide product details in an impressionFieldObject.
  'id': 'P12345',                   // Product ID (string).
  'name': 'Android Warhol T-Shirt', // Product name (string).
  'category': 'Apparel/T-Shirts',   // Product category (string).
  'brand': 'Google',                // Product brand (string).
  'variant': 'Black',               // Product variant (string).
  'list': 'Related Products',       // Product list (string).
  'position': 1                     // Product position (number).
});

// The product being viewed.
ga('ec:addProduct', {                 // Provide product details in an productFieldObject.
  'id': 'P67890',                     // Product ID (string).
  'name': 'YouTube Organic T-Shirt',  // Product name (string).
  'category': 'Apparel/T-Shirts',     // Product category (string).
  'brand': 'YouTube',                 // Product brand (string).
  'variant': 'gray',                  // Product variant (string).
  'position': 2                       // Product position (number).
});

ga('ec:setAction', 'detail');       // Detail action.

İşlemleri Ölçme

ec:setAction komutunu kullanarak ve işlem türünü purchase olarak ayarlayarak bir işlemi ölçün. Toplam gelir, vergi ve gönderim bedeli gibi işlem düzeyi ayrıntıları actionFieldObject'nda sağlanır:

ga('ec:addProduct', {               // Provide product details in an productFieldObject.
  'id': 'P12345',                   // Product ID (string).
  'name': 'Android Warhol T-Shirt', // Product name (string).
  'category': 'Apparel',            // Product category (string).
  'brand': 'Google',                // Product brand (string).
  'variant': 'black',               // Product variant (string).
  'price': '29.20',                 // Product price (number).
  'coupon': 'APPARELSALE',          // Product coupon (string).
  'quantity': 1                     // Product quantity (number).
});

ga('ec:setAction', 'purchase', {          // Transaction details are provided in an actionFieldObject.
  'id': 'T12345',                         // (Required) Transaction id (string).
  'affiliation': 'Google Store - Online', // Affiliation (string).
  'revenue': '37.39',                     // Revenue (number).
  'tax': '2.85',                          // Tax (number).
  'shipping': '5.34',                     // Shipping (number).
  'coupon': 'SUMMER2013'                  // Transaction coupon (string).
});

İşlem türü purchase veya refund ise actionFieldObject, id değerine sahip olmalıdır. Diğer tüm değerler isteğe bağlıdır ve ayarlanması gerekmez.

Geri ödemeleri ölçme

Bir işlemin tamamı için geri ödeme yapmak istiyorsanız refund işlemi belirleyip işlem kimliğini sağlayın:

// Refund an entire transaction.
ga('ec:setAction', 'refund', {
  // Transaction ID is only required field for full refund.
  'id': 'T12345'
});

Eşleşen bir işlem bulunamazsa refund isabeti işlenmez.

Kısmi geri ödemeyi ölçmek için bir refund işlemi ayarlayın ve geri ödenecek işlem kimliğini, ürün kimliklerini ve ürün miktarlarını belirtin:

// Refund a single product.
ga('ec:addProduct', {
  'id': 'P12345',       // Product ID is required for partial refund.
  'quantity': 1         // Quantity is required for partial refund.
});

ga('ec:setAction', 'refund', {
  'id': 'T12345',       // Transaction ID is required for partial refund.
});

Geri Ödemeler İçin Etkileşim Dışı Etkinlikleri Kullanma

Geri ödeme verilerini bir etkinlik kullanarak göndermeniz gerekiyorsa ve etkinlik normalde ölçülen site davranışının (kullanıcı tarafından başlatılmayan) bir parçası değilse etkileşim dışı bir etkinlik göndermeniz önerilir. Bu sayede hemen çıkma oranı ve sitede geçirilen süre gibi metrikler etkinlikten etkilenmez. Örneğin:

ga('send', 'event', 'Ecommerce', 'Refund', {'nonInteraction': 1});

Ödeme Sürecini Ölçme

Bir ödeme sürecindeki her adımı ölçmek için:

  • Ödeme işleminin her adımını ölçmek için kod ekleyin.
  • Mümkünse ödeme seçeneklerini ölçmek için kod ekleyin.
  • İsteğe bağlı olarak, web arayüzünün yönetici bölümünde E-ticaret Ayarları'nı yapılandırarak ödeme dönüşüm hunisi raporu için kullanıcı dostu adım adlarını ayarlayın.

1. Ödeme Adımlarını Ölçme

Ödeme işleminizdeki her adım için Google Analytics'e veri göndermek amacıyla karşılık gelen kodu uygulamanız gerekir:

  • step Alanı

    Ölçdüğünüz her ödeme adımı için bir step değeri eklemeniz gerekir. Bu değer, ödeme işlemlerinizi E-ticaret Ayarları'nda her bir adım için yapılandırdığınız etiketlerle eşlemek için kullanılır.

  • option Alanı

    Adımın ölçümü sırasında belirtilen ödeme adımıyla ilgili ek bilgiye sahipseniz option alanını, bu bilgileri yakalamak için checkout işlemiyle ayarlayabilirsiniz. Örneğin, kullanıcı için varsayılan ödeme türü (ör. Visa).

  • Ödeme Adımını Ölçme

    Ödeme adımını ölçmek amacıyla her ürün için ec:addProduct özelliğini kullanın ve ec:setAction bir ödeme adımı belirtin. ec:setAction, varsa ödeme adımını step ve option ile açıklamak için ek bir actionFieldObject alabilir.

    Aşağıdaki örnekte tek bir ürünle birlikte ödeme sürecinin ilk adımının nasıl ölçüleceği ve ödeme türüyle ilgili bazı ek bilgiler gösterilmektedir:

    ga('ec:addProduct', {               // Provide product details in an productFieldObject.
      'id': 'P12345',                   // Product ID (string).
      'name': 'Android Warhol T-Shirt', // Product name (string).
      'category': 'Apparel',            // Product category (string).
      'brand': 'Google',                // Product brand (string).
      'variant': 'black',               // Product variant (string).
      'price': '29.20',                 // Product price (number).
      'quantity': 1                     // Product quantity (number).
    });
    
    // Add the step number and additional info about the checkout to the action.
    ga('ec:setAction','checkout', {
        'step': 1,
        'option': 'Visa'
    });
    

2. Ödeme Seçeneklerini Ölçme

Ödeme seçenekleri, ödeme işleminin durumuyla ilgili ek bilgileri ölçmenizi sağlar. Bu, ilk sayfa görüntüleme sırasında bir ödeme adımını ölçtüğünüzde ancak kullanıcının seçtiği bir seçenek belirtildikten sonra aynı ödeme adımıyla ilgili ek bilginin mevcut olduğu durumlarda yararlıdır. Örneğin, kullanıcı bir gönderim yöntemi seçer.

Bir ödeme seçeneğini ölçmek için ec:setAction özelliğini kullanın. Burada checkout_option değerini belirtip adım numarasını ve seçenek açıklamasını ekleyin.

Kullanıcı ödeme işlemindeki bir sonraki adıma geçmek için tıkladığında bu işlemi ölçmek isteyebilirsiniz. Örneğin:

// (On "Next" button click)
ga('ec:setAction', 'checkout_option', {'step': 2, 'option': 'FedEx'});

ga('send', 'event', 'Checkout', 'Option', {
    hitCallback: function() {
      // advance to next page
    },
});

3. Ödeme Dönüşüm Hunisi Yapılandırması

Ödeme sürecinizdeki her adıma, raporlarda kullanılacak açıklayıcı bir ad verilebilir. Bu adları yapılandırmak için Google Analytics Web Arayüzü'nün Yönetici bölümünü ziyaret edin, görünümü (profil) seçin ve E-ticaret Ayarları'nı tıklayın. Ölçmek istediğiniz her ödeme adımını etiketlemek için E-ticaret kurulum talimatlarını uygulayın.

Google Analytics web arayüzünün Yönetici bölümündeki
     E-ticaret Ayarları. E-ticaret etkin ve dönüşüm hunisine yönelik 4 adım etiketi eklendi: 1. Alışveriş Sepetini İnceleme, 2. Ödeme bilgilerini toplama, 3. Satın Alma Ayrıntılarını Doğrulayın, 4. Fatura
Şekil 1: E-ticaret Kurulumu - Ödeme Dönüşüm Hunisi

Dahili Tanıtımları Ölçme

Geliştirilmiş e-ticaret eklentisi, bir web sitesinin başka bir bölümünde satışı tanıtmak için gösterilen banner'lar gibi dahili tanıtımların gösterimlerini ve tıklamalarını ölçme desteği içerir.

Tanıtımın Gösterim Sayısı

Dahili tanıtım gösterimleri, genellikle sayfa yüklendiğinde ölçülür ve ec:addPromo komutu kullanılarak ilk sayfa görüntüleme ile gönderilir. Örneğin:

ga('ec:addPromo', {               // Promo details provided in a promoFieldObject.
  'id': 'PROMO_1234',             // Promotion ID. Required (string).
  'name': 'Summer Sale',          // Promotion name (string).
  'creative': 'summer_banner2',   // Creative (string).
  'position': 'banner_slot1'      // Position  (string).
});

Promosyon Tıklama Sayısı

Dahili tanıtımlara yapılan tıklamalar promo_click işlemi belirlenerek ölçülebilir. Örneğin:

// Identify the promotion that was clicked.
ga('ec:addPromo', {
  'id': 'PROMO_1234',
  'name': 'Summer Sale',
  'creative': 'summer_banner2',
  'position': 'banner_slot1'
});

// Send the promo_click action with an event.
ga('ec:setAction', 'promo_click');
ga('send', 'event', 'Internal Promotions', 'click', 'Summer Sale');

Örneğin, bir gösterim ve promosyon tıklamasıyla birlikte ürün ayrıntısı sayfasını ölçmek için önce ürün ve gösterim verilerini ilk sayfa görüntüleme ile birlikte gönderin, ardından tanıtım tıklama verilerini ayrı bir etkinlikte gönderin:

// 1. Send product and impression data with pageview.
ga('ec:addProduct', {
  'id': 'P12345',                   // Product ID (string).
  'name': 'Android Warhol T-Shirt', // Product name (string).
  'category': 'Apparel',            // Product category (string).
  'brand': 'Google',                // Product brand (string).
  'variant': 'Black',               // Product variant (string).
  'position': 1,                    // Product position (number).
});

// The impression from the Related Products section.
ga('ec:addImpression', {
  'id': 'P12345',                   // Product ID (string).
  'name': 'Android Warhol T-Shirt', // Product name (string).
  'category': 'Apparel/T-Shirts',   // Product category (string).
  'brand': 'Google',                // Product brand (string).
  'variant': 'Black',               // Product variant (string).
  'list': 'Related Products',       // Product list (string).
  'position': 1,                    // Product position (number).
});

ga('ec:setAction', 'detail');       // Detail action.

ga('send', 'pageview');             // Send the product data with initial pageview.


// 2. Send the promo click data when the promo click occurs.
// Call this function when promo click occurs.
function onPromoClick() {
  ga('ec:addPromo', {
    'id': 'PROMO_1234',
    'name': 'Summer Sale',
    'creative': 'summer_banner2',
    'position': 'banner_slot1'
  });

  // Send the promo_click action with an event.
  ga('ec:setAction', 'promo_click');
  ga('send', 'event', 'Internal Promotions', 'click', 'Summer Sale');
}

promoFieldObject, name veya id değerine sahip olmalıdır. Diğer tüm değerler isteğe bağlıdır ve ayarlanması gerekmez.

Tam Örnek

Aşağıdaki kod snippet'leri, tek bir ürünün e-ticaret yaşam döngüsünün, geliştirilmiş e-ticaret eklentisi kullanılarak ilk gösterimden işleme kadar nasıl ölçülebileceğini gösterir.

Ürün Gösterimini Ölçme

Bu örnekte, kullanıcı ilk önce ürünü arama sonuçları listesinde görüntüler. Bu ürün gösterimini ölçmek için ec:addImpression komutunu kullanın ve ürün ayrıntılarını impressionFieldObject üzerinden sağlayın:

ga('create', 'UA-XXXXX-Y');
ga('require', 'ec');

ga('ec:addImpression', {
  'id': 'P12345',                   // Product details are provided in an impressionFieldObject.
  'name': 'Android Warhol T-Shirt',
  'category': 'Apparel/T-Shirts',
  'brand': 'Google',
  'variant': 'black',
  'list': 'Search Results',
  'position': 1                     // 'position' indicates the product position in the list.
});

ga('ec:addImpression', {
  'id': 'P67890',
  'name': 'YouTube Organic T-Shirt',
  'category': 'Apparel/T-Shirts',
  'brand': 'YouTube',
  'variant': 'gray',
  'list': 'Search Results',
  'position': 2
});

ga('send', 'pageview');              // Send product impressions with initial pageview.

Ürün Tıklamasını Ölçme

Ardından, kullanıcı daha fazla ayrıntı görmek için ürün listelemeyi tıklayarak bu ürüne ilgi duyduğunu ifade eder.

Bu ürün tıklamasını ölçmek için ec:addProduct ve ec:setAction kullanın:

// Called when a link to a product is clicked.
function onProductClick() {
  ga('ec:addProduct', {
    'id': 'P12345',
    'name': 'Android Warhol T-Shirt',
    'category': 'Apparel',
    'brand': 'Google',
    'variant': 'black',
    'position': 1
  });
  ga('ec:setAction', 'click', {list: 'Search Results'});

  // Send click with an event, then send user to product page.
  ga('send', 'event', 'UX', 'click', 'Results', {
    hitCallback: function() {
      document.location = '/product_details?id=P12345';
    }
  });
}

Ardından ürün bağlantısı şu şekilde uygulanabilir:

<a href="/next-page.html"
   onclick="onProductClick(); return !ga.loaded;">
  Android Warhol T-Shirt
</a>

Ürün Ayrıntıları Görünümünü Ölçme

Ürün listelemesini tıkladıktan sonra, kullanıcı ürün ayrıntıları sayfasını görüntüler.

Bu ürün ayrıntıları görünümünü ölçmek için ec:addProduct ve ec:setAction kullanarak detail işlemi belirtin:

ga('create', 'UA-XXXXX-Y');
ga('require', 'ec');

ga('ec:addProduct', {
  'id': 'P12345',
  'name': 'Android Warhol T-Shirt',
  'category': 'Apparel',
  'brand': 'Google',
  'variant': 'black'
});

ga('ec:setAction', 'detail');

ga('send', 'pageview');       // Send product details view with the initial pageview.

Alışveriş Sepetindeki Ekleme veya Kaldırma İşlemini Ölçme

Kullanıcı öğeyi alışveriş sepetine ekleyerek satın alma niyetini ifade eder.

Bir ürünün alışveriş sepetine eklenmesini veya kaldırılmasını ölçmek için ec:addProduct özelliğini kullanın ve add ya da remove türünü ayarlayın:

// Called when a product is added to a shopping cart.
function addToCart(product) {
  ga('ec:addProduct', {
    'id': product.id,
    'name': product.name,
    'category': product.category,
    'brand': product.brand,
    'variant': product.variant,
    'price': product.price,
    'quantity': product.qty
  });
  ga('ec:setAction', 'add');
  ga('send', 'event', 'UX', 'click', 'add to cart');     // Send data using an event.
}

Ödeme Sürecini Ölçme

Şimdi kullanıcı ödeme işlemine başlamaya hazır. Bu örnekte, her biri ayrı sayfalarda olmak üzere iki adım yer alıyor:

  • Ödeme ayrıntılarını ekleyin (payment.html).
  • Gönderim bilgilerini ekleyin (shipping.html).

Mümkünse E-ticaret Ayarları altındaki Web Arayüzü Yöneticisi'nde ödeme dönüşüm hunisini doğru şekilde yapılandırdığınızdan emin olun. Örneğin:

Google Analytics web arayüzünün Yönetici bölümündeki
     E-ticaret Ayarları. E-ticaret etkin ve ödeme dönüşüm hunisi adım etiketleri eklendi: 1. Ödeme Ayrıntıları ve 2. Gönderim Ayrıntıları
Şekil 2: E-ticaret Kurulumu - Ödeme Dönüşüm Hunisi

1. Adım: Ödeme

Ödemenin ilk adımını ölçmek için alışveriş sepetindeki her ürün için ec:addProduct ve bir checkout belirtmek için ec:setAction kullanın. ec:setAction, ödeme adımını bir sayıyla açıklamak için actionFieldObject kullanır ve bu kullanıcının varsayılan ödeme türü hakkında daha fazla bilgiyi option alanı ile içerir:

ga('create', 'UA-XXXXX-Y');
ga('require', 'ec');

/**
 * Called when the user begins the checkout process.
 * @param {Array} cart An array representing the user's shopping cart.
 */
function checkout(cart) {
  for(var i = 0; i < cart.length; i++) {
    var product = cart[i];
    ga('ec:addProduct', {
      'id': product.id,
      'name': product.name,
      'category': product.category,
      'brand': product.brand,
      'variant':  product.variant,
      'price': product.price,
      'quantity': product.qty
    });
  }
}

// In the case of checkout actions, an additional actionFieldObject can
// specify a checkout step and option.
ga('ec:setAction','checkout', {
    'step': 1,            // A value of 1 indicates this action is first checkout step.
    'option': 'Visa'      // Used to specify additional info about a checkout stage, e.g. payment method.
});
ga('send', 'pageview');   // Pageview for payment.html

2. Adım: Gönderim

Ödemenin ikinci adımını ölçmek için alışveriş sepetindeki her ürün için ec:addProduct ve bir ödeme adımını belirtmek için ec:setAction kullanın. Bu durumda, ilk sayfa görüntüleme gönderilirken belirlenen gönderim seçeneği hakkında ek bilgiye sahip olmadığımız için bir checkout_option belirtmek üzere ec:setAction kullanılarak ayrı olarak gerçekleştirilir.

// Measure checkout step 2:
ga('create', 'UA-XXXXX-Y');
ga('require', 'ec');

/**
 * Called when the user begins the checkout process.
 * @param {Array} cart An array representing the user's shopping cart.
 */
function checkout(cart) {
  for(var i = 0; i < cart.length; i++) {
    var product = cart[i];
    ga('ec:addProduct', {
      'id': product.id,
      'name': product.name,
      'category': product.category,
      'brand': product.brand,
      'variant':  product.variant,
      'price': product.price,
      'quantity': product.qty
    });
  }
}

ga('ec:setAction','checkout', {'step': 2});
ga('send', 'pageview');     // Pageview for shipping.html


// Called when user has completed shipping options.
function onShippingComplete(stepNumber, shippingOption) {
  ga('ec:setAction', 'checkout_option', {
    'step': stepNumber,
    'option': shippingOption
  });

  ga('send', 'event', 'Checkout', 'Option', {
     hitCallback: function() {
       // Advance to next page.
     }
  });
}

Ardından form şu şekilde uygulanabilir:

<a href="/next-page.html"
   onclick="onShippingComplete(2, 'FedEx'); return !ga.loaded;">
  Continue
</a>

İşlemleri Ölçme

Son olarak kullanıcı, ödeme işlemini tamamlar ve satın alma işlemini gönderir.

Bir veya daha fazla ürünün satışını ölçmek için her ürünü eklemek üzere ec:addProduct operatörünü kullanın, ardından purchase belirlemek için ec:setAction değerini kullanın. Toplam gelir, vergi vb. işlem düzeyindeki bilgiler actionFieldObject aracılığıyla belirtilebilir. Örneğin:

ga('create', 'UA-XXXXX-Y');
ga('require', 'ec');

ga('ec:addProduct', {
  'id': 'P12345',
  'name': 'Android Warhol T-Shirt',
  'category': 'Apparel',
  'brand': 'Google',
  'variant': 'black',
  'price': '29.20',
  'quantity': 1
});

// Transaction level information is provided via an actionFieldObject.
ga('ec:setAction', 'purchase', {
  'id': 'T12345',
  'affiliation': 'Google Store - Online',
  'revenue': '37.39',
  'tax': '2.85',
  'shipping': '5.34',
  'coupon': 'SUMMER2013'    // User added a coupon at checkout.
});

ga('send', 'pageview');     // Send transaction data with initial pageview.

Yerel Para Birimlerini Belirleme

Varsayılan olarak, Google Analytics yönetimi web arayüzü aracılığıyla tüm işlemler ve öğeler için ortak ve küresel bir para birimi yapılandırabilirsiniz. Global para birimi varsayılan olarak tüm öğeler ve işlemler için kullanılır. E-ticaret eklentisi, birden fazla para biriminde işlem yapan web siteleri için işlemin yerel para birimini belirtmenizi sağlar.

Yerel para birimi ISO 4217 standardında belirtilmelidir. Desteklenen dönüşüm para birimlerinin tam listesi için Para Birimi Kodları Referansı dokümanını okuyun.

Yerel para birimleri, currencyCode izleyici özelliği kullanılarak belirtilir. Örneğin, bu izleyici para birimi değerlerini Euro olarak gönderir:

ga('create', 'UA-XXXXX-Y');
ga('require', 'ec');

ga('set', 'currencyCode', 'EUR'); // Set currency to Euros.

ga('ec:addProduct', {
  'id': 'P12345',
  'name': 'Android Warhol T-Shirt',
  'category': 'Apparel',
  'brand': 'Google',
  'variant': 'black',
  'price': '21.89',
  'quantity': 1
});

ga('ec:setAction', 'purchase', {
  id: 'T12345',
  affiliation: 'Google Store - Online',
  revenue: '28.03',
  tax: '2.14',
  shipping: '4.00',
  coupon: 'SUMMER2013'
});

ga('send', 'pageview');