Procedure

Once Youmi's server receives an effective data record, it will feedback to developers' server (with GET method) with the feedback url address which is offered by developers. Relevant parameters will be will plus to the url address as below.

Parameters

Parameter Full Name

Parameter Name

Type

Description

Order ID

order

Character String(16 bytes)

Order ID: This value is unique. If developer receives the same order ID, that means the order is already existed.

App ID

app

Character String(16 bytes)

The Application ID

Ad Name

ad

Advertisement Name(50 bytes)

The advertisement name. If the ad type is app, then the ad name is the application's name

Ad Identify

adid

Advertisement Number(Integer)

ID of Advertisement

User ID

user

Character String

ID of user: User can set up his own ID, or set it as reserved callback field.

$dev_server_secret: The secret key from developers' server, offered by Youmi. Enter this page "https://app.youmi.net/apps/setting" after logging, find the rewarded ads callback method setting-server callback setting, and set up the server address. After successfully setting, a secret key will be assigned to your app.

, you can inquire the key in the developers back end control panel.

Some fields might contain special characters, please use urldecode when receiving request.

Signature Algorithm

Use all parameters in 【Parameters】 list (except "sign") as key, then get the MD5 value with the key.
Supposed the parameters participate in signature are "k1", "k2" and "k3", their value are "v1", "v2" and "v3", then the computing method is:

Build the pair form of "key=value" with the parameters. For example, "k1=v1", "k2=v2", "k3=v3".

Sort the pair of key and value with ascending lexicographical order and connect them together, like this "k1=v1k2=v2k3=v3".

Add dev_server_secret in the end of the connected character string.

The signature value is the MD5 value of the above character string.

Notes:

Don't include the sign(signature) parameters when calculating the signature

The parameters in signature procedure have not been processed by urlencode.

Verification of Signature

Statements:In the early stage of integrating advertisement SDK, developers might find it fail to pass the verification, then this verification interface will be needed to verify.Of course, you can also contact our customer service directly. Normal verification logic will be implemented by developers themselves.

Return Value

Youmi will proceed the next operation according to the returning http status code from developers' server. The normal http status code should be 200 or 403.

If the http status code is 200, that means developers already received and processed the message normally.

If the http status code is 403, that means developers refuse this request, which also means middle-tier server will not repeatedly make request to developers' server.

If timeout, or the http status code isn't 200 nor 403, the middle-tier server will make request to developers' server again in the next cycle.

There will be delays in the next cycle request to developers' server, the delay time will respectively be: 5s, 10s, 60s, 300s, 600s, 3600s(since last request). Which means, in the worst case, Youmi will send seven requests. If all of the seven requests fail, the link will be discarded.

Because of network issues or other reasons, developers' server will receive multiple records with the same order ID. In this case, developers' server need to abandon the duplicate records, and output with http status code 403. That is to say, Developers' server need to remove the duplication of receiving message.