Bu sayfa, Cloud Translation API ile çevrilmiştir.

Dönüşüm İzleme

Uygulama

Özet

Dönüşüm izleme üç aşamadan oluşur:

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

Bu dönüşüm izleme uygulaması, Google Analytics veya başka bir üçüncü taraf JavaScript kullanmanızı gerektirmez.

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ı çerezleri, yerel depolama, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme süresi boyunca koruyabilecek başka bir yöntem kullanılır. Jeton, kullanıcının cihazında yerel olarak depolanacağından, kullanıcı kullandığı cihazı değiştirir, yerel depolama alanını/çerezlerini temizlerse veya gizli tarama modunu ya da gizli modu kullanıyorsa dönüşüm etkinliği doğru şekilde ilişkilendirilmeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken, bunu desteklenen her yüzeyde (mobil cihazlar dahil) yeniden uygulamanız gerekir.
Kullanıcı düzeyi, verinin sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda kalıcı olarak tutulmasını içerir. Jeton sunucu tarafında saklanacağından, kullanıcı kullandığı cihazı değiştirir, yerel depolama alanını/çerezlerini temizler veya gizli tarama modunu ya da gizli modu 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ında bir kez uygulayıp desteklenen tüm platformlarda yeniden kullanabilirsiniz.

`rwg_token` alınıyor

Google, Feed'ler aracılığıyla sağladığınız bir action_link görüntülediğ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 saklar 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 depolamanız gerekir. Bu parametreyi depolama şartları, rwg_token koşulunun sürdürülmesi adımında açıklanmıştır.

Tarayıcı üzerinden cihaz düzeyinde izleme için bu jetonun nasıl ayrıştırılabileceğine dair bir örnek aşağıda verilmiştir. Alternatif olarak, isteğe yanıt verirken sunucu tarafında bu jetonu 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` koşulunun sürdürülmesi

Not: rwg_token politikasını korumak, gerekli ilişkilendirme aralığını doğru şekilde uygulamak için son derece önemlidir. İlişkilendirme gereksinimleri hakkında daha fazla bilgi için aşağıdaki Dönüşüm İlişkilendirme Koşulları bölümüne bakın.

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

Jetonu sürdürürken jetonu cihaz düzeyinde veya kullanıcı düzeyinde depolayabilirsiniz:

Cihaz düzeyinde; tarayıcı çerezleri, yerel depolama, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme süresi boyunca koruyabilecek başka bir yöntem kullanılır.
Kullanıcı düzeyi, verinin sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda kalıcı olarak tutulmasını içerir.

Aşağıda, bu jetonu birinci taraf çerezi aracılığıyla bir web tarayıcısında depolayan cihaz düzeyinde dönüşüm izleme örneği verilmiştir. Bu örnekte, jeton değerini yukarıdaki örnekte olduğu gibi bir değişkene çözümlediğiniz varsayılmaktadır. Bu örneği kullanmak için "rootdomain"i alanınıza 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

Kullanıcılar, Google Place Action bağlantısıyla ilişkilendirilebilecek bir işlemi tamamladığında dönüşüm uç noktasına bir HTTP POST isteği göndermeniz gerekir. Biri üretim ortamı, diğeri ise korumalı alan ortamı için olmak üzere iki uç nokta bulunur.

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

Yayın gövdesi, şu biçimde json olarak kodlanmış bir nesne olmalıdır:

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

Hem korumalı alanda 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 yapmak için aşağıdaki test jetonunu kullanabilirsiniz.

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Not: Üretimde, 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 edin.

Bu yayınlama isteğinin nasıl yapılacağını gösteren JavaScript'te cihaz düzeyinde dönüşüm izlemenin (kullanıcının cihazında bir çerez kullanılarak) tam bir örneğini aşağıda bulabilirsiniz:

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 (bulunduğu yüzeyden bağımsız olarak) sunucu tarafı depolama mekanizmanızdan almalı ve jetonu aynı üretim veya korumalı alan uç noktalarını kullanarak göndermeniz gerekir.

Not: Dönüşüm etkinlikleri bir web veya uygulama istemcisinden ya da sunucudan gönderilebilir. Bir 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üşümle İlişkilendirmeyle İlgili Koşullar

Google'ın dönüşüm ilişkilendirme için zorunlu standardı, herhangi bir mağazada yer bağlantısıyla olan 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şlemi bağlantısını takip eder ve aynı oturumda bir sipariş verir
Bir kullanıcı, bir yer işlemi bağlantısını izler ve ardından 30 günlük zaman aralığı içinde sipariş vermek için farklı bir kanaldan geri döner.
Bir kullanıcı, bir yer işlemi bağlantısını izler ve ardından aynı oturumda veya 30 günlük bir süre içindeki farklı bir oturumda farklı bir mağazadan sipariş verir.

Ayrıca dönüşüm etkinliklerinin, kullanıcıların bir yer işlemi bağlantısından ulaşabildiği tüm platformlardan gönderilmesini bekleriz. Şunlar dahil:

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

Jeton kullanıcı düzeyinde depolanıyorsa (jetonu sürdürme bölümüne bakın) cihazlar arası ilişkilendirme sağlamanız beklenir. Yani masaüstünde bir işlem bağlantısını takip eden ve daha sonra aynı kullanıcı hesabını kullanarak işlemi mobil cihazda tamamlayan kullanıcı bir dönüşüm etkinliği tetiklemelidir.

Jeton, tarayıcı çerezleri gibi özel olarak cihaz düzeyinde depolanıyorsa cihazlar arası ilişkilendirme sağlamanız beklenmez. Bu durumda, kullanıcı söz konusu cihazdaki bir işlem bağlantısını izlemişse her cihazın ayrı bir jetonu olur ve her cihaz, ilişkilendirme kurallarını ayrı ayrı uygular.