Dönüşüm İzleme

Not: Dönüşüm izleme, son olarak 2 Şubat 2024'te güncellenmiştir. Değişikliklerle ilgili sorularınız varsa Google temsilcinizle iletişime geçin.

Şekil 1. Dönüşüm izlemeye genel bakış

Genel Bakış

Dönüşüm izleme, İş Merkezi entegrasyonlarımızdan biri aracılığıyla Google tarafından başlatılan dönüşümleri izler. Belirli sayfalardaki sıralamayı etkileyebileceğinden, entegrasyonunuzun sağlıklı ve çalışır durumda kalması gerekir. Google her action_link oluşturduğunda, söz konusu URL benzersiz bir sorgu parametresi içerecek şekilde değiştirilir: rwg_token. Kullanıcı bir rezervasyonu tamamladığında jetonu saklayabilir ve uygun değerleri döndürebilirsiniz.

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

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

rwg_token öğesini ayrıştırma ve depolama

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ıyla ilgili meta verileri ve bu action_link değerini oluşturan satıcı bilgilerini içeren kodlanmış bir dizedir.

Önemli: Jetonda kullanıcı verisi depolanmaz veya şifrelenmez.

Jetonu ayrıştırma

Bir 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, rwg_token değerinin tarayıcı üzerinden cihaz düzeyinde izleme için nasıl ayrıştırıldığı gösterilmektedir.

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 jeton şifrelenir. Aşağıdaki rwg_token örneğine bakın. = gibi özel karakterlerle birlikte jetonu doğru şekilde ayrıştırdığınızdan emin olmak için bu örnek jetonu kullanın.

AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==

Jetonu depolama

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

• Cihaz düzeyinde
• Kullanıcı düzeyinde

Jetonu istediğiniz düzeyde saklayabilirsiniz ancak jetonu ilk yönlendirmeden 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 bir tarayıcıda saklayabilirsiniz. Bu örnekte, jeton değerini bir değişkene ayrıştırdığınız varsayılmaktadı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=/";
}

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

Cihaz düzeyinde depolama

Cihaz düzeyi, tarayıcı çerezlerinin, yerel depolama alanının, uygulama yerel depolama alanının veya jetonu 30 günlük ilişkilendirme aralığında koruyabilecek diğer yöntemlerin kullanımını içerir. Jeton, kullanıcının cihazında yerel olarak depolanır. Bu nedenle, kullanıcı aşağıdaki durumlarda dönüşüm etkinliğini doğru şekilde ilişkilendiremez:

• Kullandıkları cihazı değiştirir.
• Yerel depolama alanını veya çerezleri temizler.
• Gizli veya gizli tarama tarayıcısı kullanıyorsanız

Cihaz düzeyinde dönüşüm izlemeyi kullandığınızda dönüşüm etkinliğini, mobil cihazları da içeren desteklenen her cihazda yeniden uygulamanız gerekir.

Kullanıcı düzeyinde depolama

Kullanıcı düzeyi, jetonu sunucu tarafı bir analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda saklar. 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 göre kullanıcı düzeyinde dönüşüm izlemeyi kullandığınızda, dönüşüm etkinliğini sunucu tarafınıza bir kez uygulayabilir ve desteklenen tüm cihazlarda yeniden kullanabilirsiniz.

Not: rwg_token öğesini nereye depolayacağınıza ihtiyacınıza göre karar verebilirsiniz.

Jetonu yenileme

Google bir kullanıcıyı aynı satıcıya yönlendirdiğinde, depolanan mevcut jeton en son yönlendirmedeki yeni jetonla değiştirilir. Jeton değişiminden sonra, jeton deposunun 30 günlük ilişkilendirme dönemi 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 İlişkilendirme Şartları başlıklı makaleyi inceleyin.

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

Kullanıcı rezervasyon sayfanıza yönlendirildiğinde satıcı ayrıntılarını bulup yakalayabilecek mantığı uygulamanız gerekir. İş ortakları genellikle işlem bağlantılarına satıcı meta verilerini veya merchant_id ekler ve satıcı bilgilerini tanımlamak ve depolamak için bu bağlantıları kullanır.

