---
title: "Apple Ads"
description: "Adapty と Apple Ads を統合してサブスクリプションのコンバージョンを最適化しましょう。"
---

:::important
**App settings** の Apple Ads 統合は、基本的なアナリティクスおよび SplitMetrics Acquire と Asapty の統合にのみ使用されます。
[Adapty Ads Manager](adapty-ads-manager)は別の接続を使用します。Apple Ads アカウントを[Adapty Ads Manager](adapty-ads-manager-get-started)で接続してください。
:::

Adapty は Apple Ads からアトリビューションデータを取得し、キャンペーンおよびキーワードのセグメンテーションで指標を分析するのに役立ちます。Adapty は SDK と AdServices Framework を通じて、Apple Ads のアトリビューションデータを自動的に収集します。

Apple Ads インテグレーションを設定すると、Adapty は Apple Ads からアトリビューションデータの受信を開始します。このデータはプロファイルページで簡単に確認できます。

  <img src="/assets/shared/img/ba4a3e9-CleanShot_2023-08-21_at_15.14.592x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

## 連携の設定 \{#set-up-integration\}

### AdServicesフレームワークをAdaptyに接続する \{#connect-adapty-to-the-adservices-framework\}

[AdServices](https://developer.apple.com/documentation/adservices)を使ったApple Adsは、Adapty ダッシュボードでの設定が必要です。また、アプリ側での有効化も必要です。AdServicesフレームワークを使ってAdapty経由でApple Adsを設定するには、以下の手順に従ってください。

#### ステップ1：公開鍵を取得する \{#step-1-obtain-public-key\}

Adapty ダッシュボードで[Settings -> Apple Ads](https://app.adapty.io/settings/apple-search-ads)に移動します。
あらかじめ生成された公開鍵（Adaptyがキーペアを提供します）を見つけてコピーします。

  <img src="/assets/shared/img/baa5998-CleanShot_2023-08-21_at_14.55.542x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

:::note
Apple Ads のアトリビューションに別のサービスや独自のソリューションを使用している場合は、独自のプライベートキーをアップロードできます。
:::

#### ステップ 2: Apple Ads でユーザー管理を設定する \{#step-2-configure-user-management-on-apple-ads\}
[Apple Ads アカウント](https://ads.apple.com/app-store)で **Settings > User Management** ページに移動します。Adapty がアトリビューションデータを取得するには、別の Apple ID アカウントを招待し、API Account Manager のアクセス権を付与する必要があります。既存のアカウントを使用することも、この目的専用に新しいアカウントを作成することもできます。重要なのは、その Apple ID で Apple Ads にログインできる必要があるという点です。

  <img src="/assets/shared/img/ec183b2-kdjsfldsfjkdsfdfd.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

#### ステップ 3: API 認証情報を生成する \{#step-3-generate-api-credentials\}

次に、Apple Ads に新しく追加したアカウントでログインします。Apple Ads の画面で Settings -> API に移動し、先ほどコピーした公開鍵を所定のフィールドに貼り付けて、新しい API 認証情報を生成してください。

#### ステップ 4: Apple Ads の認証情報を Adapty に設定する \{#step-4-configure-adapty-with-apple-ads-credentials\}
Apple Ads の設定画面から Client ID、Team ID、Key ID の各フィールドをコピーし、Adapty ダッシュボードの対応するフィールドに貼り付けます。

  <img src="/assets/shared/img/7356113-CleanShot_2023-08-21_at_15.08.512x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

### アプリを AdServices ネットワークに接続する \{#connect-your-app-to-the-adservices-network\}

[AdServices フレームワークの設定](#connect-the-adservices-framework)が完了すると、Adapty は Apple Search Ad のアトリビューションデータの収集を自動的に開始します。SDK コードを追加する必要はありません。

iOS アプリケーションでは、このアトリビューションデータは**常に**他のソースからのデータより優先されます。この動作が不要な場合は、以下の手順で ASA アトリビューションを*無効化*してください。

## インテグレーションを無効にする \{#disable-integration\}

Apple Search Ads のアトリビューションをオフにするには、[**App Settings** -> **Apple Search Ads** タブ](https://app.adapty.io/settings/apple-search-ads)を開き、**Receive Apple Search Ads attribution** スイッチをオフにしてください。

  <img src="/assets/shared/img/asa-disable.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

:::warning
この設定を無効にすると、ASA アナリティクスの受信が完全に停止します。その結果、ASA はアナリティクスで使用されなくなり、インテグレーションにも送信されなくなります。また、SplitMetrics Acquire と Asapty は ASA アトリビューションに依存して動作しているため、機能しなくなります。

この変更以前に受信済みのアトリビューションには影響しません。

:::
## 独自のキーをアップロードする \{#uploading-your-own-keys\}

:::note
オプション

これらの手順は Apple Ads アトリビューションには必要ありません。Asapty などの他のサービスや独自ソリューションと連携する場合にのみ必要です。
:::

ASA アトリビューションに他のサービスや独自ソリューションを使用している場合は、独自の公開鍵・秘密鍵ペアを使用できます。

### ステップ 1 \{#step-1\}

ターミナルで秘密鍵を生成する

```text showLineNumbers title="Text"
openssl ecparam -genkey -name prime256v1 -noout -out private-key.pem
```

Adapty の Settings -> Apple Ads でアップロードする（**Upload private key** ボタン）

### ステップ 2 \{#step-2\}

ターミナルで公開鍵を生成する

```text showLineNumbers title="Text"
openssl ec -in private-key.pem -pubout -out public-key.pem
```

この公開鍵は、API Account Manager ロールを持つアカウントの Apple Ads 設定で使用できます。これにより、生成された Client ID、Team ID、Key ID の値を Adapty や他のサービスで利用できます。