Sorun giderme

Bu kılavuzda, yaygın uygulama hatalarını düzeltmek için genel sorun giderme adımları özetlenmiştir.

Etkinlik yok

Etkinlikleriniz Google Analytics'te görünmüyorsa göz atmanız gereken birkaç yaygın sorun vardır.

Öncelikle müşterinizi seçin:

• Doğru api_secret değerini mi kullanıyorsunuz?

  Doğru akış için api_secret değerini kullandığınızdan emin olun. Ölçüm protokolünü birden fazla akış için ayarlarsanız her akışın kendi gizli anahtarı olur.

• api_secret parametreniz hâlâ geçerli mi?

  Spam'le mücadeleye yardımcı olmak için api_secret'leri iptal edebilirsiniz. Kullandığınız api_secret'nin hâlâ geçerli olduğundan emin olun. Akışınıza erişimi olan başka bir kullanıcının yanlışlıkla erişimi iptal etmiş olması mümkündür.

• api_secret değeriniz doğru kopyalandı mı?

  api_secret büyük/küçük harfe duyarlıdır. Google Analytics kullanıcı arayüzündeki api_secret değerinin, kodunuzda kullandığınızla tam olarak aynı olduğundan emin olun.

• advertising_id kullanmayın.

  advertising_id, geçerli bir cihaz tanımlayıcısı olarak desteklenmiyor. Firebase kullanıyorsanız app_instance_id, gtag.js kullanıyorsanız client_id değerini kullanın.

• Doğru firebase_app_id kullanıyor musunuz?

  Bir Firebase uygulamasının tanımlayıcısını kullandığınızdan emin olun. Bu değer, Firebase konsolunda Proje Ayarları > Genel > Uygulamalarınız > Uygulama Kimliği bölümünde bulunur.

  firebase_app_id, app_instance_id'ten farklıdır.

• Doğru app_instance_id kullanıyor musunuz?

  Firebase uygulamasının yüklemesine özgü tanımlayıcıyı kullandığınızdan emin olun. Bu değerin Firebase için Google Analytics SDK'sı aracılığıyla alınması gerekir.

  • Android - getAppInstanceId()
  • Kotlin - getAppInstanceId()
  • Swift - appInstanceID()
  • Objective-C - appInstanceID
  • C++ - GetAnalyticsInstanceId()
  • Unity - GetAnalyticsInstanceIdAsync()

  app_instance_id, firebase_app_id'ten farklıdır.

Geçersiz kimlikler

Ölçüm Protokolü, Firebase için Google Analytics SDK'sındaki ve gtag.js'deki kimlikleri desteklediğinden doğru kimliği kullandığınızdan emin olun. Kullanmanız gereken kimlikler, Firebase için Google Analytics SDK'sını mı yoksa gtag.js'yi mi kullandığınıza bağlı olarak değişir. Aşağıda, kullanmanız gereken kimlikler özetlenmiştir:

Firebase için Google Analytics SDK'sı

Firebase için Google Analytics SDK'sını kullanıyorsanız kullanmamanız gereken kimlikler şunlardır:

• firebase_app_id: Bu kimliği, istek için sorgu parametrelerine ekleyin. Bu kimlik, Firebase uygulamanızı benzersiz şekilde tanımlar. Uygulamanızın tüm kullanıcıları aynı firebase_app_id değerine sahiptir. Firebase konsolunda şu konumda bulunur:
  Proje Ayarları > Genel > Uygulamalarınız > Uygulama Kimliği

• app_instance_id: Bu kimliği, isteğin POST gövdesine ekleyin. Bu kimlik, Firebase uygulamasının belirli bir yüklemesini benzersiz şekilde tanımlar. Bu değer, uygulamanızın her yüklemesi için farklı olur. Her Firebase platformu için bu değeri isteme yöntemleri aşağıda verilmiştir:

  • Android - getAppInstanceId()
  • Kotlin - getAppInstanceId()
  • Swift - appInstanceID()
  • Objective-C - appInstanceID
  • C++ - GetAnalyticsInstanceId()
  • Unity - GetAnalyticsInstanceIdAsync()

Aşağıdakileri kullanmamalısınız:

• firebase_instance_id: Bu kimlik isteğinize dahil edilmemelidir. Bu kimlik, uygulamanın belirli bir örneğini tanımlamak için kullanılır ancak Firebase'e özgüdür. FCM mesajları gibi görevler için kullanılır.

gtag.js

gtag.js kullanıyorsanız kullanmamanız gereken kimlikler şunlardır:

• measurement_id: Bu kimliği, istek için sorgu parametrelerine ekleyin. Bu kimlik, veri akışını benzersiz şekilde tanımlar. Web sitenizin tüm kullanıcıları aynı measurement_id değerine sahip olur. Google Analytics kullanıcı arayüzünde şu konumda bulunur:
  Yönetici > Veri Akışları > akışınızı seçin > Ölçüm Kimliği
• client_id: Bu kimliği, isteğin POST gövdesine ekleyin. Bu kimlik, web istemcisinin belirli bir kullanıcı örneğini benzersiz şekilde tanımlar. Bu değer, uygulamanızın her kullanıcısı için farklı olacaktır. Bu değeri nasıl alacağınızı öğrenmek için bu örneklere bakın.

Sunucu tarafı etiketleme etkinlikleri eksik

Measurement Protocol istemcisi içeren sunucu tarafı Etiket Yöneticisi kurulumu, etkinlikleri Measurement Protocol biçiminde bir kapsayıcıya göndermenize olanak tanır. Ardından kapsayıcı, diğer tüm SGTM etkinlikleriyle aynı mekanizmayı kullanarak bu etkinlikleri Google Analytics'e gönderir.

Measurement Protocol'un tüm özelliklerini kullanmak istiyorsanız etkinlikleri kapsayıcınız yerine doğrudan Measurement Protocol'e gönderin.