Skip to content

docs: update GMA iOS plugin to v3.1.0 with version compatibility table #1029

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sunnywu wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: update GMA iOS plugin to v3.1.0 with version compatibility table #1029

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
26 changes: 19 additions & 7 deletions docs/guides/mobile-plugin-gma-ios.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,21 @@ This plugin simplifies integration with Google Mobile Ads (GMA) for any publishe

## Version

<!-- As of 2024-10-22 -->
<!-- As of 2026-06-12 -->

This documentation is for the UID2 GMA Plugin for iOS version 1.0.0 or later.
This documentation is for the UID2 GMA Plugin for iOS version 3.1.0 or later.

### Version compatibility

The following table shows which versions of the UID2 GMA Plugin for iOS are compatible with each version of the Google Mobile Ads SDK and the UID2 SDK for iOS.

| GMA Plugin Version | GMA SDK Version | UID2 SDK for iOS Version |
| :--- | :--- | :--- |
| 3.1.0 (latest) | 13.x | 1.7.0 – 3.x |
| 3.0.0 – 3.0.2 | 13.x | 1.7.0 – 2.x |

@BehnamMozafari BehnamMozafari Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Critical — 3.0.2 (and 3.0.1) don't exist. The only 3.0.x release is v3.0.0. The tag list has just v3.1.0, v3.0.0, v3.0.0-beta, v2.0.2, ..., and Package.swift?ref=v3.0.1 returns 404 ("No commit found for the ref v3.0.1"). This row tells readers to pin a version that was never published.

Suggest changing the label to just 3.0.0. The 13.x / 1.7.0 – 2.x columns are correct — Package.swift@v3.0.0 pins GMA 13.x and uid2-ios-sdk 1.7.0 ..< 3.0.0.

| 2.0.0 – 2.0.2 | 12.x | 1.7.0 – 1.x |

@BehnamMozafari BehnamMozafari Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important — this understates the UID2 SDK range for 2.0.2. v2.0.0 and v2.0.1 do cap at UID2 SDK 1.x (Package.swift = 1.7.0 ..< 2.0.0), but Package.swift@v2.0.2 allows 1.7.0 ..< 3.0.0 (= 1.7.0 – 2.x). GMA is 12.x for all three. As written, a user on plugin 2.0.2 + UID2 SDK 2.x would be wrongly told the combination is unsupported.

Suggest widening the cell to 1.7.0 – 2.x, or splitting the row (2.0.0–2.0.1 → 1.x, 2.0.2 → 2.x).

| 1.0.0 – 1.0.1 | 10.7.0 – 11.x | 1.7.0 – 1.x |
| 0.3.0 – 0.4.0 | 10.7.0 – 11.x | 0.2.0 – 1.x |

## GitHub repository

Expand All @@ -40,13 +52,13 @@ The steps you'll take in the UID2 Portal are different depending on whether your

To run this plugin, install the following:

