プロパティリストキー

SKExternalPurchaseMultiLink

あなたのアプリを使用するユーザが外部購入を行うことができる Web サイトへの URL の配列を含む辞書。

iOS 17.5+ iPadOS 2.0+ Mac Catalyst 17.3+ macOS 10.0+

tvOS 9.0+ visionOS 1.0+ watchOS 2.0+

詳細

Type

オブジェクト

プロパティ

Any Key [string]

議論

あなたのアプリに com.apple.developer.storekit.external-purchase-link 権限がある場合は、この情報プロパティリストキーを使用して下さい。

この辞書のキーは、小文字の ISO 3166-1 alpha-2 国コードです。有効な国コードには、欧州連合の国コードが含まれます: オーストリア (at)、ベルギー (be)、ブルガリア (bg)、クロアチア (hr)、キプロス (cy)、チェコ (cz)、デンマーク (dk)、エストニア (ee)、フィンランド (fi)、フランス (fr)、ドイツ (de)、ギリシャ (gr)、ハンガリー (hu)、アイルランド (ie)、イタリア (it)、ラトビア (lv)、リトアニア (lt)、ルクセンブルク (lu)、マルタ (mt)、オランダ (nl)、ポーランド (pl)、ポルトガル (pt)、ルーマニア (ro)、スロバキア (sk)、スロベニア (si)、スペイン (es)、スウェーデン (se);そしてアイスランド (is)、ノルウェー (no)、ロシア (ru)、アメリカ合衆国 (us)。

あなたのアプリが外部購入リンクをサポートしている場合は、国コードごとに 1 つのキーエントリを含めて下さい。国コードごとに、あなたのアプリが選択できる宛先 URL (Web サイトへのリンク) を 1 ～ 5 個提供して下さい。

注意

外部購入リンクを提供する音楽ストリーミングアプリを EEA で配布する (Distributing music streaming apps in the EEA that provide an external purchase link) で説明されているように、あなたのアプリが StoreKit 外部購入リンクの資格を満たしている場合は、最大 5 つのリンクを提供できます。それ以外の場合は、国コードごとに 1 つのリンクを提供して下さい。

あなたのアプリは、ExternalPurchaseLink オブジェクトの eligibleURLs 配列を通じてこれらの URL にアクセスし、ExternalPurchaseLink オブジェクトの open(url:) メソッドで選択したリンクを使用します。

重要

プロパティリストキーであなたが指定する宛先 URL は常に、App Review に提出するアプリバイナリの値と一致しなければなりません。

各宛先 URL が以下の条件をすべて満たしていることを確認してください。

HTTPS スキームを使用している

有効な絶対 URL を形成している

query (問い合わせ) パラメータが含まれていない

ASCII 文字が 1,000 文字以下である。

以下のコード例は、複数の国コードのキーと各エントリへのリンクを含むプロパティリストエントリを示しています。

<key>SKExternalPurchaseMultiLink</key>
<dict>
<key>es</key>
<array>
<string>https://www.example.com/es1</string>
<string>https://www.example.com/new-user-es</string>
<string>https://www.example.com/seasonal-sale-es</string>
<string>https://www.example.com/es2</string>
<string>https://www.example.com/es3</string>
</array>
<key>fr</key>
<array>
<string>https://www.example.com/fr</string>
<string>https://www.example.com/global-sale</string>
<string>https://www.example.com/new-user-fr</string>
</array>
<key>it</key>
<array>
<string>https://www.example.com/global-sale</string>
</array>
</dict>

リンクの順序は重要ではありません。

詳細については、外部購入 (External Purchase) および ExternalPurchaseLink を参照してください。

最大数のリンクを提供する

以下の国コードには、外部購入リンクを提供する EEA で音楽ストリーミングアプリの配布 で説明されているように、StoreKit 外部購入リンクの資格を満たすアプリのリンクが最大 5 つあります: オーストリア (at)、ベルギー (be)、ブルガリア (bg)、クロアチア (hr)、キプロス (cy)、チェコ (cz)、デンマーク (dk)、エストニア (ee)、フィンランド (fi)、フランス (fr)、ドイツ (de)、ギリシャ (gr)、ハンガリー (hu)、アイルランド (ie)、イタリア (it)、ラトビア (lv)、リトアニア (lt)、ルクセンブルク (lu)、マルタ (mt)、オランダ (nl)、ポーランド (pl)、ポルトガル (pt)、ルーマニア (ro)、スロバキア (sk)、スロベニア (si)、スペイン (es)、スウェーデン (se)、アイスランド (is)、ノルウェー (no)。それ以外の場合、有効な国コードの最大リンク数は 1 つです。

SKExternalPurchaseMultiLink および SKExternalPurchaseLink プロパティリストキーであなたが提供するリンクの数を合計して、国コードごとに提供する一意のリンクの合計数をカウントします。

たとえば、国コードに最大 5 つのリンクがあり、SKExternalPurchaseMultiLink キーに 5 つの一意のリンクをあなたが提供する場合、SKExternalPurchaseLink キーに同じ 5 つのリンクのうちの 1 つを指定して、許可されている最大リンク数を超えないようにします。国コードに最大 1 つのリンクがある場合、SKExternalPurchaseMultiLink キーと SKExternalPurchaseLink キーに同じリンクを指定する必要があります。