Facebook Ads

Facebook Ads インテグレーションを使用すると、Meta Analytics でアプリの統計を簡単に確認できます。Adapty は Meta Ads Manager にイベントを送信し、サブスクリプションに基づいた類似オーディエンスを作成して広告効果を高めるのに役立ちます。これにより、サブスクリプションから広告がどれだけの収益を生み出しているかを正確に把握できます。

Adapty と Facebook Ads の連携は次のように機能します。Adapty は、連携で設定されたすべてのサブスクリプションイベントを Facebook Ads に送信します。この連携は、広告キャンペーンの効果を評価するのに役立ちます。

連携のセットアップ

AdaptyをFacebook Adsに接続する

Facebook Adsと連携してアプリの指標を分析するには、Meta Analyticsとの連携をセットアップします。Meta Ads Managerにイベントを送信することで、更新などのサブスクリプションイベントを基に類似オーディエンスを作成できます。この連携を設定するには、Adapty ダッシュボードの Integrations > Facebook Ads に移動し、必要な認証情報を入力してください。

1. App IDを確認するには、App Store Connect でアプリのページを開き、General セクションの App Information ページに移動して、画面左下の Apple ID を確認します。
2. Meta for Developers プラットフォームでアプリケーションが必要です。アプリにログインして詳細設定を開くと、ヘッダーに App ID が表示されます。

3. Meta Ads Managerでの収益の二重カウントを防ぐため、Meta SDKの設定でクライアントサイドのトラッキングを無効にしてください。この設定は、Meta Developer Consoleの App Settings > Advanced Settings にあります。Log in-app events automatically を「No」に設定してください。これにより、収益イベントはAdaptyの連携経由でのみトラッキングされます。

   インストールや使用状況のイベントをトラッキングするには、コード内でMeta SDKを有効化する必要があります。各プラットフォームのMeta SDKドキュメントで実装の詳細を確認できます：

   • iOS SDK
   • Android SDK
   • Unity SDK

この連携はAndroidアプリでも利用できます。App Settings でAndroid SDKの設定を行っている場合は、Facebook App ID を設定するだけで十分です。

イベントとタグの設定

AdaptyはサブスクリプションのイベントをMetaの標準イベント（StartTrial、Subscribe、fb_mobile_purchase）にマッピングします。これらはMetaがキャンペーンの最適化に使用するイベントです。Subscription started、Subscription renewed、Trial started、Trial converted はそれぞれ、イベントのフィールドで選択された名前ごとに1つのMetaイベントを送信します。デフォルトではすべての名前が選択されています。たとえばトライアル開始は、3つのイベントとしてMetaに届きます。送信数を減らすには、フィールドから名前を削除してください。

Metaには残りのイベントに対応する標準イベントがないため、AdaptyはこれらをAdaptyの名前でカスタムイベントとして送信します。独自の命名規則に合わせる場合は、イベントのフィールドで名前を変更してください。

Trial still active と Subscription still active は合成イベントです。Adapty はタイマーに基づいてこれらを Meta に送信しますが、タイマーが切れた時点でトライアルまたはサブスクリプションがまだ有効な場合のみ送信されます。これらは収益を含まないため、Meta は購入金額としてカウントしません。どちらもデフォルトでは無効です。送信するには、有効にして遅延を設定してください。

アプリをFacebook Adsに接続する

上記の手順を完了すると、FacebookはAdaptyからサブスクリプションデータを自動的に受信します。

iOS 14.5でのIDFAの変更を受け、ユーザーのfacebookAnonymousIdをFacebookからリクエストすることをお勧めします。これにより、ユーザーのIDFAが取得できない場合でも連携が継続して機能します。このパラメーターを設定するには、 ユーザー属性設定ガイド iOS、Android、React Native、Flutter、Unity をご参照ください。

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

イベント構造

AdaptyはGraph API経由でFacebook Ads（Meta）にイベントを送信します。各イベントは次のような構造になっています：

{
  "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"
}

各パラメーターの説明：

custom_events パラメータは、Adapty イベントが対応する各 Meta イベントを表すオブジェクトを含む JSON エンコードされた配列です。StartTrial、Subscribe、fb_mobile_purchase のみが fb_content_id、fb_content_type、fb_num_items、fb_transaction_id を持ちます。各オブジェクトには以下が含まれます：

トラブルシューティング

access_level_updated がイベントフィードで失敗と表示される

access_level_updated は webhook 専用イベントです。Adapty はこのインテグレーションにこのイベントを送信しません。ただし、Adapty は有効なすべてのインテグレーションに対して結果を記録するため、サポートされていないイベントは失敗として表示されます。