Dönüşüm İzleme

Genel Bakış

Dönüşüm izleme, Google tarafından İşlem Merkezi entegrasyonlarımızdan biri aracılığıyla başlatılan dönüşümleri takip eder. Bu, belirli sayfalardaki sıralamayı etkileyebileceğinden entegrasyonunuzun sorunsuz ve çalışır durumda kalmasına yardımcı olur. Google her action_link oluşturduğunda, belirli URL benzersiz bir sorgu parametresi içerecek şekilde değiştirilir: rwg_token. Jetonu saklayabilir ve kullanıcı rezervasyonu tamamladığında uygun değerleri döndürebilirsiniz.

Entegrasyonu tamamlamak için aşağıdaki adımları uygulayın:

rwg_token öğesini ayrıştırıp saklayın.
Satıcı bilgilerini ayrıştırıp saklayın.
rwg_token ve merchant_changed değerlerini döndürür.
Dönüşüm izlemeyi test edin ve doğrulayın.

`rwg_token` ayrıştırma ve depolama

Entegrasyonu tamamlamak için rwg_token değerini ilk Google yönlendirmesinden sonraki 30 gün boyunca toplamanız ve saklamanız gerekir. rwg_token değeri, bağlantıyla ilgili meta verileri ve söz konusu action_link değerini oluşturan satıcı bilgilerini içeren kodlanmış bir dizedir.

Jetonu ayrıştırma

Kullanıcı rezervasyon sayfanıza yönlendirildiğinde, sağlanan URL'ye yeni bir rwg_token eklenir. Rezervasyon sayfanızda jeton değerini ayrıştırmanız gerekir.

Aşağıdaki örnekte, tarayıcı üzerinden cihaz düzeyinde izleme için rwg_token değerinin nasıl ayrıştırıldığı gösterilmektedir.

const rwgToken = new URLSearchParams(location.search).get('rwg_token') || undefined;

Jetonu saklama

rwg_token değerini depoladığınızda dönüşüm izlemeyi iki farklı düzeyde uygulayabilirsiniz:

Cihaz düzeyinde
Kullanıcı düzeyi

Jetonu istediğiniz düzeyde saklayabilirsiniz ancak ilk tavsiyeden sonraki 30 gün boyunca saklamanız gerekir.

Aşağıdaki örnekte cihaz düzeyinde dönüşüm izleme gösterilmektedir. Jeton değerlerini birinci taraf çereziyle birlikte bir tarayıcıda saklayabilirsiniz. Bu örnekte, jeton değerini bir değişkene ayrıştırdığınız varsayılır. rootdomain.com alan adınızla güncellediğinizden emin olun.

if (rwgToken !== undefined) {
  document.cookie =
  "_rwgToken=" + rwgToken + "; max-age=2592000; domain=rootdomain.com; path=/";
}

Google, feed'ler aracılığıyla sağladığınız bir action_link oluşturduğunda URL, benzersiz bir sorgu parametresi (rwg_token) içerecek şekilde değiştirilir. Bu jetonu saklamanız ve dönüşüm etkinliğinin bir parçası olarak geri iletmeniz gerekir.

Cihaz düzeyinde depolama

Cihaz düzeyinde, tarayıcı çerezlerinin, yerel depolama alanının, uygulama yerel depolama alanının veya jetonu 30 günlük ilişkilendirme penceresi boyunca kalıcı hale getirebilecek diğer yöntemlerin kullanımı yer alır. Jeton, kullanıcının cihazında yerel olarak depolanır. Bu nedenle, kullanıcı aşağıdaki durumlarda dönüşüm etkinliği düzgün şekilde ilişkilendirilemez:

Kullandıkları cihazı değiştirirlerse
Yerel depolama alanını veya çerezleri temizler.
Gizli tarama penceresi kullanıyorsanız

Cihaz düzeyinde dönüşüm izlemeyi kullandığınızda dönüşüm etkinliğini mobil cihazlar da dahil olmak üzere desteklenen her cihazda yeniden uygulamanız gerekir.

Kullanıcı düzeyinde depolama

Kullanıcı düzeyinde, sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla jeton, uygulama veritabanınızda kalıcı hale getirilir. Jeton, sunucu tarafında depolanır. Bu nedenle, kullanıcı tekrar giriş yaptıktan sonra dönüşüm etkinliği yine doğru şekilde ilişkilendirilir.