merchant_id veya seçili tanımlayıcıyı rwg_token ile birlikte saklamanızı öneririz. Bir kullanıcı rezervasyonu onayladığında, dönüşüm isteğini eksiksiz olarak göndermeden önce satıcıya danışabilirsiniz. Jeton depolamaya benzer şekilde, satıcı ayrıntılarını ilk yönlendirmeden sonraki 30 gün boyunca jetonla birlikte kaydetmeniz gerekir.

Aşağıdaki örnekte, daha önce depolanan rwg_token değiştirilmektedir. Sağlanan URL'deki meta verilerden satıcı bilgilerini ayrıştırdığınız ve bu bilgileri 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_changed Değerlerini Döndürme

Bir kullanıcı action_link tavsiyesiyle 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
• Korumalı ortam: https://www.google.com/maps/conversion/debug/collect

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

POST mesaj 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 JavaScript ile yazılmış bir çerez içeren cihaz düzeyinde dönüşüm izleme yer almaktadı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: Yalnızca text/plain MIME Content-Type kabul edilir. Başlıkta başka bir Content-Type ayarlamamanız gerekir. Aksi takdirde CORS hatası oluşur.

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

Not: Üretim ortamında, bu entegrasyonla ilişkilendirilmeyen dönüşüm etkinlikleri göndermemeniz gerekir. Etkinliği göndermeden önce geçerli ve süresi dolmamış bir rwg_token değerini 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şikliği sık karşılaşılan bir durumdur. Bu durumda, bir kullanıcı Google tarafından platformunuza yönlendirilir ve rezervasyon yapmak 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 tanımlamak için Boole kullanabilirsiniz ancak satıcı ayrıntılarını kullanamazsınız.

merchant_changed değerine hangi değeri atayacağınıza karar verirken Satıcı Bilgilerini Ayrıştırma ve Saklama bölümünde kayıtlı orijinal satıcıyı 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 gerçekleştirdiğinde.
  • Satıcı değişikliği değeri: 1
• Şart: Kullanıcı orijinal satıcı üzerinden bir işlem tamamladığında.
  • Satıcı değişikliği değeri: 2

Not: 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.

Dönüşüm İzlemeyi Test Etme ve Doğrulama

Aşağıdaki test örnekleri, Test Jetonları bölümünde sağlanan test jetonlarını kullanır ve dönüşüm etkinliğiyle sonuçlanabilecek tüm senaryolarda size yol göstermeyi amaçlar. Bu, jetonun uygun şekilde depolandığından, merchant_changed değerinin doğru ayarlandığından ve dönüşüm etkinliğinin uygun olduğunda gönderildiğinden emin olmanızı sağlar.

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

Test Örneği	Test Açıklaması	Kullanıcı Akışları	Beklenen Sonuç
1	Kullanıcı, Google'dan kaynaklanmayan bir rezervasyonu tamamladığında	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çlanmaz.	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'dan gelen bir rezervasyonu tamamlar.	Bir kullanıcı Google üzerinden satıcınızı bulur, rezervasyon sayfanıza yönlendirilir ve rezervasyon yapar.	Kullanıcı Google tarafından rezervasyon sayfasına yönlendirildiği için A jetonu ve satıcı değişti değeri 2 olan 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: 4. ve 5. test için bu oturumu açık tutun.	Bir kullanıcı rezervasyon sayfanıza yönlendirilir ancak oturum sona erer ve kullanıcı rezervasyon yapmaz.	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 geri döner ve rezervasyon yapar. Not: Rezervasyon akışı URL'sinde rwg_token bulunmamalıdır.	Kullanıcı, 4. test sonrasında rezervasyon sayfasına geri döner. B jetonu 30 gün boyunca saklanmalı ve bu 30 gün içinde gerçekleşen tüm dönüşümler bir dönüşüm etkinliği döndürmelidir.	Kullanıcı, Google'dan önceki yönlendirmeden sonra rezervasyon sayfasına geri döndüğü için B jetonu ve satıcı değişti değeri 2 olan bir dönüşüm etkinliği gönderilir.
5	Kullanıcı, 4. test sonrasında Google'dan gelen yeni bir rezervasyonu tamamlar.	Bir kullanıcı, önceki bir Google yönlendirmesinden sonra Google yönlendirmesi kullanarak rezervasyon sayfanıza geri dönerse 30 günlük depolama alanı süresi sıfırlanır ve eski Jeton B yerine yeni bir jeton Jeton C oluşturulur. Bu durumda, gelecekteki tüm dönüşümler C jetonu ile ilişkilendirilir.	Kullanıcı rezervasyonu tamamladığı ve yeni jeton daha önce depolanan jetonun yerini aldığı için C jetonu ve satıcı değişti değeri 2 olan bir dönüşüm etkinliği gönderilir.

