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

Dönüşüm İzleme

Uygulama

Özet

Dönüşüm izleme uygulamasının üç aşaması vardır:

Açılış sayfasından / uygulama giriş noktasından rwg_token toplama.
Uygun ilişkilendirme dönemi için rwg_token varlığını sürdürmek
Ö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 3. taraf JavaScript 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üzeyinde; tarayıcı çerezleri, yerel depolama alanı, uygulama yerel depolama alanı veya 30 günlük ilişkilendirme dönemi için jetonu koruyabilen diğer yöntemlerin kullanılması dahildir. Jeton kullanıcının cihazında yerel olarak depolanacağından, kullanıcı kullandığı cihazı değiştirir, yerel depolama alanını/çerezlerini temizler ya da özel bir tarama veya gizli mod kullanıyorsa, dönüşüm etkinliği doğru şekilde ilişkilendirilmeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken, desteklenen her yüzeyde (mobil dahil) yeniden uygulamanız gerekir.
Kullanıcı düzeyi, uygulama veritabanınızda, sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla kalıcı hale getirmeyi içerir. Jeton sunucu tarafında saklanacağı için kullanıcı kullandığı cihazı değiştirir, yerel depolama alanını/çerezlerini temizler ya da gizli bir göz atma veya gizli mod kullanıyorsa, kullanıcı tekrar giriş yaptıktan sonra 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` alınıyor

Google, Feed'ler aracılığıyla sağladığınız bir action_link özelliğini her öne çıkardığında 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 depolayıp dönüşüm etkinliğinin bir parçası olarak geri gönderirsiniz.

Her açılış sayfası/uygulama giriş noktasında, rwg_token sorgu parametresi için ayarlanan değeri ayrıştırıp depolamanız gerekir. Bu parametreyi depolamaya ilişkin gereksinimler, rwg_token ile devam ettirme adımında açıklanmıştır.

Tarayıcı aracılığıyla cihaz düzeyinde izleme için bu jetonun nasıl ayrıştırılabileceğine dair bir örneği aşağıda bulabilirsiniz. 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` kalıcıdır

Not: rwg_token ilişkilendirmesini sürdürmek, gerekli ilişkilendirme aralığını doğru şekilde uygulamak için çok önemlidir. İlişkilendirme şartlarıyla ilgili daha fazla ayrıntı için aşağıdaki Dönüşüm İlişkilendirme Gereksinimleri bölümünü inceleyin.

Sağladığınız tüm işlem bağlantılarına eklenen rwg_token URL parametresini, toplam 30 gün boyunca kullanmanız gerekir. rwg_token değeri depolanmalı ve düzenleme yapılmadan döndürülmelidir. Önceki bir ziyaretten itibaren mevcut olan bir jeton varsa eski jetonun değiştirilmesi ve depolama alanının 30 günlük penceresinin sıfırlanması gerekir.

Jetonu korurken jetonu cihaz düzeyinde veya kullanıcı düzeyinde depolayabilirsiniz:

Cihaz düzeyinde; tarayıcı çerezleri, yerel depolama alanı, uygulama yerel depolama alanı veya 30 günlük ilişkilendirme dönemi için jetonu koruyabilen diğer yöntemlerin kullanılması dahildir.
Kullanıcı düzeyi, uygulama veritabanınızda sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla kalıcı olmasını sağlar.

Aşağıda, bu jetonu bir web tarayıcısında birinci taraf çerezi üzerinden depolayarak cihaz düzeyinde dönüşüm izleme ile ilgili bir örnek verilmiştir. Bu örnekte, yukarıdaki örnekte olduğu gibi jeton değerini bir değişkene ayrıştırmış olduğunuz varsayılır. Bu örneği kullanmak için "kök alanı" alan adınızı 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 Yer İşlemi 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 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

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

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

Not: Üretimde, bu entegrasyonla ilişkilendirilmemiş dönüşüm etkinliklerini göndermemeniz gerekir. Etkinliği göndermeden önce geçerli ve süresi dolmamış bir rwg_token değeri olup olmadığını kontrol edin.

Bu gönderi isteğinin nasıl yapılacağına ilişkin JavaScript kodundaki cihaz düzeyinde dönüşüm izlemenin tam olarak bir örneğini (kullanıcının cihazında bir çerez kullanarak) 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 sunucu tarafındaki depolama mekanizmasından almanız 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 kararının dönüşüm başına tam olarak bir kez gönderilmesi ve geçerli bir rwg_token değeri içermesi koşuluyla, bu kararı ihtiyaçlarınıza göre ve jetonun depolandığı yere göre alabilirsiniz.

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

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

Bu ilişkilendirme dönemi, 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 sipariş verir
Kullanıcı bir yer işlemi bağlantısını takip eder ve ardından sipariş vermek için 30 gün içinde farklı bir kanaldan döner.
Kullanıcı bir yer işlemi bağlantısını takip ettikten sonra, aynı oturum içinde veya 30 günlük bir zaman diliminde farklı bir oturumda farklı bir mağazadan sipariş verir.

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

Masaüstü veya mobil web uygulamaları
Mobil derin uygulamalar veya alanınız için kayıtlı uygulama planı aracılığıyla mobil uygulamalar

Jeton kullanıcı düzeyinde depolanıyorsa (jetonun kalıcı olması 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 eden ve daha sonra işlemi mobil cihazda (aynı kullanıcı hesabını kullanarak) tamamlayan bir kullanıcı, bir dönüşüm etkinliği tetiklemelidir.

Jeton yalnızca tarayıcı 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ı takip etmişse her bir cihazın ayrı bir jetonu kalır ve her cihaz, ilişkilendirme kurallarını ayrı ayrı izler.