概要：アプリのアプリ内リッチイベントをAppsFlyerからFacebook Adsへ送信します。
Facebookアプリ内イベントマッピング
SDKまたはS2S経由のアプリ内イベントをFacebookの既定イベントにマッピングしてください。広告主は、アプリ起動またはアプリのアンインストールに関するポストバックをFacebook側に送信することもできます。
これにより、広告主はFacebookの高度な最適化機能を利用したり、カスタムおよび類似オーディエンスセグメントを構築できます。
規定イベントのマッピング
Facebookはすでに定義されておりマッピング可能な幅広いイベントを提供しています。
こちらにて、イベントの質に関する追加情報を含むパラメーターと一緒に Facebookに送信できるリッチアプリ内イベントの一覧をご覧ください。
なお、Facebook Adsにアンインストールを送信するための事前定義されたイベントはありません。アンインストールを送信するには、カスタムイベントを使用してください。
以下は、追加のパラメーターを持たない、他のFacebook 規定イベントの一覧です：
| Facebookイベント識別子 |
説明 |
AppsFlyer SDK上で推奨されるイベント名 |
|---|---|---|
| Donate |
団体または活動への資金の寄付。 |
af_donate |
| Schedule |
いずれかのロケーションを訪問するための予約。 |
af_schedule |
| SubmitApplication |
クレジットカード、教育プログラム、仕事など、提供する製品、サービスまたはプログラムへの申込みの提出。 |
af_submit_application |
| FindLocation |
訪問する意図を持って、ウェブまたはアプリを介していずれかのロケーションを見つけた場合。例えば、製品を検索し、ローカル店舗でその製品を見つけた場合。 |
af_find_location |
| Contact |
電話またはSMS、メール、チャットなど、またはその他の顧客とビジネス間の連絡手段。 |
af_contact |
| CustomizeProduct |
ビジネスが所有する設定ツールやアプリケーションを介する製品のカスタマイズ。 |
af_customize_product |
カスタムアプリ内イベントマップ
AppsFlyerでは、CUSTOM Facebookイベント識別子オプションを使うことで、どんなカスタムアプリ内イベントもFacebookに送信することができます。
SDKで定義されたイベント名とイベント値（イベントパラメーターを含む）は、そのままFacebookに転送され、「custom」ではなく、AppsFlyer SDKのイベント名がそのまま表示されます。
これらのイベントを使用してキャペーンを最適化することができます。
カスタムイベントによる自動パラメーターマッピング
AppsFlyerとFacebookの緊密な連携により、AppsFlyerの標準SDKイベントパラメーターの多くは、自動でFacebookの規定パラメーターに紐づけされます。例えば、 af_revenue パラメーターは Facebookの _valueToSum パラメーターに変換され、イベントごとの収益値を送信し、Facebook上で測定および最適化に利用することができます。
注記
自動パラメーターマッピングは、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イベントを介してFacebookにマッピングされると、Facebookのパラメーターに自動的にマップされます。
| AppsFlyerのパラメーター | Facebookのパラメーター |
|---|---|
| af_city | fb_city |
| af_class | fb_travel_class |
| 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 |
イベントとパラメーターの制限
Facebook Adsに送信するイベントに次の制限が適用されます。
-
次の文字は使用できません：
- コロン (:)
- ピリオド (.)
- ラテン文字（英語）以外の文字：2020年1月12日から、Facebookは漢字のサポートを停止しています。AppsFlyerでは、他の言語について検証をしていませんので、これらの文字がポストバックでサポートされているか、事前にFacebookに確認してから使用してください。
- イベント名は大文字小文字を区別します。乖離を避けるために、全てのメディアソースとアプリバージョンで、イベント名の大文字小文字が正しく統一されていることを確認してください。
- パラメーターの上限数：25
- イベント名とパラメーターの長さ：2–40
- パラメーター最長：100文字
- 許可される文字：英数字、アンダースコア、ハイフン、またはスペース。ラテン語（英語）以外の文字は使用しないでください。ラテン文字以外の文字を使用すると、一貫性のない結果が表示されます。
アプリ内イベントの命名に関する注意点：
- AppsFlyerのイベント名はFacebookのイベント名と同じ名前を付けることができますが（例：fb_price）、これらのイベントはCUSTOMイベントとしてFacebook側に送信しないでください。
このミスを防ぐため、Facebookのイベント名と同じイベント名をSDKで定義するのは避けてください。 - Facebookでアプリ内イベントのポストバックマッピングを行うためには、オーガニックを含むすべての媒体からイベントデータを取得する必要があります。
重要！
上記のパラメーターを除いて、AppsFlyerはCUSTOMイベントデータをそのまま Facebookに送信します。アプリ所有者の責任で、イベントのデータがFacebookの要件に合っているかを確認してください。
イベント値に、有効な Facebook パラメーターにマッピングされていないパラメーターが含まれている場合（上記の表を参照）、これらのパラメーターは Facebook に送信されません。