GS2-AdReward Script Trigger Reference

Reference for event triggers that call extended scripts

Trigger

acquirePoint

Point acquisition

Synchronous Execution Script

The script is executed synchronously before the point acquisition process.

Request

	Type	Description
namespace	Namespace	Namespace
point	Point	Point before acquisition processing
acquirePointValue	long	Amount of points to be acquired

Result

	Type	Required	Default	Value Limits	Description
permit	bool	✓			Whether to allow point acquisition
overridePointValue	long			0 ~ 2147483645	Amount of points to override the acquisition value

Implementation Example

-- Request
local namespace = args.namespace
local point = args.point
local acquirePointValue = args.acquirePointValue

-- Business logic:
local permit = true
local overridePointValue = 0

-- Result
result = {
  permit=permit,
  overridePointValue=overridePointValue
}

Asynchronous Execution Script

The script is executed asynchronously after the point acquisition process.

Request

	Type	Description
namespace	Namespace	Namespace
point	Point	Point before acquisition processing
afterPoint	Point	Point after acquisition processing
acquirePointValue	long	Amount of points to be acquired

Implementation Example

-- Request
local namespace = args.namespace
local point = args.point
local afterPoint = args.afterPoint
local acquirePointValue = args.acquirePointValue

-- Asynchronous scripts typically do not affect the API response.
-- Use for logging, analytics, external notifications, etc.

result = {
}

consumePoint

Point consumption

Synchronous Execution Script

The script is executed synchronously before the point consumption process.

Request

	Type	Description
namespace	Namespace	Namespace
point	Point	Point before consumption processing
consumePointValue	long	Amount of points to be consumed

Result

	Type	Required	Default	Value Limits	Description
permit	bool	✓			Whether to allow point consumption
overridePointValue	long			0 ~ 2147483645	Amount of points to override the consumption value

Implementation Example

-- Request
local namespace = args.namespace
local point = args.point
local consumePointValue = args.consumePointValue

-- Business logic:
local permit = true
local overridePointValue = 0

-- Result
result = {
  permit=permit,
  overridePointValue=overridePointValue
}

Asynchronous Execution Script

The script is executed asynchronously after the point consumption process.

Request

	Type	Description
namespace	Namespace	Namespace
point	Point	Point before consumption processing
afterPoint	Point	Point after consumption processing
consumePointValue	long	Amount of points to be consumed

Implementation Example

-- Request
local namespace = args.namespace
local point = args.point
local afterPoint = args.afterPoint
local consumePointValue = args.consumePointValue

-- Asynchronous scripts typically do not affect the API response.
-- Use for logging, analytics, external notifications, etc.

result = {
}