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ı bir siparişi 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

Bir kullanıcı sipariş sayfanıza yönlendirildiğinde, sağlanan URL'ye yeni bir rwg_token eklenir. Sipariş 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ı sipariş 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. Bir kullanıcı siparişi 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 siparişi 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ı siparişini 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 sipariş sayfası URL'lerini kullanın ve her test senaryosunu URL'nin sonuna test jetonlarını ekleyerek ç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	Bir kullanıcı, Google'da başlamayan bir siparişi tamamladığında	Kullanıcı, Google tarafından yönlendirilmeden veya mevcut bir yönlendirme olmadan doğrudan sipariş sayfasına gider. Bu işlem herhangi bir dönüşüm etkinliğiyle sonuçlanmamalıdır.	Kullanıcı daha önce sipariş 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 siparişi tamamladığında	Bir kullanıcı Google üzerinden satıcınızı bulur, sipariş sayfanıza yönlendirilir ve sipariş verir.	Kullanıcı, Google tarafından sipariş sayfasına yönlendirildiği için 2 satıcı değiştirildi değeri ve A jetonu ile bir dönüşüm etkinliği gönderilir.
3	Google'dan gelen bir kullanıcı sipariş sürecini başlatır ancak sipariş tamamlanmadan oturumu terk eder. Not: Bu oturumu 4. ve 5. test için açık tutun.	Bir kullanıcı sipariş sayfanıza yönlendiriliyor ancak oturum sona eriyor ve kullanıcı sipariş vermiyor.	Kullanıcı siparişi tamamlamadığı için dönüşüm yok ancak B jetonu 30 gün boyunca saklanmalıdır.
4	Google'dan gelmemiş olan bir kullanıcı, sipariş sayfasına geri döner ve siparişi tamamlar. Not: Sipariş akışı URL'sinde rwg_token bulunmamalıdır.	Kullanıcı, 4. Test'ten sonra sipariş 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 bir yönlendirmeden sonra sipariş sayfasına geri döndüğü için Token B ile merchant changed değeri 2 olan bir dönüşüm etkinliği gönderilir.
5	Kullanıcı, 4. testten sonra Google'dan yeni bir sipariş verir.	Bir kullanıcı, önceki bir Google yönlendirmesinden sonra Google yönlendirmesini kullanarak sipariş sayfanıza geri dönerse 30 günlük depolama aralığı sıfırlanır ve eski jetonun (B jetonu) yerini yeni bir jeton (C jetonu) alır. Gelecekteki tüm dönüşümler C jetonuna atfedilir.	Kullanıcı siparişi tamamladığı ve yeni jeton daha önce depolanan jetonun yerini aldığı için 2 satıcı değiştirildi 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 sipariş sayfanıza yönlendirilen bir kullanıcı, farklı bir satıcıdan sipariş veriyor.	Google tarafından sipariş sayfanıza yönlendirilen bir kullanıcı, A jetonunu kullanır ancak siparişi tamamlamadan önce farklı bir sayfaya gidip siparişi ilk yönlendirmeden farklı bir satıcıyla tamamlar.	Kullanıcı, Google'dan gelen bir yönlendirme ile başlayan ve jeton A ile 1 değerinde satıcı değişikliği içeren bir siparişi tamamladığı için dönüşüm etkinliği gönderilir. Kullanıcı, siparişi yönlendirmeden farklı bir satıcıda tamamladığı için satıcı değişikliği 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 sipariş 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.

Gerçek zamanlı güncelleme