Dönüşüm İzleme

Şekil 1: Dönüşüm İzlemeye Genel Bakış

Özet

Dönüşüm izleme, İş Merkezi Entegrasyonlarımızdan biri aracılığıyla Google tarafından başlatılan dönüşümleri izlemeyi amaçlar. Bu, entegrasyonunuzun sağlıklı ve çalışır durumda kalması için çok önemlidir ve belirli sayfalardaki sıralamayı etkileyebilir. Google her action_link gösterdiğinde bu URL, benzersiz bir sorgu parametresi içerecek şekilde değiştirilir: rwg_token. Bu jetonu depolamak ve kullanıcı bir rezervasyon tamamladığında uygun değerleri döndürmek size bağlıdır.

Entegrasyonu tamamlamak için aşağıdakileri tamamlamanız gerekir:

1. rwg_token dosyasını toplayın ve saklayın.
2. Satıcıyı toplayıp saklayın.
3. rwg_token ve merchant_change değerlerini döndürür.
4. Dönüşüm izlemeyi test edin ve doğrulayın.

rwg_token dosyasını toplayın ve saklayın.

Bu entegrasyonu tamamlamak için ilk Google yönlendirmesinden sonraki 30 gün içinde rwg_token'yi toplayıp saklamanız gerekir. rwg_token değeri, bağlantı ve bu işlem bağlantısını oluşturan satıcıyla ilgili bazı meta veriler içeren kodlanmış bir dizedir. Jetonda kullanıcı verisi depolanmadığını veya şifrelenmediğini unutmayın.

Jeton toplama

Kullanıcı rezervasyon sayfanıza yönlendirildiğinde, sağlanan URL'ye yeni bir sorgu parametresi (rwg_token) eklenir. Rezervasyon sayfanızda değeri ayrıştırmanız gerekir. Bu jetonun tarayıcı üzerinden cihaz düzeyinde izleme için nasıl ayrıştırılabileceğine dair bir örnek verilmiştir.

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

URL'nize eklenen sorgu parametresi şifrelenmiş bir jeton olacaktır. rwg_token örneğini aşağıda bulabilirsiniz. "=" gibi özel karakterler dahil olmak üzere jetonu doğru şekilde ayrıştırdığınızdan emin olmak için bu örnek jetonu kullanın. Aşağıda, tipik bir jetonun nasıl görüneceğine dair bir örnek verilmiştir.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Jeton Depolama

rwg_token'yi saklarken dönüşüm izlemeyi uygulayabileceğiniz iki farklı düzey vardır: cihaz düzeyi ve kullanıcı düzeyi. Jetonu nereye sakladığınıza siz karar verirsiniz ancak jetonu ilk yönlendirmeden itibaren 30 gün boyunca saklamanız gerekir.

Bir sonraki örnek, bu değerleri birinci taraf çerezi kullanarak bir web tarayıcısında depolayan cihaz düzeyinde dönüşüm izlemedir. Bu örnekte, jeton değerini Token Depolama örneğindeki gibi bir değişkene ayrıştırdığınız varsayılmıştır. rootdomain.com değerini alanınızla güncellediğinizden emin olun.

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

rwg_token değerini nereye depolayacağınıza karar verirken aşağıdakileri göz önünde bulundurun.

Cihaz Seviyesinde Depolama Alanı

Cihaz düzeyi, tarayıcı çerezlerini, yerel depolama alanını, uygulama yerel depolama alanını veya jetonu 30 günlük ilişkilendirme aralığında koruyabilecek başka bir yöntemi kullanmayı içerir. Jeton, kullanıcının cihazında yerel olarak depolandığı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 şekilde ilişkilendirilemeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken bunu desteklenen her platformda (mobil dahil) yeniden uygulamanız gerekir.

Kullanıcı Düzeyinde Depolama Alanı

Kullanıcı düzeyi, sunucu tarafı bir analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda kalıcı olarak saklamayı içerir. Jeton sunucu tarafında depolandığından, kullanıcı kullandığı cihazı değiştirirse, 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 yine ilişkilendirilir. Kullanıcı düzeyinde dönüşüm izlemeyi kullanırken, sisteminizin mimarisine bağlı olarak bunu sunucu tarafınızda bir kez uygulayabilir ve desteklenen tüm platformlarda yeniden kullanabilirsiniz.

