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

1. Giriş

Son Güncelleme: 2021-02-19

Ne oluşturacaksınız?

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

Bu codelab boyunca, müşterilerimizin karşılaştığı uygulama işletmesi sürecinin tamamını deneyimleyebilirsiniz. iOS'te Firebase ve AdMob'a daha kolay bir giriş yapmak istiyorsanız AdMob+Firebase 101 Unity: Setup & Analytics Basics (AdMob+Firebase 101 Unity: Kurulum ve Analytics Temelleri) başlıklı makaleyi inceleyin.

Neler öğreneceksiniz?

• Unity + iOS'te GA4F'yi (Firebase için Google Analytics) başlatma
• Özel etkinlikler ve parametreler oluşturma
• Etkinlikleri Firebase'den Google Ads'e aktarma
• Ö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

Basit bir şablonlu Unity uygulaması oluşturun. Bu basit uygulamayı değiştirerek tamamlanmış uygulamayı oluşturursunuz.

Unity'yi başlatın.

1. Açık projeniz yoksa yeni proje oluştur'u seçin.
2. İletişim kutusundan 3D şablonları seçin.
3. Proje Adı'nı doldurun: örneğin, Unity Firebase Özel Etkinliği.
4. Projenizi kaydetmek için bir konum seçin ve OLUŞTUR'u 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 Google Analytics'i ayarlar > proje ayarları bölümündeki Entegrasyonlar sekmesinden etkinleştirebilirsiniz. Firebase yapılandırma adımına geçin.

1. Firebase'de oturum açın.

Firebase konsolunda Proje Ekle'yi(veya Proje oluştur) 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 > File > Build Settings'e (Unity > Dosya > Derleme Ayarları) gidin. Önemli olan, aşağıdaki adımı kullanarak elde edeceğiniz iOS paket kimliğini ayarlamaktır.

Aşağıdaki ekranda gösterilen iletişim kutusunu görürsünüz.

2. iOS uygulaması için Unity projenizde Build Settings (Derleme Ayarları) iletişim kutusunu açın, File > Build Settings (Dosya > Derleme Ayarları) seçeneğini belirleyin. (Platform iOS olarak ayarlanmamışsa iOS Platform'u seçip Switch Platform (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. Kimlik alanının etrafındaki metin alanını görebilirsiniz.
4. Paket tanımlayıcı alanının değeri, iOS paket kimliğidir (örneğin, com.yourcompany.yourproject). 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. Register App'i (Uygulamayı Kaydet) 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ıp Firebase konsolunun ana sayfasına geri 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ındaki Unity simgesini ( ) tıklayın. Firebase projenize zaten bir 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 aynı anda kaydedebilirsiniz.

Not: Unity projenizin yalnızca bir derleme hedefini şimdi kaydederseniz diğer derleme hedefini kaydetmek için kurulum iş akışına daha sonra her zaman dönebilirsiniz.

4. Unity projenizin platforma özel kimliklerini girin.

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

5. Unity projenizin kimliğini nerede bulabilirsiniz?

Not: Projenizin kullandığı kimliği girdiğinizden emin olun. Kimlik değeri büyük/küçük harfe duyarlıdır ve bu Firebase uygulamaları Firebase projenize kaydedildikten sonra değiştirilemez.

6. (İsteğe bağlı) Unity projenizin platforma özel takma adlarını girin. Bu takma adlar dahili, kolaylık sağlayan tanımlayıcılardı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'yı indir'i tıklayın ve 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 Öğeler > Paket İçe Aktar > Özel Paket'e 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 izin verir. Unity projenizde .NET 4.x kullanılı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 konsoluna geri dönün ve kurulum iş akışında Sonraki'yi tıklayın.

Önemli: iOS için Firebase Unity SDK'sında yöntem dönüşümü özelliğini devre dışı bırakmayın. SDK'nın çalışması için swizzle işlemi gereklidir. Bu işlem yapılmadığında temel Firebase özellikleri (ör. FCM jetonu işleme) düzgün çalışmaz.

6. Firebase Analytics ile Özel Etkinlikleri Günlüğe Kaydetme

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

Firebase Analytics bazı etkinlikleri sizin için otomatik olarak kaydeder; bunları almak için herhangi bir kod eklemeniz gerekmez. Uygulamanızın başka veriler de toplaması gerekiyorsa uygulamanıza 500 farklı türde Analytics özel etkinliği 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);

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

