When picking your bid type, you can choose to have your campaign optimize for installs by selecting App Installsas your optimization method. This is the recommended approach if your goal is to maximize the reach of your application and your main criterion is reduced cost per new customer installation.
Not recommended. This option is provided as a fallback for small-scale advertisers who haven't installed the Facebook SDK. It is recommended that you install the SDK and use one of the more powerful optimization techniques.
App event optimization is the ability to display mobile app install ads to people likely to take a specific action in your app. The value of using app event optimization is that, beyond new installations for your app, you will also acquire people who are likely to take a specific action that is of value to your app or business. For example, if you are looking to acquire people most likely to make a purchase in your app, you can choose to run mobile app install ads that would optimize for the purchasesevent.
To use this feature, you must have app events enabled.
This feature is charged on an impression basis, similar to how you are charged when you optimize for installs. The difference is that your ads reach people most likely to take the action you specify, not just the ones most likely to install your app.
You can use this feature in the Ads Manager tool or via the API . In the Ads Manager, for Optimization for Ad Delivery, choose App Eventsand then choose an event from the App Eventslist. For details, see available app events .
You can optimize for any of the app events in the table that follows.
These are the only standard events supported. Other standard events are not supported.
Achieve Level
Log this event when a person achieves specific levels you define within your application, business, or organization.
Add Payment Info
Log this event during the addition of customer payment information during a checkout process.
Recommended Parameters
content_category
content_ids
contents
currency
value
Add to Cart
Log this event during the addition of an item to a shopping cart or basket (example: clicking an Add to Cartbutton on a website).
Recommended Parameters
content_ids
*content_name
content_type
*contents
*currency
value
*Required parameters for Advantage+ catalog ads .
Add to Wishlist
Log this event during the addition of items to a wishlist (example: clicking an Add to Wishlistbutton on a website).
Recommended Parameters
contentData
contentId
contentType
currency
Complete Registration
Log this event during the submission of information in exchange for a service provided by your business (example: sign up for email subscription).
Recommended Parameters
content_name
currency
status
value
Content View
Log this event during a telephone/SMS, email, chat, or other type of content between a customer and your business.
Initiate Checkout
Log this event at the start of a checkout process.
Recommended Parameters
content_category
content_ids
contents
currency
num_items
value
Purchase
Log this event during the completion of a purchase, usually signified by receiving order/purchase confirmation or a transaction receipt
If you use Facebook to manage your in-app purchases, the purchase events are automatically logged.
Required Parameters
currency
value
Recommended Parameters
content_ids
*content_name
content_type
*contents
*num_items
*Required for Advantage+ catalog ads
Rate
Log this event during a rating of something within your app, business, or organization (example: rates a restaurant within a restaurant review app).
Search
Log this event during a search performed on your website, app or other property (example: product searches, travel searches).
Recommended Parameters
content_category
content_ids
contents
currency
search_string
value
Spend Credits
Log this event during the completion of a transaction where people spend credits (example: in-app currency) specific to your business or application.
Start Trial
Log this event at the start of a free trial of a product or service you offer (example: trial subscription).
Recommended Parameters
currency
predicted_ltv
value
Subscribe
Log this event at the start of a paid subscription for a product or service you offer.
Recommended Parameters
currency
predicted_ltv
value
Tutorial Completion
Log this event during the completion of a tutorial.
Unlocked Achievement
Log this event during the completion of specific activities or actions you want to reward within your application, business or organization (refer a friend, complete your profile, etc.).
Optimize Mobile App Install campaigns for AppEvent by specifying OFFSITE_CONVERSIONS
as an option. Ads will be delivered to people most likely to take actions such as purchasing products in your app after app install:
OFFSITE_CONVERSIONS
IMPRESSIONS
custom_event_type
in the promoted object to the app event you want to optimize. You can only optimize on one app event at a time. Note that in addition to standard app events, custom events are also available.Possible values for the custom_event_type
in the Promoted Object are:
COMPLETE_REGISTRATION
CONTENT_VIEW
SEARCH
RATE
TUTORIAL_COMPLETION
ADD_TO_CART
ADD_TO_WISHLIST
INITIATED_CHECKOUT
ADD_PAYMENT_INFO
PURCHASE
LEAD
LEVEL_ACHIEVED
ACHIEVEMENT_UNLOCKED
SPENT_CREDITS
Example:
curl -F "name=App Event Optimization Example" -F "status=PAUSED" -F "optimization_goal=OFFSITE_CONVERSIONS" -F "billing_event=IMPRESSIONS" -F "promoted_object={'application_id': {app_id}, 'object_store_url': '{appstore_url}', 'custom_event_type': 'PURCHASE'}" -F "bid_amount=100" -F "daily_budget=300" -F "campaign_id={campaign_id}" -F "targeting={'geo_locations':{'countries':['US','GB']}, 'page_types':['mobilefeed'], 'user_os':['ios']}" -F "access_token={access_token}" "https://graph.facebook.com/<API_VERSION>/act_{act_id}/adset
You can now use custom events for app event optimization. If you already matched your custom app event to a standard app event, we recommend that you optimize directly for your custom event instead of the matched standard event. Learn more best practices for app event optimization.
Make sure your events adhere to Facebook’s Business Tools Terms requirements and data policies. To comply with our Facebook Business Tools Terms and help protect your users’ privacy, don't share sensitive user data with us when setting up events. Learn more about sensitive data .
To use App Event optimization with custom events, ensure your mobile app SDK implementation is sending valid custom events and your Ad Set has an optimization goal of OFFSITE_CONVERSIONS
. While creating your ads, ensure to state the following:
OFFSITE_CONVERSIONS
IMPRESSIONS
custom_event_type
to OTHER
and custom_event_str
to the name of the custom eventFor example:
curl -F "name=Custom Event Optimization Example" -F "status=PAUSED" -F "optimization_goal=OFFSITE_CONVERSIONS" -F "billing_event=IMPRESSIONS" -F "promoted_object={'application_id': {app_id}, 'object_store_url': '{appstore_url}', 'custom_event_type': 'OTHER', 'custom_event_str': {valid_custom_event}}" -F "bid_amount=100" -F "daily_budget=300" -F "campaign_id={campaign_id}" -F "targeting={'geo_locations':{'countries':['US','GB']}, 'page_types':['mobilefeed'], 'user_os':['ios']}" -F "access_token={access_token}" "https://graph.facebook.com/<API_VERSION>/act_{act_id}/adset
At this time, optimising for custom app events is only available in the App Installs objective.
You can choose to have your campaign optimize for people who are likely to generate the most revenue given period after making a purchase. A purchase event that generates a lot of revenue relative to its cost is considered “higher value” than one that generates less revenue relative to its cost. For more information, see About Value Optimization in the Help Center .
Value Optimization via API is available on a limited basis to partners and advertisers that are on the allow list. Contact your Facebook representative if you want to use value optimization.
To use value optimization, ensure your mobile app SDK implementation is sending purchase events and their values. See the App Events pages for additional detail. While creating your ads, remember the following:
VALUE
IMPRESSIONS
custom_event_type
to PURCHASE
is_autobid
to true
7-day
or 1-day
For example:
curl -F "name=App Event Optimization Example" -F "status=PAUSED" -F "optimization_goal=VALUE" -F "billing_event=IMPRESSIONS" -F "promoted_object={'application_id': {app_id}, 'object_store_url': '{appstore_url}', 'custom_event_type': 'PURCHASE'}" -F "is_autobid=true" -F "daily_budget=300" -F "campaign_id={campaign_id}" -F "attribution_spec=[{'event_type': 'CLICK_THROUGH', 'window_days':'1'}]" -F "targeting={'geo_locations':{'countries':['US','GB']}, 'publisher_platforms':['facebook'], 'device_platforms': ['mobile'], 'facebook_positions': ['feed'], 'user_os':['ios']}" -F "access_token={access_token}" "https://graph.facebook.com/<API_VERSION>/act_{act_id}/adset
As of v3.3 of Marketing API we no longer support this optimization goal for App Ads.