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

1. Giriş

Son Güncelleme Tarihi: 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 codelab'de, müşterilerimizin uygulama işinin tüm sürecini deneyimleyebilirsiniz. iOS'te Firebase ve AdMob'a daha sorunsuz bir şekilde giriş yapmak istiyorsanız AdMob+Firebase 101 Unity: Kurulum ve Analytics ile İlgili Temel Bilgiler.

Neler öğreneceksiniz?

• Unity ve 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 Unity projesi başlatın

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

Unity'yi başlat

1. Açık projeleriniz yoksa "Yeni proje oluştur"u seçin.
2. İletişim kutusundan 3D şablonlar seçin.
3. Proje adını yazın: ör. Unity Firebase Özel Etkinliği.
4. Projenizi kaydetmek için bir Konum seçin ve CREATE'i (OLUŞTUR) 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 Entegrasyonlar sekmesinden Google Analytics'i etkinleştirebilirsiniz > Proje ayarları. Firebase yapılandırması adımına geçin.

1. Firebase'de oturum açın.

Firebase konsolunda Proje Ekle(veya Proje oluştur) seçeneğini tıklayın ve Firebase projenizi Firebase-iOS-Ads olarak adlandırın.

2. Proje oluşturma seçeneklerini tıklayarak ilerleyin. İ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 için Firebase projelerini anlama başlıklı makaleyi inceleyin.

4. Unity yapılandırması

1. Unity'de > Dosya > Derleme Ayarları. Ö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, Derleme Ayarları iletişim kutusunu açın: Dosya > Derleme Ayarları (Platform, iOS olarak ayarlanmadıysa 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ısı alanının değeri, iOS paket kimliğidir (com.yourcompany.yourproject gibi). Bu değeri kopyalayın veya değeri belirleyip 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 GoogleService-Info.plist yapılandırma dosyasını indirme talimatlarını uygulayın
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. Firebase Analytics'i Unity'de yapılandırma

Bu adımda, Unity projenize Firebase SDK'sını 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 iki hedefi aynı anda kaydetmeyi de 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 paket 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 kaydedildikten sonra bu Firebase uygulamaları için değiştirilemez.

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

Firebase Analytics Unity SDK'larını ekleme

1. Firebase konsolunda Firebase Unity SDK'sını İndir'i tıklayın ve ardından SDK'yı uygun bir yerde açın.

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

2. Açık Unity projenizde Assets (Öğeler) > Paketi İçe Aktar > Özel Paket.
3. Sıkıştırılmamış 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. Import Unity Package (Unity Paketini İçe Aktar) penceresinde Import'u (İçe Aktar) tıklayın.
5. Tekrar Firebase konsolunda kurulum iş akışında İleri'yi tıklayın.

Önemli: iOS için Firebase Unity SDK'sı ile yöntem kaydırmayı devre dışı bırakmayın. Kaydırma, SDK tarafından zorunlu tutuluyor; olmadan, temel Firebase özellikleri (ör. FCM jeton işleme) düzgün çalışmaz.

6. Firebase Analytics ile Özel Etkinlikleri 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 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üleyin

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. Otomatik ve manuel olarak kaydedilen etkinlikler de buna dahildir.

Ayrıntılı günlük kaydını aşağıdaki şekilde etkinleştirebilirsiniz:

1. Xcode'da Product > Şema > Şemayı düzenle...
2. Soldaki menüden Çalıştır'ı seçin.
3. Bağımsız değişkenler sekmesini seçin.
4. Lansmanda Aktarılan Bağımsız Bağımsız Değişkenler bölümüne -FIRAnalyticsDebugEnabled değerini ekleyin.

Uygulamanızı bir sonraki çalıştırmanızda, etkinlikleriniz Xcode hata ayıklama konsolunda görüntülenerek etkinliklerin gönderildiğini hemen doğrulamanıza yardımcı olur.

Kontrol panelinde etkinlikleri 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.

"text_search"ü işaretleyeceksiniz "dönüşüm olarak işaretle"yi kaydırarak dönüşüm olarak işaretle sağa geçin.

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şlayın. 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 ve bir Bağlantı düğmesi 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.

Şimdi Firebase kısmı tamamlandı.

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

1. Google Ads'e giriş yapın ve Araçlar ve Ayarlar → Ölçüm → Özel etkinlikleri dönüşüm olarak içe aktarmak için dönüşümler.
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 parametresini 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 uygulamaya ihtiyacınız vardır. Uygulamayı yayınlamaya hazır değilseniz bu adımı şimdilik bırakı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ıp devam edin.
7. Bu tarihte, Uygulama Yüklemeleri seçeneğini içeren 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 hedefi belirleyin ve diğer seçenekleri de doldurun.

11. Kampanya ayarlarını yapılandırın. Bu işlemler codelab'in kapsamı dışındadır. Bu nedenle, bu belgelere göz atın veya ayarları optimize etmek için başka bir kanal üzerinden iletişime geçin.

9. Tebrikler

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

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 ekleyin
• GitHub: firebase/quickstart-unity