LogoSubmit a requestSupersonic Mone

LogoSubmit a request
Supersonic Monetize Monetize Android
Handling Ad-Completion Callback Events

A commission event occurs when a user has completed an ad offer. In the case of RewardedVideo and OfferWall, this means that the user should be rewarded with virtual currency or items. Supersonic calls the commission event callback (as defined in the Callback URL parameter in the application settings) with the details about the reward.

Note: In the case of RewardedVideo and OfferWall, you must implement the commission event callback such that your code awards the correct amount to the correct user. In the case of Interstitial, the event only informs you that the user has completed an offer (no reward is involved).

The following sections describe the syntax of the commission event callback, provide a code sample, and describe how to authenticate, manage and test the event callback.

Note: In the case of the RewardedVideo product, a client-side event is also sent when a user completes an ad offer (see onRVAdCredited), in addition to the server-side commission event callback being called. In the case of OfferWall, the client-side event onOWAdCredited is called.
We recommend using the server-side event to trigger the user reward, as the authenticity of the callback can be verified (see Authenticating the Commission Event Callback). Make sure not to reward the user twice for the same event when handling onRVAdCredited.
If you do not operate a back-end data server for your application and wish to rely solely on client-side events, you can disable the server-to-server callback system. Please contact our support team for help, and use the onRVAdCredited and Client-Side Events and Polling API sections for further reading.

Commission Event Callback

Name As provided in Callback URL setting. See Registering Your Application.
Type Event from Supersonic
Description The commission event callback is called when a user has completed an ad offer and should be rewarded with credit or virtual items. You are responsible for implementing the code to handle this event.
Parameters [USER_ID] (string) The unique identifier of the user to be rewarded. This is sent by the calling app when initializing the Supersonic product.
Note: The URL-encoded form is passed (for example, "123%40abc.com" rather than "[e-mail]").
[REWARDS] (integer) The number of credit units to be awarded to the user.
[EVENT_ID] (string) A unique identifier of the commission event, generated by Supersonic and represented as an MD5 string (32 alphanumeric characters).
[ITEM_NAME] (string) The name of the virtual item to be awarded (if the virtual item option is used).
Timestamp (string) A string representation of the exact date and time at which this callback was called, in the following format: YYYYMMDDHHMM (e.g. "201001021455" stands for January 2, 2010 14:55).
signature (string) An MD5 hash string to be used for authentication (see Authenticating the Commission Event Callback). This key is generated based on the following formula: md5([TIMESTAMP][EVENT_ID][USER_ID]
[REWARDS][PRIVATE_KEY]).
The [USER_ID] element is the URL-decoded value of the userID (for example, "[e-mail]" rather than "123%40abc.com").
The [PRIVATE_KEY] element is the value you defined in the Private Key setting.
Response Your application must acknowledge receiving the commission event by sending an HTTP response with a status of 200 (OK), where the "[EVENT_ID]:OK" string appears anywhere in the response. For example:

dae8e6cf42b1357f8652ad6ecb5b24f1:OK

Notes Note: It is important to send a response with the correct syntax, so that Supersonic does not continue to send retries of the callback.
Note: Please read the following sections carefully:
Authenticating the Commission Event Callback
Enabling the Callback, with regards to preparing a receipt acknowledgement response to the commission event callback (step 6)
Sample Commission Event Callback Code

The following PHP code sample demonstrates a typical commission event callback handler. All you need to do after copying the code is to implement the alreadyProcessed() and doProcessEvent() functions and set the [YOUR_PRIVATE_KEY] string to the correct value.
// get the variables
$userId = $_GET['applicationUserId'];
$eventId = $_GET['eventId'];
$rewards = $_GET['rewards'];
$signature = $_GET['signature'];
$timestamp = $_GET['timestamp'];
$privateKey = ‘[YOUR_PRIVATE_KEY]’;
// validate the call using the signature
if (md5($timestamp.$eventId.$userId.$rewards.$privateKey) != $signature)
{
echo "Signature doesn’t match parameters";
return;
}
// check that we haven't processed the same event before
if (!alreadyProcessed($eventId)){
// grant the rewards
doProcessEvent($eventId, $userId, $rewards);
}
// return ok
echo $eventId.":OK";

