Skip to main content
With the Google Ads integration, you can:
  1. Import all your ad campaigns.
  2. Measure post-install activity at the keyword level using the Appstack SDK.
To successfully connect Apple Ads, you must:
  1. Have an Apple Ads API account with one of these roles: API Account Manager, API Account Read Only, Limited Access API Read & Write, or API Read Only
  2. Ensure your Apple Ads account has access to the app used within Appstack
1

SDK configuration

Start by implementing the Appstack SDK to leverage Apple Ads.
import UIKit
import AppTrackingTransparency
import AppstackSDK

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Configure Appstack SDK v2.1.0+
        AppstackAttributionSdk.shared.configure(
            apiKey: "your_api_key",
            isDebug: false,  // Set to true for development
            endpointBaseUrl: nil,
            logLevel: .info
        )
        
        // Request tracking permission and enable Appple Ads Attribution
        if #available(iOS 14.3, *) {
            ATTrackingManager.requestTrackingAuthorization { status in
                AppstackASAAttribution.shared.enableAppleAdsAttribution()
            }
        }
        
        return true
    }
}
2

Invite the user with API Account Manager access

In your Apple Ads account, follow these steps:
  1. Go to Account Settings > User Management.
  2. Click Invite Users.
  3. Fill in account information.
  4. Assign the API Account Manager role.
  5. Send invite.
3

Paste the Appstack public key

Using the user with API Account Manager access, copy the dedicated Appstack Public Key you will :
  1. In Appstack, from the side menu, select Integrations > Apple Ads > Setup guide.
  2. Look for the designated public key (in step 2): 
    -----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcopQgAEgVn6XPywgAgZ6veyGwJ7/Gkj6oRB
oVH/8tOTT6u6tmQ8ca+5gvFe1p+DuRxuf4uULTmchIDRyxGIDKnSlEpE5A==
-----END PUBLIC KEY-----
  3. Go to Account Settings > API.
  4. Paste the Public Key you copied.
  5. Look for the Client ID, Team ID, and Key ID.
4

Copy and paste the credentials

Paste all the requested credentials to start the connection process.
  1. Paste the Client ID, Team ID, and Key ID.
  2. To find the Apple Ads Campaign Group ID, click your app name at the top left; a drop-down menu will appear, showing the name and ID of your campaign group.
  3. Copy and paste the Apple Ads Campaign Group ID.
  4. Click on Connect.

​
Troubleshooting

​
General tips

  1. Make sure you have the right access (API Account Manager). Having Admin access won’t work
  2. Ensure your Apple Ads account has access to the app used within Appstack
  3. When saving API credentials in Apple Ads, you may need to use the Safari browser if you encounter any ‘invalid key’ errors
  4. Contact support: If issues persist, reach out to our support team with specific error messages at support@appstack.tech.

​
Error messages

ErrorHow to fix
Authentication failed1. Verify your Client ID, Team ID, Key ID, and Account ID are correct.
2. Ensure your API key is active and not expired.
3. Check that your account has the required API role: **API Account Manager.
4. **Ensure your Apple Ads account has access to the app used within Appstack.
No campaign data found1. Verify the app ID is correct in Apple Ads.
2. Ensure the app has campaign data over the last 30 days.
3. Check that campaigns are active and running.
4. Verify your Apple Ads account has access to this app.