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

1. Giriş

Son Güncelleme: 14.12.2020

Oluşturacağınız uygulama

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

Bu codelab aracılığıyla müşterilerimizin uygulama işinin tüm sürecini deneyimleyebilirsiniz. Firebase iOS'e daha kolay bir giriş yapmak istiyorsanız Firebase iOS Codelab Swift ile başlayın.

Neler öğreneceksiniz?

• iOS Swift'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
• Firebase Hesabı
• Google Ads hesabı

2. Yeni bir iOS Swift projesi başlatma

Basit bir şablonlu iOS Swift uygulaması oluşturun. Bu başlangıç uygulamasını değiştirerek tamamlanmış uygulamayı oluşturabilirsiniz.

İlk olarak Xcode'u başlatın.

1. Açık projeniz yoksa karşılama sayfasından Yeni Xcode projesi oluştur'u seçin.
2. İletişim kutusunun üst kısmında iOS'i seçin.
3. Uygulama bölümünde Uygulama'yı seçin ve ardından Sonraki'yi tıklayın.
4. Açılan iletişim kutusunda, uygulamanızı adlandırmak ve projeniz için ek seçenekler belirlemek üzere aşağıdaki değerleri kullanın ve Sonraki'yi tıklayın:
5. Ürün Adı: Ör. ios-app

Xcode, projenizi ve uygulamanızı adlandırmak için girdiğiniz ürün adını kullanır.

2. Ekip: Bu alan otomatik olarak doldurulmazsa ekibi Yok olarak ayarlayın.
3. Kuruluş Adı: Kuruluşunuzun adı veya kendi adınız.
4. Paket Tanımlayıcısı: Bu değer, ürün adınıza ve kuruluş tanımlayıcınıza göre otomatik olarak oluşturulur.
5. Dil: Swift
6. Projenizi kaydedeceğiniz konumu seçin ve Oluştur'u tıklayın.
7. Xcode, yeni projenizi çalışma alanı penceresinde açar.

3. Firebase projesi oluşturup ayarlama

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

Firebase projesi oluşturma

Google Analytics'in etkinleştirilmediği bir Firebase projeniz varsa Google Analytics'i ayarlarınızın Entegrasyonlar sekmesi > Proje ayarları bölümünden 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ı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. Firebase yapılandırması

1. Firebase Konsolu'nda soldaki gezinme bölümünden Projeye Genel Bakış > Proje Ayarları'nı seçin ve ardından Genel > Uygulamalarınız bölümündeki iOS düğmesini tıklayın.

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

2. Sağlanması gereken önemli değer, aşağıdaki adımı izleyerek elde edeceğiniz iOS paket kimliğidir.
3. iOS uygulamasının Xcode projenizde, proje gezgininde en üst düzey uygulamayı ve ardından Genel sekmesini seçin.
4. Paket Tanımlayıcı alanının değeri iOS paket kimliğidir (com.yourcompany.yourproject gibi). Bu değeri kopyalayın.
5. Firebase iletişim kutusunda, kopyalanan paket kimliğini iOS bundle ID alanına yapıştırın.
6. Uygulama Kaydet'i tıklayın.
7. Firebase'de devam ederek yapılandırma dosyasını indirme talimatlarını uygulayın GoogleService-Info.plist

8. Xcode projenize gidin ve yeni indirdiğiniz GoogleService-Info.plist dosyasını Xcode projenizin kök dizinine taşıyın.
9. Kalan adımları atlayıp Firebase konsolunun ana sayfasına geri dönün.

5. Xcode'da Firebase Analytics'i yapılandırma

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

Not: Google hizmetleri, bağımlılıkları yüklemek ve yönetmek için CocoaPods'u kullanır. Daha önce CocoaPods kullanmadıysanız terminalinizde şu komutu çalıştırarak önce yüklemeniz gerekir:

$ sudo gem install cocoapods

1. Bir terminal penceresi açın ve uygulamanıza ait Xcode projesinin konumuna gidin.
2. Henüz yoksa bir Podfile oluşturun:

$ pod init

3. Podfile dosyanızı açın ve şunu ekleyin:

$ vi Podfile

$ pod 'Firebase/Analytics'

4. Dosyayı kaydedin ve çalıştırın :

$ pod install

5. İlk kullanıma hazırlama kodu ekleyin:

Uygulamanız başlatıldığında Firebase'e bağlanmak için aşağıdaki ilk kullanıma hazırlama kodunu ana AppDelegate sınıfınıza ekleyin.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. Artık hazırsınız! Konsola devam et.

Artık bazı özel etkinlik günlüklerini tetiklemeye hazırsınız!

6. Firebase Analytics ile Özel Etkinlikleri Kaydetme

Bu adımda, iOS uygulamasında Firebase Analytics ile özel etkinliklerin nasıl kaydedileceğini öğ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.

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Varsayılan etkinlik parametrelerini ayarlama

setDefaultEventParameters'ı kullanarak parametreleri etkinliklere kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilen gelecekteki tüm etkinliklerle ilişkilendirilir.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

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

Etkinliklerin doğru şekilde günlüğe kaydedildiğini doğrulamak için SDK'nın etkinlikleri günlüğe kaydetmesini izlemek üzere ayrıntılı günlüğe kaydetme özelliğini etkinleştirebilirsiniz. Otomatik ve manuel olarak kaydedilen etkinlikler de buna dahildir.

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. Soldaki 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. Google Ads'de analiz etkinliklerini iç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'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.

Firebase bölümü 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 dönüşüm işlemi olarak ayarlandıktan sonra, text_search etkinliklerini tetikleyebilecek kullanıcıları hedefleyen bir kampanya başlatmanın tam zamanı.

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 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 ve Google Ads'i başarıyla entegre ettiniz. Bu, kampanyanızın performansını artırmanıza yardımcı olacaktır.

Komut dosyasını yüklediniz, yeni bir codelab değişiklik listesi oluşturup sahnelediniz, bekleyen codelab değişiklik listesini güncelleyip sahnelediniz, codelab değişiklik listesini inceleyip onayladınız ve codelab değişiklik listesini gönderip yayınladınız.

Öğrendikleriniz

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