At a glance: Set up partner integrations to automatically import all your creative data into Creative Optimization.
About partner integrations
A partner integration seamlessly and continuously imports your creatives from campaigns run through the partner, into Creative Optimization.
Data availability
Once a partner integration is added:
- The system backfills creative data and AppsFlyer performance data from the past 90 days. The data is typically available in Creative Optimization within 24 hours.
- Creative data will continue to be pulled from integrated partners twice a day, every day. The data is incorporated, and matched to other performance data points from AppsFlyer such as attribution, spend, clicks, impressions, revenue, etc. (AppsFlyer performance data is refreshed hourly). The Creative Optimization dashboards display the combined data from all the above processes and are updated once daily at UTC + 10 (all creative data from the last 90 days is updated).
Note: To see AppsFlyer cost data (such as ROAS), an ROI360 subscription is required.
Media partner integrations
This section describes how to set up integrations with each partner.
Adikteev
Prerequisites:
- Credentials for integration:
- Email (Adikteev username)
- Adikteev password
- Note: These must be the same credentials used to access your Adikteev dashboard.
- To enable us to pull all cost data from Adikteev, the same user who integrated ROI360 should be the one to integrate Creative Optimization as well.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Adikteev.
- Select the apps that you are promoting.
- Enter the email and password.
- Click Save.
Note: Adikteev is also known as Trademob (trademob_int).
Adjoe
Prerequisite:
- Credential for integration:
- Token
Reach out to your Adjoe account manager to get the token. See Adjoe documentation
- Token
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Adjoe GmbH.
- Select the apps that you are promoting.
- Enter the token.
- Click Save.
AppLovin
Prerequisites:
- Ad account permissions for the relevant apps you want to integrate. Note: Authentication to AppLovin must be done by the account admin.
- Report key credentials to pull Partner metrics from AppLovin.
You can get the credentials in 2 ways:- Use the API key from your ROI360 AppLovin integration (if applicable).
- Get the Report key from your AppLovin dashboard. To get the Report key: In AppLovin, go to Account > Keys > Report key
To add an integration:
-
Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select AppLovin.
- Select the apps that you are promoting.
- Under Partner metrics, Enter the AppLovin Report key in the API Key field.
- Then click Log in with AppLovin.
Google Ads
Prerequisites:
- Ad account admin permissions for the relevant apps you want to integrate.
- To enable us to pull all creative data from Google, the same user who integrated ROI360 should be the one to integrate Creative Optimization as well. If there is no ROI360 subscription then you must have admin permissions to all relevant apps and ad accounts in Google AdWords.
Note:
- The integration with Google Ads is per user, which means that multiple users can have active integrations simultaneously.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- Click the Partner list and select Google Ads (AdWords).
- Select the apps that you are promoting.
- Click Log in to Google. The Sign in with Google window opens.
- Complete the Google sign-in and provide your permissions. Note that in order for AppsFlyer to pull complete data, it is recommended that you have full permissions.
- Click Save.
Note: We support UAC campaign (ACi, ACe, and ACpre) ad types only. The data of unsupported ad types will be available in Creative Optimization on the ad level only (not the creative level).
ironSource
Prerequisites:
- ironSource credentials for integration:
- Secret key
- Refresh token
- Learn where to find your unique credentials.
- Either an Administrator or Contributor user role in ironSource. Learn how to set up user roles.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select ironSource.
- Select the apps that you are promoting.
- Enter the secret key and refresh token.
- Click Save.
Note: Certain ad types aren’t supported, which means that their data in Creative Optimization is available on the ad level only (not the creative level). Unsupported ad types include Offerwall ads.
Liftoff
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Liftoff.
- Select the apps that you are promoting.
- Contact your Liftoff CSM to get your Liftoff reporting API username and password.
- Click Save.
Meta Ads
Prerequisites:
- Ad account permissions for the apps you want to integrate. Note: The integration with Meta Ads is per user, which means that multiple users can have active integrations simultaneously.
- To pull creatives that are displayed on internal and/or external Facebook pages, make sure your Facebook Business Center admin provides the relevant permissions to the user setting up the integration with Creative.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Meta Ads.
- Select the apps that you are promoting.
- Click Log in with Meta Ads.
- Complete the sign-in and provide your permissions. Note: For AppsFlyer to pull complete data, we recommend that you have full permissions.
- Click Save.
Note: Certain ad types aren’t supported, which means that their data in Creative Optimization is available on the ad level only (not the creative level). Unsupported ad types include:
- Catalog/DPA
Moloco
Prerequisites:
- To be able to pull creatives, you need a Moloco "Workplace Owner" or "Ad Account Owner" role.
- Moloco credentials for integration (Note: These are the same credentials used to access your Moloco dashboard):
- Password
- Workplace ID
To get your Workplace ID on Moloco's dashboard:- Click on Workplace Settings.
- Copy the Workplace ID.
- If the Workplace ID is composed of more than one word and includes spaces, delete the spaces when copying the value into the field in Creative Optimization. You might also need to the entire value in capital letters.
- Learn more about finding your Workplace ID in Moloco.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Moloco.
- Select the apps that you are promoting.
- Enter the email, password, and Workplace ID.
- Click Save.
Note:
- If your Workplace ID doesn't work, try entering your Workplace Title instead.
- Certain ad types aren’t supported, which means that their data in Creative Optimization is available on the ad level only (not the creative level). Unsupported ad types include CTV ads.
Prerequisites:
- To be able to pull creatives, you need a Reddit "Creator" or "Admin" role.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Reddit.
- Select the apps that you are promoting.
- Click Log in with Reddit.
- Complete the sign-in and provide your permissions. Note: For AppsFlyer to pull complete data, we recommend that you have full permissions.
- Click Save.
Remerge
Prerequisites:
- Credentials for integration (Note: These are the same credentials used to access your Remerge dashboard. See Remerge documentation):
- User email
- Password
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Remerge.
- Select the apps that you are promoting.
- Enter the email and password.
- Click Save.
Smadex
Prerequisites:
- Smadex credentials for integration (Note: These are the same credentials used to access your Smadex dashboard):
- Password
To add an integration:
-
Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Smadex.
- Select the apps that you are promoting.
- Enter the required credentials.
- Click Save.
Snapchat
Prerequisites: Ad account permissions for the relevant apps you want to integrate. Note: The integration with Snapchat is per user, which means that multiple users can have active integrations simultaneously.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Snapchat.
- Select the apps that you are promoting.
- Click Log in with Snapchat. The window opens.
- Complete the sign-in and provide your permissions. Note that in order for AppsFlyer to pull complete data, it is recommended that you have full permissions.
- Click Save.
Note: Certain ad types aren’t supported, which means that their data in Creative Optimization is available on the ad level only (not the creative level). Unsupported ad types include Collection Ads.
TikTok
Prerequisites:
- Ad account permissions for the relevant apps you want to integrate. Note: The integration with TikTok is per user, which means that multiple users can have active integrations simultaneously.
- To pull creative data from Spark Ads, make sure your TikTok Business Center admin provides the relevant permissions to the user setting up the integration with Creative.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select TikTok.
- Select the apps that you are promoting.
- Click Log in with TikTok. The window opens.
- Complete the sign-in and provide your permissions. Note that in order for AppsFlyer to pull complete data, it is recommended that you have full permissions.
- Click Save.
Notes
- On January 30, 2023, the new TikTok for Business—Advanced SRN integration tiktokglobal_int was added, while the [Legacy] TikTok for Business integration bytedanceglobal_int is gradually phasing out and will be deprecated by March 2024. Learn more in this bulletin.
- If the legacy integration (bytedanceglobal_int) is still active after the new one (tiktokglobal_int) is integrated, there will be a duplication of performance data in Creative Optimization as it will be pulled from both networks.
- Creatives won’t be duplicated since AI identifies the actual assets.
- Removing the legacy integration will not delete historical data from the product.
- To pull all the required data, the one who connects TikTok SRN must have the relevant permissions (an ad account admin is recommended).
- If the legacy integration (bytedanceglobal_int) is still active after the new one (tiktokglobal_int) is integrated, there will be a duplication of performance data in Creative Optimization as it will be pulled from both networks.
- Certain ad types aren’t supported, which means that their data in Creative Optimization is available on the ad level only (not the creative level). Unsupported ad types include Collections Ads and Shopping Ads.
Unity Ads
Prerequisites:
- Unity service account credentials for integration:
- Key ID
- Secret key
- Organization core ID
- See instructions for retrieving the credentials.
-
The following service account (organization) roles selected within Unity:
- Advertisers API Stats Viewer, to pull Unity metrics.
-
One of the other below roles, to pull the creatives:
- Advertise API Admin
- Advertise API Viewer
- Advertise API Creative Packs Editor
- See instructions for selecting a service account (organization) role.
Instructions for retrieving the credentials
To retrieve the Key ID and Secret key:
- Log in to Unity Ads.
- On the main menu side panel, click on Administration, then Service Accounts.
- Click the specific service account.
- Click + Add key.
This brings up the Key ID and Secret key. - Copy the Key ID and Secret key.
To retrieve the Organization core ID:
- Within Unity Ads, click Products on the side menu.
- Cick Grow.
- Click Unity Ads User Acquisition.
- Click Settings.
- Copy the Organization core ID.
To select a service account (organization) role:
-
In the Unity dashboard, click Administration.
- Click Service accounts.
- Click the relevant service account, then click + Manage organization roles.
- In the Growth dropdown menu, select the following service account organization roles:
- Advertisers API Stats Viewer, to pull Unity metrics.
-
One of the other below roles, to pull the creatives:
- Advertise API Admin
- Advertise API Viewer
-
Advertise API Creative Packs Editor
- Click Save.
Note: If you don't have access to these roles, please contact your Unity customer success manager or email unityads-support@unity3d.com to request the required permissions.
To add a Unity integration to the Creative dashboard:
- In the Creative Optimization dashboard, do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select Unity Ads.
- Select the apps that you are promoting.
- Enter the key ID, secret key, and organization core ID.
- Enter the Partner metrics information to also get metrics as reported by Unity Ads (optional).
- Click Save.
YouAppi
Prerequisite:
YouAppi credentials for integration :
- Token
Note: You can reach out to your account manager in YouAppi to get the token. For more information, see YouAppi documentation.
To add an integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- In the Partner list, select YouAppi.
- Select the apps that you are promoting.
- Enter the token.
- Click Save.
Additional information
Creative Integrations dashboard
The Creative Integrations dashboard is where you can add new media partner integrations. To add a new integration, follow the specific instructions per partner.
Once added, the dashboard displays the status of all your current integrations, with the following columns:
Column | Description |
---|---|
Partner | The name of the integrated partner, for example, Meta Ads or ironsource_int. Expand the partner column to see all the different connections for the partner. For example, each user might have their own connection. |
App | The list of apps per integrated partner and specific user connection. |
Integration update | The date when the partner integration settings were last updated. |
Coverage status |
The amount of creative performance data from the partner integration available in Creative Optimization dashboards and reports:
Click the status to see the coverage status breakdown by app. The per-app status means different things depending on whether you’re an ROI360 subscriber or not. Non-ROI360 subscriber:
ROI360 subscriber:
For both ROI360 and non-ROI360 subscribers:
|
Agency integrations
You can integrate with your agency partners to pull their data into the Creative dashboard.
To add an agency integration:
- Log in to Creative Optimization and do one of the following:
- If you don't have any partner integrations, click + Add new integration.
- Otherwise, click the ⋮ icon on the upper right of the dashboard to get to Creative integrations.
- Click + New integration.
- After selecting the Partner and Apps in the partner integration window, click the Agency toggle.
- Select the specific agency from the Select agency dropdown menu.
- Click Save.
The agency integration is added.
Notes:
- For each agency whose creative data you want to see on the dashboard, you'll need to create a separate partner integration with the "Agency" checkbox selected.
- Data is available from transparent agencies only. Learn more
- Creative data will be pulled from the agency only. This means that if you selected Google Ads as the partner, as in the example above, but you also have campaigns running directly with Google Ads, you will need to create an additional partner integration for Google ads.
Update credentials
Once certain partner integrations are set up, their account-level credentials can't be changed (this doesn't apply to Meta ads, Google Ads, TikTok, and AppLovin). If you need to update credentials for a partner:
- On the Creative integrations page, select the expander to the left of the partner, to open the partner connections.
- Click the menu icon to the right of the connection, then click Delete integration.
- Create a new integration for the partner with the updated credentials.