3. Adım: Dönüşüm İzleme

Uygulama

Özet

Dönüşüm izlemenin uygulanması üç adımdan oluşur:

  1. Açılış sayfasından / uygulama giriş noktasından rwg_token toplanması
  2. Uygun ilişkilendirme aralığı için rwg_token değerini koruma
  3. Ödeme sırasında dönüşüm etkinliği gönderme

Bu dönüşüm izleme uygulaması için Google Analytics veya başka bir üçüncü taraf JavaScript'i kullanmanız gerekmez.

Dönüşüm izleme uygulamanız üzerinde çalışmaya başlamadan önce, dönüşümleri cihaz düzeyinde mi yoksa kullanıcı düzeyinde mi izleyeceğinize karar vermeniz gerekir:

  • Cihaz düzeyi, tarayıcı çerezlerini, yerel depolama alanını, uygulama yerel depolama alanını veya 30 günlük ilişkilendirme aralığı için jetonu koruyabilecek başka herhangi bir yöntemi kullanmayı içerir. Jeton, kullanıcının cihazında yerel olarak depolandığından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını/çerezlerini temizlerse veya gizli tarama ya da gizli mod kullanıyorsa dönüşüm etkinliği düzgün şekilde ilişkilendirilemeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken bunu desteklenen her platformda (mobil dahil) yeniden uygulamanız gerekir.
  • Kullanıcı düzeyi, sunucu tarafı bir analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda kalıcı olarak saklamayı içerir. Jeton sunucu tarafında depolandığından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını/çerezlerini temizlerse veya gizli tarama ya da gizli mod kullanıyorsa kullanıcı tekrar giriş yaptığında dönüşüm etkinliği ilişkilendirilmeye devam eder. Kullanıcı düzeyinde dönüşüm izlemeyi kullanırken, sisteminizin mimarisine bağlı olarak bunu sunucu tarafınızda bir kez uygulayabilir ve desteklenen tüm platformlarda yeniden kullanabilirsiniz.

rwg_token

Google, feed'ler aracılığıyla sağladığınız bir action_link'yi her gösterdiğinde bu URL, benzersiz bir sorgu parametresi içerecek şekilde değiştirilir: rwg_token. rwg_token değeri, kullanıcının tıkladığı bağlantıyla ilgili bazı meta verileri içeren kodlanmış bir dizedir. Bu jetonu depolar ve dönüşüm etkinliğinin bir parçası olarak geri gönderirsiniz.

Her açılış sayfasında / uygulama giriş noktasında, rwg_token sorgu parametresi için ayarlanan değeri ayrıştırmanız ve kaydetmeniz gerekir. Bu parametrenin depolanmasına dair şartlar rwg_token'ü kalıcı tutma adımında açıklanmıştır.

Bu jetonun tarayıcı üzerinden cihaz düzeyinde izleme için nasıl ayrıştırılabileceğine dair bir örnek aşağıda verilmiştir. Alternatif olarak, isteğe yanıt verirken bu jetonu sunucu tarafında da toplayabilirsiniz: 

<script>
  var query = location.search.substring(1);
  var params = query.split('&');
  var rwgToken = undefined;
  for (var i = 0; i < params.length; ++i) {
    var pair = params[i].split('=');
    if (pair[0] == 'rwg_token') {
      rwgToken = decodeURIComponent(pair[1]);
      break;
    }
  }
</script>

rwg_token değerini koruma

rwg_token URL parametresini, sağladığınız tüm işlem bağlantılarına eklenecek şekilde toplam 30 gün boyunca korumanız gerekir. rwg_token değerinin kaydedilmesi ve herhangi bir düzenleme yapılmadan döndürülmesi gerekir. Önceki bir ziyaretten kalan mevcut bir jeton varsa eski jeton değiştirilmeli ve depolama için 30 günlük aralık sıfırlanmalıdır.

Jetonu kalıcı hale getirirken jetonu cihaz düzeyinde veya kullanıcı düzeyinde saklayabilirsiniz:

  • Cihaz düzeyi, tarayıcı çerezlerini, yerel depolama alanını, uygulama yerel depolama alanını veya 30 günlük ilişkilendirme aralığı boyunca jetonu koruyabilecek başka bir yöntemi kullanmayı içerir.
  • Kullanıcı düzeyi, sunucu tarafı bir analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda kalıcı olarak saklamayı içerir.

Aşağıda, cihaz düzeyinde dönüşüm izleme örneği verilmiştir. Bu örnekte, jeton birinci taraf çerez aracılığıyla bir web tarayıcısında depolanmaktadır. Bu örnekte, jeton değerini yukarıdaki örnekte olduğu gibi bir değişkene ayrıştırdığınız varsayılmaktadır. Bu örneği kullanmak için "rootdomain" değerini alanınızla güncellemeniz gerekir. 