Google, feed'ler aracılığıyla sağladığınız bir action_link'i her gösterdiğinde bu URL, benzersiz bir sorgu parametresi (rwg_token) içerecek şekilde değiştirilir. rwg_token değeri, kullanıcının tıkladığı bağlantıyla ilgili bazı meta verileri içeren ancak kullanıcı verisi içermeyen kodlanmış bir dizedir. Bu jetonu saklamanız ve dönüşüm etkinliğinin bir parçası olarak geri göndermeniz gerekir.

Jetonu yenileme

Bir kullanıcı Google tarafından aynı satıcıya yönlendirildiğinde, mevcut bir jeton depolanmışsa jeton, en son yönlendirmedeki yeni jetonla değiştirilir. Jeton değiştirildiğinde, jeton depolama alanının 30 günlük aralığı sıfırlanır ve bu satıcının yeni dönüşümleri en son jetonla ilişkilendirilir.

Daha fazla bilgi için dönüşüm ilişkilendirme koşullarımıza göz atın.

Satıcıyı toplayıp saklayın.

Kullanıcı rezervasyon sayfanıza yönlendirildiğinde satıcıyı bulup yakalayacak mantık uygulamanız gerekir. İş ortakları genellikle işlem bağlantılarına satıcı meta verilerini veya merchant_id öğesini ekleyerek satıcıyı tanımlamak ve depolamak için bu öğeyi kullanır. Kullanıcı bir rezervasyonu onayladığında tamamlanmış dönüşüm isteğini göndermeden önce satıcıya danışabilmek için merchant_id'yi (veya seçili tanımlayıcıyı) rwg_token ile birlikte saklamanızı öneririz. Jeton depolama süresine benzer şekilde, satıcı ilk yönlendirme tarihinden itibaren 30 gün boyunca jetonla birlikte kaydedilmelidir.

Sonraki örneklerde, önceden saklanan rwg_token ayarlanır. Bu durumda, satıcıyı sağlanan URL'deki meta verilerden ayrıştırdığınız ve merchant_id olarak kaydettiğiniz veya mevcut bir merchant_id ile eşleştirdiğiniz varsayılır.

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

rwg_token ve merchant_change değerlerini döndürür.

Bir kullanıcı, işlem bağlantısı yönlendirmesiyle başlayan bir rezervasyonu 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

Bir dönüşüm etkinliği gönderirken saklanan rwg_token değerini ve 1 veya 2 değerine sahip bir merchant_change değerini eklemeniz gerekir. merchant_change hakkında daha fazla bilgi için Satıcı Değişiklik Değerini Döndürme başlıklı makaleyi inceleyin.

POST gövdesi, aşağıdaki biçimde JSON kodlu bir nesne olmalıdır:

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

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

Aşağıdaki örnekte, kullanıcının cihazında çerez kullanılarak cihaz düzeyinde dönüşüm izleme yer alır. Örnek JavaScript ile yazılmıştır:

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

Dikkat: Kabul edilen tek MIME Content-Type text/plain'tır. Üstbilgide başka Content-Type ayarlama Aksi takdirde CORS hatası alırsınız.

Uyarı: Dönüşüm verilerinin bir parçası olarak kullanıcı kimlik bilgilerinin (PII) Google'a gönderilmediğinden emin olun.

Not: Üretimde bu entegrasyonla ilişkili olmayan dönüşüm etkinlikleri göndermemelisiniz. Etkinliği göndermeden önce geçerli ve süresi dolmamış bir rwg_token değerinin olup olmadığını kontrol etmeniz önerilir.

Satıcı Değişiklik Değerini Döndürme

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. Açılış sayfanız diğer satıcıları da içeren bir platformdaysa satıcı değiştirmek yaygın bir durumdur. Bu durumda, bir kullanıcı Google tarafından platformunuza yönlendirildiyse ve farklı bir satıcıya gidip rezervasyon yapmaya karar verdiyse dönüşümün gerçekleştiğini ancak farklı bir satıcıyla gerçekleştiğini bilmek isteriz. Satıcıyı bilmemiz gerekmez, yalnızca bir dönüşüm etkinliğinin gerçekleştiğini ve satıcının farklı olduğunu bilmemiz gerekir. Satıcının değişip değişmediğini belirlemek için bir boole değeri kullanırız.

merchant_change için hangi değeri atayabileceğinize karar verirken Satıcıyı Toplama ve Depolama bölümünde kayıtlı orijinal satıcıyı almanız ve satıcının değişip değişmediğini kontrol etmeniz, ardından değeri atarken aşağıdaki tabloya başvurmanız gerekir.

