Firebase için Google Analytics ile Google Ads özel etkinlikleri - Unity

1. Giriş

Son Güncelleme: 19.02.2021

Oluşturacaklarınız

Bu codelab'de, Unity ortamında GA4F iOS ile özel etkinlikleri nasıl uygulayacağınızı ve Google Ads aracılığıyla işlem kampanyaları başlatmayı öğreneceksiniz.

Bu kod laboratuvarının tamamında, müşterilerimize sunduğumuz uygulama işletmeciliği sürecini deneyimleyebilirsiniz. iOS'te Firebase ve AdMob'a daha kolay bir giriş yapmak istiyorsanız AdMob+Firebase 101 Unity: Kurulum ve Analizler ile İlgili Temel Bilgiler başlıklı makaleyi inceleyin.

Neler öğreneceksiniz?

• Unity + iOS'te GA4F'yi (Firebase için Google Analytics) başlatma.
• Özel etkinlik ve parametreler oluşturma
• Etkinlikler Firebase'den Google Ads'e nasıl aktarılır?
• Özel etkinliklerle işleme yönelik kampanyalar başlatın.

Gerekenler

• Xcode
• Unity
• Firebase Hesabı
• Google Ads hesabı

2. Yeni bir Unity projesi başlatma

Şablonlu basit bir Unity uygulaması oluşturun. Bu basit uygulamayı değiştirerek bitmiş bir uygulama oluşturabilirsiniz.

Unity'yi başlat

1. Açık projeniz yoksa yeni proje oluştur'u seçin.
2. İletişim kutusunda 3D şablonları seçin.
3. Proje Adı'nı doldurun: Ör. Unity Firebase Özel Etkinliği.
4. Projenizi kaydetmek için bir Konum seçin ve CREATE (OLUŞTUR) seçeneğini tıklayın.
5. Unity yeni projenizi çalışma alanı penceresinde açar.

3. Firebase projesi oluşturma ve ayarlama

Firebase'i kullanmaya başlamak için bir Firebase projesi oluşturup ayarlamanız gerekir.

Google Analytics'in etkinleştirilmediği bir Firebase projeniz varsa ayarlarınızın > Proje ayarları bölümündeki Entegrasyonlar sekmesinden Google Analytics'i etkinleştirebilirsiniz. Firebase yapılandırması adımına geçin.

1. Firebase'de oturum açın.

Firebase konsolunda Proje Ekle'yi (veya Proje oluştur'u) tıklayın ve Firebase projenizi Firebase-iOS-Ads olarak adlandırın.

2. Proje oluşturma seçeneklerini tıklayın. İstenirse Firebase şartlarını kabul edin. İşlem etkinliklerini ve dönüşümleri izlemek için Google Analytics etkinliklerine ihtiyacınız olduğundan bu proje için Google Analytics'i etkinleştirmeniz gerekir.

Firebase projeleri hakkında daha fazla bilgi edinmek için Firebase projelerini anlama başlıklı makaleyi inceleyin.

4. Unity yapılandırması

1. Unity > Dosya > Derleme Ayarları bölümüne gidin. Önemli değer, aşağıdaki adımı uygulayarak elde edeceğiniz iOS paket kimliğini ayarlamaktır.

Bir sonraki ekranda gösterilen iletişim kutusunu göreceksiniz.

2. iOS uygulaması için Unity projenizde, Build Settings (Dosya) iletişim kutusunu, File > Build Settings'i (Dosya > Derleme Ayarları) açın (Platform iOS olarak ayarlanmamışsa iOS Platformu'nu seçip Platformu Değiştir düğmesini tıklayabilirsiniz).

3. Platform değişikliğinden sonra paket kimliğini ayarlamak için Oynatıcı Ayarları düğmesini tıklayın. Metin alanını Kimlik alanının etrafında görebilirsiniz.
4. Paket Tanımlayıcı alanının değeri iOS paket kimliğidir (com.yourcompany.yourproject gibi bir değer). Bu değeri kopyalayın veya kendi değerinizi ayarlayıp kopyalayın.
5. Firebase iletişim kutusunda, kopyalanan paket kimliğini iOS bundle ID alanına yapıştırın.
6. Uygulamayı Kaydet'i tıklayın.
7. Firebase'de devam ederek yapılandırma dosyasını indirme talimatlarını uygulayın GoogleService-Info.plist
8. Unity projenizin Proje penceresini açın, ardından yapılandırma dosyalarınızı Assets klasörüne taşıyın.
9. Kalan adımları atlayın ve Firebase konsolunun ana sayfasına dönün.

5. Unity'de Firebase Analytics'i yapılandırma

Bu adımda, Firebase SDK'sını Unity projenize eklemeye başlayacaksınız.

1. Firebase konsoluna gidin.
2. Kurulum iş akışını başlatmak için projeye genel bakış sayfasının ortasında Unity simgesini ( ) tıklayın. Firebase projenize daha önce uygulama eklediyseniz platform seçeneklerini görüntülemek için Uygulama ekle'yi tıklayın.
3. Unity projenizin hangi derleme hedefini kaydetmek istediğinizi seçin. Dilerseniz her iki hedefi de hemen aynı anda kaydetmeyi seçebilirsiniz.

