SKAdTestSession
The class you use to test ad impressions and postbacks in Xcode.
Declaration
class SKAdTestSessionOverview
Use the SKAdTestSession class to test your implementations of SKAdNetwork. Create one instance of this class to use in multiple test cases. The instance represents a test session, and holds a set of test postbacks. Use SKAdTestPostback to create test postbacks. Call setPostbacks(_:) to add test postbacks to the test session. The test session deletes the postbacks from the instance after you call flushPostbacks(responses:).
Validate ad impressions
In the production environment, ad networks sign the ad impressions that apps display. In the testing environment, you have the opportunity to validate the ad impression signature. Ad networks provide two types of ads: StoreKit-rendered ads and view-through ads. To validate the ad impressions, use the following methods:
validate(_:publicKey:) to test your signature for view-through ads
validateImpression(parameters:publicKey:) to test your signature for StoreKit-rendered ads
validateWebAdImpressionPayload(_:publicKey:) to test your signature for web ads
You need a cryptographic private key to generate signatures. Use a public/private key pair that you create using an Elliptic Curve Digital Signature Algorithm (ECDSA) with a prime256V1 curve. Provide the public key in the validation methods. Secure your private keys as you would other credentials, such as passwords. Never share your private keys, store keys in a code repository, or include keys in client-facing code.
Test conversion values and postbacks
In the production environment, ad networks receive postbacks on their server after users install an advertised app and a timer expires. In the testing environment, you can control all aspects of the postback, including when it’s sent.
In the production environment, an advertised app may update a conversion value as the user interacts with the app. The final conversion value appears in the winning postback. In the testing environment, you have the opportunity to check the test postback before it’s sent to determine whether your app is updating conversion values as expected.
To perform tests on conversion values and postbacks, follow these steps:
Create up to six test postbacks using SKAdTestPostback.
Add the test postbacks to the test session by calling setPostbacks(_:).
In the code representing the advertised app, register the test postbacks by calling updatePostbackConversionValue(_:completionHandler:)or registerAppForAdNetworkAttribution().
To test conversion values, call updatePostbackConversionValue(_:completionHandler:) to update the conversion value of the winning test postback.
Call flushPostbacks(responses:) when you’re done updating the conversion value and are ready to test receiving postbacks on your server. This method sends the test postbacks to your server, and removes them from the test session.
Topics
Validating impressions
validate(_:publicKey:)validateImpression(parameters:publicKey:)validateWebAdImpressionPayload(_:publicKey:)