Skip to content

Commit 2d3502e

Browse files
committed
CPP A/B tests
1 parent 8edd510 commit 2d3502e

9 files changed

Lines changed: 19 additions & 39 deletions
126 KB
Loading
121 KB
Loading
317 KB
Loading
1.42 MB
Loading
831 KB
Loading
496 KB
Loading
67.6 KB
Loading
174 KB
Loading

src/content/docs/version-3.0/ads-manager-cpp-ab-tests.mdx

Lines changed: 19 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -9,16 +9,6 @@ CPP A/B Tests let you compare custom product pages (CPPs) against each other ins
99

1010
You can include your **default product page** as one of the variants, so you can test whether a custom page performs better than your current default.
1111

12-
## How it works
13-
14-
Apple Ads Manager uses the **Ad Group Switch** method:
15-
16-
1. When the test starts, the system clones the source ad group once per variant. Each clone points to a different CPP (one of them can be your default page).
17-
2. Only one clone runs at a time. The system rotates which clone is active on a fixed schedule (hourly, daily, or weekly).
18-
3. The original ad group is paused while the test runs. It is restored to its previous state when the test ends.
19-
4. Apple Ads Manager collects per-variant impressions, taps, and downloads, and tracks how close each variant is to a statistically meaningful sample.
20-
5. The test ends automatically once each variant has enough data, or when the scheduled duration is reached.
21-
2212
## Prerequisites
2313

2414
Before you create a CPP A/B test, make sure:
@@ -31,19 +21,15 @@ Before you create a CPP A/B test, make sure:
3121

3222
To create a test, in the left sidebar, go to **CPP A/B Tests** and click **Create A/B Tests**.
3323

34-
:::note
35-
cpp-ab-tests-list.webp
36-
:::
24+
<ZoomImage id="cpp-ab-tests-create.webp" width="900px" alt="CPP A/B Tests page with the Create A/B Tests button" />
3725

3826
The wizard has four steps: **Ad Group(s)**, **Ad Creative(s)**, **Testing Method**, and **Review**.
3927

4028
### 1. Ad Group(s)
4129

4230
Enter a **Test Name** and click **Select Ad Group** to pick the ad group whose CPPs you want to test. You can select up to four ad groups from the same campaign, but only if you plan to test a single ad creative across them. To compare multiple CPPs, select one ad group.
4331

44-
:::note
45-
cpp-ab-tests-step-ad-group.webp
46-
:::
32+
<ZoomImage id="cpp-ab-tests-step-ad-group.webp" width="700px" alt="Create CPP A/B Test wizard: Ad Group(s) step" />
4733

4834
### 2. Ad Creative(s)
4935

@@ -52,21 +38,17 @@ Pick the CPPs you want to compare. You can include the **Default Product Page**
5238
- **Default Product Page**: Click **+ Add Default** to include your existing default product page as the control variant.
5339
- **Custom Product Pages**: Click **+ Select CPP** to choose a custom product page from App Store Connect.
5440

55-
:::note
56-
cpp-ab-tests-step-creatives.webp
57-
:::
41+
<ZoomImage id="cpp-ab-tests-step-creatives.gif" width="700px" alt="Create CPP A/B Test wizard: Ad Creative(s) step" />
5842

5943
### 3. Testing Method
6044

6145
Configure how the test runs. Apple Ads Manager calculates the **Calculated Test Duration**, **Start Time**, and **End Time** automatically — the values update whenever you change one of the three settings below.
6246

63-
:::note
64-
cpp-ab-tests-step-method.webp
65-
:::
47+
<ZoomImage id="cpp-ab-tests-step-method.webp" width="700px" alt="Create CPP A/B Test wizard: Testing Method step with switch preset, precision, and confidence dropdowns" />
6648

6749
#### Switch Time Preset
6850

69-
How often the system rotates between variants. The recommended option is marked with **(RECOMMENDED)** based on your ad group's traffic. If you select one that's too high for the traffic level, the system automatically downgrades it.
51+
How often the system rotates between variants. If you select one that's too high for the traffic level, the system automatically downgrades it.
7052