Rezervasyon sayfanız bir platformda değilse veya kullanıcılar farklı bir satıcıya gidemiyorsa bu isteklerin değerini 2 olarak sabitleyebilirsiniz. Bu durum, rezervasyon sayfalarını satıcının web sitesine entegre eden veya rezervasyonları işlemek için özel açılış sayfalarına sahip olan iş ortakları için yaygındır.

Satıcı Değişiklik Değeri	Gereksinim
1	Bu değer, kullanıcı orijinal satıcının web sitesinden ayrılıp platformunuz üzerinden farklı bir satıcıdan satın alma işlemi gerçekleştirdiğinde kullanılmalıdır.
2	Müşteri, orijinal öğe (satıcı) üzerinden bir işlemi tamamladığında bu değer kullanılmalıdır.

Dönüşüm izlemeyi test edin ve doğrulayın.

Dönüşüm izleme uygulamanızın doğru olduğundan emin olmak için aşağıdaki testi çalıştırmanız gerekir. Satıcılarınıza bağlı işlem bağlantılarını kullandığınızdan ve bu kullanıcıyla ilişkili önceki jetonların silinmesini sağlamak için isteklerin gizli veya gizli pencerede gönderildiğinden emin olun.

1. Yalnızca işlem bağlantısı kullanarak rezervasyon tamamlama
   • Referans veya önceden depolanmış jeton içermeyen doğrudan rezervasyonlar, Google'a herhangi bir istek gönderilmesine neden olmaz.
2. rwg_token eklenmiş bir bağlantı kullanarak rezervasyon yapın.
   • İsteğin başarılı olduğundan ve 2 için rwg_token ve merchant_change değeriyle gönderildiğinden emin olun
   • rwg_token dosyasını 30 gün boyunca sakladığınızdan emin olun
3. Yeni bir rwg_token kullanarak aynı satıcıyla yeni bir rezervasyon yapın.
   • İsteğin başarılı olduğundan ve 2 için yeni rwg_token ve merchant_change değeriyle gönderildiğinden emin olun
   • Jetonun ilişkilendirme depolama süresinin 30 gün boyunca yenilendiğinden emin olun
4. Doğrudan test ettiğiniz satıcının rezervasyon sayfasına gidin ve rwg_token eklenmeden yeni bir rezervasyon yapın.
   • İsteğin daha önce saklanan rwg_token ile gönderildiğinden ve merchant_change değerinin 2 olduğundan emin olun

Kullanıcıların farklı bir satıcı kullanarak ödeme yapabildiği bir platformsanız aşağıdakileri test edin.

1. rwg_token ekiyle birlikte bir bağlantı kullanarak satıcının rezervasyon sayfasına gidin, ardından farklı bir satıcıya gidip rezervasyon yapın.
   • İsteğin 1 değerinin rwg_token ve merchant_change ile gönderildiğinden emin olun

Test ederken HTTP POST isteğini dönüşüm uç noktasına gönderin. Biri üretim ortamı, diğeri korumalı 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

İşlem bağlantınıza veya URL'nize aşağıdaki jetonu eklemeniz gerekir:

rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D

Ek jeton gerektiren testler için aşağıdaki jetonu kullanın.

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Gönderdiğiniz başarılı dönüşüm etkinliklerini, Dönüşüm İzleme Kontrol Paneli'nin altındaki İşlem Merkezi'nde toplu olarak görebilirsiniz. Dönüşümlerin kontrol panelinde görünmesinin bir saati bulabileceğini unutmayın.

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

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

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

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

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

• 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 (jetonun kalıcılaştırılmasına bakın) cihazlar arası ilişkilendirme sağlamanız beklenir. Yani, masaüstünden bir işlem bağlantısını takip edip işlemi mobil cihazda tamamlayan (aynı kullanıcı hesabını kullanarak) bir kullanıcı, 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 beklenmez. Bu durumda, kullanıcı ilgili cihazda bir işlem bağlantısını izlediyse her cihazın kalıcı olarak ayrı bir jetonu olur ve her cihaz ilişkilendirme kurallarını ayrı ayrı uygular.

Not: Bu ilişkilendirme çerçevesi, analiz sisteminizin dönüşümleri ilişkilendirme şeklinden farklı olabilir. Bu sistem, sistemlerinizde yaptığınız dönüşüm izleme işlemlerinden bağımsız olarak çalışacak şekilde tasarlanmıştır ve dahili analizlerinizi etkilemez.