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

1. Giriş

Son Güncelleme: 14.12.2020

Oluşturacaklarınız

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

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

Neler öğreneceksiniz?

• iOS Swift'te GA4F'yi (Firebase için Google Analytics) başlatma
• Özel etkinlik 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 projeleriniz yoksa karşılama sayfasında Yeni bir Xcode projesi oluşturun '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ıza ad vermek için aşağıdaki değerleri kullanın, projeniz için ek seçenekler belirleyin ve Sonraki 'yi tıklayın :
5. Ürün Adı: ör. ios-uygulaması

Xcode, projenizi ve uygulamayı 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ı: 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 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. Firebase yapılandırması

1. Firebase Konsolu'nda Projeye Genel Bakış > Sol gezinme bölmesindeki Proje Ayarları'nı, ardından Genel > altındaki iOS düğmesini tıklayın Uygulamalarınız

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

2. Sağlanması gereken önemli değer, aşağıdaki adımı izleyerek elde edeceğiniz iOS paket kimliğidir.
3. iOS uygulamasına ilişkin Xcode projenizde, proje gezgininden üst düzey uygulamayı ve ardından Genel sekmesini seçin.
4. Paket Tanımlayıcısı 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. 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. Xcode Projenize gidin, ardından yeni indirdiğiniz GoogleService-Info.plist dosyasını Xcode projenizin köküne taşıyın.
9. Kalan adımları atlayın ve Firebase konsolunun ana sayfasına 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 öncelikle terminalinizde aşağıdaki komutu çalıştırarak yüklemeniz gerekir:

$ sudo gem install cocoapods

1. Bir terminal penceresi açın ve uygulamanızın 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. Başlatma 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 alanını kullanarak parametreleri etkinlikler arasında günlüğe kaydedebilirsiniz. Varsayılan parametreler, günlüğe kaydedilecek tüm gelecekteki etkinliklerle ilişkilendirilir.

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

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. 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 dönüşüm işlemi olarak ayarlandıktan sonra, text_search etkinliklerini tetikleyebilecek 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 ile 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 hazırladınız, beklemedeki codelab değişiklik listesini güncelleyip hazırladınız, codelab değişiklik listesini inceleyip onayladıktan ve codelab değişiklik listesini gönderip yayınladınız.

Neler öğrendiniz?

• 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.