Sorun giderme

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

Etkinlik yok

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

Öncelikle istemcinizi seçin:

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

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

• api_secret değeriniz hâlâ geçerli mi?

  Spam ile mücadeleye yardımcı olmak için api_secretleri iptal edebilirsiniz. Kullandığınız api_secret öğesinin hâlâ geçerli olduğundan emin olun. Akışınıza erişimi olan başka bir kullanıcı, erişimi yanlışlıkla iptal etmiş olabilir.

• api_secret değeriniz doğru şekilde 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ız değerle 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 simgesini kullanın.

• Doğru firebase_app_id kullanıyor musunuz?

  Firebase uygulaması için tanımlayıcı 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 ile aynı değil.

• Doğru app_instance_id kullanıyor musunuz?

  Firebase uygulamasının yüklenmesine özel tanımlayıcıyı kullandığınızdan emin olun. Bu değer, Firebase için Google Analytics SDK'sı aracılığıyla alınmalıdır.

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

  app_instance_id, firebase_app_id ile aynı değil.

Geçersiz kimlikler

Measurement Protocol, Firebase için Google Analytics SDK'sından ve gtag.js'den gelen 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 hangi kimlikleri kullanmanız gerektiği özetlenmiştir:

Firebase için Google Analytics SDK'sı

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

• firebase_app_id - Bu kimliği, isteğ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'ya sahip olur. Firebase konsolunda
  Proje Ayarları > Genel > Uygulamalarınız > Uygulama Kimliği bölümünde bulunur.

• app_instance_id: Bu kimliği isteğin POST gövdesine ekleyin. Bu kimlik, bir 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. Bu değeri her Firebase platformu için isteme yöntemleri şunlardır:

  • 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 kullanmanız gereken kimlikler şunlardır:

• measurement_id - Bu kimliği, isteğin sorgu parametrelerine ekleyin. Bu kimlik, bir 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, bir 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ı olur. Bu değeri nasıl alacağınızla ilgili örnekleri inceleyin.

Sunucu tarafı etiketleme etkinlikleri eksik

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

Measurement Protocol'ün tüm özelliklerini kullanmak istiyorsanız etkinlikleri kapsayıcınıza değil, doğrudan Measurement Protocol'e gönderin.