Meta広告へのアプリ内イベントのマッピング

広告主は、SDKまたはサーバー間（S2S）で送信するアプリ内イベントを、Metaの定義済みイベントにマッピングします。また、アプリの起動ごと、または検知されたアプリのアンインストールについても、Metaにポストバックを送信できます。

これにより、Metaの高度な最適化機能を利用し、カスタムオーディエンスや類似オーディエンスのセグメントを作成できます。

定義済みイベントのマッピング

Meta広告には、マッピングに使用できるさまざまな定義済みイベントが用意されています。

詳細なアプリ内イベントの一覧は、こちらを参照してください。追加パラメータとともにMetaに送信することで、イベントの質に関する詳細情報を提供できます。

詳細は、Meta広告へのイベントのマッピングを参照してください。 

Meta広告には、アンインストール送信用の定義済みイベントはありません。アンインストールを送信するには、カスタムイベントを使用してください。

以下は、追加パラメータのない、その他のMetaの定義済みイベントの一覧です。

キャンペーン最適化のための広告収益データのマッピング

Meta広告では、広告収益データに基づいてキャンペーンを最適化できます。そのためには、af_ad_revenueイベントを以下のMeta広告イベントにマッピングします。

利用上の制限

• 現在、Adimpressionイベントを使用した最適化は、以下の場合にのみ利用できます。
  • Androidアプリ。 iOSアプリでは、引き続きfb_mobile_purchaseイベントを使用して広告収益データを送信できます。
  • Metaの基準に基づいて選ばれたMeta広告アカウント。グレーアウトしている場合は、利用要件を満たしていない可能性があります。
• af_ad_revenueイベントは、ROI360のアドバンスプランを契約している場合にのみ利用できます。また、SDK経由のインプレッションレベルの広告収益連携が必要です。
  • ROI360以外のプランでは、他のイベント名を使用して広告収益データを送信できます。

カスタムアプリ内イベントのマッピング

Metaのイベント識別子としてCUSTOMを選択すると、任意のカスタムアプリ内イベントをマッピングし、Metaに送信できます。

SDKで設定したイベント名とイベント値（イベントパラメータを含む）はそのままMetaに転送され、「custom」ではなく、元のAppsFlyer SDKのイベント名で表示されます。

これらのイベントをキャンペーンの最適化に利用することもできます。

カスタムイベントでのパラメータの自動マッピング

AppsFlyerとMetaの緊密な連携により、AppsFlyer SDKの標準イベントパラメータの多くは、Metaの定義済みパラメータに自動的にマッピングされます。たとえば、af_revenueパラメータはMetaの_valueToSumパラメータに変換されます。これにより、イベントごとの収益を送信し、Metaで計測や最適化に利用できます。

以下の表は、CUSTOMイベントを介してMetaにマッピングした際に、Metaのパラメータに自動的にマッピングされるAppsFlyerのイベントパラメータをすべて示しています。

定義済みイベントの_valueToSumパラメータへの自動マッピング

定義済みイベントでは、Metaの_valueToSumパラメータはaf_priceまたはaf_revenueのいずれかにマッピングされます。

以下の表は、_valueToSumパラメータを持つすべてのMetaの定義済みイベントについて、マッピングの対応関係を示しています。

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

イベントとパラメータの制限

Meta広告に送信するイベントには、以下の制限が適用されます。

• 以下の文字は使用できません。
  • コロン（:）
  • ピリオド（.）
  • ラテン文字（英字）以外の文字：2020年1月12日時点で、Metaは中国語の文字を拒否します。 AppsFlyerでは他の文字種をテストしていません。使用する場合は、ポストバックでの対応可否をMetaに確認してください。
• イベント名は大文字と小文字を区別します。乖離を避けるため、すべてのメディアソースとアプリバージョンで、イベント名の大文字と小文字を正しく使い分けてください。
• パラメータ数の上限：25個。
• イベント名とパラメータ名の長さ：2～40文字。
• パラメータ値の長さの上限：100文字。
• af_contentパラメータ値の長さの上限：1,000文字。
• 使用可能な文字：英数字、アンダースコア、ハイフン、スペース。ラテン文字（英字）以外の文字は使用しないでください。ラテン文字以外の文字を使用すると、処理結果が一貫しなくなります。

アプリ内イベント名に関する注意事項：

• AppsFlyerのイベントにはMetaのイベント名と同じ名前（例：fb_price）を付けることもできますが、その場合はMetaにCUSTOMイベントとして送信しないでください。
  問題を避けるため、Metaのイベント名と同じ名前を付けることは控えてください。
• Metaへのアプリ内イベントポストバックをマッピングするには、オーガニックを含むすべての流入元のイベントデータを取得してください。