Kullanıcıların farklı bir satıcıyla ödeme yapabildiği bir platformunuz varsa aşağıdakileri test edin.

Önemli: Satıcı Değişikliği Değerini Döndürme bölümünde belirtildiği gibi, rezervasyon sayfalarınızda veya işlem bağlantılarınızda kullanıcının satıcıyı değiştirme özelliği yoksa bu isteklerin değerini 2 olarak sabitleyebilirsiniz. Bu durum, rezervasyon sayfalarını satıcının web sitesine entegre eden veya rezervasyonu işlemek için özel açılış sayfalarına sahip olan iş ortakları için yaygındır. Bu iş ortaklarından biriyseniz aşağıdaki test durumlarını atlayabilirsiniz.

Test Örneği	Test Açıklaması	Kullanıcı Akışları	Beklenen Sonuç
6	Bir kullanıcı Google tarafından rezervasyon sayfanıza yönlendirilir ve farklı bir satıcıyla rezervasyon yapar.	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ı, rezervasyonu yönlendirmeden farklı bir satıcıda tamamladığı için Google'dan gelen bir yönlendirmeyle başlayan rezervasyonu A jetonu ile tamamladığı ve satıcı değişti değeri 1 olduğu için dönüşüm etkinliği gönderilir.

Test ederken 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

B jetonu:

rwg_token=AJKvS9U2QfiQanHFQrlJxBjD0AyFany3qpaJVEWOcY4nHqY_UkLYFFDj6RIa-EXS1iEmV8gtFPG6v1cU1jnusJK66ijXXnaqkQ%3D%3D

Jeton C:

rwg_token=AJKvS9VwInjZ_hGZPvBz0COVWJ5oFDzocFt9hGi7TMurlo2l71uiXP48PspPUMmRnqCUDE1mF_A5H_dMV78cBTF8jIfSQK6lEA%3D%3D

Gönderdiğiniz başarılı dönüşüm etkinliklerini, dönüşüm izleme kontrol panelinin altındaki İşlem Merkezi'nde toplu olarak görebilirsiniz.

Not: Dönüşümlerin kontrol panelinde görünmesi bir saati bulabilir.

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

Google'ın dönüşüm ilişkilendirmesi için zorunlu standardı, herhangi bir mağazada yer işlemi 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 aşağıdaki senaryolardan herhangi birinde bir dönüşüm etkinliğinin 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şikliği değeri = 2.
• Bir kullanıcı, bir işlem gerçekleştirme bağlantısını takip eder ve ardından 30 günlük ilişkilendirme aralığı içinde farklı bir kanaldan aynı satıcı için sipariş vermek üzere geri döner. Satıcı değişikliği değeri = 2.
• Kullanıcı, bir yer işlemi bağlantısını takip eder ve ardından aynı oturum içinde veya 30 günlük ilişkilendirme aralığında farklı bir mağazada sipariş verir. Satıcı değişikliği değeri = 1.

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

• Masaüstü veya mobil web uygulamaları.
• Mobil uygulamalar (uygulama derin bağlantısı veya alanınız için kayıtlı bir uygulama amacı 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 aynı kullanıcı hesabıyla mobil cihazda işlemi tamamlayan bir kullanıcı, 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ı ilgili cihazda bir işlem bağlantısını takip ederse her cihazın kalıcı ayrı bir jetonu olabilir ve her cihaz ilişkilendirme kurallarını ayrı ayrı uygulayabilir.

Not: Bu ilişkilendirme çerçevesi, dönüşümleri ilişkilendiren analiz sisteminizdekinden 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 etkilemesi gerekmez.