서버 간 보상 지급 콜백 구현

자세히 알아보기

구현

예시

ShowOptions.gamerSid

Show

using UnityEngine;using System.Collections;using UnityEngine.Advertisements;public class UnityAdsManager : MonoBehaviour{  public string gameId;  public string placement = "rewardedVideo"  public void ShowAd() {  ShowOptions options = new ShowOptions();  // setting the server ID  options.gamerSid = "your-side-id";    Advertisement.Show(placementID, options);  }}

PlayerMetaData.setServerId

PlayerMetaData playerMetaData = new PlayerMetaData(context);playerMetaData.setServerId("example");playerMetaData.commit();UnityAds.show(activity);

playerMetaData.setServerId

id playerMetaData = [[UADSPlayerMetaData alloc] init];[playerMetaData setServerId:@"example"];[playerMetaData commit];[UnityAds show: self  placementId: placementId  showDelegate: showDelegate];

콜백 정보

콜백 출처

콜백 URL 형식

GET

[CALLBACK_URL][SEPARATOR1]sid=[SID][SEPARATOR]oid=[OID][SEPARATOR]hmac=[SIGNATURE]

CALLBACK_URL

https://developer.example.com/award.php?productid=1234

SEPARATOR1

?

?

&

SID

SEPARATOR

&

OID

SEPARATOR

&

SIGNATURE

106ed4300f91145aff6378a355fced73

http title="Example callback URL"https://developer.example.com/award.php?productid=1234&sid=1234567890&oid=0987654321&hmac=106ed4300f91145aff6378a355fced73

콜백 URL 서명

https://developer.example.com/award.php?productid=1234&sid=1234567890&oid=0987654321

oid=0987654321,productid=1234,sid=1234567890

https://developer.example.com/award.php?productid=1234&sid=1234567890&oid=0987654321&hmac=106ed4300f91145aff6378a355fced73

콜백 응답

1

HTTP/1.1 200 OK

http title="Callback response example"HTTP/1.1 200 OKDate: Wed, 22 Feb 2012 23:59:59 GMTContent-Length: 81

400

500

http title="Callback error response example"HTTP/1.1 400 ERRORDate: Wed, 22 Feb 2012 23:59:59 GMTContent-Length: 12Duplicate order

node.js의 콜백

js title="node.js callback example"// NODE.js S2S callback endpoint sample implementation// Unity Adsvar express = require("express");var crypto = require("crypto");var app = express();app.listen(process.env.PORT || 3412);function getHMAC(parameters, secret) {  var sortedParameterString = sortParams(parameters);  return crypto    .createHmac("md5", secret)    .update(sortedParameterString)    .digest("hex");}function sortParams(parameters) {  var params = parameters || {};  return Object.keys(params)    .filter((key) => key !== "hmac")    .sort()    .map((key) => (params[key] === null ? `${key}=` : `${key}=${params[key]}`))    .join(",");}app.get("/", function (req, res) {  var sid = req.query.sid;  var oid = req.query.oid;  var hmac = req.query.hmac;  // Save the secret as an environment variable. If none is set, default to xyzKEY  var secret = process.env.UNITYADSSECRET || "xyzKEY";  var newHmac = getHMAC(req.query, secret);  if (hmac === newHmac) {    // Signatures match    // Check for duplicate oid here (player already received reward) and return 403 if it exists    // If there's no duplicate - give virtual goods to player. Return 500 if it fails.    // Save the oid for duplicate checking. Return 500 if it fails.    // Callback passed, return 200 and include '1' in the message body    res.status(200).send("1");  } else {    // no match    res.sendStatus(403);  }});

PHP의 콜백

php title="PHP callback example"<?phpfunction generate_hash($params, $secret) {  ksort($params); // All parameters are always checked in alphabetical order  $s = '';  foreach ($params as $key => $value) {    $s .= "$key=$value,";  }  $s = substr($s, 0, -1);  $hash = hash_hmac('md5', $s, $secret);  return $hash;}$hash = $_GET['hmac'];unset($_GET['hmac']);$signature = generate_hash($_GET, 'xyzKEY'); // insert here the secret hash key you received from Unity Ads supporterror_log("req hmac".$hash);error_log("sig hmac".$signature);// check signatureif($hash != $signature) { header('HTTP/1.1 403 Forbidden'); echo "Signature did not match"; exit; }// check duplicate ordersif(check_duplicate_orders($_GET['oid']) { header('HTTP/1.1 403 Forbidden'); echo "Duplicate order"; exit; }// if not then give the player the item and check that it succeeds.if(!give_item_to_player($_GET['sid'], $_GET['product']) { header('HTTP/1.1 500 Internal Server Error'); echo "Failed to give item to the player"; exit; }// save the order ID for duplicate checkingif(save_order_number($_GET['oid']) { header('HTTP/1.1 500 Internal Server Error'); echo "Order ID saving failed, user granted item"; exit; }// everything OK, return "1"header('HTTP/1.1 200 OK');echo "1";?>