1. Google Mobile Ads SDK v10.7.0 or later:
1. Google Mobile Ads SDK v13.0.0 or later:
- [SDK](https://developers.google.com/admob/ios)
- [Release Notes](https://developers.google.com/admob/ios/rel-notes)
1. SDK for iOS v1.7.0 or later:
- [SDK](https://github.com/IABTechLab/uid2-ios-sdk)
- [SDK for iOS reference guide](../sdks/sdk-ref-ios.md)
1. [UID2 GMA Plugin for iOS v1.0.0](https://github.com/IABTechLab/uid2-ios-plugin-google-gma)
1. [UID2 GMA Plugin for iOS v3.1.0](https://github.com/IABTechLab/uid2-ios-plugin-google-gma)

## Installation

Expand All @@ -66,7 +78,7 @@ Add the following dependency to Package.swift:

```js
dependencies: [
.package(url: "https://github.com/IABTechLab/uid2-ios-plugin-google-gma.git", exact: "1.0.0")
.package(url: "https://github.com/IABTechLab/uid2-ios-plugin-google-gma.git", from: "3.1.0")

@BehnamMozafari BehnamMozafari Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Important — exact: → from: desyncs the three install methods. from: "3.1.0" resolves to >= 3.1.0, < 4.0.0 (auto-adopts any future 3.x), but the Xcode row below still says "Exact Version: 3.1.0" and CocoaPods still pins '3.1.0' exactly. Previously all three agreed (exact 1.0.0); now the SPM path floats while the other two are hard-pinned, so the documented methods no longer resolve equivalently.

Pick one intent: keep the exact-pin convention (exact: "3.1.0"), or float all three consistently (~> 3.1 for CocoaPods, "Up to Next Major" for Xcode).

]
```

Expand All @@ -76,12 +88,12 @@ In the Xcode user interface, under Package Dependencies, add the following entry

| Name | Location | Dependency Rule |
| :--- | :--- | :--- |
| uid2-ios-plugin-google-gma | `git@github.com:IABTechLab/uid2-ios-plugin-google-gma.git` | Exact Version: 1.0.0 |
| uid2-ios-plugin-google-gma | `git@github.com:IABTechLab/uid2-ios-plugin-google-gma.git` | Exact Version: 3.1.0 |

### Installing with CocoaPods

Add the following entry in your `Podfile`:

```
pod 'UID2GMAPlugin', '1.0.0'
pod 'UID2GMAPlugin', '3.1.0'
```
26 changes: 19 additions & 7 deletions i18n/ja/docusaurus-plugin-content-docs/current/guides/mobile-plugin-gma-ios.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,21 @@ UID2 Google Mobile Ads (GMA) Plugin for iOS は、[Google Mobile Ads (GMA) SDK](

## Version

<!-- As of 2024-10-23 -->
<!-- As of 2026-06-12 -->

このドキュメントは UID2 GMA Plugin for iOS バージョン 1.0.0 以降用です。
このドキュメントは UID2 GMA Plugin for iOS バージョン 3.1.0 以降用です。

### Version compatibility

以下の表は、UID2 GMA Plugin for iOS の各バージョンと、Google Mobile Ads SDK および UID2 SDK for iOS の互換性を示しています。

| GMA Plugin バージョン | GMA SDK バージョン | UID2 SDK for iOS バージョン |
| :--- | :--- | :--- |
| 3.1.0 (最新) | 13.x | 1.7.0 – 3.x |
| 3.0.0 – 3.0.2 | 13.x | 1.7.0 – 2.x |
| 2.0.0 – 2.0.2 | 12.x | 1.7.0 – 1.x |
| 1.0.0 – 1.0.1 | 10.7.0 – 11.x | 1.7.0 – 1.x |
| 0.3.0 – 0.4.0 | 10.7.0 – 11.x | 0.2.0 – 1.x |

## GitHub repository

Expand All @@ -40,13 +52,13 @@ UID2 Portal で実行する手順は、実装が Client-Side、Client-Server、S

このプラグインを実行するには、以下をインストールします:

1. Google Mobile Ads SDK v10.7.0 or later:
1. Google Mobile Ads SDK v13.0.0 or later:
- [SDK](https://developers.google.com/admob/ios)
- [Release Notes](https://developers.google.com/admob/ios/rel-notes)
1. SDK for iOS v1.7.0 or later:
- [SDK](https://github.com/IABTechLab/uid2-ios-sdk)
- [SDK for iOS reference guide](../sdks/sdk-ref-ios.md)
1. [UID2 GMA Plugin for iOS v1.0.0](https://github.com/IABTechLab/uid2-ios-plugin-google-gma)
1. [UID2 GMA Plugin for iOS v3.1.0](https://github.com/IABTechLab/uid2-ios-plugin-google-gma)

## Installation

Expand All @@ -66,7 +78,7 @@ Package.swift に次の依存関係を追加します:

```js
dependencies: [
.package(url: "https://github.com/IABTechLab/uid2-ios-plugin-google-gma.git", exact: "1.0.0")
.package(url: "https://github.com/IABTechLab/uid2-ios-plugin-google-gma.git", from: "3.1.0")
]
```

Expand All @@ -76,12 +88,12 @@ Xcode ユーザーインターフェースで、パッケージ依存関係の

| Name | Location | Dependency Rule |
| :--- | :--- | :--- |
| uid2-ios-plugin-google-gma | `git@github.com:IABTechLab/uid2-ios-plugin-google-gma.git` | Exact Version: 1.0.0 |
| uid2-ios-plugin-google-gma | `git@github.com:IABTechLab/uid2-ios-plugin-google-gma.git` | Exact Version: 3.1.0 |

### Installing with CocoaPods

`Podfile` に次のエントリを追加します:

```
pod 'UID2GMAPlugin', '1.0.0'
pod 'UID2GMAPlugin', '3.1.0'
```
Loading