7153
| Interval | Typical traffic level | Slot duration | Typical test length |
7254
|--------------|----------------------------------------|---------------|---------------------|
@@ -102,9 +84,7 @@ Verify the summary — selected ad groups, creatives, testing method, duration,
10284

10385
After you start the test, the system clones the ad group for each variant, activates the first variant, and the test status moves to **Running** within a few minutes.
10486

105-
:::note
106-
cpp-ab-tests-step-review.webp
107-
:::
87+
<ZoomImage id="cpp-ab-tests-step-review.webp" width="700px" alt="Create CPP A/B Test wizard: Review step with test summary" />
10888

10989
## Monitor a running test
11090

@@ -117,9 +97,7 @@ To open the test list, go to **CPP A/B Tests** in the left sidebar. The four tab
11797

11898
Each test card shows its name, status, switch interval, desired precision, and how long it has been running. Click **View metrics** to expand the variant table.
11999

120-
:::note
121-
cpp-ab-tests-tabs.webp
122-
:::
100+
<ZoomImage id="cpp-ab-tests-tabs.webp" width="900px" alt="CPP A/B Tests list with Live, Completed, Draft, and Archive tabs" />
123101

124102
### Variant performance
125103

@@ -140,9 +118,7 @@ The variant table compares performance across all variants in the test:
140118

141119
Until each variant has comparable impressions, Apple Ads Manager doesn't highlight a winner. While the data is still coming in, you'll see a banner above the table: **Winner highlighting is paused — variants don't have comparable impressions yet.**
142120

143-
:::note
144-
cpp-ab-tests-variant-table.webp
145-
:::
121+
<ZoomImage id="cpp-ab-tests-variant-table.webp" width="900px" alt="Expanded test row with the variant performance table" />
146122

147123
### Detailed metrics
148124

@@ -155,9 +131,7 @@ The **Winner** column shows which variant leads on each metric. A variant is mar
155131

156132
For metric definitions, see [Metrics in Apple Ads Manager](adapty-ads-manager-metrics).
157133

158-
:::note
159-
cpp-ab-tests-detailed-metrics.webp
160-
:::
134+
<ZoomImage id="cpp-ab-tests-detailed-metrics.webp" width="900px" alt="Detailed metrics page with cohort retention chart, ARPPU comparison, and per-variant metrics" />
161135

162136
## Stop a test
163137

@@ -173,10 +147,6 @@ To stop a running test:
173147
Stopping a test is final — you can't resume it. The results collected so far remain available on the **Completed** tab.
174148
:::
175149

176-
:::note
177-
cpp-ab-tests-stop-confirmation.webp
178-
:::
179-
180150
## Test statuses
181151

182152
Every test moves through a fixed set of statuses:
@@ -190,6 +160,16 @@ Every test moves through a fixed set of statuses:
190160
| **Stopped** | You stopped the test manually. The original ad group is restored. |
191161
| **Failed** | Setup failed or too many consecutive errors occurred. You can restart a failed test. |
192162

163+
## How it works
164+
165+
Apple Ads Manager uses the **Ad Group Switch** method:
166+
167+
1. When the test starts, the system clones the source ad group once per variant. Each clone points to a different CPP (one of them can be your default page).
168+
2. Only one clone runs at a time. The system rotates which clone is active on a fixed schedule (hourly, daily, or weekly).
169+
3. The original ad group is paused while the test runs. It is restored to its previous state when the test ends.
170+
4. Apple Ads Manager collects per-variant impressions, taps, and downloads, and tracks how close each variant is to a statistically meaningful sample.
171+
5. The test ends automatically once each variant has enough data, or when the scheduled duration is reached.
172+
193173
## What to expect while a test runs
194174

195175
A few things are worth knowing about how a running test behaves on the dashboard:

0 commit comments

Comments
 (0)