Getting Credentials for Apple Search Ads

Implementing OAuth for the Apple Search Ads API

An SSL certificate is required for gaining access to the API. Log in to your Apple Search Ads account to get your Organization ID and the necessary Certificates to connect to EMMA.

1. Get your Organization ID. Go to the upper right section where is your username and copy your ID. 

   

2. Get the necessary certificates to connect to EMMA. Click on Settings in the upper-right drop-down menu (where you can see your username)
   

   

3. Create your certificate from the API section by clicking on the Create API Certificate button.  

   

4. In the pop-up, write the certificate's name and choose the Account Read-Only option. If you are an agency and you work with many campaign groups you must get a specific certificate for each one of them. To do this, in the pop-up, write a name for the certificate and select the option Limited Access. In the new drop-down menu, select the desired campaign in the first, and the role (read-only) in the second.
   

   

   
   

   
   

5. Select the certificate you have already created and click on Download certificate from the Actions drop-down menu. 
   

   

When certificates will be downloaded (one .pem and other .key) you can finalize the configuration for EMMA. Convert the received PEM file and a private key file into a PKCS#12 (.p12) file using the OpenSSL command: 

openssl pkcs12 -export -in <PEM_file>.pem -inkey <PRIVATE_KEY>.key -out <FILENAME>.p12

The certificate (*.p12) must be placed in some folder (<path>\BI_API.p12), then the following line must be added in the file

• For Windows: bin\standalone.conf.bat

set "JAVA_OPTS=%JAVA_OPTS% -Djavax.net.ssl.keyStore=<path>\BI_API.p12 -Djavax.net.ssl.keyStoreType=pkcs12 -Djavax.net.ssl.keyStorePassword=<password>"

• For Linux: bin/standalone.conf:

JAVA_OPTS="$JAVA_OPTS -Djavax.net.ssl.keyStore=<path>/BI_API.p12 -Djavax.net.ssl.keyStoreType=pkcs12 -Djavax.net.ssl.keyStorePassword=<password>"