Authenticating the Commission Event Callback

In order to protect your code from unauthorized access, we recommend performing some simple tests on the commission event callback signature and source, to verify that the call was made by Supersonic.
To authenticate the commission event callback you can:

Generate the MD5 hash value from the call’s parameters, according to this formula: md5([TIMESTAMP][EVENT_ID][USER_ID][REWARDS][PRIVATE_KEY]), and verify that the result is identical to the signature parameter value.
Verify that the call has originated from one of these IP addresses:
79.125.5.179
79.125.26.193
79.125.117.130
176.34.224.39
176.34.224.41
176.34.224.49
Was this article helpful?
0 out of 0 found this helpful
Facebook Twitter LinkedIn Google+
Have more questions? Submit a request

Kết quả (Việt) 1:

LogoSubmit cầuSiêu âm kiếm tiền từ kiếm tiền từ Android Xử lý hoàn thành quảng cáo gọi lại sự kiệnMột ủy ban sự kiện xảy ra khi một người sử dụng đã hoàn thành một cung cấp quảng cáo. Trong trường hợp của RewardedVideo và OfferWall, điều này có nghĩa rằng người sử dụng nên được khen thưởng với tiền tệ ảo hoặc các mục. Siêu âm cuộc gọi gọi lại sự kiện hoa hồng (như được định nghĩa trong tham số gọi lại URL trong cài đặt ứng dụng) với các chi tiết về phần thưởng.Lưu ý: Trong trường hợp của RewardedVideo và OfferWall, bạn phải thực hiện gọi lại sự kiện Ủy ban sao cho mã của bạn giải thưởng đúng số tiền để người sử dụng đúng. Trong trường hợp của Interstitial, sự kiện này chỉ thông báo cho bạn rằng người sử dụng đã hoàn tất một giao dịch (không có phần thưởng tham gia).Phần sau đây mô tả cú pháp của Ủy ban sự kiện gọi lại, cung cấp một mẫu mã và mô tả làm thế nào để xác thực, quản lý và kiểm tra gọi lại sự kiện.Lưu ý: Trong trường hợp của các sản phẩm RewardedVideo, một sự kiện phía khách hàng cũng đã gửi khi người dùng hoàn tất một quảng cáo cung cấp (xem onRVAdCredited), ngoài việc gọi lại sự kiện phía máy chủ ủy ban được gọi là. Trong trường hợp của OfferWall, onOWAdCredited phía khách hàng tổ chức sự kiện được gọi là.Chúng tôi khuyên bạn nên sử dụng các sự kiện phía máy chủ để kích hoạt phần thưởng người dùng, vì tính xác thực của gọi lại có thể xác nhận (xem cá gọi lại sự kiện hoa hồng). Đảm bảo rằng bạn không phải để thưởng cho người sử dụng hai lần cho cùng một sự kiện khi xử lý onRVAdCredited.Nếu bạn không sử dụng một máy chủ trở lại-kết thúc dữ liệu cho ứng dụng của bạn và muốn dựa hoàn toàn vào sự kiện phía khách hàng, bạn có thể vô hiệu hóa hệ thống máy chủ đến máy chủ gọi lại. Xin vui lòng liên hệ với nhóm hỗ trợ của chúng tôi để giúp đỡ, và sử dụng onRVAdCredited và Client-Side sự kiện và bỏ phiếu API phần đọc thêm.Ủy ban sự kiện gọi lạiTên là cung cấp trong khung cảnh gọi lại URL. Xem đăng ký ứng dụng của bạn.Loại sự kiện từ siêu âmMô tả gọi lại sự kiện hoa hồng được gọi là khi một người sử dụng đã hoàn thành một đề nghị quảng cáo và nên được khen thưởng với tín dụng hoặc các mục ảo. Bạn chịu trách nhiệm cho việc thực hiện mã để xử lý sự kiện này.Tham số [USER_ID] (chuỗi) các định danh duy nhất của người sử dụng để được khen thưởng. Điều này được gửi bởi các ứng dụng gọi khi khởi tạo các sản phẩm siêu âm.Lưu ý: Các hình thức URL mã hóa được thông qua (cho ví dụ, "123%40abc.com" thay vì "[e-mail]").[PHẦN THƯỞNG] (số nguyên) Số đơn vị tín dụng được trao cho người dùng.[EVENT_ID] (chuỗi) Một định danh duy nhất của sự kiện hoa hồng, được tạo ra bởi siêu âm và đại diện như là một chuỗi MD5 (32 ký tự chữ và số).[ITEM_NAME] (chuỗi) Tên mục ảo được trao tặng (nếu các tùy chọn mục ảo được sử dụng).Dấu thời gian (chuỗi) A chuỗi đại diện của ngày chính xác và thời gian mà tại đó gọi lại này được gọi là, theo định dạng sau: YYYYMMDDHHMM (ví dụ: "201001021455" là viết tắt của 2 tháng một, 2010 14:55).chữ ký (chuỗi) An MD5 hash chuỗi được sử dụng để xác thực (xem cá gọi lại sự kiện hoa hồng). Chìa khóa này được tạo ra dựa trên công thức sau: md5 ([TIMESTAMP] [EVENT_ID] [USER_ID][PHẦN THƯỞNG][PRIVATE_KEY]).Các yếu tố [USER_ID] là giá trị URL giải mã của userID (ví dụ, "[e-mail]" thay vì "123%40abc.com"). Các yếu tố [PRIVATE_KEY] là giá trị bạn xác định trong khóa riêng thiết lập.Phản ứng của bạn ứng dụng phải xác nhận nhận được sự kiện hoa hồng bằng cách gửi một hồi đáp HTTP với một tình trạng 200 (OK), nơi các "[EVENT_ID]: OK" chuỗi xuất hiện bất cứ nơi nào trong các phản ứng. Ví dụ: dae8e6cf42b1357f8652ad6ecb5b24f1:OKLưu ý ghi chú: Nó là quan trọng để gửi một phản ứng với cú pháp chính xác, siêu âm không tiếp tục gửi retries gọi lại.Lưu ý: Xin vui lòng đọc phần sau một cách cẩn thận:Cá gọi lại sự kiện hoa hồngCho phép gọi lại, là liên quan đến chuẩn bị một phản ứng nhận được xác nhận để gọi lại sự kiện hoa hồng (bước 6)Mẫu ủy ban sự kiện gọi lại mãMẫu mã PHP sau chứng tỏ một xử lý gọi lại sự kiện tiêu biểu Hoa hồng. Tất cả bạn cần làm sau khi sao chép mã là để thực hiện các chức năng alreadyProcessed() và doProcessEvent() và thiết lập [YOUR_PRIVATE_KEY] chuỗi giá trị chính xác.nhận được các biến$userId = $_GET ['applicationUserId'];$eventId = $_GET ['eventId'];$rewards = $_GET ['thưởng'];$signature = $_GET ['chữ'];$timestamp = $_GET ['timestamp'];$privateKey = '[YOUR_PRIVATE_KEY]';xác nhận cuộc gọi bằng cách sử dụng chữ kýNếu (md5($timestamp.$eventId.$userId.$rewards.$privateKey)! = $signature){ echo "Chữ ký không khớp với tham số"; trở lại;}kiểm tra rằng chúng tôi đã không xử lý sự kiện tương tự trước khiNếu (! alreadyProcessed($eventId)) {} cấp những phần thưởng doProcessEvent ($eventId, $userId, $rewards);}trở về okecho eventId $. ": OK";Cá gọi lại sự kiện hoa hồngĐể bảo vệ mã của bạn khỏi truy cập trái phép, chúng tôi khuyên bạn nên thực hiện một số xét nghiệm đơn giản trên Ủy ban chữ ký gọi lại sự kiện và nguồn, để xác minh rằng cuộc gọi được thực hiện bởi siêu âm.Để xác thực Ủy ban sự kiện gọi lại bạn có thể:Tạo ra giá trị MD5 hash từ tham số cuộc gọi, theo công thức này: md5([TIMESTAMP][EVENT_ID][USER_ID][REWARDS][PRIVATE_KEY]), và xác minh rằng kết quả là giống hệt nhau để giá trị tham số chữ ký.Xác minh rằng cuộc gọi có nguồn gốc từ một trong những địa chỉ IP:79.125.5.17979.125.26.19379.125.117.130176.34.224.39176.34.224.41176.34.224.49Bài viết này là hữu ích? 0 trong số 0 tìm thấy điều này hữu íchFacebook Twitter LinkedIn Google +Có thêm câu hỏi? Gửi yêu cầu