Not: Şu anda Unity projenizin yalnızca bir derleme hedefini kaydederseniz daha sonra istediğiniz zaman kurulum iş akışına dönerek diğer derleme hedefini kaydedebilirsiniz.

4. Unity projenizin platforma özgü kimliklerini girin.

• iOS için: iOS paketi kimliği alanına Unity projenizin iOS kimliğini girin.
• Android için: Android paket adı alanına Unity projenizin Android kimliğini girin. Paket adı ve uygulama kimliği terimleri genellikle birbirinin yerine kullanılır.

5. Unity projenizin kimliğini nerede bulabilirsiniz?

Not: Projenizde kullanılan kimliği girdiğinizden emin olun. Kimlik değeri büyük/küçük harfe duyarlıdır ve Firebase projenize kaydedilen bu Firebase uygulamaları için değiştirilemez.

6. (İsteğe bağlı) Unity projenizin platforma özel takma adlarını girin. Bu takma adlar, dahili ve kolaylık tanımlayıcılarıdır ve yalnızca Firebase konsolunda size görünür.
7. Uygulamayı kaydet'i tıklayın.

Firebase Analytics Unity SDK'larını ekleme

1. Firebase konsolunda Firebase Unity SDK'sını indir'i tıklayın, ardından SDK'yı uygun bir konumda arşivden çıkarın.

• Firebase Unity SDK'yı istediğiniz zaman tekrar indirebilirsiniz.
• Firebase Unity SDK platforma özgü değildir.

2. Açık Unity projenizde Assets > Import Package > Custom Package'a (Paketi İçe Aktar) gidin.
3. Arşivden çıkarılan SDK'dan, uygulamanızda kullanmak istediğiniz desteklenen Firebase ürünlerini seçin.

• Google Analytics için Firebase paketini ekleyin: FirebaseAnalytics.unitypackage
• Uygulamanızda kullanmak istediğiniz diğer Firebase ürünlerinin paketlerini ekleyin. Örneğin, Firebase Authentication ve Firebase Realtime Database'i kullanmak için: FirebaseAuth.unitypackage ve FirebaseDatabase.unitypackage

Unity 5.x ve önceki sürümler .NET 3.x çerçevesini kullandığından dotnet3/ paketini içe aktarın. Unity 2017.x ve sonraki sürümler, .NET 4.x çerçevesinin kullanılmasına olanak tanır. Unity projeniz .NET 4.x kullanıyorsa dotnet4/ paketini içe aktarın. Unity 2019 ve sonraki sürümler artık .NET 3.x çerçevesini desteklemediğinden dotnet4/ paketini içe aktarın.

4. Unity Paketini İçe Aktar penceresinde İçe Aktar'ı tıklayın.
5. Firebase Konsolu'ndaki kurulum iş akışında Sonraki'yi tıklayın.

Önemli: iOS için Firebase Unity SDK'sında yöntem karıştırmayı devre dışı bırakmayın. SDK, kaydırma hızını zorunlu kılar. Bu işlem yapılmadığında, temel Firebase özellikleri (FCM jeton işleme gibi) düzgün çalışmaz.

6. Firebase Analytics ile özel etkinlikleri günlüğe kaydetme

Bu adımda, Unity iOS uygulamasında Firebase Analytics'i kullanarak özel etkinlikleri nasıl günlüğe kaydedeceğinizi öğreneceksiniz.

Firebase Analytics bazı etkinlikleri sizin için otomatik olarak günlüğe kaydeder. Bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın ek veri toplaması gerekiyorsa, uygulamanıza 500'e kadar farklı Analytics Özel Etkinlik türünü kaydedebilirsiniz.

Etkinlikleri günlüğe kaydetme

FirebaseApp örneğini yapılandırdıktan sonra logEvent() yöntemiyle etkinlikleri günlüğe kaydetmeye başlayabilirsiniz.

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Xcode hata ayıklama konsolunda etkinlikleri görüntüleme

Etkinliklerin düzgün şekilde günlüğe kaydedildiğini doğrulamaya yardımcı olması için SDK tarafından günlüğe kaydedilen etkinliklerin izlenmesi için ayrıntılı günlük kaydını etkinleştirebilirsiniz. Hem otomatik olarak hem de manuel olarak kaydedilen etkinlikler bu kapsamdadır.

Ayrıntılı günlük kaydını şu şekilde etkinleştirebilirsiniz:

1. Xcode'da Ürün > Şema > Şemayı düzenle...'yi seçin.
2. Sol menüden Çalıştır'ı seçin.
3. Bağımsız değişkenler sekmesini seçin.
4. Başlatma sırasında iletilen bağımsız değişkenler bölümüne -FIRAnalyticsDebugEnabled ekleyin.