Sistem mimarinize dayalı kullanıcı düzeyinde dönüşüm izlemeyi kullandığınızda dönüşüm etkinliğini sunucu tarafınızda bir kez uygulayabilir ve desteklenen tüm cihazlarda yeniden kullanabilirsiniz.

Jetonu Yenileme

Google, bir kullanıcıyı aynı satıcıya yönlendirdiğinde, halihazırda depolanmış olan mevcut jeton, en son yönlendirmeden alınan yeni jetonla değiştirilir. Jeton değiştirildikten sonra jeton depolama alanının 30 günlük ilişkilendirme dönemi sıfırlanır ve bu satıcı için yeni dönüşümler en son jetonla ilişkilendirilir.

Daha fazla bilgi için Dönüşüm ilişkilendirmeyle ilgili koşullar başlıklı makaleyi inceleyin.

Satıcı bilgilerini ayrıştırma ve depolama

Bir kullanıcı rezervasyon sayfanıza yönlendirildiğinde satıcı ayrıntılarını bulup yakalayabilen mantığı uygulamanız gerekir. İş ortakları genellikle işlem bağlantılarına satıcı meta verileri veya merchant_id ekler ve satıcı bilgilerini tanımlayıp depolamak için bunları kullanır.

merchant_id veya seçilen tanımlayıcıyı rwg_token ile birlikte saklamanızı öneririz. Kullanıcı bir rezervasyonu onayladığında, tam dönüşüm isteğini göndermeden önce satıcıya başvurabilirsiniz. Jeton depolamaya benzer şekilde, ilk tavsiyeden sonraki 30 gün boyunca satıcı ayrıntılarını jetonla birlikte kaydetmeniz gerekir.

Aşağıdaki örnekte, daha önce depolanan rwg_token değiştirilmektedir. Bu işlev, sağlanan URL'deki meta verilerden satıcı bilgilerini ayrıştırdığınızı ve bunları merchant_id olarak kaydettiğinizi veya mevcut bir merchant_id ile eşleştirdiğinizi varsayar.

// Store the rwgToken and merchantId in your cookie and set the cookie
// expiration date to 30 days.
if (typeof rwgToken !== 'undefined') {
  document.cookie =
  "_rwgToken=" + rwgToken + "; _merchantId=" + merchantId + "; max-age=2592000;domain=rootdomain.com; path=/";
}

`rwg_token` ve `merchant_changed` değerlerini döndürür.

Bir kullanıcı, action_link yönlendirmesiyle başlayan bir rezervasyonu tamamladığında dönüşüm uç noktasına bir HTTP POST isteği göndermeniz gerekir. İki uç nokta vardır:

Üretim ortamı: https://www.google.com/maps/conversion/collect
Sandbox ortamı: https://www.google.com/maps/conversion/debug/collect

Bir dönüşüm etkinliği gönderdiğinizde, depolanan rwg_token ve 1 veya 2 değerini eklemeniz gerekir.merchant_changed merchant_changed hakkında daha fazla bilgi için Satıcı Değişikliği Değerini Döndürme başlıklı makaleyi inceleyin.

POST 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"
}

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

Aşağıdaki örnekte, kullanıcının cihazındaki çerezle cihaz düzeyinde dönüşüm izleme yer almaktadır. Bu örnek JavaScript ile yazılmıştır:

const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;

// Retrieve the value of the rwgToken stored in the browser's cookie
const match = document.cookie.match(new RegExp('(?:^| )_rwgToken=([^;]+)'));
const storedRwgToken = match ? match[1] : undefined;

// Send Conversion event with decoded token, verify any special characters
// are sent properly.
if (storedRwgToken !== undefined) {
  fetch(endpoint, {
    method: "POST",
    body: JSON.stringify({
      conversion_partner_id: partnerId,
      rwg_token: decodeURIComponent(storedRwgToken),
      merchant_changed: merchantChanged
    })
  });
}

Not: Üretim aşamasında, 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 etmeniz önerilir.

Satıcı Değişikliği Değerini döndürür.