<script>
  if (typeof rwg_token !== 'undefined') {
    document.cookie =
    "_rwg_token=" + rwg_token + ";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

Kullanıcı düzeyinde dönüşüm izleme kullanılırken rwg_token, sunucuda depolanmalı ve kullanıcıyla ilişkilendirilmelidir.

Dönüşüm Verilerini Gönderme

Bir kullanıcı, Google Yer İşlemi bağlantısıyla ilişkilendirilebilen bir işlemi tamamladığında dönüşüm uç noktasına bir HTTP POST isteği göndermeniz gerekir. Biri üretim ortamı, diğeri korumalı alan ortamı olmak üzere iki uç nokta vardır.

  • Üretim: https://www.google.com/maps/conversion/collect
  • Korumalı alan: https://www.google.com/maps/conversion/debug/collect

Gönderi gövdesi, aşağıdaki biçimde JSON kodlu bir nesne olmalıdır: 

{
  'conversion_partner_id': partnerId,
  'rwg_token': <rwg_token_val>
}

Hem korumalı alan hem de üretim ortamlarında, dönüşüm etkinliği gönderirken geçerli bir rwg_token sağlamanız gerekir. Korumalı alan ortamında test amacıyla aşağıdaki test jetonunu kullanabilirsiniz. 

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Bu POST isteğinin nasıl yapılacağına dair JavaScript'te cihaz düzeyinde dönüşüm izlemenin (kullanıcı cihazında çerez kullanılarak) tam örneği aşağıda verilmiştir: 

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

const rwgTokenCookie = document.cookie
  .split('; ')
  .find(row => row.startsWith('_rwg_token='));

if (typeof rwgTokenCookie !== 'undefined') {
  const rwgTokenVal = rwgTokenCookie.split('=')[1];
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: rwgTokenVal
    })
  });
}

Kullanıcı düzeyinde dönüşüm izlemeyi kullanırken, kullanıcıyla ilişkili jetonu (kullanıcı hangi platformda olursa olsun) sunucu tarafı depolama mekanizmanızdan almanız ve aynı üretim veya korumalı alan uç noktalarını kullanarak jetonu göndermeniz gerekir.

Dönüşümle İlişkilendirme Şartları

Google'ın dönüşüm ilişkilendirmesi için zorunlu standardı, herhangi bir mağazadaki bir yer bağlantısıyla yapılan tüm etkileşimler için 30 günlük bir ilişkilendirme aralığıdır.

Bu ilişkilendirme aralığı, aşağıdaki senaryolardan herhangi birinde bir dönüşüm etkinliğinin gönderilmesini beklediğimiz anlamına gelir:

  • Kullanıcı, bir yer işlem bağlantısını takip eder ve aynı oturumda sipariş verir
  • Bir kullanıcı, bir yer işlemi bağlantısını takip eder ve ardından 30 günlük süre içinde farklı bir kanaldan sipariş vermek için geri döner.
  • Kullanıcı, bir yer işlemi bağlantısını takip eder ve ardından 30 günlük bir süre içinde aynı oturumda veya farklı bir oturumda farklı bir mağazada sipariş verir.

Ayrıca, dönüşüm etkinliklerinin bir yer işlemi bağlantısından kullanıcının ulaşabileceği tüm platformlardan gönderilmesini bekleriz. İçerik:

  • Masaüstü veya mobil web uygulamaları
  • Mobil uygulamalar (uygulama derin bağlantısı veya alanınız için kayıtlı uygulama amacı üzerinden)

Jeton kullanıcı düzeyinde depolanıyorsa (Jetonu kalıcı tutma bölümüne bakın) cihazlar arası ilişkilendirme sağlamanız beklenir. Yani, masaüstünden bir işlem bağlantısını takip edip işlemi mobil cihazda tamamlayan (aynı kullanıcı hesabını kullanan) bir kullanıcı, dönüşüm etkinliği tetiklemelidir.

Jeton yalnızca cihaz düzeyinde (ör. tarayıcı çerezlerinde) depolanıyorsa cihazlar arası ilişkilendirme sağlamanız beklenmez. Bu durumda, kullanıcı ilgili cihazda bir işlem bağlantısını izlediyse her cihazın kalıcı ayrı bir jetonu olur ve her cihaz ilişkilendirme kurallarını ayrı ayrı uygular.

Önceki
2. Adım: Feed'ler
Sonraki
4. Adım: Pilot program ve lansman