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

1. Giriş

Son Güncelleme: 2020-12-14

Ne oluşturacaksınız?

Bu codelab'de, GA4F iOS SDK'sı ile özel etkinlikleri nasıl uygulayacağınızı ve Google Ads üzerinden harekete geçirici mesaj kampanyalarını nasıl başlatacağınızı öğreneceksiniz.

Bu codelab ile müşterilerimizin karşılaştığı uygulama işi sürecinin tamamını deneyimleyebilirsiniz. Firebase iOS'a 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şturursunuz.

Öncelikle Xcode'u başlatın.

1. Açık projeniz yoksa karşılama sayfasından Yeni bir 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çip İleri'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 İleri'yi tıklayın :
5. Ürün adı: ör. ios-app

Xcode, projenize ve uygulamanıza ad vermek için girdiğiniz ürün adını kullanır.

2. Takım: Bu alan otomatik olarak doldurulmazsa takımı 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 kaydetmek için bir konum seçin ve Oluştur'u tıklayın.
7. Xcode, 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.

Firebase projesi oluşturma

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. Firebase yapılandırması

1. Firebase konsolunda, sol gezinme menüsünde Projeye Genel Bakış > Proje Ayarları'nı seçin, ardından Genel > Uygulamalarınız bölümünde iOS düğmesini tıklayın.

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

2. Sağlamanız gereken önemli değer, aşağıdaki adımı kullanarak elde edeceğiniz iOS paket kimliğidir.
3. iOS uygulaması için 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 (örneğin, com.yourcompany.yourproject). Bu değeri 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. Xcode projenize gidin, ardından GoogleService-Info.plist dosyasını (yeni indirdiğiniz) Xcode projenizin kök dizinine taşıyın.
9. Kalan adımları atlayıp Firebase konsolunun ana sayfasına geri dönün.

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

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

Not: Google hizmetleri, bağımlılıkları yüklemek ve yönetmek için CocoaPods'u kullanır. CocoaPods'u daha önce hiç kullanmadıysanız önce terminalinizde şu komutu çalıştırarak 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 şunu ç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. Her şey hazır Konsola geçin.

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

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

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

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

Varsayılan etkinlik parametrelerini ayarlama

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

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

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 günlüğe 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 dönüşüm işlemi olarak ayarlandı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ını 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 ve Google Ads'i başarıyla entegre ettiniz. Bu sayede kampanya performansınızı artırabilirsiniz.

Komut dosyasını yüklediniz, yeni bir codelab değişiklik listesi oluşturup hazırladınız, bekleyen codelab değişiklik listesini güncelleyip hazırladınız, 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 etkinlikler nasıl günlüğe kaydedilir?
• Etkinlikleri içe aktarma ve işlem kampanyalarında kullanma