Satıcının ilk yönlendirme satıcısından değiştirilip değiştirilmediğini belirlemek için merchant_changed değeri kullanılır. Açılış sayfanız diğer satıcıları da içeren bir platformdaysa satıcı değişikliği yaygın bir durumdur. Bu durumda, Google tarafından platformunuza yönlendirilen bir kullanıcı rezervasyon işlemini tamamlamak için farklı bir satıcıya gitmeye karar verirse ayrı bir satıcıyla dönüşüm gerçekleştiğini bilmeniz gerekir. Satıcı değişikliğini belirlemek için Boole değeri kullanabilirsiniz ancak satıcı ayrıntılarını belirlemek için kullanamazsınız.

merchant_changed öğesine hangi değeri atayacağınıza karar verirken Parse and Store the Merchant Information içinde kaydedilen orijinal satıcıyı dikkate almanız gerekir. Satıcının değişip değişmediğini kontrol edin ve değeri ihtiyacınıza göre atayın.

Koşul: Kullanıcı, orijinal satıcının web sitesinden ayrılıp platformunuz üzerinden farklı bir satıcıdan satın alma işlemi yaptığında.
- Satıcı değişikliği değeri: 1
Şart: Kullanıcı, orijinal satıcı üzerinden bir işlemi tamamladığında.
- Satıcı değişikliği değeri: 2

Dönüşüm izlemeyi test etme ve doğrulama

Aşağıdaki test senaryolarında, Test Jetonları bölümünde sağlanan test jetonları kullanılır ve dönüşüm etkinliğiyle sonuçlanabilecek çeşitli senaryoların tamamında size yol göstermeyi amaçlar. Bu, jetonun uygun şekilde saklanmasını, merchant_changed değerinin doğru şekilde ayarlanmasını ve dönüşüm etkinliğinin uygun olduğunda gönderilmesini sağlar.

Feed'lerinizde sağlanan işlem bağlantısı veya rezervasyon sayfası URL'lerini kullanın ve URL'nin sonuna Test Jetonları'nı ekleyerek her test senaryosunu çalıştırın. Özel veya gizli tarama penceresi kullandığınızdan emin olun. Bu, mevcut kullanıcıyla ilişkili tüm jetonları temizler ve size temiz bir başlangıç sunar.

Test Durumu (Test Case)	Test Açıklaması	Kullanıcı akışı	Beklenen Sonuç
1	Kullanıcı, Google'da başlamayan bir rezervasyonu tamamladığında	Bir kullanıcı, Google tarafından yönlendirilmeden veya mevcut bir yönlendirme olmadan doğrudan rezervasyon sayfasına gider. Bu işlem herhangi bir dönüşüm etkinliğiyle sonuçlanmamalıdır.	Kullanıcı daha önce rezervasyon sayfasını ziyaret etmediği veya Google tarafından yönlendirilmediği için dönüşüm etkinliği yok.
2	Kullanıcı, Google'da başlayan bir rezervasyonu tamamladığında	Bir kullanıcı Google üzerinden satıcınızı bulur, rezervasyon sayfanıza yönlendirilir ve rezervasyon işlemini tamamlar.	Kullanıcı, Google tarafından rezervasyon sayfasına yönlendirildiği için Jeton A ile 2 satıcı değiştirildi değeriyle bir dönüşüm etkinliği gönderilir.
3	Google'dan gelen bir kullanıcı, rezervasyon akışını başlatır ancak rezervasyon tamamlanmadan oturumu terk eder. Not: Bu oturumu 4. ve 5. test için açık tutun.	Bir kullanıcı rezervasyon sayfanıza yönlendirilir ancak oturum sona erer ve kullanıcı rezervasyonu tamamlamaz.	Kullanıcı rezervasyonu tamamlamadığı için dönüşüm yok ancak B jetonu 30 gün boyunca saklanmalıdır.
4	Bir kullanıcı, Google'dan gelmeden rezervasyon sayfasına döner ve rezervasyonu tamamlar. Not: Rezervasyon akışı URL'si rwg_token içermemelidir.	Kullanıcı, 4. Test'ten sonra rezervasyon sayfasına geri döner. B jetonu 30 gün boyunca saklanmalı ve bu 30 gün içindeki tüm dönüşümler bir dönüşüm etkinliği döndürmelidir.	Kullanıcı, Google'dan daha önce yapılan yönlendirme sonrasında rezervasyon sayfasına geri döndüğü için 2 merchant changed değeri ve B jetonu ile bir dönüşüm etkinliği gönderilir.
5	Kullanıcı, 4. Test'ten sonra Google'dan gelen yeni bir rezervasyonu tamamlar.	Bir kullanıcı, önceki bir Google yönlendirmesinden sonra Google yönlendirmesini kullanarak rezervasyon sayfanıza geri dönerse 30 günlük depolama aralığı sıfırlanır ve eski jetonun Jeton B yerini yeni bir jeton Jeton C alır. Gelecekteki tüm dönüşümler C jetonuna atfedilir.	Kullanıcı rezervasyonu tamamladığı ve yeni jeton daha önce depolanan jetonun yerini aldığı için 2 merchant_changed değeri ve C jetonu ile bir dönüşüm etkinliği gönderilir.

