ドキュメント

iOS SKAdNetwork サポート

SKAdNetworkインテグレーションやユーザー同意の処理に関するガイダンスなど、AppleのiOS14のプライバシー要件をサポート。
読み終わるまでの所要時間 10 分最終更新 1ヶ月前

このガイドは、Unityがプログラマティック パートナー向けに現在提案しているUnity Adsオークション ロジックの変更を示しています。このドキュメントを定期的に参照して、最新のガイダンスを確認することをお勧めします。
注
すべてのフィールドと名前は大文字と小文字が区別されます。

入札リクエスト変更

BidRequest.imp.ext.skadn

DSPがパブリッシャー アプリケーションの
Info.plist
に少なくとも1つの
SKAdNetworkItem
がある場合、Unityはこのオブジェクトを入札リクエストに加えます。これは、署名の作成に必要な情報を提供します。

フィールド

型

説明

例

sourceapp
stringApple のアプリストアのパブリッシャー App ID。入札リクエストの application.bundle 値と一致する必要があります。
"sourceapp":"123456789"
skadnetids
string arrayパブリッシャーアプリケーションのInfo.plist_ファイルに表示されるDSP固有の
SKAdNetworkItem
エントリーの小文字のリスト。
"skadnetids": ["dsp1.skadnetwork"]
versions
string arrayサポートされている skadnetwork バージョンを含む文字列の配列。OS バージョンと SDK バージョンの両方に依存。
"versions":["2.0","2.1","3.0"]

BidRequest.device.ext.atts

Unity の
BidRequest.device.ext.atts
フィールドにはアプリケーション トラッキングの承認状態が表示されます。このフィールドの詳細については、Apple の API ドキュメント

フィールド

型

説明

例

atts
int
アプリケーション トラッキング承認の状態値。使用可能な値は以下のとおりです。
  • 0
    = 未決定
  • 1
    = 制限あり
  • 2
    = denied
  • 3
    = authorized
"atts":2

入札反応変更

BidResponse.seatbid.bid.ext.skadn

入札リクエストに
BidRequest.imp.ext.skadn
が含まれている場合、DSPは反応として
BidResponse.seatbid.bid.ext.skadn
オブジェクトを送信できます。存在する場合、Unity はこのオブジェクトの署名をアトリビューションに使用します。詳細については、Apple の API ドキュメント
Apple のアプリストアでのパブリッシャーアプリケーションの

フィールド

型

説明

例

signature
stringApple によって指定された
SKAdNetwork
署名。
"signature": "WOBQQIRTnAcfYzF..."
network
stringシグニチャで使用される広告ネットワーク識別子。これは、リクエスト内の
skadnetids
配列内のアイテムの 1 つと一致する必要があります。
"network":"5HUO92BLLQ.skadnetwork"
version
string指定した SKAdNetwork のバージョン。
"version":"2.0"
campaign
stringApple の仕様と互換性のあるキャンペーン ID。バージョン 2.0 では、これは
1
と
100
の間の整数でなければならず、文字列で表されます。
"campaign":"83"
itunesitem
stringApple のアプリストアの広告主 App ID。これは入札反応の bid.bundle と一致する必要があります。
"itunesitem":"987654321"
nonce
string各広告反応に一意の ID。
"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9"
sourceapp
stringID。これは入札リクエストの
imp.ext.skadn.sourceapp
と一致する必要があります。
"sourceapp":"123456789"
timestamp
stringシグニチャが生成されたときのミリ秒単位の Unix 時間。
"timestamp": "1225091839"
fidelities
object arraySKAdNetwork v2.2で導入された複数の忠実度タイプをサポートします。
"fidelities":[ { "fidelity":0, "signature": "MEQCIEQlmZRNfYzK…", "nonce":「473b1a16…」 "timestamp": "1603246928149" } ]
sourceidentifier
string
広告ネットワークが広告キャンペーンを表すために定義する 4 桁の整数。SKAdNetwork 4.0 以降で使用され、
BidResponse.imp.ext.skad.
フィールドを置き換えます。
注
DSP は、バージョン 4.0 以降でソース ID を使用して署名を生成する必要があります。バージョン 3.0 以前については、引き続き を使用します
campaign
。
"sourceidentifier": "1234"

bid.ext.skadn.fidelities

入札リクエストに
BidRequest.imp.ext.skadn
が含まれている場合、DSPは反応として
BidResponse.seatbid.bid.ext.skadn
オブジェクトを送信できます。存在する場合、Unity はこのオブジェクトの署名をアトリビューションに使用します。詳細については、Apple の API ドキュメントを参照してください。

フィールド

型

説明

例

fidelity
int追跡するアトリビューションの忠実度タイプ。
"fidelity": 0
nonce
string各広告反応に一意の ID。適切な UUID 形式 の要件については、Apple のドキュメントを参照してください。
"nonce":"385c9n44-a9ik-28fd-8247-gjk2efoa56a9
timestamp
stringシグニチャが生成されたときのミリ秒単位の Unix 時間。
"timestamp": "1225091839"
signature
stringApple によって指定された SKAdNetwork シグニチャ。
"signature": "MEQCIEQlmZRNfYzK…"

デバイス ID

注
Unity は IDFA が存在する場合はパスします。IDFA が存在しない場合は、IDFV が渡されます。

フィールド

型

説明

例

Device.ifa
string優先デバイス Advertisement Identifier(IDFA)。追跡する権限が与えられていない場合、値は
00000000-0000-0000-0000-000000000000
になります。
ABC123AB-1234-5678-A1B2-123ABCBCD789
Device.ext.ifv
stringパブリッシャー内のデバイスのIDFV。これは、同じベンダーのアプリケーション間の一意の識別子です。
ABCDEFGH-ABCD-1234-1234-ABCDEFGHABCD