Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
95 changes: 94 additions & 1 deletion ad-networks/google-ads.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Start in the Linkrunner dashboard.
Once connected, your account appears in the **Google Ad Accounts** table with **Auth Status** showing **Connected**.

<Note>
Select **Google Web to App Ads** instead if you run Search, Display, or Performance Max campaigns that drive
Select **Google Web to App Ads** instead if you run Search, Display, or Demand Gen campaigns that drive
installs through your website. See [Google Web to App](/ad-networks/google-web-to-app).
</Note>

Expand Down Expand Up @@ -122,6 +122,92 @@ After creating the link ID and mapping events in Linkrunner, you can import app
3. Configure additional settings as needed for each conversion action
4. Save your conversion actions

## 5. Create Your First Campaign

With steps 1 to 4 complete, launch an App campaign in Google Ads. App campaigns need no tracking links. Attribution flows through the link ID, and campaigns appear in Linkrunner automatically as installs come in.

<Note>
Running Search, Display, or Demand Gen campaigns that drive installs through your website? Follow [Google Web
to App](/ad-networks/google-web-to-app) instead. It has its own campaign creation flow.
</Note>

### Step 1: Start a New Campaign

1. Open [Google Ads](https://ads.google.com) and go to **Campaigns**
2. Click the **+** button and choose **New campaign**

![Google Ads Campaigns page with the create button and New campaign menu item highlighted](/images/google_ads/first-campaign/new-campaign-button.png)

3. Under **What's your campaign objective?**, select **App promotion** and click **Continue**

![Campaign objective screen with the App promotion card highlighted](/images/google_ads/first-campaign/objective-app-promotion.png)

### Step 2: Choose Subtype and Select Your App

1. Under **Select a campaign subtype**, choose the subtype that matches your goal. **App installs** is the right choice for most first campaigns.
2. Select your app's platform (**Android** or **iOS**)
3. Under **Look up your app**, search by app name, package name, or store URL and select your app
4. Enter a campaign name and click **Continue**

![Campaign subtype screen with App installs and the Android platform highlighted](/images/google_ads/first-campaign/subtype-app-installs.png)

<Note>
Pick a different subtype when your goal is not new installs:

- **App engagement**: re-engage users who already have your app with in-app actions. Google requires a minimum of
50K installs.
- **App pre-registration** (Android only): drive Play Store pre-registrations before your app launches.
</Note>

### Step 3: Set Locations and Languages

1. Under **Locations**, select the countries to run in
2. Under **Languages**, select the languages your customers speak
3. Click **Next**

![Campaign settings screen with the Locations and Languages sections highlighted](/images/google_ads/first-campaign/campaign-settings.png)

### Step 4: Add Ad Assets

App campaigns generate ads automatically from the assets you provide. Google mixes and matches them across Search, Play, YouTube, Display, and Discover.

1. Add up to 5 **Headlines** and 5 **Descriptions**
2. Upload images and videos if you have them
3. Click **Next**

![Ad group screen with the Headlines panel highlighted and the ad preview on the right](/images/google_ads/first-campaign/ad-assets.png)

### Step 5: Set Bidding and Budget

1. Under **What do you want to focus on?**, pick what Google should optimize for. You can choose either option; for your first campaign, choose **Install volume**.
2. Under **What kind of users do you want to target?**, pick either option. For this guide, we select **All users**.
3. Set your average daily **Budget**
4. Click **Next**, review the campaign, and click **Publish campaign**

![Bidding and budget screen with Install volume and All users highlighted](/images/google_ads/first-campaign/bidding-install-volume.png)

<Note>
Bid on **In-app actions** only after your imported conversion actions have enough volume. Under **How do you want to
track install volume?**, Google lists the download conversion actions imported from Linkrunner.
</Note>

### Step 6: Verify the Campaign in Linkrunner

Campaigns and spend sync automatically from your connected Google Ads account. Attribution rows appear after the campaign receives its first install.

1. Open the [**Campaigns** section](https://dashboard.linkrunner.io/dashboard) in your Linkrunner dashboard
2. Click **All Channels** and select **Google** to filter your campaigns
3. Open the campaign to view installs, events, and revenue attributed to it

![Linkrunner Campaigns section with the channel filter open and Google selected](/images/google_ads/first-campaign/linkrunner-campaigns-google-filter.png)

<Note>
Campaigns appear after the first attributed install, not immediately at launch. New campaigns can also take a few
hours to exit Google's review and start serving.
</Note>

To open a specific screen after install, click **Edit** on the campaign row and set a **Deferred Deep Link**. Your app receives the URL from `getAttributionData()`. See [Deferred Deep Linking](/features/deferred-deep-linking).

## Important Notes

<Note>
Expand All @@ -146,6 +232,13 @@ For answers to common questions and an explanation of why numbers in Google Ads

## Troubleshooting

### Campaign Not Showing in Linkrunner

- Wait for the first install. Campaigns appear only after at least one install is attributed.
- Confirm the link ID is saved for the right platform under [Integrations → Google Ads](https://dashboard.linkrunner.io/dashboard/integrations/google-ads?p_id=89)
- Confirm the campaign is active and serving impressions in Google Ads
- Confirm your released app build includes the Linkrunner SDK at 100% rollout

### Events Not Showing Up

- Ensure the link ID was copied correctly
Expand Down
74 changes: 63 additions & 11 deletions ad-networks/meta-ads.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -130,22 +130,74 @@ Use Meta Events Manager to verify that Meta receives events from Linkrunner.
correct.
</Note>

## 4. Campaign Tracking
## 4. Create Your First Campaign

Once your integration is configured, Meta ad campaigns will automatically appear on the Linkrunner Dashboard as they go live.
With the integration configured, launch an App Promotion campaign in Meta Ads Manager. No tracking links are needed. Linkrunner attributes installs through the Meta install referrer (Android) and SKAdNetwork (iOS), and campaigns appear in Linkrunner automatically as installs come in.

### Automatic Campaign Detection
<Note>
Your app must be registered in [Meta for Developers](https://developers.facebook.com/) with its store listing URL,
and linked to the ad account you run campaigns from. Running website campaigns that send users to your app through a
landing page? Follow [Meta Web to App](/ad-networks/meta-web-to-app) instead.
</Note>

### Step 1: Start a New Campaign

1. Open [Meta Ads Manager](https://business.facebook.com/adsmanager) and select the ad account you connected to Linkrunner
2. Click **+ Create**

![Meta Ads Manager Campaigns tab with the Create button highlighted](/images/meta/first-campaign/create-button.png)

3. Keep the buying type as **Auction**, select the **App promotion** objective, and click **Continue**

![Create new campaign dialog with the App promotion objective selected](/images/meta/first-campaign/objective-app-promotion.png)

4. Enter a campaign name and click **Next**

<Note>
Meta enables **Advantage+** by default, which automates audience and placements. You can switch to a manual setup
during configuration. Linkrunner attributes both the same way.
</Note>

### Step 2: Configure the Ad Set

1. Under **App promotion**, select your **Mobile app store** (**Google Play Store** or **App Store**) and search for your app under **App name**

- **No manual setup required** — Campaigns are detected automatically
- **Real-time tracking** — See campaign performance as soon as ads start running
- **Attribution data** — Track installs, events, and revenue back to specific campaigns
![Ad set editor with the Mobile app store dropdown and App name field highlighted](/images/meta/first-campaign/ad-set-app-store.png)

### Viewing Campaign Data
2. Set your **Budget & schedule**. Keep the budget low for the first campaign.
3. Define your **Audience** (locations, age, interests)
4. Leave **Advantage+ placements** on unless you have a reason not to
5. Click **Next**

1. Go to your [Linkrunner Dashboard](https://dashboard.linkrunner.io)
2. Navigate to the **Campaigns** section
3. Filter by **Meta** to see all your Meta ad campaigns
4. View detailed attribution and conversion data for each campaign
<Note>
If your app is not listed under **App name**, it is not registered with Meta or not linked to this ad account.
</Note>

### Step 3: Create the Ad

1. Choose the Facebook Page and Instagram account for the ad's **Identity**
2. Upload your creative and write the primary text and headline
3. In **Destination**, keep **Main destination** as **App**
4. To open a specific screen after install, add your link in **Deferred deep link**. See [Deferred Deep Linking](#5-deferred-deep-linking) below.

![Ad editor Destination section with the Deferred deep link field highlighted](/images/meta/first-campaign/ad-destination-deferred-deep-link.png)

5. Click **Publish**

### Step 4: Verify the Campaign in Linkrunner

Campaigns and spend sync automatically from your connected ad account. Attribution rows appear after the campaign receives its first install.

1. Open the [**Campaigns** section](https://dashboard.linkrunner.io/dashboard) in your Linkrunner dashboard
2. Click **All Channels** and select **Meta** to filter your campaigns
3. Open the campaign to view installs, events, and revenue attributed to it, broken down by ad set and ad creative

![Linkrunner Campaigns section with the channel filter open and Meta selected](/images/meta/first-campaign/linkrunner-campaigns-meta-filter.png)

<Note>
Campaign, ad set, and ad creative rows appear after they receive at least one install, not immediately at launch.
New campaigns can also take a few hours to exit Meta's review and start delivering.
</Note>

## 5. Deferred Deep Linking

Expand Down
Binary file added images/google_ads/first-campaign/ad-assets.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/meta/first-campaign/ad-set-app-store.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/meta/first-campaign/create-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading