Dönüşüm İzleme

Uygulama

Özet

Dönüşüm izleme uygulaması üç kısımdan oluşur:

Açılış sayfası / uygulama giriş noktasından rwg_token toplama.
Uygun ilişkilendirme dönemi için rwg_token kalıcı hale getirme
Ödeme sırasında dönüşüm etkinliği gönderme

Bu dönüşüm izleme uygulamasında Google Analytics'i 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 vermelisiniz:

Cihaz düzeyinde, tarayıcı çerezlerinin, yerel depolama alanının, uygulama yerel depolama alanının veya jetonu 30 günlük ilişkilendirme penceresi boyunca kalıcı hale getirebilecek başka bir yöntemin kullanılması yer alır. Jeton, kullanıcının cihazında yerel olarak depolanacağından kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını/çerezlerini temizlerse veya özel tarama ya da gizli modu kullanıyorsa dönüşüm etkinliği düzgün şekilde ilişkilendirilmeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken bunu desteklenen her yüzeyde (mobil dahil) yeniden uygulamanız gerekir.
Kullanıcı düzeyinde, sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulamanızın veritabanında kalıcı hale getirme işlemi yer alır. Jeton sunucu tarafında depolandığından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını/çerezlerini temizlerse veya özel tarama ya da gizli mod kullanıyorsa kullanıcı tekrar oturum açtığında dönüşüm etkinliği yine de ilişkilendirilir. 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 yüzeylerde yeniden kullanabilirsiniz.

`rwg_token` toplama

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

Her açılış sayfasında / uygulama giriş noktasında, rwg_token sorgu parametresi için ayarlanan değeri ayrıştırıp saklamanız gerekir. Bu parametrenin depolanmasıyla ilgili şartlar, rwg_token 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 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` kalıcı hale getirme

Not: Gerekli ilişkilendirme aralığının doğru şekilde uygulanması için rwg_token değerinin kalıcı olması gerekir. İlişkilendirme koşulları hakkında daha fazla bilgi için aşağıdaki Dönüşüm İlişkilendirme Koşulları bölümüne bakın.

Toplam 30 gün boyunca, sizin tarafınızdan sağlanan tüm işlem bağlantılarına eklenecek olan rwg_token URL parametresini kalıcı hale getirmeniz gerekir. rwg_token değeri, herhangi bir düzenleme yapılmadan saklanmalı ve döndürülmelidir. Önceki bir ziyaretten kalma 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 depolayabilirsiniz:

Cihaz düzeyinde, tarayıcı çerezlerinin, yerel depolama alanının, uygulama yerel depolama alanının veya jetonu 30 günlük ilişkilendirme penceresi boyunca kalıcı hale getirebilecek başka bir yöntemin kullanılması yer alır.
Kullanıcı düzeyinde, uygulama veritabanınızda, sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla kalıcı hale getirme işlemi yer alır.

Aşağıda, bu jetonu birinci taraf çerezi aracılığıyla bir web tarayıcısında saklayan cihaz düzeyinde dönüşüm izlemeye ilişkin bir örnek verilmiştir. 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"i alanınızla değiştirmelisiniz.

<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ı için 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, şu biçimde JSON kodlu bir nesne olmalıdır:

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

Hem test hem de üretim ortamlarında bir 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==

Not: Üretim ortamında, bu entegrasyonla ilişkilendirilmeyen dönüşüm etkinliklerini göndermemelisiniz. Etkinliği göndermeden önce geçerli ve süresi dolmamış bir rwg_token değeri olup olmadığını kontrol ettiğinizden emin olun.

Bu POST isteğinin nasıl yapılacağını gösteren, cihaz düzeyinde dönüşüm izlemeyle (kullanıcının cihazındaki çerez kullanılarak) ilgili tam bir JavaScript ö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ının bulunduğu yüzeyden bağımsız olarak kullanıcıyla ilişkili jetonu sunucu tarafı depolama mekanizmanızdan alıp aynı üretim veya test ortamı uç noktalarını kullanarak göndermeniz gerekir.

Not: Dönüşüm etkinlikleri bir web veya uygulama istemcisinden ya da sunucudan gönderilebilir. Dönüşüm etkinliği dönüşüm başına tam olarak bir kez gönderildiği ve geçerli bir rwg_token değeri içerdiği sürece, bu kararı ihtiyaçlarınıza ve jetonun depolandığı yere göre verebilirsiniz.

Dönüşüm ilişkilendirme şartları

Google'ın dönüşüm ilişkilendirmesi için gerekli standart, herhangi bir mağazada yer bağlantısıyla yapılan etkileşimler için 30 günlük bir ilişkilendirme dönemidir.

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

Bir kullanıcı, yer işlemi bağlantısını takip eder ve aynı oturumda sipariş verir.
Bir kullanıcı, yer işlemi bağlantısını takip ediyor ve 30 günlük süre içinde farklı bir kanaldan geri dönerek sipariş veriyor.
Bir kullanıcı, yer işlemi bağlantısını tıkladıktan sonra aynı oturumda veya 30 günlük süre içinde farklı bir oturumda farklı bir mağazadan sipariş verir.

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

Masaüstü veya mobil web uygulamaları
Mobil uygulamalar (uygulama derin bağlantısı veya alanınız için kayıtlı bir uygulama amaçlı bağlantı aracılığıyla)

Jeton kullanıcı düzeyinde depolanıyorsa (jetonu kalıcı hale getirme 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ı tıklayan ve ardından işlemi mobil cihazda (aynı kullanıcı hesabını kullanarak) tamamlayan bir kullanıcı, dönüşüm etkinliğini 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ı söz konusu cihazda bir işlem bağlantısını takip etmişse her cihazın ayrı bir jetonu kalıcı hale getirilir ve her cihaz ilişkilendirme kurallarını ayrı ayrı uygular.