トピック×
設定メソッド
iOS ライブラリが提供するメソッドの一覧を以下に示します。
SDK は現在、Analytics、Target、Audience Manager、Adobe Experience Platform ID サービスなど、複数の Adobe Experience Cloud ソリューションをサポートしています。
- setAppExtensionType現在実行中のエクステンションの種類を判断するように Adobe Mobile SDK 設定を指定します。次のいずれかの値に設定します。
- ADBMobileAppExtensionTypeRegular :エクステンションは本体アプリにバンドルされています。
- ADBMobileAppExtensionTypeStandAlone :エクステンションは本体アプリにバンドルされていません。
このメソッドは、アプリにエクステンションがあるか、アプリがスタンドアロンエクステンションの場合に のみ 使用してください。詳しくは、以下の referrerTimeout を参照してください。- このメソッドの構文を次に示します。
+ (void) setAppExtensionType:(ADBMobileAppExtensionType)type;
- このメソッドのコードサンプルを次に示します。
[ADBMobile setAppExtensionType:ADBMobileAppExtensionTypeStandAlone];
- versionAdobe Mobile ライブラリの現在のバージョンを返します。
- このメソッドの構文を次に示します。
+(NSString*) version;
- このメソッドのコードサンプルを次に示します。
NSString*libraryVersion = [ADBMobileversion];
- privacyStatus現在のユーザーのプライバシーステータスの enum 表現を返します。
- ADBMobilePrivacyStatusOptIn :ヒットは即座に送信されます。
- ADBMobilePrivacyStatusOptOut :ヒットは破棄されます。
- ADBMobilePrivacyStatusUnknown - オフライン追跡が有効になっている場合、プライバシーステータスがオプトイン(ヒットが送信される)またはオプトアウト(ヒットが破棄される)に変更されるまで、ヒットは保存されます。オフライン追跡が有効になっていない場合、プライバシーステータスがオプトインに変更されるまで、ヒットは破棄されます。デフォルト値は ADBMobileConfig.json ファイルに設定します。
- このメソッドの構文を次に示します。
+ (ADBMobilePrivacyStatus) privacyStatus;
- このメソッドのコードサンプルを次に示します。
ADBMobilePrivacyStatus privacyStatus = [ADBMobileprivacyStatus];
- setPrivacyStatus現在のユーザーのプライバシーステータスを status に設定します。次のいずれかの値に設定します。
- ADBMobilePrivacyStatusOptIn :ヒットは即座に送信されます。
- ADBMobilePrivacyStatusOptOut :ヒットは破棄されます。
- ADBMobilePrivacyStatusUnknown - オフライン追跡が有効になっている場合、プライバシーステータスがオプトイン(ヒットが送信される)またはオプトアウト(ヒットが破棄される)に変更されるまで、ヒットは保存されます。オフライン追跡が有効になっていない場合、プライバシーステータスがオプトインに変更されるまで、ヒットは破棄されます。
- このメソッドの構文を次に示します。
+ (void) setPrivacyStatus:(ADBMobilePrivacyStatus)status;
- このメソッドのコードサンプルを次に示します。
[ADBMobile setPrivacyStatus:ADBMobilePrivacyStatusOptIn];
- lifetimeValue現在のユーザーのライフタイム値を返します。デフォルト値は 0 です。
- このメソッドの構文を次に示します。
+ (NSDecimalNumber *) lifetimeValue;
- このメソッドのコードサンプルを次に示します。
NSDecimalNumber *lifeValue = [ADBMobile lifetimeValue];
- trackingIdentifier自動的に生成された訪問者識別子を返します。これは、アドビのサーバーによって生成される、アプリ固有の一意の訪問者 ID です。生成時にアドビのサーバーに到達できない場合、ID は Apple の CFUUID を使用して生成されます。値は初期起動時に生成され、保存されて、その時点から使用されます。この ID はアプリをアップグレードしても保持され、標準的なアプリケーションバックアッププロセス時に保存および復元され、アンインストール時に削除されます。アプリを Experience Cloud 3.x から 4.x SDK にアップグレードした場合、以前のカスタムまたは自動生成された訪問者 ID が取得され、カスタムユーザー識別子として保存されます。詳しくは、以下の userIdentifier 行を参照してください。これによって、SDK をアップグレードしても訪問者データが保持されます。4.x SDK を新規インストールした場合、ユーザー識別子は nil なので、トラッキング識別子が使用されます。
- このメソッドの構文を次に示します。
+ (NSString *) trackingIdentifier;
- このメソッドのコードサンプルを次に示します。
NSString *tid = [ADBMobile trackingIdentifier];
- userIdentifierカスタムの識別子が設定されている場合は、ユーザーの識別子が返されます。カスタムの識別子が設定されていない場合は、 nil が返されます。デフォルト値は nil です。アプリを Experience Cloud 3.x から 4.x SDK にアップグレードした場合、以前のカスタムまたは自動生成された訪問者 ID が取得され、カスタムユーザー識別子として保存されます。これにより、SDK をアップグレードしても訪問者データは保存されます。4.x SDK での新規インストールの場合、ユーザー識別子は設定されるまで nil です。
- このメソッドの構文を次に示します。
+(NSString *) userIdentifier;
- このメソッドのコードサンプルを次に示します。
NSString *uid = [ADBMobileuserIdentifier];
- setUserIdentifierユーザー識別子を identifier に設定します。
- このメソッドの構文を次に示します。
+(void)setUserIdentifier:(NSString*)identifier;
- このメソッドのコードサンプルを次に示します。
[ADBMobile setUserIdentifier:@"billybob"];
- debugLogging現在のデバッグログの環境設定を返します。デフォルト値は NO です。
- このメソッドの構文を次に示します。
+ (BOOL) debugLogging;
- このメソッドのコードサンプルを次に示します。
BOOL debugging = [ADBMobile debugLogging];
- setDebugLoggingデバッグログの環境設定を debug に設定します。
- このメソッドの構文を次に示します。
+ (void) setDebugLogging:(BOOL)debug;
- このメソッドのコードサンプルを次に示します。
[ADBMobile setDebugLogging:YES];
- keepLifecycleSessionAlive設定ファイル内のライフサイクルセッションのタイムアウト値にかかわらず、バックグラウンドから次に戻ったときに新しいセッションを開始しないように SDK に指示します。このメソッドは、バックグラウンドにある間に通知を登録するアプリで使用されることを目的としており、アプリがバックグラウンドにある間に実行されるコードからのみ呼び出される必要があります。
- このメソッドの構文を次に示します。
+ (void) keepLifecycleSessionAlive;
- このメソッドのコードサンプルを次に示します。
[ADBMobile keepLifecycleSessionAlive];
- collectLifecycleDataSDK のすべてのソリューションで使用するライフサイクルデータを収集するように SDK に指示します。詳しくは、「 ライフサイクル指標 」を参照してください。このメソッドを呼び出すのに望ましい場所は、 application:didFinishLaunchingWithOptions: 内です。
- このメソッドの構文を次に示します。
+ (void) collectLifecycleData;
- このメソッドのコードサンプルを次に示します。
[ADBMobile collectLifecycleData];
- collectLifecycleDataWithAdditionalData:ライフサイクル指標収集時に追加データとして渡すことができます。このメソッドは、アプリのエントリポイントから呼び出す必要があります。該当する場合、 application:didFinishLaunchingWithOptions: メソッドと applicationWillEnterForeground: メソッドのどちらかまたは両方を AppDelegate クラスに含めることができます。collectLifecycleDataWithAdditionalData: を使用して SDK に渡されたデータは、SDK によって NSUserDefaults に保持されます。SDK は、 NSDictionary 型または NSString 型ではない NSNumber パラメーターの値を削除します。 collectLifecycleDataWithAdditionalData: を使用するには、SDK バージョン 4.4 以降が必要です。
- このメソッドの構文を次に示します。
+ (void) collectLifecycleDataWithAdditionalData:(nullableNSDictionary*)data;
- このメソッドのコードサンプルを次に示します。
[ADBMobile collectLifecycleDataWithAdditionalData:@{@"entryType":@"appShortcutIcon"}];
- overrideConfigPathアプリケーションの起動時に、別の ADBMobile JSON 設定ファイルを読み込むことができます。アプリケーションが閉じられるまで、この設定が使用されます。overrideConfigPath を使用するには、SDK バージョン 4.2 以降が必要です。
- このメソッドの構文を次に示します。
+ (void) overrideConfigPath: (nullableNSString *) path;
- このメソッドのコードサンプルを次に示します。
NSString *filePath = [[NSBundle mainBundle] pathForResource:@"ExampleJSONFile" ofType:@"json"]; [ADBMobile overrideConfigPath:filePath];
- setPushIdentifierプッシュ通知用のデバイストークンを設定します。このメソッドは、 application:didRegisterForRemoteNotificationsWithDeviceToken: メソッド内でのみ使用する必要があります。
- このメソッドの構文を次に示します。
+ (void) setPushIdentifier:(NSData *)deviceToken;
- このメソッドのコードサンプルを次に示します。
- (void) application:(UIApplication *) application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { [ADBMobile setPushIdentifier:deviceToken]; }
- setAdvertisingIdentifierIDFA を SDK に設定します。SDK で IDFA が設定されている場合、ライフサイクルで IDFA が送信されます。IDFA にはシグナル(ポストバック)でもアクセスできます。広告サービスを使用している場合に のみ 、Apple API から IDFA を取得してください。IDFA を取得し、正しく使用していない場合は、アプリが拒否されることがあります。
- このメソッドの構文を次に示します。
+(void) setAdvertisingIdentifier:(NSString*)identifier;
- このメソッドのコードサンプルを次に示します。
NSString *idfa = [[[ASIdentifierManager sharedManager]advertisingIdentifier] UUIDString]; [ADBMobile setAdvertisingIdentifier:idfa];
ADBMobileAppExtensionType enum
/** * @brief An enum type. * The possible types of app extension you might use * @see setAppExtensionType */ typedef NS_ENUM(NSUInteger, ADBMobileAppExtensionType) { ADBMobileAppExtensionTypeRegular = 0, /*!< Enum value ADBMobileAppExtensionTypeRegular. */ ADBMobileAppExtensionTypeStandAlone = 1 /*!< Enum value ADBMobileAppExtensionTypeStandAlone. */ };