Kết quả (Việt) 2:

LogoSubmit một yêu cầu
Supersonic hữu Kiếm tiền hữu Kiếm tiền Android
Xử lý Ad-Hoàn Callback Sự kiện Sự kiện hoa hồng xảy ra khi một người sử dụng đã hoàn thành một đề nghị quảng cáo. Trong trường hợp của RewardedVideo và OfferWall, điều này có nghĩa là người sử dụng nên được thưởng bằng tiền ảo hoặc các mặt hàng. Supersonic gọi gọi lại sự kiện hoa hồng (như được định nghĩa trong các tham số URL Callback trong cài đặt ứng dụng) với các thông tin chi tiết về phần thưởng. Chú ý: Trong trường hợp của RewardedVideo và OfferWall, bạn phải thực hiện các cuộc gọi lại sự kiện ủy ban như vậy mà giải thưởng mã của bạn chính xác số tiền cho người sử dụng chính xác. Trong trường hợp của kẽ, sự kiện này chỉ thông báo cho bạn biết rằng người sử dụng đã hoàn thành một đề nghị (không có phần thưởng được tham gia). Các phần sau đây mô tả cú pháp của callback event hoa hồng, cung cấp mẫu mã, và mô tả cách xác thực, quản lý và kiểm tra các sự kiện gọi lại. Lưu ý: Trong trường hợp của các sản phẩm RewardedVideo, một sự kiện phía khách hàng cũng sẽ được gửi khi một người dùng hoàn thành một đề nghị quảng cáo (xem onRVAdCredited), ngoài các server-side gọi lại sự kiện được gọi là hoa hồng. Trong trường hợp của OfferWall, các sự kiện phía client onOWAdCredited được gọi. Chúng tôi khuyên bạn nên sử dụng các sự kiện phía máy chủ để kích hoạt các phần thưởng của người dùng, như tính xác thực của các cuộc gọi lại có thể được xác nhận (xem xác thực của Ủy ban tổ chức sự kiện gọi lại). Hãy chắc chắn rằng không để thưởng cho những người sử dụng hai lần cho cùng một sự kiện khi xử lý onRVAdCredited. Nếu bạn không có cơ sở dữ liệu máy chủ back-end cho ứng dụng của bạn và muốn chỉ dựa trên các sự kiện phía máy khách, bạn có thể vô hiệu hóa các máy chủ đến máy chủ hệ thống gọi lại. Vui lòng liên hệ với nhóm hỗ trợ của chúng tôi để được giúp đỡ, và sử dụng các onRVAdCredited và sự kiện Client-Side và phần Polling API để đọc thêm. Ban tổ chức sự kiện gọi lại Tên Theo quy định tại thiết lập URL gọi lại. Xem Đăng ký ứng dụng của bạn. Loại sự kiện từ Supersonic Mô tả sự kiện gọi lại hoa hồng được gọi khi một người sử dụng đã hoàn thành một đề nghị quảng cáo và được tưởng thưởng với tín dụng hoặc các mục ảo. Bạn chịu trách nhiệm thực hiện các mã để xử lý sự kiện này. Các thông số [USER_ID] (string) định danh duy nhất của người sử dụng để được khen thưởng. Điều này được gửi bởi các ứng dụng gọi điện thoại khi khởi tạo các sản phẩm Supersonic. Lưu ý:. Các hình thức URL mã hoá được thông qua (ví dụ, "123% 40abc.com" hơn là "[e-mail]") [THƯỞNG] (số nguyên) Số lượng các đơn vị tín dụng được trao cho người sử dụng. [event_id] (string) Một định danh duy nhất của sự kiện hoa hồng, được tạo ra bởi siêu âm và biểu diễn như là một chuỗi MD5 (32 ký tự chữ và số). [ITEM_NAME] (string) Tên của mục ảo để được trao tặng (nếu tùy chọn mục ảo được sử dụng). Timestamp (string) Một chuỗi đại diện chính xác ngày và thời gian mà gọi lại này được gọi là, trong các định dạng sau: YYYYMMDDHHMM (ví dụ: "201.001.021.455" là viết tắt của tháng một 2, 2010 14:55). chữ ký (string) MD5 chuỗi hash được dùng để xác thực (xem xác thực của Ủy ban tổ chức sự kiện gọi lại). Khóa này được được tạo ra dựa trên công thức sau đây: md5 ([TIMESTAMP] [event_id] [USER_ID] . [THƯỞNG] [PRIVATE_KEY]) Các [USER_ID] nguyên tố là giá trị URL-giải mã của userID (ví dụ, "123 @ abc.com "hơn là" 123% 40abc.com "). Các [PRIVATE_KEY] phần tử là các giá trị mà bạn xác định trong thiết lập Key Private. Đáp ứng các ứng dụng của bạn phải báo nhận sự kiện hoa hồng bằng cách gửi một phản ứng HTTP với một trạng thái của 200 (OK), nơi "[event_id]: OK" chuỗi xuất hiện bất cứ nơi nào trong các phản ứng. Ví dụ như:




























