Apple Ads Connection
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Apple Ads Connection

  • Dark
    Light
  • PDF

Apple Search Ads Credentials Type

Apple Search Ads connection provide 2 types of connectivity methods:

* Zip archive file (Legacy): The legacy way to provide the API credentials. It is going to be deprecated soon, and isn't yet available for new API users.

* The OAuth Way (JWT): The new way to provide API credentials on Apple Search Ads. Based on client_id, team_id, key_id and a public key provided you by Rivery.

OAuth (JWT) 

In order to connect to Apple Search Ads there's a need to create a specific user for Rivery with the right API scope, create a new key pair in Rivery, add  to Apple Search Ads the public key Rivery provided, and provide back the client_id, team_id and key_id to Rivery. 


Step 1: Invite an Apple ID with API permissions 

  1. Sign in to Apple Search Ads, using Advanced mode, and with an Account admin permissions Apple ID.



  2. Click on your Name in the top right corner, choose the account you want to manage, and then click on Settings.
  3.  In the Account Settings, go to Users Management, and then Invite Users.

  4.  Invite the user that you want Rivery will connect with, and set it's permissions to API Account Read Only. Click on Send Invite.
  5. Complete the invitation process, and connect to Apple Search Ads again with the user you've just invited.

Step2: Generate a new public key in Rivery

Apple Ads API requires from its users to provide a pre-generated public key, which refers to a private key, and with it Rivery generates a new token every run. In order to do that, please follow the next.

  1.  In Rivery console, go to connections -> create new connection.
  2.  Choose Apple Ads from the list of connections.
  3.  In order to provide a public key for Apple Search Ads, choose an existing key from the list, or click on create new key pair.
  4. Click on Display public key.


  5.  Copy the entire public key including the BEGIN PUBLIC KEY and the END PUBLIC KEY or use the copy icon. 
  6. Keep it for the next steps.  


Step 3: Provide the public key to Apple Search Ads and get the client id, team id and key id

  1. Connect again to the API Account Read Only user invited in Step 1 using Advanced login.
  2. Click on your Name in the top right corner, choose the account you want to manage, and then click on Settings.

  3. Go to API and Paste the public key generated on Step 2. Click Save.
  4. In Rivery, go to the Apple Search Ads connection, and provide the ClientId, TeamId and KeyId generated from Apple Search Ads.


  5. Test the connection.
  6. Name it and click on Save.


Zip archive file (Legacy)

In order to connect to Apple Search Ads, you will first need to generate a *.zip archive file with certification keys files, which Apple provides.

  1. Sign in to Apple Search Ads.
  2. Click Your Name, at the right top corner of the screen.
  3. Press Settings:
     image4.png

  4. Go to the API section and click on Create API Certificate:
    image3.png

  5. Give a name to your certification. Choose the account and set the role to Read Only. Press Create.
    image2.png

  6. After the certificate appears on your list, check it and click on Actions and Download Certificate. This will produce a zip archive fileSave it in a safe place.
     image5.png

  7. In Rivery, go to Connections -> New Connection.
  8. Choose Apple Search Ads from the sources
  9. Give a name to your connection. 
  10. Choose Legacy in Credentials TypeUpload the zip archive file you just generated.
  11. Test your credentials by pressing Test Connection.
  12. Save the connection.

 


Was this article helpful?