> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appstack.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Google

With the Google Ads integration, you can:

1. Run enhanced app campaigns.
2. Import all your ad campaigns (app and web).
3. Enable Appstack to audit Google's reporting capabilities.
4. Allow Appstack to send in-app events, postbacks (signals) back to Google.

<Note>
  **To successfully connect Google Ads, you must:**

  1. Have 'Administrator' access over the right Google Ads account. 'Standard' access is not enough to make the integration work
  2. Ensure that the app used within Appstack is connected to the correct ad account
</Note>

<AccordionGroup>
  <Accordion title="Available metrics and definitions">
    | Metrics                   | Definition                                                                |
    | :------------------------ | :------------------------------------------------------------------------ |
    | Ad spend                  | Money paid to run ads                                                     |
    | Installs                  | New or old users who installed the app                                    |
    | Cost per install (CPI)    | Cost per install from your ad campaigns. Formula: Ad spend / Installs     |
    | Installs per mille (IPM)  | Installs per 1,000 impressions. Formula: (Installs / Impressions) x 1,000 |
    | Impressions               | Number of times an ad was shown                                           |
    | Cost per mille (CPM)      | Cost per 1,000 impressions. Formula: (Ad spend / Impressions) x 1,000     |
    | Clicks                    | Number of times an ad was clicked                                         |
    | Cost per click (CPC)      | Cost per click. Formula Ad spend / Clicks                                 |
    | Click-through rate (CTR)  | How often an impression becomes a click. Formula: Clicks / Impressions    |
    | Click to install rate     | Share of clicks that became installs. Formula: Installs / Clicks          |
    | Return on ad spend (ROAS) | Return on ad spend. Formula: Ads revenue / Ad spend                       |
    | Revenue                   | Total money earned from attributed users.                                 |
  </Accordion>
</AccordionGroup>

## Connect to Google Ads

The first step is to connect your Google Ads account with Appstack. Follow these steps:

1. In Appstack, from the side menu, select **Integrations** > **Google Ads.**
2. Click on **Connect to Google Ads.**
3. In Google's Ads integration flow, select the correct Google account that has access to the correct ad accounts/apps.
4. Click on **Allow.**

## Configure the Google Ads API

Configuring the Google Ads API with Appstack lets you run enhanced app campaigns using the assigned ads link.

<Steps>
  <Step title="Add the ad account and MCC ID">
    The dataset receives all app events, not only Appstack-attributed ones. Choosing the wrong dataset will cause your app's events to be sent to the wrong destination.

    1. Sign in to your Google Ads account.
    2. Click your profile picture in the top right corner.
    3. Your customer ID will be listed under **Account Information.**
    4. (Optional) Paste your Manager Customer ID (MCC ID) for extra verification.

    <Note>
      **Information**

      1. For additional information on how to get the customer ID, follow the official instructions: [Get customer ID](https://support.google.com/google-ads/answer/1704344?hl=en)
    </Note>
  </Step>

  <Step title="Create offline conversions and link them to the SDK events">
    Offline conversions allow Google Ads to measure in-app actions triggered by ads. Appstack maps SDK events to offline conversions and sends them back to Google Ads, enabling campaigns to be measured and optimized correctly.

    <Note>
      It's mandatory to create one conversion action per application.
    </Note>

    Follow these instructions to create the offline conversion action ID for your 'Install' event:

    <video src="https://storage.googleapis.com/appstack-public/integrations/google-integration-1.mp4" controls={true} />

    Follow these instructions to create the offline conversion actions ID for all the in-app events like 'Purchase', 'Start trial', etc.:

    <video src="https://storage.googleapis.com/appstack-public/integrations/google-integration-2.mp4" controls={true} />

    Follow these instructions to get the conversion action ID to paste in Appstack next to the correct SDK event:

    <video src="https://storage.googleapis.com/appstack-public/integrations/google-integration-3.mp4" controls={true} />

    <Note>
      If you see a misconfigured warning on your conversion goals, this will disappear automatically once you start a new campaign using those conversions.
    </Note>
  </Step>

  <Step title="Create your first enhanced app campaign">
    1. Copy the ad link from the Appstack's integration page.
    2. Inside Google Ads, click on **+** to start the campaign creation flow.

    <Note>
      **Information**

      1. Always ensure that you are filtering by mobile devices and the correct operating system (iOS or Android)
      2. The Appstack ad link only needs to be pasted at the campaign level inside the **Tracking template** box within the **Campaign URL options** section. Don't paste the ad link at the ad set or ad level.
      3. The final URL must always be your app store page URL, not the Appstack ad link.
      4. When running search ads, remember to add the install CTA
    </Note>
  </Step>
</Steps>

## Troubleshooting

### **General tips**

1. Check your permissions: Ensure you have the required access to connect.
2. Verify connections: Ensure your customer ID is correct and add your MCC ID if required.
3. Update tokens: Generate fresh API keys and access tokens by reconnecting.
4. Contact support: If issues persist, reach out to our support team with specific error messages at [support@appstack.tech](mailto:support@appstack.tech).

### Error messages

| Error                     | How to fix                                                                                                                                                                     |
| :------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentication** failed | 1. Go to your Google Ads Manager<br />2. Check that your user account has the correct permissions<br />3. Try to connect again in Appstack                                     |
| Application not found     | 1. Verify your customer ID is correct in<br />2. Ensure your user account has access to the correct ad account<br />3. Check that the app is connected to the right ad account |