Facebook Ads

Facebook Ads entegrasyonu sayesinde uygulama istatistiklerinizi Meta Analytics’te kolayca takip edebilirsiniz. Adapty, Meta Ads Manager’a etkinlikler göndererek aboneliklere dayalı benzer kitleler oluşturmanıza ve daha iyi dönüşümler elde etmenize yardımcı olur. Bu sayede reklamlarınızın aboneliklerden ne kadar gelir sağladığını doğru bir şekilde görebilirsiniz.

Adapty ile Facebook Ads arasındaki entegrasyon şu şekilde çalışır: Adapty, entegrasyonunuzda yapılandırılmış tüm abonelik olaylarını Facebook Ads’e gönderir. Bu entegrasyon, reklam kampanyalarınızın etkinliğini değerlendirmek için faydalıdır.

Entegrasyonu kurma

Adapty’yi Facebook Ads’e bağlama

Facebook Ads entegrasyonunu kurmak ve uygulama metriklerinizi analiz etmek için Meta Analytics entegrasyonunu ayarlayabilirsiniz. Meta Ads Manager’a etkinlik göndererek yenileme gibi abonelik etkinliklerine dayalı benzer kitleler oluşturabilirsiniz. Bu entegrasyonu yapılandırmak için Adapty Kontrol Paneli’nde Integrations > Facebook Ads bölümüne gidin ve gerekli kimlik bilgilerini girin.

1. App ID’yi bulmak için App Store Connect’te uygulamanızın sayfasını açın, General bölümündeki App Information sayfasına gidin ve ekranın sol alt kısmında Apple ID’yi bulun.
2. Meta for Developers platformunda bir uygulamanız olması gerekir. Uygulamanıza giriş yapın ve gelişmiş ayarları bulun. App ID’yi üst bilgi kısmında görebilirsiniz.

3. Meta Ads Manager’da gelirin çift sayılmasını önlemek için Meta SDK yapılandırmanızda istemci taraflı izlemeyi devre dışı bırakın. Bu ayarı Meta Developer Console’da App Settings > Advanced Settings altında bulabilirsiniz. Log in-app events automatically seçeneğini “No” olarak ayarlayın. Bu sayede gelir etkinlikleri yalnızca Adapty’nin entegrasyonu üzerinden izlenir.

   Yükleme ve kullanım etkinliklerini izlemek için kodunuzda Meta SDK’yı etkinleştirmeniz gerekir. Platforma göre uygulama ayrıntılarını Meta SDK belgelerinde bulabilirsiniz:

   • iOS SDK
   • Android SDK
   • Unity SDK

Bu entegrasyonu Android uygulamalarıyla da kullanabilirsiniz. App Settings bölümünde Android SDK yapılandırmasını ayarladıysanız yalnızca Facebook App ID’yi girmek yeterlidir.

Olayları ve etiketleri yapılandırın

Adapty, satın alma olaylarını Meta’nın standart olaylarıyla eşleştirir; Meta bu olaylar üzerinden kampanyaları optimize edebilir: StartTrial, Subscribe ve Meta’nın satın alma olayı olan fb_mobile_purchase. Subscription started, Subscription renewed, Trial started ve Trial converted olaylarının her biri, olay alanında seçili olan her ad için ayrı bir Meta olayı gönderir ve varsayılan olarak tüm adlar seçilidir. Örneğin bir deneme başlangıcı, Meta’ya üç ayrı olay olarak iletilir. Daha az olay göndermek istiyorsanız alandaki adları kaldırabilirsiniz.

Meta’nın geri kalan olaylar için standart bir etkinliği yoktur; bu nedenle Adapty bunları kendi Adapty adlarıyla özel olaylar olarak gönderir. Kendi adlandırmanızla eşleştirmek için olayın alanındaki adı değiştirin.

Trial still active ve Subscription still active, sentetik event’lardır: Adapty bunları Meta’ya bir zamanlayıcıyla gönderir; yalnızca deneme süresi veya abonelik, zamanlayıcı sona erdiğinde hâlâ devam ediyorsa iletilir. Gelir içermediklerinden Meta bunları satın alma değerine dahil etmez. Her ikisi de varsayılan olarak kapalıdır. Göndermek için açın ve gecikmeyi ayarlayın.

Uygulamanızı Facebook Ads’e bağlama

Yukarıdaki adımları izlerseniz Facebook, abonelik verilerini Adapty’den otomatik olarak alır.

iOS 14.5’te IDFA’ya yapılan değişikliklerin ardından, kullanıcının facebookAnonymousId bilgisini Facebook’tan istemenizi öneririz. Bu sayede kullanıcının IDFA’sı mevcut olmasa bile entegrasyon çalışmaya devam eder. Bu parametreyi ayarlamak için set user attributes guide iOS, Android, React Native, Flutter ve Unity kılavuzlarını takip edin.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "facebook_anonymous_id", 
        value: AppEvents.shared.anonymousID
    )
} catch {
    // handle the error
}

Adapty.setIntegrationIdentifier(
    "facebook_anonymous_id",
    AppEventsLogger.getAnonymousAppDeviceGUID(context)
) { error ->
    if (error != null) {
        // handle the error
    }
}

try {
  const anonymousId = await AppEventsLogger.getAnonymousID();

  await adapty.setIntegrationIdentifier("facebook_anonymous_id", anonymousId);
} catch (error) {
  // handle `AdaptyError`
}

There is no official SDK for Flutter

anonymousID is not available in the official SDK
https://github.com/facebook/facebook-sdk-for-unity/issues/676

Etkinlik yapısı

Adapty, Graph API aracılığıyla Facebook Ads’e (Meta) etkinlik gönderir. Her etkinlik şu yapıdadır:

{
  "event": "CUSTOM_APP_EVENTS",
  "app_user_id": "user_12345",
  "advertiser_id": "00000000-0000-0000-0000-000000000000",
  "advertiser_tracking_enabled": 1,
  "application_tracking_enabled": 1,
  "custom_events": "[{\"_eventName\":\"Subscribe\",\"_logTime\":1709294400,\"fb_num_items\":1,\"fb_content_type\":\"in_app\",\"fb_content_id\":\"yearly.premium.6999\",\"fb_currency\":\"USD\",\"fb_order_id\":\"GPA.3383...\",\"fb_transaction_id\":\"GPA.3383...\",\"_valueToSum\":9.99}]",
  "extinfo": "[\"i2\",\"com.example.app\",\"1.0.0\",\"100\",\"17.0.1\",\"iPhone14,3\",\"en_US\",\"GMT+3\",\"\",0,0,0,0,0,0,\"GMT+3\"]",
  "anon_id": "facebook_anon_id_123"
}

Parametreler:

custom_events parametresi, Adapty olayının eşlendiği her Meta olayı için bir nesne içeren JSON kodlu bir dizidir. Yalnızca StartTrial, Subscribe ve fb_mobile_purchase olayları fb_content_id, fb_content_type, fb_num_items ve fb_transaction_id alanlarını taşır. Her nesne şunları içerir:

Sorun Giderme

access_level_updated Event Feed’de başarısız olarak görünüyor

access_level_updated yalnızca webhook’a özgü bir event’tir. Adapty bu event’i bu entegrasyona hiçbir zaman göndermez. Ancak Adapty, etkinleştirilmiş her entegrasyon için bir sonuç kaydeder ve desteklenmeyen bir event başarısızlık olarak görüntülenir.