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

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

Uygulama

Özet

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

Açılış sayfasından / uygulama giriş noktasından rwg_token toplanıyor.
Uygun ilişkilendirme dönemi için rwg_token değerinin devamlılığını sağlama
Ödeme sırasında dönüşüm etkinliği gönderme

Bu dönüşüm izleme uygulaması, Google Analytics'i veya başka bir 3. taraf JavaScript'i 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 alanı, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme dönemine kadar koruyabilen başka herhangi bir yöntem kullanılabilir. 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 ya da gizli mod 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, bir 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 temizlerse veya gizli göz atma 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 yüzeylerde yeniden kullanabilirsiniz.

`rwg_token` verileri toplanı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ırmalı ve depolamalısınız. Bu parametreyi depolama koşulları, rwg_token için devamlılık sağlama 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 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` için ısrarcı olma

Not: rwg_token koşulunu 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 Şartları bölümüne bakın.

Sağladığınız tüm işlem bağlantılarına eklenecek olan rwg_token URL parametresini toplam 30 gün boyunca sürdürmeniz gerekir. rwg_token değeri depolanmalı ve herhangi bir düzenleme yapılmadan döndürülmelidir. Önceki 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 cihaz düzeyinde veya kullanıcı düzeyinde saklayabilirsiniz:

Cihaz düzeyinde tarayıcı çerezleri, yerel depolama alanı, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme dönemine kadar koruyabilen başka herhangi bir yöntem kullanılabilir.
Kullanıcı düzeyi, bir 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 jetonun birinci taraf çerezi aracılığıyla bir web tarayıcısında saklandığı 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 ayrıştırıdığınız varsayılmaktadır. Bu örneği kullanmak için "rootdomain" alanını kendi 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ı, Google Place Action bağlantısıyla ilişkilendirilebilir 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 bulunur.

Yapım: 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 kodlamalı 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 amacıyla aşağıdaki test jetonunu kullanabilirsiniz.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

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ın isteğinin nasıl yapılacağını gösteren JavaScript'te cihaz düzeyinde dönüşüm izlemenin (kullanıcının cihazında çerez kullanarak) 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 (bulundukları 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. 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şkilendirme Gereksinimleri

Google'ın dönüşüm ilişkilendirmesi için zorunlu standardı, herhangi bir mağazada bir yer bağlantısıyla kurulan 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ği gönderilmesini beklediğimiz anlamına gelir:

Bir 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 sipariş vermek için 30 günlük zaman aralığı içinde 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 süre içinde 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ı
Uygulama derin bağlantısı veya alanınız için kayıtlı uygulama amacı aracılığıyla mobil uygulamalar

Jeton kullanıcı düzeyinde depolanıyorsa (jetonu devam ettirme konusuna bakın) cihazlar arası ilişkilendirme sağlamanız beklenir. Yani masaüstünden bir işlem bağlantısını takip eden ve ardından işlemi mobil cihazda tamamlayan (aynı kullanıcı hesabını kullanarak) kullanıcı bir dönüşüm etkinliği tetiklemelidir.

Jeton özellikle cihaz düzeyinde depolanırsa (ör. tarayıcı çerezlerinde), cihazlar arası ilişkilendirme yapmanız beklenmez. Bu durumda, kullanıcı söz konusu cihazdaki işlem bağlantısını izlemiş olsaydı her bir cihazın ayrı bir jetonu kalıcı olur ve her cihaz, ilişkilendirme kurallarını ayrı ayrı uygular.

2. Adım: Feed'ler

4. Adım: Pilot Uygulama ve Lansman