Etkinliklerin düzgün şekilde kaydedildiğini doğrulamak için SDK tarafından etkinliklerin kaydedilmesini izlemek üzere ayrıntılı günlük kaydını etkinleştirebilirsiniz. Bu, hem otomatik olarak hem de manuel olarak kaydedilen etkinlikleri içerir.

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

1. Xcode'da Product (Ürün) > Scheme (Şema) > Edit scheme (Şemayı düzenle)... seçeneğini belirleyin.
2. Soldaki menüden Run'ı (Çalıştır) seçin.
3. Arguments (Bağımsız değişkenler) sekmesini seçin.
4. Arguments Passed On Launch (Başlatmada İletilen Parametreler) bölümüne -FIRAnalyticsDebugEnabled ifadesini ekleyin.

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

Etkinlikleri kontrol panelinde görüntüleme

Kaydedilen etkinliğiniz birkaç saat içinde Firebase konsolunda görünür. Bu raporu Analytics → Etkinlikler bölümünde bulabilirsiniz. Etkinliği tıklayarak da parametre değerlerini bulabilirsiniz.

"Dönüşüm olarak işaretle" anahtarını sağa kaydırarak "text_search"ü 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 tekrar kontrol edebilirsiniz. Etkinliği dönüşüm olarak işaretlediğinizde Google Ads de etkinliği dönüşüm olarak içe aktarabilir.

7. Google Ads'de analiz etkinliklerini içe aktarma

Firebase-iOS kurulumunuz tamamlandı ve kaydedilen işlem etkinlikleriyle uygulama kampanyasını başlatmaya hazırsınız. Firebase'i Google Ads'e bağlayarak başlayacaksınız. Firebase'i Google Ads'e bağladığınızda uygulama kampanyaları kitleler hakkında daha fazla bilgi edinebilir ve uygulama kampanyası öğrenimlerini artırabilir. Bu durum genellikle daha iyi performans ve dönüşümlerle sonuçlanır.

1. Proje Genel Bakış'ın hemen yanındaki düğmeyi tıklayarak Firebase Ayarları'na gidin.
2. Entegrasyonlar sekmesinde Google Ads'i ve bir Bağla 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 doğru şekilde dönüşüm olarak işaretlendiğinden emin olun.

Firebase bölümü tamamlandı.

Şimdi Google Ads'e gidip giriş yapın.

1. Google Ads'e gidip oturum açı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şaretleyip 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ı geldi.

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 uygulamanızın olması gerekir. Uygulamayı yayınlamaya hazır değilseniz bu adımı şimdilik atlayın.

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

8. Uygulama adını, paket adını veya yayıncıyı girerek uygulamanızı bulun.
9. Teklif verme bölümünde, reklamlarda işlemlere odaklanmak için açılır listeden uygulama içi işlemleri seçin.
10. Özel etkinliklerinizi sağlanan listede bulabilirsiniz. Hedef işlem başına maliyet belirleyin ve diğer seçenekleri de doldurun.

11. Kampanya ayarlarını yapılandırın. Bu, codelab'in kapsamı dışında kalır. Bu nedenle, ayarları optimize etmek için bu belgelere bakın veya başka kanallar üzerinden iletişime geçin.

9. Tebrikler

Tebrikler, Firebase'i Unity ve Google Ads ile başarıyla entegre ettiniz. Bu sayede kampanya performansınızı artırabilirsiniz.

Öğrendikleriniz

• 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şlem kampanyalarında kullanma

Referans belgeler

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