Facebook Adsアプリ内イベントマッピング

概要:アプリのアプリ内リッチイベントをAppsFlyerからFacebook Adsへ送信します。

Facebookアプリ内イベントマッピング

SDKまたはS2S経由のアプリ内イベントをFacebookの既定イベントにマッピングしてください。広告主は、アプリ起動またはアプリのアンインストールに関するポストバックをFacebook側に送信することもできます。

これにより、広告主はFacebookの高度な最適化機能を利用したり、カスタムおよび類似オーディエンスセグメントを構築できます。

規定イベントのマッピング

Facebookはすでに定義されておりマッピング可能な幅広いイベントを提供しています。

こちらにて、イベントの質に関する追加情報を含むパラメーターと一緒に Facebookに送信できるリッチアプリ内イベントの一覧をご覧ください。

なお、Facebook Adsにアンインストールを送信するための事前定義されたイベントはありません。アンインストールを送信するには、カスタムイベントを使用してください。

fb-events.png

以下は、追加のパラメーターを持たない、他の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 に送信されません。