Kullanıcıların farklı bir satıcıyla ödeme yapmasına olanak tanıyan bir platformunuz varsa aşağıdakileri test edin.

Test Durumu (Test Case)	Test Açıklaması	Kullanıcı akışı	Beklenen Sonuç
6	Google tarafından rezervasyon sayfanıza yönlendirilen bir kullanıcı, farklı bir satıcıdan rezervasyon yaptırır.	Bir kullanıcı Google tarafından rezervasyon sayfanıza yönlendirilir, A jetonu kullanılır ancak rezervasyonu tamamlamadan önce farklı bir sayfaya gider ve rezervasyonu orijinal yönlendirmeden farklı bir satıcıyla tamamlar.	Kullanıcı, Google'dan gelen bir yönlendirmeyle başlayan ve Jeton A ile yapılan bir rezervasyonu tamamladığı için dönüşüm etkinliği gönderilir. Kullanıcı, rezervasyonu yönlendirmeden farklı bir satıcıda tamamladığı için satıcı değiştirildi değeri 1 olur.

Test sırasında HTTP POST isteğini dönüşüm uç noktasına gönderin. İki uç nokta vardır:

Üretim ortamı: https://www.google.com/maps/conversion/collect
Korumalı alan ortamı: https://www.google.com/maps/conversion/debug/collect

Test Jetonları

Dönüşüm izlemeyi test etmek için feed'lerinizde sağladığınız işlem bağlantılarının veya rezervasyon sayfası URL'lerinin sonuna aşağıdaki test jetonlarından birini ekleyin.

A jetonu:

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

Token B:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Token C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Başarılı dönüşüm etkinliklerini gönderdiğinizde, bu etkinliklerin toplu halini İşlem Merkezi'ndeki dönüşüm izleme kontrol panelinde görebilirsiniz.

conversion-tracking-dashboard

Dönüşüm ilişkilendirme koşulları

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

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

Bir kullanıcı, yer işlemi bağlantısını takip eder ve aynı oturumda aynı satıcıdan sipariş verir. Satıcı değişim değeri = 2.
Bir kullanıcı, yer işlemi bağlantısını takip ediyor ve 30 günlük ilişkilendirme dönemi içinde farklı bir kanaldan geri dönerek aynı satıcıdan sipariş veriyor. Satıcı değişim 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 ilişkilendirme dönemi içindeki farklı bir oturumda farklı bir mağazadan sipariş verir. Satıcı değişim değeri = 1.

Ayrıca Google, kullanıcıların yer işlemi bağlantısı üzerinden erişebileceği tüm cihazlardan dönüşüm etkinlikleri göndermeyi bekler. Bu cihazlar şunlardır:

Masaüstü veya mobil web uygulamaları.
Mobil uygulamalar, alanınız için uygulama derin bağlantısı veya kayıtlı uygulama amaçlı bağlantı aracılığıyla.

Jeton kullanıcı düzeyinde depolanıyorsa cihazlar arası ilişkilendirme sağlamanız beklenir. Daha fazla bilgi için Kullanıcı düzeyinde depolama başlıklı makaleyi inceleyin. Bu durumda, masaüstünden bir işlem bağlantısını takip eden ve ardından işlemi aynı kullanıcı hesabıyla mobil cihazda tamamlayan bir kullanıcının dönüşüm etkinliğini tetiklemesi gerekir.

Tarayıcı çerezleri gibi yalnızca cihaz düzeyinde depolanan jetonlar için cihazlar arası ilişkilendirme sağlamanız beklenmez. Bu durumda, kullanıcı söz konusu cihazda bir işlem bağlantısını takip ederse her cihazda ayrı bir jeton kalıcı hale getirilebilir ve her cihaz ilişkilendirme kurallarını ayrı ayrı uygulayabilir.