---
title: "Facebook Ads"
description: "Etkili abonelik pazarlaması için Facebook Ads'i Adapty ile entegre edin."
---

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

Adapty ile Facebook Ads entegrasyonu şu şekilde çalışır: Adapty, entegrasyonunuzda yapılandırılan tüm abonelik etkinliklerini Facebook Ads'e gönderir. Bu entegrasyon, reklam kampanyalarınızın etkinliğini değerlendirmek için oldukça kullanışlıdır.

## Entegrasyonu kurma \{#set-up-integration\}

### Adapty'yi Facebook Ads'e bağlama \{#connect-adapty-to-facebook-ads\}

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](https://app.adapty.io/integrations/facebookanalytics) bölümüne gidin ve gerekli kimlik bilgilerini girin.

:::note
Facebook Ads entegrasyonunun yalnızca ATT onayı vermiş kullanıcılar için iOS 14.5 ve üzeri sürümlerde çalıştığını lütfen unutmayın.
:::

  <img src="/assets/shared/img/fd84ddf-CleanShot_2023-08-15_at_15.45.442x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

1. App ID'yi bulmak için [App Store Connect](https://appstoreconnect.apple.com/)'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](https://developers.facebook.com/) 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.

  <img src="/assets/shared/img/4b326c4-001563-August-23-4tO3JVso.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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](https://developers.facebook.com/docs/ios/getting-started)
   - [Android SDK](https://developers.facebook.com/docs/android/getting-started)
   - [Unity SDK](https://developers.facebook.com/docs/unity/getting-started/canvas)

  <img src="/assets/shared/img/c4eb8eb-001565-August-23-483KKBbC.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

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.

### Etkinlikleri ve etiketleri yapılandırma \{#configure-events-and-tags\}

Facebook Ads entegrasyonunun özellikle reklam kampanyaları için Meta kullanan ve bu kampanyaları müşteri davranışlarına göre optimize eden şirketlere yönelik olduğunu lütfen unutmayın. Bu entegrasyon, optimizasyon amacıyla Meta'nın standart etkinliklerini destekler. Dolayısıyla Meta Ads entegrasyonunda etkinlik adını değiştirmek mümkün değildir. Adapty, müşteri etkinliklerinizi doğru analiz için ilgili Meta etkinlikleriyle otomatik olarak eşleştirir.

| Adapty etkinliği              | Meta Ads etkinliği          |
| :---------------------------- | :-------------------------- |
| Subscription initial purchase | Subscribe                   |
| Subscription renewed          | Subscribe                   |
| Subscription cancelled        | CancelSubscription          |
| Trial started                 | StartTrial                  |
| Trial converted               | Subscribe                   |
| Trial cancelled               | CancelTrial                 |
| Non subscription purchase     | fb_mobile_purchase          |
| Billing issue detected        | billing_issue_detected      |
| Entered grace period          | entered_grace_period        |
| Auto renew off                | auto_renew_off              |
| Auto renew on                 | auto_renew_on               |
| Auto renew off subscription   | auto_renew_off_subscription |
| Auto renew on subscription    | auto_renew_on_subscription  |

StartTrial, Subscribe ve CancelSubscription standart etkinliklerdir.

  <img src="/assets/shared/img/8a5df9d-CleanShot_2023-07-04_at_12.47.312x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

Belirli etkinlikleri etkinleştirmek için istediğiniz etkinlikleri açmanız yeterlidir. Birden fazla etkinlik adı seçilmesi durumunda Adapty, seçilen tüm etkinliklerin verilerini tek bir Adapty etkinlik adı altında birleştirir.

### Uygulamanızı Facebook Ads'e bağlama \{#connect-your-app-to-facebook-ads\}

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 <InlineTooltip tooltip="set user attributes guide">[iOS](setting-user-attributes), [Android](android-setting-user-attributes), [React Native](react-native-setting-user-attributes), [Flutter](flutter-setting-user-attributes) ve [Unity](unity-setting-user-attributes)</InlineTooltip> kılavuzlarını takip edin.

<Tabs groupId="current-os" queryString>
<TabItem value="swift" label="iOS (Swift)" default>

```swift showLineNumbers

do {
    try await Adapty.setIntegrationIdentifier(
        key: "facebook_anonymous_id", 
        value: AppEvents.shared.anonymousID
    )
} catch {
    // handle the error
}
```
</TabItem>
<TabItem value="kotlin" label="Android (Kotlin)" default>

```kotlin showLineNumbers
Adapty.setIntegrationIdentifier(
    "facebook_anonymous_id",
    AppEventsLogger.getAnonymousAppDeviceGUID(context)
) { error ->
    if (error != null) {
        // handle the error
    }
}
```
</TabItem>
<TabItem value="rn" label="React Native (TS)" default>

```typescript showLineNumbers

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

  await adapty.setIntegrationIdentifier("facebook_anonymous_id", anonymousId);
} catch (error) {
  // handle `AdaptyError`
}
```
</TabItem>
<TabItem value="flutter" label="Flutter (Dart)" default>

```text
There is no official SDK for Flutter
```
</TabItem>
<TabItem value="unity" label="Unity (C#)" default>

```csharp
anonymousID is not available in the official SDK
https://github.com/facebook/facebook-sdk-for-unity/issues/676
```
</TabItem>
</Tabs>

## Etkinlik yapısı \{#event-structure\}

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

```json
{
  "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:

| Parametre | Tür | Açıklama |
|:---|:---|:---|
| `event` | String | Her zaman "CUSTOM_APP_EVENTS" değerini alır. |
| `app_user_id` | String | Kullanıcının Customer User ID'si. |
| `advertiser_id` | String | IDFA (iOS) veya Advertising ID (Android). |
| `advertiser_tracking_enabled` | Integer | İzleme etkinleştirilmişse (ATT yetkili) `1`, aksi hâlde `0`. |
| `application_tracking_enabled` | Integer | Her zaman `1`. |
| `custom_events` | String | JSON kodlu etkinlik nesneleri dizisi (aşağıya bakın). |
| `extinfo` | String | Uygulama/cihaz bilgilerini içeren JSON kodlu dize (ör. sürüm, işletim sistemi, dil ayarı). |
| `anon_id` | String | Facebook Anonymous ID (mevcutsa). |

`custom_events` parametresi, aşağıdakileri içeren JSON kodlu bir nesneler dizisidir:

| Parametre | Tür | Açıklama |
|:---|:---|:---|
| `_eventName` | String | Meta Ads etkinlik adı (ör. "Subscribe"). |
| `_logTime` | Long | Etkinliğin saniye cinsinden zaman damgası. |
| `_valueToSum` | Float | Gelir tutarı. |
| `fb_content_id` | String | Mağazadaki Ürün ID'si. |
| `fb_currency` | String | Para birimi kodu (ör. "USD"). |
| `fb_order_id` | String | Orijinal işlem ID'si. |
| `fb_transaction_id` | String | Orijinal işlem ID'si. |
| `fb_content_type` | String | Her zaman "in_app". |
| `fb_num_items` | Integer | Satın alma etkinlikleri için her zaman 1. |