概要: リッチアプリ内イベントをAppsFlyerからMeta広告に送信する方法を説明します。
Metaアプリ内イベントマッピング
広告主は、アプリ内イベント(SDKまたはサーバー間)をMetaの事前定義されたイベントにマッピングします。広告主は、アプリ起動またはアプリのアンインストールに紐づくポストバックをMeta側に送信することもできます。
これにより、広告主はMetaの高度な最適化機能を利用したり、カスタムおよび類似オーディエンスセグメントを構築できます。
規定イベントのマッピング
Meta広告には、事前定義済みでマッピング可能な さまざまなイベント が用意されています。
こちらにて、イベントの質に関する追加情報を含むパラメーターと一緒に Metaに送信できるリッチアプリ内イベントの一覧をご覧ください。
なお、Meta広告にアンインストールを送信するための事前定義されたイベントはありません。アンインストールを送信するには、カスタムイベントを使用してください。
以下は、追加のパラメーターを持たない、他のMeta 規定イベントの一覧です:
| Metaイベント識別子 | 説明 | AppsFlyer SDK上で推奨されるイベント名 |
|---|---|---|
| Donate | 団体または活動への資金の寄付。 | af_donate |
| Schedule | いずれかのロケーションを訪問するための予約。 | af_schedule |
| SubmitApplication | クレジットカード、教育プログラム、仕事など、提供する製品、サービスまたはプログラムへの申込みの提出。 | af_submit_application |
| FindLocation | 訪問する意図を持って、ウェブまたはアプリを介していずれかのロケーションを見つけた場合。例えば、製品を検索し、ローカル店舗でその製品を見つけた場合。 | af_find_location |
| Contact | 電話またはSMS、メール、チャットなど、またはその他の顧客とビジネス間の連絡手段。 | af_contact |
| CustomizeProduct | ビジネスが所有する設定ツールやアプリケーションを介する製品のカスタマイズ。 | af_customize_product |
Adimpression—for AndroidFb_mobile_purchase—for iOS |
Optimizes ad revenue on the Meta ads platform. See details below. | af_ad_revenue |
Mapping ad revenue data for campaign optimization
Meta ads can optimize your campaigns based on your ad revenue data. This is done by mapping the af_ad_revenue event to the following Meta ads event:
| Event name in AppsFlyer | Platform | Mapped to partner event | Meta ads optimization based on: |
|---|---|---|---|
|
af_ad_revenue |
Android | Adimpression | Specific ad revenue |
| iOS | fb_mobile_purchase | In-app purchases |
Availability limitations
- Currently, optimization via the Adimpression event is available only for:
- Android apps. iOS apps can continue sending ad revenue data using the fb_mobile_purchase event.
- Selected Meta ads accounts, as per Meta's criteria. When grayed out, eligibility criteria may not be met.
- The af_ad_revenue event is available for plans with an ROI360 advanced subscription only. Additionally, you need the impression-level via SDK ad revenue integration type.
- Non-ROI360 plans can send ad revenue data using other event names.
カスタムアプリ内イベントマップ
AppsFlyerでは、CUSTOMパートナーイベント識別子オプションを使用することで、カスタムアプリ内イベントをMetaにマッピングすることができます。
SDKで定義されたイベント名とイベント値(イベントパラメーターを含む)は、そのままMetaに転送され、「custom」ではなく、AppsFlyer SDKのイベント名がそのまま表示されます。
これらのイベントを使用してキャペーンを最適化することができます。
カスタムイベントによる自動パラメーターマッピング
AppsFlyerとMetaの緊密な連携により、AppsFlyerの標準SDKイベントパラメータの多くは、自動でMetaの規定パラメータに紐づけされます。たとえば、 af_revenue パラメータはMetaの _valueToSum パラメータに変換され、Metaで測定および最適化できるイベントあたりの収益を送信できます。
注記
自動パラメーターマッピングは、CUSTOMイベントと 定義済みイベントでは異なる場合があります。
事前定義されたイベントの場合、 af_price は _valueToSum にマッピングされる場合もあります(例えば、fb_mobile_add_to_cartの場合)。それ以外の場合、af_revenue は _valueToSum にマッピングされます(例えば、 fb_mobile_purchase の場合)。
CUSTOMにマッピングされたイベントの場合、常に af_price は fb_priceに、af_revenueは valueToSum にマッピングされます。
次の表は、全てのAppsFlyerイベントパラメーターの詳細を示しています。 CUSTOMイベントを介してMetaにマッピングされると、Metaのパラメーターに自動的にマッピングされます。
| AppsFlyerのパラメーター | Metaパラメータ |
|---|---|
| af_city | fb_city |
| af_class | fb_travel_class |
| af_content | fb_content |
| af_content_id | fb_content_id |
| af_content_list | fb_content_id |
| af_content_type | fb_content_type |
| af_country | fb_country |
| af_currency | fb_currency |
| af_date_a | fb_checkin_date |
| af_date_b | fb_checkout_date |
| af_departing_arrival_date | fb_departing_arrival_date |
| af_departing_departure_date | fb_departing_departure_date |
| af_description | fb_description |
| af_destination_a | fb_origin_airport |
| af_destination_b | fb_destination_airport |
| af_destination_list | fb_destination_ids |
| af_hotel_score | fb_hotel_score |
| af_level | fb_level |
| af_max_rating_value | fb_max_rating_value |
| af_num_adults | fb_num_adults |
| af_num_children | fb_num_children |
| af_num_infants | fb_num_infants |
| af_order_id | fb_order_id |
| af_payment_info_available | fb_payment_info_available |
| af_preferred_neighborhoods | fb_preferred_neighborhoods |
| af_preferred_num_stops | fb_preferred_num_stops |
| af_preferred_price_range | fb_preferred_price_range |
| af_preferred_star_ratings | fb_preferred_star_ratings |
| af_price | fb_price |
| af_quantity | fb_num_items |
| af_region | fb_region |
| af_registration_method | fb_registration_method |
| af_returning_arrival_date | fb_returning_arrival_date |
| af_returning_departure_date | fb_returning_departure_date |
| af_revenue | _valueToSum |
| af_search_string | fb_search_string |
| af_success | fb_success |
| af_suggested_destinations | fb_suggested_destinations |
| af_suggested_hotels | fb_suggested_hotels |
| af_travel_end | fb_travel_end |
| af_travel_start | fb_travel_start |
| af_user_score | fb_user_score |
Predefined events automatic mapping to the _valueToSum parameter
For predefined events, the Meta parameter _valueToSum is mapped either to the af_price or to the af_revenue parameters.
The following table details this mapping for all predefined Meta events with the _valueToSum parameter:
| Meta event | _valueToSum mapped to |
|---|---|
| fb_mobile_level_achieved | none |
| fb_mobile_add_payment_info | none |
| fb_mobile_add_to_cart | af_price |
| fb_mobile_add_to_wishlist | af_price |
| fb_mobile_complete_registration | none |
| fb_mobile_tutorial_completion | none |
| fb_mobile_initiated_checkout | af_price |
| fb_mobile_purchase | af_revenue |
| fb_mobile_rate | af_rating_value |
| fb_mobile_search | af_revenue |
| fb_mobile_spent_credits | af_price |
| fb_mobile_achievement_unlocked | none |
| fb_mobile_content_view | af_price |
| StartTrial | af_price |
| Subscribe | af_revenue |
Send complex in-app events to Meta ads
As of September 2026, we recommend using the new af_order_info object to send complex in-app events – events with multiple items – to Meta Ads. This object lets advertisers share complex in-app events with multiple supported networks. For more information, see Item-level order data for ad networks (af_order_info).
When you use af_order_info, AppsFlyer sends the item information to Meta under the fb_contents event field, which supports SKU, quantity, and revenue per item.
As an alternative, you can still use a structured af_content array. Each object in the array must include id and quantity to ensure proper postback handling.
af_content_list is optional. When it is absent, Meta falls back to the fb_content field (mapped from af_content) to identify product IDs. As long as the af_content JSON includes an id field in each object, Meta can parse and extract content IDs from it.
If you do include af_content_list, do not also include af_content_id in the same event. Both parameters map to fb_content_id, and only one should be populated to prevent conflicts.
Note
fb_content_id is important for product-level use cases such as matching events to catalog items for Advantage+ Catalog Ads and Dynamic Ads, product-level performance reporting, and product-based optimization signals. For general conversion optimization based on event count and value, campaigns work without it.
Example, unified format compatible with Meta and TikTok
{
"af_revenue": 4.99,
"af_currency": "USD",
"af_order_id": "12345",
"af_content": "[{\"id\":\"ID1\",\"quantity\":\"1\"},{\"id\":\"ID2\",\"quantity\":\"1\"},{\"id\":\"ID3\",\"quantity\":\"2\"}]"
}
This format works for both Meta and TikTok. TikTok also reads id values from the af_content field, so a single payload is sufficient when postbacking to both networks.
ピリオド (.)
If the af_content parameter exceeds 1,000 characters, AppsFlyer may send the event to Meta without the fb_content parameter. If af_content_list is also absent in that scenario, Meta receives no product identification data. Keep af_content under 1,000 characters for events that include many items.
For more details about structuring complex in-app events, see the In-app events: Overview article.
イベントとパラメーターの制限
Meta広告に送信するイベントには、以下の制限が適用されます。
- 次の文字は使用できません:
- コロン (:)
- Period (.)
- ラテン語(英語)以外の文字列: 2020年1月12日以降、Meta広告では日本語の利用が拒否されています。 AppsFlyerは他の文字セットをテストしていないため、ポストバックでこれらの文字セットをサポートしているかどうかは、Meta広告で確認した後にのみ使用してください。
- イベント名は大文字小文字を区別します。乖離を避けるために、全てのメディアソースとアプリバージョンで、イベント名の大文字小文字が正しく統一されていることを確認してください。
- パラメーターの上限数:25
- イベント名とパラメーターの長さ:2–40
- パラメーター最長:100文字
- Maximum parameter length for the af_content parameter: 1000 characters.
- 許可される文字:英数字、アンダースコア、ハイフン、またはスペース。ラテン語(英語)以外の文字は使用しないでください。ラテン文字以外の文字を使用すると、一貫性のない結果が表示されます。
アプリ内イベントの命名に関する注意点:
- AppsFlyerのイベント名には、 Meta のイベント名と同じ名前 (fb_priceなど) を付けることができますが、カスタムイベントとして Metaに送信しないでください。
念のため、イベントに Metaイベント名と同じ名前を付けるのは控えてください。 - Metaでアプリ内イベントのポストバックマッピングを行うためには、オーガニックを含むすべての媒体からイベントデータを取得する必要があります。
重要!
上記のパラメータを除き、AppsFlyerはカスタムイベントデータをそのままMetaに送信します。アプリの所有者は、有効なMetaパラメータを使用して、イベントデータがMetaの要件に従っていることを確認する責任があります(上の表を参照)。それ以外の場合、これらのパラメータは Metaに送信されません。