SKAdNetworkとconversion valueの設定

StoreKit AdNetwork（SKAdNetwork）は、アプリのインストールおよび再インストールアトリビューションのための、Appleのフレームワークです。SKAdNetworkのワークフローは以下のようになります：

Appleがアトリビューション情報を収集し、関連するアドネットワークに通知します。
ネットワークがこの情報をAdjustにポストバックで送信します。
AdjustがDatascape上にSKAdNetworkデータを表示します。

Disable SKAdNetwork communication

- (void)deactivateSKAdNetworkHandling;

Adjust SDKはv4.23.0以降ではデフォルトでSKAdNetworkと通信を行います。SDKは初期化時にSKAdNetworkのアトリビューションを記録します。

Configオブジェクトにはブーリアン値のisSKAdNetworkHandlingActiveプロパティが含まれており、それが動作を制御します。SKAdNetworkとの通信を非有効化するには、引数なしでdeactivateSKAdNetworkHandlingメソッドを呼び出してください。

Update conversion values

+ (void)updateConversionValue:(NSInteger)conversionValue;

Conversion valueは、SKAdNetworkでアプリ内のユーザー行動を計測するためのメカニズムです。64の条件を0～63の値に対応させ、ユーザーのインストール時にこの整数値をSKAdNetworkに送信することができます。これによって、はじめの3日間のユーザー行動に関するインサイトを取得することが可能になります。

Adjustでconversion valueを管理している場合、AdjustのサーバーはSDKでこの値を更新します。また、updateConversionValueメソッドを使用して、この値を更新することが可能です。このメソッドはAppleのupdateConversionValueメソッドをラップしており、更新されたconversion valueを表す整数の引数を受け入れます。

Example

この例では、ユーザーがイベントをトリガーしたことに応じて、conversion valueを10に更新する方法を示しています。

Set up completion handlers

Adjust SDKには、AppleのupdatePostbackConversionValueメソッドのラッパーが含まれています。これらのメソッドを使用すると、エラーを処理するオプションを含め、より多くの方法でSKAdNetworkポストバックを処理できます。

以下のメソッドがサポートされます。

updatePostbackConversionValue(_:completionHandler:)：conversion valueを更新してエラーを処理します。
updatePostbackConversionValue(_:completionHandler:coarseValue:)：粗い粒度と細かい粒度の両方のconversion valueを更新し、エラーを処理します。
updatePostbackConversionValue(_:coarseValue:lockWindow:completionHandler:)：粗い粒度と細かい粒度の両方のconversion valueをアップデートし、conversion value期間の終了前にポストバックを送信するかどうかを決定し、エラーを処理します。

引数	データタイプ	説明
`fineValue`	整数	Conversion value。`0`～`63`の値にする必要があります。
`coarseValue`	`SKAdNetwork.CoarseConversionValue`	粒度が粗いconversion value。この値は、プライバシーのしきい値に到達するだけのアプリインストール数でない場合に使用されます。 `SKAdNetworkCoarseConversionValueLow` `SKAdNetworkCoarseConversionValueMedium` `SKAdNetworkCoarseConversionValueHigh`
`lockWindow`	Boolean	Conversion期間の終了前にポストバックを送信するかどうか。 `true`を指定した場合、conversion期間の終了を待たずにポストバックを送信するようにシステムに指示します。デフォルトの設定は`false`となっています。
`completion`	機能	オプションの完了ハンドラー。conversion valueのアップデート時にこのメソッドで発生するエラーをキャッチして処理するために指定します。ハンドラーを指定しない場合は、この値を`nil`に設定します。

Example

Listen for changes to conversion values

Adjustを使用してconversion valueを管理している場合、Adjustのサーバーはconversion valueのアップデートをSDKに送信します。adjustConversionValueUpdatedメソッドを使用して、こうした変更を受信するデリゲート関数を設定できます。

Example

この例では、conversion valueが更新されたときに以下を記録する方法を示しています：

conversion valueのアップデートを確認するメッセージ
新しいconversion value

SKAdNetwork 4.0 callbacks

SKAdNetwork 4.0のポストバックにはいくつかの追加情報が含まれており、広告主はユーザーに関する詳細なインサイトを得ることができます。この追加情報は、Adjustサーバーによってconversion valueが更新されるときにペイロードで送信されます。この情報には、adjustConversionValueUpdatedコールバックメソッドを使用してアクセスできます。

引数	データタイプ	説明
`fineValue`	`NSNumber`	Adjustサーバーから送信されるconversion value。
`coarseValue`	`NSString`	粒度が粗いconversion value。この値は、プライバシーのしきい値に到達するだけのアプリインストール数でない場合に使用されます。 `none` `low` `medium` `high` Appleは、low, medium, highに設定された条件がいずれも満たされなかった場合、noneを送信します。
`lockWindow`	`NSNumber`	Conversion期間の終了前にポストバックを送信するかどうか。`1`の場合、conversion期間の終了前にポストバックが送信されることを示します。デフォルト値は、SKAdNetwork 4.0のポストバックでは`0`、それ以前のSKAdNetworkのポストバックでは`nil`になります。

Example

この例では、粒度が細かいconversion value、粒度が粗いconversion value、SKAdNetworkポストバックがconversion期間の終了前に送信されるよう設定されているかどうかをログに記録する方法を示しています。

Set up direct install postbacks

獲得したSKAdNetworkコールバックのコピーをAdjustに送信するようにアプリを設定できます。これにより、SKAdNetworkの情報をアナリティクスで使用できるようになります。

ダイレクトインストールポストバックを設定するには、Info.plistファイルにAdjustのコールバックURLを追加してください：

Xcodeのプロジェクトナビゲーターで Info.plist を選択します。
プロパティリストエディタでキーの横にある追加ボタンを選択し、Returnキーを押します。
キーの名前として NSAdvertisingAttributionReportEndpoint を入力します。
ポップアップ画面で Type から String までを設定します。
アドレス https://adjust-skadnetwork.com を入力します。