Set up Ocean Engine
Ocean Engine is an ad network integrated with Adjust. Our integration lets Ocean Engine receive attribution and in-app event data through automated callbacks.
In this article, learn how to set up measurement with Ocean Engine for your app. This includes activating the integration, creating a campaign link, and choosing what data Adjust can share with Ocean Engine.
Before you begin
Requirements
- Admin, Editor, or Custom Editor permissions in Adjust.
- Adjust SDK v4.0.0 and later to map SDK parameters to Ocean Engine parameters. Follow the guides linked below to use this feature.
iOS / Android / Windows / Unity / React Native / Flutter / Adobe Air / Cordova / Marmalade / Xamarin / Cocos2d-x / Titanium / Corona
Select Ocean Engine and your app in Campaign Lab
- Under Campaign Lab, select Partners.
- Select New partner > Ocean Engine. Select Next to move to the next screen.
- In the App selection screen, choose the app for which you want to create the link, and enable the integration to share data with Ocean Engine.
- Select Next.
Enable data sharing
Enable data sharing to activate the integration with Ocean Engine. To enable data sharing:
- Turn on Enabled
Once you enable data sharing with Ocean Engine, Adjust automatically sends Ocean Engine the following data, by default:
- installs (attributed only)
- event (attributed only)
Set your data sharing options
If you’re working with a multi-platform app with data sharing enabled for multiple platforms, you can:
- Separate data sharing options at the platform-level by selecting Use platform-specific settings.
- Set the same data sharing settings for multiple platforms by selecting Use global settings.
Now, under What will be shared by default?, review the activities that Adjust shares with Ocean Engine by default.
- installs (attributed only)
- event (attributed only)
Send additional data
Choose the amount and type of data that you want to share with Ocean Engine through callbacks. Ocean Engine may use this information to optimize performance.
- Under What sources of data do you want to share?, choose the attribution source of the data you are sharing with Ocean Engine:
- Data from all attribution sources
- Only data attributed to Ocean Engine
Map events
Map events that you want to share to the values that Ocean Engine can receive. Data for unmapped events is not shared with Ocean Engine.
Under Map events, follow these steps to choose the in-app events you want to directly send to Ocean Engine.
- Select Map event.
- In the Adjust event list, choose the Adjust event that you want to share with Ocean Engine.
- In the Partner event list, choose or enter a custom event name that you want to map the Adjust event to. You might have to map an event to several values.
- Select Apply.
Now Ocean Engine will receive in-app event data for each of your linked events.
Configure your link and settings
You have the option to set your:
Create your link and share it with Ocean Engine
In the Setup review screen, you can review your choices. You can also go back and make changes to:
- Your selected app
- Data sharing options
- Link structure parameters
- User destinations
- Attribution settings
Select Create link to create your click URL, impression URL, QR code and link token. Creating a link also enables data sharing and the integration with Ocean Engine.
Once you’ve created your link, share it with Ocean Engine for placement in campaigns.
Partner specific setup instructions
Ocean Engine has predefined events to link, please enter the Event Name (English) within the Event Linking.
- Here are main predefined Ocean Engine event names, please refer to their official website for full list.
| Event name in Chinese | Event to link | Comment |
| 注册 | active_register | 用户在推广的应用/落地页场景下完成注册（手机号/微信等）行为，具体注册形式取决于广告主业务模式，如：招商加盟行业，用户下载app后完成注册行为；游戏行业，用户下载游戏后完成激活+注册；电商行业，完成注册 |
| 付费 | active_pay | 用户在推广的应用/落地页场景下发生交易并完成至少一笔付款，具体支付形式取决于广告主业务模式 |
| 表单提交 | form | 用户在页面内完成表单填写并提交 |
| 有效咨询 | consult_effective | 一般指用户点击“在线咨询”，通过IM向商户进行有效咨询，发言≥1条，广告主也可自定义有效的标准。 |
| 次留 | next_day_open | 激活且在第二天内打开app |
| 有效获客 | customer_effective | 提交线索的用户进一步完成了一次有价值的行为，具体行为取决于广告主业务模式，如预约到店，完成授权，完成支付等 |
| App内下单 | in_app_order | 用户进入电商平台APP，并完成提交订单行为 |
| App内加购物车 | in_app_cart | 用户将商品加入购物车 |
| App内付费 | in_app_pay | 用户完成商品下单并完成付款 |
| App内访问 | in_app_uv | 用户成功打开访问应用打开并访问通常考核吊起打开，不考核活动/商品 uv/pv |
| 关键行为 | game_addiction | 用户在推广的应用/落地页场景下发生的关键行为/行为集合，具体行为取决于广告主业务模式。如：商务服务行业的用户下载激活app后提交简历，房地产行业的用户有看房意向；游戏行业的用户在游戏内发生关键行为或行为组合等 |
| App内详情页到站UV | in_app_detail_uv | 浏览重点页面，比如商品页、活动页、文章等考核活动/商品页面uv/pv |
List of all parameters forwarded to Ocean Engine
Ocean Engine requires Adjust to send the following parameters (data points) with your callbacks:
| Placeholder | Information |
{idfa} | ID for advertisers (iOS only) |
{os_name} | Device operating system |
{revenue} | Revenue, as sent from Adjust SDK in cents |
{activity_kind} | Type of user activity |
{created_at} | Activity timestamp |
{oaid} | OAID device ID |