Contents

Registering an ad network

Use the install-validation APIs for your ad campaigns after registering your ad network with Apple.

Overview

Ad networks provide and cryptographically sign ads that are eligible for ad attribution through SKAdNetwork. Ad networks need to register with Apple before using the SKAdNetwork API.

To register your ad network, go to Ad Network ID Request Form, which prompts you to sign in to Apple Developer and opens the request form.

When registering, you:

  • Receive your ad network ID.

  • Create an elliptic curve cryptographic key pair and share your public key with Apple for signature verification.

  • Provide a URL for receiving SKAdNetwork install-validation postback requests.

Share your ad network ID with developers

The ad network ID is a unique lowercased identifier in the format of “example123.skadnetwork”. Share your ad network ID with app developers who display your ads. Developers need to include your ad network ID in their app’s information property list to initiate the app install-validation process.

Generate your private key

Ad networks use a private cryptographic key to generate a signature for each ad that an app displays. During registration, ad networks create a public-private key pair, and send the public key to Apple. The private key you create uses an Elliptic Curve Digital Signature Algorithm (ECDSA) with a prime256v1 curve.

To create your private key, open Terminal and enter the following command:

openssl ecparam -name prime256v1 -genkey -noout -out companyname_skadnetwork_private_key.pem

In the command, replace companyname with the name of your company. For example, the name of the private key file for a company named Example is example_skadnetwork_private_key.pem.

Generate and share your public key

Next, you create a public key from the private key you created in the previous section. The public key is a PEM-encoded PKCS#8 EC key that uses the prime256v1 curve. In Terminal, enter the following command, again replacing companyname with the name of your company:

openssl ec -in companyname_skadnetwork_private_key.pem -pubout -out companyname_skadnetwork_public_key.pem

This command creates the file companyname_skadnetwork_public_key.pem, which contains your public key. Run this command any time to generate a copy of your public key file.

Send your public key file to Apple when you register your ad network.

See Also

Registering ad networks and configuring apps