Uygulamanızı bir sonraki sefer çalıştırdığınızda etkinlikleriniz Xcode hata ayıklama konsolunda gösterilir. Bu sayede, etkinliklerin gönderildiğini hemen doğrulayabilirsiniz.

Etkinlikleri kontrol panelinde görüntüleme

Günlüğe kaydedilen etkinliğinizi birkaç saat içinde Firebase konsolunda görürsünüz. Analytics → Etkinlikler bölümünde bulunur. Parametre değerlerini etkinliği tıklayarak da bulabilirsiniz.

"Dönüşüm olarak işaretle" anahtarını sağa kaydırarak "metin_arama"yı dönüşüm olarak işaretlersiniz.

Etkinliğin başarıyla dönüşüm olarak işaretlenip işaretlenmediğini Firebase Analytics Dönüşümler sekmesinden kontrol edebilirsiniz. Dönüşüm olarak işaretlediğiniz etkinliği Google Ads de dönüşüm olarak içe aktarabilir.

7. Analiz etkinliklerini Google Ads'e aktarma

Firebase-iOS kurulumunuz tamamlandı ve günlüğe kaydedilen işlem etkinlikleriyle uygulama kampanyasını başlatmaya hazırsınız. Firebase'i Google Ads'e bağlayarak başlarsınız. Firebase'i Google Ads'e bağladığınızda, uygulama kampanyaları kitleler hakkında daha fazla bilgi edinebilir ve uygulama kampanyasından daha iyi bilgi edinebilir. Bu da genellikle daha iyi performans ve dönüşüm sağlar.

1. Projeye Genel Bakış'ın hemen yanındaki düğmeyi tıklayarak Firebase Ayarları'na gidin.
2. Entegrasyonlar sekmesinde Google Ads'i ve Bağlan düğmesini görürsünüz. Bağlantı oluştur ve devam et'i tıklayın.

3. Google Ads hesabını seçin.

Dikkat: Hedef etkinlik dönüşüm olarak işaretlenmemişse Google Ads bu etkinliği içe aktaramaz. Etkinliğin dönüşüm olarak doğru şekilde işaretlendiğinden emin olun.

Şimdi Firebase kısmı tamamlandı.

Şimdi, Google Ads'e gidin ve giriş yapın.

1. Google Ads'e gidip giriş yapın ve Özel etkinlikleri dönüşüm olarak içe aktarmak için Araçlar ve Ayarlar → Ölçüm → Dönüşümler'e gidin.
2. Yeni dönüşüm işlemi eklemek için + düğmesini tıklayın.

3. Google Analytics 4 mülklerini (Firebase) seçin ve Devam'ı tıklayın.

4. Dönüşüm olarak işaretlenen tüm analiz etkinliklerini görebilirsiniz. Daha önce uyguladığımız clicked_counter etkinliğini bulun.

5. İçe Aktar ve Devam Et düğmesini işaretleyin ve tıklayın.

text_search etkinliğini dönüşüm işlemi olarak ayarladıktan sonra, text_search etkinliklerini tetikleme olasılığı yüksek olan kullanıcıları hedefleyen bir kampanya başlatmanın zamanı gelmiştir.

8. İçe aktarılan etkinliklerle uygulama işlemi kampanyaları başlatma

Önemli: Uygulama kampanyası başlatmak için Google Play'de üretim düzeyinde bir uygulamaya ihtiyacınız vardır. Uygulamayı yayınlamaya hazır değilseniz bu adımı şimdilik atlayın.

6. Mevcut hesabınızın kampanyalar sekmesine gidin ve + düğmesini tıklayarak yeni bir kampanya başlatın. Yeni kampanyayı tıklayın ve devam edin.
7. Bu sefer, uygulama yükleme seçeneğiyle bir uygulama tanıtım kampanyası yayınlayacağız.

8. Uygulama adını, paket adını veya yayıncıyı sağlayarak uygulamanızı bulun.
9. Teklif verme bölümünde, reklamların işlemlere odaklanması için dropbox'taki Uygulama içi işlemler'i seçin.
10. özel etkinliklerinizi verilen listede bulabilirsiniz. İşlem başına maliyet hedefini belirleyin ve diğer seçenekleri de doldurun.

11. Kampanya ayarlarını yapılandırın. Bu, codelab'in kapsamı dışındadır. Bu nedenle, ayarları optimize etmek için bu dokümanlara bakın veya diğer kanallardan iletişime geçin.

9. Tebrikler

Tebrikler, Firebase'inizi Unity ve Google Ads'e başarıyla entegre ettiniz. Bu, kampanyanızın performansını artırmanıza yardımcı olur.

Neler öğrendiniz?

• Unity iOS platformu için Firebase'i yapılandırma
• Unity ve Firebase Analytics ile özel etkinlikleri günlüğe kaydetme
• Etkinlikleri içe aktarma ve işleme yönelik kampanyalarda kullanma.

Referans belgeler

• Firebase'i Unity projenize ekleme
• GitHub: firebase/quickstart-unity