Unreal Engine SDK:Skadnetworkサポートの追加

 

はじめにSKAdNetworkとSKAN

SKAdNetworkは、エンドユーザーのプライバシーを損なうことなくモバイルインストールを帰属させるためのAppleの新しいフレームワークです。Singularの新バージョンのiOS SDKは、最小限のエンジニアリング労力でシームレスにSKAdNetworkを実装するのに役立ちます。このSKAdNetworkの実装はSKAN-SKAdNetworkをスムーズに実装するためにSingularが開発した標準-に基づいています。

SingularのSKAdNetwork実装に関する完全なガイドは iOS SDK SKAdNetwork実装ガイドをご覧ください。

アンリアル エンジン SDK での SKAdNetwork の実装

USingularSDKBPLibrary::Initialize メソッドの設定

USingularSDKBPLibrary::Initialize メソッドでは、以下のオプションを設定できます。各オプションの詳細については、 iOS SDK SKAdNetwork 実装ガイドを参照してください。

オプション デフォルト
説明
skAdNetworkEnabled True SKAdNetworkサポートを有効にするにはtrueを設定します。
manualSKANConversionManagement False 変換値を手動で管理する場合は true に設定します。

注意:Unreal Engine SDK バージョン 2.0.11 以降、SKAdNetwork はデフォルトで有効になって います。

古いバージョンの SDK を使用している場合は、skAdNetworkEnabledTrue に設定して SKAdNetwork を有効にする必要があります。

SKAdNetwork メソッド

SingularSDK SkanRegisterAppForAdNetworkAttribution メソッド
説明

SKAdNetwork トラッキングに登録します。

注意事項

  • これはUSingularSDKBPLibrary::Initialize メソッドでskAdNetworkEnabledを True に設定するのと同じです。
  • このメソッドを呼び出すと、USingularSDKBPLibrary::Initialize で設定された値がオーバーライドされます。
  • アンリアル エンジン SDK バージョン 2.0.11 以降、SKAdNetwork はデフォルトで有効になっています。
署名 public void SkanRegisterAppForAdNetworkAttribution()
使用例
USingularSDKBPLibrary::SkanRegisterAppForAdNetworkAttribution();
SingularSDK SkanUpdateConversionValue メソッド
説明

SKAdNetwork の変換値を更新します。

注: SKAdNetworkの変換値を手動で更新することを選択した場合、このメソッドを使用する。このメソッドはmanualSKANConversionManagementTrue に設定されている場合にのみ動作する。

署名 public void SkanUpdateConversionValue(int conversionValue)
使用例
  // サイン会イベントが開催されました
  USingularSDKBPLibrary::SendEvent("SignUp");
  
  // コンバージョン値を 7 に更新します
  USingularSDKBPLibrary::SkanUpdateConversionValue(7);
SingularSDK SkanGetConversionValue メソッド
説明 Singular SDK が追跡している現在の変換値を取得します。
シグネチャ public int SkanGetConversionValue()
使用例
int value = USingularSDKBPLibrary::SkanGetConversionValue();

更新されたSKAN変換値への登録

  1. デリゲートを登録したいクラスのヘッダーファイルの先頭に#include "SingularDelegates.h" を追加します。
  2. クラスに以下を追加します:

      // 更新されたコンバージョン値を呼び出す登録するデリゲート
      UPROPERTY(BlueprintAssignable, Category = "Singular-SDK")
      FOnConversionValueUpdated OnConversionValueUpdated;
      
      // デリゲートを登録するために使用するメソッド
      UFUNCTION()
      void NewConversionValue(int32 conversionValue);
  3. クラス cpp ファイルでイベントに登録します:

    OnConversionValueUpdated.AddDynamic(this,&YOURCLASS::NewConversionValue);