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

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 alınıyor.
rwg_token öğesinin uygun ilişkilendirme dönemi için korunması
Ödeme sırasında dönüşüm etkinliği gönderme

Bu dönüşüm izleme uygulaması, Google Analytics'i veya başka bir üçüncü 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 vermeniz gerekir:

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

rwg_token toplanıyor

Google, Feed'ler aracılığıyla sağladığınız bir action_link özelliğini her 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 depolamanız ve dönüşüm etkinliğinin bir parçası olarak geri vermeniz gerekir.

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'in Devam Etmesi başlıklı adımda 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'ın kalıcı olması

Sağladığınız tüm işlem bağlantılarına eklenecek olan rwg_token URL parametresini toplam 30 gün boyunca korumanız gerekir. rwg_token değeri saklanmalı ve herhangi bir düzenleme yapılmadan döndürülmelidir.

rwg_token ile birlikte işlem bağlantısıyla ilişkilendirilen merchant_id öğesini depolamanız gerekir.

Önceki ziyaretten kalan mevcut bir jeton varsa önceki rwg_token ve merchant_id değiştirilmeli ve depolama alanına yönelik 30 günlük zaman aralığı sıfırlanmalıdır.

Yukarıdaki eşleşmeyi sürdürürken değerleri cihaz düzeyinde veya kullanıcı düzeyinde depolayabilirsiniz:

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

Aşağıda, cihaz düzeyinde dönüşüm izleme örneği verilmiştir. Bu değerler, birinci taraf çerezi kullanılarak bir web tarayıcısında saklanır. Bu örnekte, yukarıdaki örnekte olduğu gibi jeton değerini 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 + ";_merchant_id="+merchantid +";max-age=2592000;domain=rootdomain.com;path=/";
  }
</script>

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

Dönüşüm Verilerini Gönderme

Kullanıcı, Google Yer İşlemi 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 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 kodlamalı bir nesne olmalıdır:

{
  "conversion_partner_id": <partnerId>,
  "rwg_token": <rwg_token_val>
  "merchant_changed": 1|2
}

merchant_changed değeri, satıcının ilk yönlendirmeli satıcıdan değiştirilip değiştirilmediğini belirlemek için kullanılır. İki değer iletilebilir.

Satıcı Değişim Değeri	Gereksinim
1	Bu değer, bir kullanıcı orijinal satıcının web sitesinden ayrılıp platformunuz üzerinden farklı bir satıcıyla bir satın alma işlemini tamamladığında kullanılmalıdır.
2	Bu değer, müşteri bir işlemi orijinal Varlık (Satıcı) aracılığıyla tamamladığında kullanılmalıdır.

Hem korumalı alan hem de üretim ortamlarında, bir dönüşüm etkinliği gönderirken geçerli bir rwg_token sağlamanız gerekir. Test amacıyla, lansmana kadar her iki ortamda aşağıdaki test jetonunu kullanın:

ADQ7psRE9YyDSVR6YpfD-fYdxoFYVKS1xeTvXdSxqF8a3bnk0W62eMEnUjoNPwjhNHG0elwBnM1awTjr9vXET8yOowCeuODjwA==

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 bir çerez kullanarak) 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,
      Merchant_changed: merchantChanged
    })
  });
}

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.

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 olan tüm etkileşimler için 30 günlük bir ilişkilendirme aralığıdır.

Bu ilişkilendirme aralığı, Google'ın aşağıdaki senaryolardan herhangi birinde bir dönüşüm etkinliği gönderilmesini bekleyebileceği anlamına gelir:

Bir kullanıcı, bir yer işlemi bağlantısını izler ve aynı oturumda aynı satıcıya sipariş verir(Satıcı Değişim Değeri = 2 )
Bir kullanıcı, bir yer işlemi bağlantısını izler ve ardından aynı satıcıya sipariş vermek için 30 gün içinde farklı bir kanaldan geri döner. ( Satıcı Değişim Değeri = 2 )
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. ( Satıcı Değişim Değeri = 1 )

Buna ek olarak Google, dönüşüm etkinliklerinin kullanıcıların bir yer işlemi bağlantısı üzerinden ulaşabilecekleri tüm platformlardan gönderilmesini bekler. Ş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 kullanmaya devam etme konusuna bakın) cihazlar arası ilişkilendirme sağlamanız beklenir. Diğer bir deyişle, 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) bir kullanıcı bir dönüşüm etkinliği tetiklemelidir.

Jeton yalnızca cihaz düzeyinde depolanıyorsa (ör. tarayıcı çerezlerinde), cihazlar arası ilişkilendirme sağlamanız beklenmez. Bu durumda, kullanıcı söz konusu cihazdaki işlem bağlantısını izlemiş olsaydı her bir cihaz için ayrı bir jeton kullanılmaya devam eder ve her cihaz ilişkilendirme kurallarını ayrı ayrı izler.

Feed'ler

Entegrasyon İncelemesi