dae8e6cf42b1357f8652ad6ecb5b24f1: OK

Ghi chú Lưu ý: Điều quan trọng là để gửi một phản ứng với cú pháp chính xác, do đó siêu âm không tiếp tục gửi thử lại các cuộc gọi lại.
Lưu ý: Vui lòng đọc kỹ các phần sau:
Chứng thực của Ủy ban tổ chức sự kiện Callback
Bật gọi lại, liên quan đến việc chuẩn bị một phản ứng tiếp nhận phải thông báo cho callback event hoa hồng (bước 6)
Mẫu Ủy ban tổ chức sự kiện Callback Mã Mẫu mã PHP sau thể hiện một trình xử lý gọi lại sự kiện điển hình hoa hồng. Tất cả bạn cần làm sau khi sao chép mã này là để thực hiện các chức năng alreadyProcessed () và doProcessEvent () và thiết lập [YOUR_PRIVATE_KEY] chuỗi giá trị chính xác. // có được các biến $ userid = $ _GET ['applicationUserId']; $ EvenID = $ _GET ['EvenID']; $ thưởng = $ _GET ['thưởng']; $ chữ ký = $ _GET ['chữ ký']; $ timestamp = $ _GET ['timestamp']; $ privateKey = '[YOUR_PRIVATE_KEY] '; // xác nhận các cuộc gọi bằng cách sử dụng chữ ký if (md5 ($ timestamp $ EvenID $ UserID $ thưởng $ privateKey) = $ chữ ký....!) { echo "Chữ ký không phù hợp với thông số"; return; } // kiểm tra mà chúng tôi đã không được xử lý cùng một sự kiện trước khi {(alreadyProcessed ($ EvenID)!) // cấp những phần thưởng doProcessEvent ($ EvenID, $ UserID, $ thưởng); } // trả lại ok echo $ EvenID ": OK. "; xác thực của Ủy ban tổ chức sự kiện gọi lại Để bảo vệ mã của bạn từ truy cập trái phép, chúng tôi khuyên bạn nên thực hiện một số xét nghiệm đơn giản trên chữ ký gọi lại sự kiện hoa hồng và nguồn, để xác minh rằng các cuộc gọi được thực hiện bằng siêu âm. Để xác nhận các cuộc gọi lại sự kiện hoa hồng bạn có thể : Tạo ra các giá trị hash MD5 từ các thông số của cuộc gọi, theo công thức này: md5 ([TIMESTAMP] [event_id] [USER_ID] [THƯỞNG] [PRIVATE_KEY]), và xác minh rằng kết quả là giống với giá trị tham số chữ ký. Xác minh rằng các cuộc gọi đã có nguồn gốc từ một trong các địa chỉ IP: 79.125.5.179 79.125.26.193 79.125.117.130 176.34.224.39 176.34.224.41 176.34.224.49 Bài viết này hữu ích không? 0 của 0 thấy hữu ích này Facebook Twitter LinkedIn Google+ Bạn có câu hỏi nhiều hơn? Gửi yêu cầu