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

Dönüşüm İzleme

Uyarı: Dönüşüm verileri kapsamında kullanıcı Kişisel Kimlik Bilgilerinin (PII) Google'a gönderilmediğinden emin olun.

Uygulama

Özet

Dönüşüm izleme üç bölümden oluşur:

Açılış sayfasından / uygulama giriş noktasından rwg_token ve merchant_id bilgileri toplanıyor.
Uygun ilişkilendirme dönemi için rwg_token ve merchant_id koşullarının geçerli olması.
Dönüşüm zamanında kalıcı merchant_id ile merchant_id karşılaştırmasını karşılaştırma (rezervasyon tamamlandı).
Dönüşüm zamanında bir dönüşüm etkinliği gönderme (rezervasyon tamamlandı).

Bu dönüşüm izleme uygulaması, Google Analytics veya başka bir 3. 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 alanı, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme penceresi için saklayabilecek başka bir yöntem kullanılabilir. Jeton, kullanıcının cihazında yerel olarak depolanacağından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını veya çerezlerini temizlerse ya da gizli tarama veya gizli mod kullanıyorsa dönüşüm etkinliği düzgün bir şekilde ilişkilendirilemeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken bunu, desteklenen her yüzeyde (mobil dahil) yeniden uygulamanız gerekir.
Kullanıcı düzeyi, verilerin sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda tutulmasını içerir. Jeton sunucu tarafında depolanacağından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını veya çerezlerini temizlerse ya da özel bir 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 izleme özelliğini kullanırken, sisteminizin mimarisine bağlı olarak bunu sunucu tarafında bir kez uygulayabilir ve desteklenen tüm yüzeylerde yeniden kullanabilirsiniz.

`rwg_token` toplanıyor

Google, Feed'ler aracılığıyla sağladığınız bir action_link öğesini her gösterdiğ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 ancak kullanıcı verilerini içermeyen kodlanmış bir dizedir. Bu jetonu depolamalı ve dönüşüm etkinliğinin bir parçası olarak geri iletmeniz gerekir.

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 parametrenin depolanmasıyla ilgili şartlar, rwg_token ürününün devamlılığı bölümünde açıklanmıştır.

Bu jetonun tarayıcı üzerinden cihaz düzeyinde izleme için nasıl ayrıştırılabileceğine dair bir örneği aşağıda bulabilirsiniz. Alternatif olarak, isteğe yanıt verirken bu jetonu sunucu tarafında toplayabilirsiniz:

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;
  }
}

`merchant_id` toplanıyor

Ön uçta dönüşüm izleme mantığını uygularsanız açılış sayfasında merchant_id öğesini bulup yakalayacak özel bir komut dosyası uygulamanız gerekir. Genellikle merchant_id, açılış sayfasında veya URL'de zaten mevcut olabilir. Böylece, bunu oradan yakalayabilirsiniz. Böyle bir durum söz konusu değilse arka uç değişikliklerine işaret edecek şekilde kullanılabilmesi için bir yerde görünür hale getirmenin bir yolunu bulmanız gerekir.

Arka uçta dönüşüm izleme mantığını uygularsanız ön uç sayfasını oluşturmak için dahili sisteminizi sorgulayan verilerin yanında merchant_id görebilirsiniz.

Bu merchant_id, feed'inizde Google ile paylaştığınızla aynı olmalıdır.

`rwg_token` ve `merchant_id` devam ediyor

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

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

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

Yukarıdaki eşlemeyi 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 penceresi için saklayabilecek başka bir yöntem kullanılabilir.
Kullanıcı düzeyi, verilerin sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda tutulmasını içerir.

Aşağıda, birinci taraf çerezi kullanılarak bu değerlerin bir web tarayıcısında depolandığı 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ılır. Bu örneği kullanmak için rootdomain.com alan adını güncellemeniz gerekir.

if (typeof rwg_token !== 'undefined') {
  document.cookie =
  "_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}

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

Dönüşüm Verileri Gönderiliyor

Bir kullanıcı, 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 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>,
  "merchant_changed": 1|2
}

Örnek (iş ortağı 20123456 için test jetonuna sahip değiştirilmemiş satıcı):

{
  "conversion_partner_id": 20123456,
  "rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ",
  "merchant_changed": 2
}

merchant_changed değeri, satıcının ilk yönlendirme satıcısından 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, kullanıcı asıl satıcının web sitesinden ayrılıp platformunuz üzerinden farklı bir satıcıyla satın alma işlemi tamamladığında kullanılmalıdır
2	Bu değer, müşteri orijinal Varlık (Satıcı) aracılığıyla bir işlemi tamamladığında kullanılmalıdır.

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

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Bu gönderme isteğinin nasıl yapılacağına dair JavaScript'te, cihaz düzeyinde dönüşüm izlemeye (kullanıcının cihazındaki bir çerez kullanılarak) ilişkin tam bir örnek 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şkilendirilen jetonu (bulundukları yüzeye bakılmaksızın) sunucu tarafı depolama mekanizmanızdan almanız ve jetonu aynı üretim veya korumalı alan uç noktalarını kullanarak göndermeniz gerekir.

Dönüşümle İlişkilendirme Koşulları

Google'ın dönüşüm ilişkilendirmesi için zorunlu standardı, herhangi bir mağazada yer bağlantısıyla her etkileşim için 30 günlük bir ilişkilendirme aralığıdır.

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

Bir kullanıcı, yer işlemi bağlantısını takip eder ve aynı oturumda aynı satıcı için sipariş verir. (Satıcı Değişim Değeri = 2 )
Kullanıcı, yer işlemi bağlantısını takip eder ve ardından aynı satıcıya sipariş vermek için 30 günlük zaman aralığı içinde farklı bir kanaldan geri döner. (Satıcı Değişiklik Değeri = 2 )
Kullanıcı, bir yer işlemi bağlantısını takip ettikten sonra farklı bir mağazada aynı oturumda veya 30 günlük zaman aralığındaki farklı bir oturumda sipariş verir. ( Satıcı Değişim Değeri = 1 )

Ayrıca Google, dönüşüm etkinliklerinin bir kullanıcının bir yer işlemi bağlantısından gidebileceği tüm yüzeylerden gönderilmesini bekler. Şunlar dahil:

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

Jeton kullanıcı düzeyinde depolanıyorsa (jetonun devam ettiğini görün) cihazlar arası ilişkilendirme sağlamanız beklenir. Yani masaüstündeki bir işlem bağlantısını takip eden ve daha sonra mobil cihazda işlemi tamamlayan (aynı kullanıcı hesabını kullanarak) bir kullanıcı, bir dönüşüm etkinliği tetiklemelidir.

Jeton yalnızca cihaz düzeyinde (ör. tarayıcı çerezlerinde) depolanıyorsa cihazlar arası ilişkilendirme sağlamanız beklenemez. Bu durumda, kullanıcının cihazdaki bir işlem bağlantısını izlemesi durumunda her cihazın ayrı bir jetonu olur ve her cihaz ilişkilendirme kurallarını ayrı ayrı izlerdi.

Gerçek zamanlı güncelleme