You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/version-3.0/ads-manager-cpp-ab-tests.mdx
+19-39Lines changed: 19 additions & 39 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,16 +9,6 @@ CPP A/B Tests let you compare custom product pages (CPPs) against each other ins
9
9
10
10
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.
11
11
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
-
22
12
## Prerequisites
23
13
24
14
Before you create a CPP A/B test, make sure:
@@ -31,19 +21,15 @@ Before you create a CPP A/B test, make sure:
31
21
32
22
To create a test, in the left sidebar, go to **CPP A/B Tests** and click **Create A/B Tests**.
33
23
34
-
:::note
35
-
cpp-ab-tests-list.webp
36
-
:::
24
+
<ZoomImageid="cpp-ab-tests-create.webp"width="900px"alt="CPP A/B Tests page with the Create A/B Tests button" />
37
25
38
26
The wizard has four steps: **Ad Group(s)**, **Ad Creative(s)**, **Testing Method**, and **Review**.
39
27
40
28
### 1. Ad Group(s)
41
29
42
30
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.
43
31
44
-
:::note
45
-
cpp-ab-tests-step-ad-group.webp
46
-
:::
32
+
<ZoomImageid="cpp-ab-tests-step-ad-group.webp"width="700px"alt="Create CPP A/B Test wizard: Ad Group(s) step" />
47
33
48
34
### 2. Ad Creative(s)
49
35
@@ -52,21 +38,17 @@ Pick the CPPs you want to compare. You can include the **Default Product Page**
52
38
-**Default Product Page**: Click **+ Add Default** to include your existing default product page as the control variant.
53
39
-**Custom Product Pages**: Click **+ Select CPP** to choose a custom product page from App Store Connect.
54
40
55
-
:::note
56
-
cpp-ab-tests-step-creatives.webp
57
-
:::
41
+
<ZoomImageid="cpp-ab-tests-step-creatives.gif"width="700px"alt="Create CPP A/B Test wizard: Ad Creative(s) step" />
58
42
59
43
### 3. Testing Method
60
44
61
45
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.
62
46
63
-
:::note
64
-
cpp-ab-tests-step-method.webp
65
-
:::
47
+
<ZoomImageid="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" />
66
48
67
49
#### Switch Time Preset
68
50
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.
@@ -102,9 +84,7 @@ Verify the summary — selected ad groups, creatives, testing method, duration,
102
84
103
85
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.
104
86
105
-
:::note
106
-
cpp-ab-tests-step-review.webp
107
-
:::
87
+
<ZoomImageid="cpp-ab-tests-step-review.webp"width="700px"alt="Create CPP A/B Test wizard: Review step with test summary" />
108
88
109
89
## Monitor a running test
110
90
@@ -117,9 +97,7 @@ To open the test list, go to **CPP A/B Tests** in the left sidebar. The four tab
117
97
118
98
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.
119
99
120
-
:::note
121
-
cpp-ab-tests-tabs.webp
122
-
:::
100
+
<ZoomImageid="cpp-ab-tests-tabs.webp"width="900px"alt="CPP A/B Tests list with Live, Completed, Draft, and Archive tabs" />
123
101
124
102
### Variant performance
125
103
@@ -140,9 +118,7 @@ The variant table compares performance across all variants in the test:
140
118
141
119
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.**
142
120
143
-
:::note
144
-
cpp-ab-tests-variant-table.webp
145
-
:::
121
+
<ZoomImageid="cpp-ab-tests-variant-table.webp"width="900px"alt="Expanded test row with the variant performance table" />
146
122
147
123
### Detailed metrics
148
124
@@ -155,9 +131,7 @@ The **Winner** column shows which variant leads on each metric. A variant is mar
155
131
156
132
For metric definitions, see [Metrics in Apple Ads Manager](adapty-ads-manager-metrics).
157
133
158
-
:::note
159
-
cpp-ab-tests-detailed-metrics.webp
160
-
:::
134
+
<ZoomImageid="cpp-ab-tests-detailed-metrics.webp"width="900px"alt="Detailed metrics page with cohort retention chart, ARPPU comparison, and per-variant metrics" />
161
135
162
136
## Stop a test
163
137
@@ -173,10 +147,6 @@ To stop a running test:
173
147
Stopping a test is final — you can't resume it. The results collected so far remain available on the **Completed** tab.
174
148
:::
175
149
176
-
:::note
177
-
cpp-ab-tests-stop-confirmation.webp
178
-
:::
179
-
180
150
## Test statuses
181
151
182
152
Every test moves through a fixed set of statuses:
@@ -190,6 +160,16 @@ Every test moves through a fixed set of statuses:
190
160
|**Stopped**| You stopped the test manually. The original ad group is restored. |
191
161
|**Failed**| Setup failed or too many consecutive errors occurred. You can restart a failed test. |
192
162
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
+
193
173
## What to expect while a test runs
194
174
195
175
A few things are worth knowing about how a running test behaves on the dashboard:
0 commit comments