この情報は、ADBMobile.json
設定ファイルを使用する場合に役立ちます。
複数のプラットフォームで同じ設定ファイルをアプリに使用することができます。
iOS では、バンドル内でアクセス可能な任意の場所に ADBMobileConfig.json
ファイルを配置できます。
acquisition
モバイルアプリの獲得を有効にします。
このセクションがない場合は、モバイルアプリの獲得を有効にして、SDK 設定ファイルを再度ダウンロードしてください。詳しくは、以下の referrerTimeout を参照してください。
server
- 初回起動時に獲得リファラーを探すために確認される獲得サーバー。appid
- 獲得サーバー上でこのアプリを一意に識別する生成された ID。analyticsForwardingEnabled
audienceManager
オブジェクトのプロパティ。Audience Manager
が設定され、analyticsForwardingEnabled
が true
に設定されている場合は、Analytics のトラフィックもすべて Audience Manager に転送されます。デフォルト値は false
です。
backdateSessionInfo
Adobe SDK がセッション情報のヒットの日付を遡る機能を有効または無効にします。
現在、セッション情報のヒットは、クラッシュ回数とセッションの長さで構成されており、有効または無効にすることができます。
値が false
に設定されている場合、ヒットは無効になります。
SDK は 4.1 より前の動作に戻り、前のセッションのセッション情報を後続セッションの最初のヒットとまとめて処理します。また、Adobe SDK は、セッション情報を現在のライフサイクルに付加し、これにより、訪問の水増しを防ぎます。水増し訪問が発生しなくなるので、すぐに訪問回数が減少します。
値を指定しない場合、デフォルト値は true
になり、ヒットは有効になります。
ヒットを有効にした場合、Adobe SDK は、セッション情報のヒットを、前のセッションの最終ヒットの 1 秒後に戻します。これによって、クラッシュとセッションのデータが、その正しい発生日に関連付けられます。1 つの副作用として、日付を遡ったヒットの訪問が SDK によって作成される可能性があります。アプリケーションを新しく起動するたびに、1 つのヒットの日付を遡ります。
最小 SDK バージョン:4.6
日付を遡るセッションヒット情報は、セッション情報サーバー呼び出しで送信されます。このとき、追加のサーバー呼び出しが適用される場合があります。
batchLimit
連続する呼び出しで送信されるヒット数のしきい値。例えば、この batchLimit
を 10 に設定した場合は、ヒットが 10 個たまるまでヒットをキューに格納していきます。10 番目のヒットが格納されると、10 個のヒットすべてが連続して送信されます。
0
です。これはバッチ処理が有効になっていないことを意味します。offlineEnabled = true
が必要です。charset
Analytics に送信されるデータに使用する文字セットを定義します。この文字セットは、受信データを格納およびレポート用に UTF-8 に変換するために使用されます。詳しくは、「s.charSet」を参照してください。
clientCode
割り当てたクライアントコード。
この変数は Target で必要です。
coopUnsafe
Device Co-op のユーザーで、この値を true
に設定する必要がある場合は、Co-op グループに連絡して、お使いの Device Co-op アカウント上でブロックリストフラグをリクエストする必要があります。これらのフラグをセルフサービスで有効にする方法はありません。
次の情報に留意してください。
coopUnsafe
を coop_unsafe=1
に設定すると、常に Audience Manager および訪問者 ID ヒットに true
が追加されます。coop_unsafe=1
も表示されます。追加情報を以下に示します。
marketingCloud
オブジェクトのブールプロパティが true
に設定されると、デバイスが Experience Cloud の Device Co-op からオプトアウトします。false
です。environmentId
使用する環境の ID です。有効な ID(environmentId=8
)を指定できます。environmentId
が含まれていない場合、デフォルトの実稼動環境を使用します。
lifecycleTimeout
デフォルト値は 300 秒です。
アプリケーションが起動されてから新しいセッションであると見なされるまでに経過する必要がある時間を秒数で指定します。このタイムアウトは、アプリケーションがバックグラウンドに移行し、再びアクティブになる場合にも適用されます。アプリケーションがバックグラウンドになっている時間はセッションの長さには含まれません。
messages
Adobe Mobile Services によって自動的に生成され、アプリ内メッセージの設定を定義します。詳しくは、以下の「メッセージの説明」節を参照してください。
offlineEnabled
有効にした場合、ヒットはデバイスがオフラインのときにキューに格納され、後でデバイスがオンラインになったときに送信されます。オフライン追跡を使用するには、レポートスイートでタイムスタンプを有効にする必要があります。デフォルト値は false
です。
いくつかの重要情報を以下に示します。
レポートスイートでタイムスタンプが有効になっている場合、offlineEnabled
設定プロパティを必ず true に設定してください。
レポートスイートでタイムスタンプが有効になっていない場合、offlineEnabled
設定プロパティを必ず false に設定してください。
このプロパティを適切に設定しなければ、データが失われます。レポートスイートのタイムスタンプが有効になっているかどうかが不明な場合は、カスタマーケアに問い合わせるか、Adobe Mobile Servicesから設定ファイルをダウンロードしてください。現在、同じレポートスイートで JavaScript と AppMeasurement からデータを収集している場合は、モバイルデータのレポートスイートを個別に設定するか、s.timestamp
変数を使用するすべての JavaScript ヒットにカスタムタイムスタンプを含めます。
最小 SDK バージョン:4.0
org
Adobe Experience Platform ID サービスに Experience Cloud 組織 ID を指定します。
poi
各 POI 配列は、対象の地点の POI 名、緯度、経度、半径(メートル単位)を保持します。POI 名には任意の文字列を使用できます。trackLocation
コールの送信時、現在の座標が定義した目標地点内にある場合は、コンテキストデータ変数に代入され、trackLocation
コールで送信されます。
"poi" [
["sanfrancisco",37.757144,-122.44812,7000]
["santacruz",36.972935,-122.01725,600]
]
バージョン 4.2 以降、POI は Adobe Mobile インターフェイスで定義され、アプリ設定ファイルに動的に同期されます。この同期をおこなうには、analytics.poi
設定が必要です。
“analytics.poi”: “`https://assets.adobedtm.com/…/yourfile.json`”,
これを設定しない場合は、ADBMobile.json
ファイルを更新してこの行を含める必要があります。更新された設定ファイルをダウンロードするには、「事前設定」を参照してください。
postback
「コールバック」メッセージテンプレートの定義を次に示します。
"payload":{
"templateurl":"",//required- will be token-expanded prior to being sent
"templatebody":"", //optional-if this length > 0 POST will be used as transport method. This is a base-64 encoded blob,which will be decoded and token-expanded prior to being sent.
"contenttype":"", //optional-if this is length > 0 and POST type is selected, this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
"timeout": 0 //optional-number of seconds to wait before timingout.Defaultis2.}
コード内の payload
オブジェクトは、ADBMobileConfig.json
ファイルに追加されるメッセージ定義のサンプルペイロードです。詳しくは、「ポストバック」を参照してください。
privacyDefault
optedin
:ヒットは即座に送信されます。
optedout
:ヒットは破棄されます。
optunknown
:レポートスイートのタイムスタンプが有効になっている場合、プライバシーステータスがオプトイン(ヒットが送信される)またはオプトアウト(ヒットが破棄される)に変更されるまで、ヒットは保存されます。
レポートスイートのタイムスタンプが有効になっていない場合、プライバシーステータスがオプトインに変更されるまで、ヒットは破棄されます。
このオプションは、初期値のみを設定します。この値をコードで設定または変更した場合、値が再び変更されるか、アプリがアンインストールされて再インストールされるまで、新しい値が使用されます。デフォルト値は optedin
です。
最小 SDK バージョン:4.0
referrerTimeout
初回起動時に、SDK が獲得リファラーデータを待機する秒数です。この秒数を過ぎるとタイムアウトになります。獲得を使用している場合、推奨タイムアウトは 5 秒です。
この変数は獲得で必要です。この変数が 0
、またはこの変数自体が含まれていない場合は、SDK は獲得データを待機せず、獲得指標は追跡されません。
remotes
自動的に設定され、アドビがホストする、動的設定ファイルのエンドポイントを定義します。起動するたびに各設定ファイルの最終更新時間が現在のバージョンと比較され、更新がダウンロードされて保存されます。
analytics.poi
は、ホストされる POI 設定のエンドポイントです。
messages
は、ホストされるアプリ内メッセージ設定のエンドポイントです。
最小 SDK バージョン:4.2
rsids
Analytics データを受信する 1 つ以上のレポートスイート。レポートスイート ID を複数指定する場合は、スペースを入れずにレポートスイート ID をコンマで区切る必要があります。
"rsids": "rsid"
"rsids" : "rsid1,rsid2"
この変数は Analytics で必要です。
server
親ノードに基づく、Analytics または Audience Management サーバー。
この変数は、https://
または https://
プロトコルプレフィックスを付けずに、サーバードメインを設定する必要があります。プレフィックスは、ライブラリによって自動的に処理され、ssl
変数に基づきます。
ssl
が true
の場合、このサーバーとの安全な接続が確立されます。ssl
が false
の場合、このサーバーとの安全でない接続が確立されます。
この変数は、Analytics または Audience Management で必要です。
ssl
バージョン 4.10.0 以降では、フラグが設定されていない場合、SSL はデフォルトで true に設定されています。
SSL(HTTPS)を使用して測定データを送信する機能を有効(true
)または無効(false
)にします。
「コールバック」メッセージテンプレートの定義を次に示します。
"payload":{
"templateurl":"",//required-will be token-expanded prior to being sent
"templatebody":"",//optional-if this length > 0, POST will be used as transport method. This is a base64 encoded blob,which will be decoded and token-expanded prior to being sent.
"contenttype":"",//optional-if this is length > 0 and POST type is selected this will be set as the Content-Typeheader. if this is not supplied for a POST request,the default will be "application/x-www-form-urlencoded"
"timeout":0//optional-numberofsecondstowaitbeforetimingout.Defaultis2.}
コードの payload
オブジェクトは、ADBMobileConfig.json
ファイルに設定するメッセージ定義のサンプルペイロードです。詳しくは、「ポストバック」を参照してください。
timeout
Target が応答を待つ時間を決定します。
ADBMobileConfig.json
ファイルサンプルの ADBMobileConfig.json
ファイルを次に示します。
{
"version": "2014-08-05T19:18:28.169Z",
"marketingCloud" : {
"org": "016D5C175213CCA80A490D05@AdobeOrg",
"coopUnsafe": false
},
"target": {
"clientCode": "",
"timeout": 5,
"environmentId": 8
},
"audienceManager": {
"server": "",
"analyticsForwardingEnabled": false
},
"acquisition": {
"server": "c00.adobe.com",
"appid": "10a77a60192fbb628376e1b1daeeb65debf934e2c807e067ceb2963a41b165ee"
},
"analytics": {
"rsids": "coolApp",
"server": "my.CoolApp.com",
"ssl": true,
"offlineEnabled": true,
"charset": "UTF-8",
"lifecycleTimeout": 300,
"privacyDefault": "optedin",
"batchLimit": 0,
"referrerTimeout": 5,
"poi": [
["san francisco",37.757144,-122.44812,7000],
["santa cruz",36.972935,-122.01725,600]
]
},
"messages": [
{
"messageId": "cb426565-a563-497a-a889-9dbeb451f8ae",
"template": "fullscreen",
"payload": {
"html": "<!DOCTYPE html><html><head><meta charset=\"utf-8\" /><title></title><style></style></head><body><iframe src=\"https://www.adobe.com/\" frameborder=\"0\"></iframe></body></html>"
},
"showOffline": false,
"showRule": "always",
"endDate": 2524730400,
"startDate": 0,
"audiences": [],
"triggers": [
{
"key": "pev2",
"matches": "eq",
"values": [
"AMACTION:custom"
]
}
]
}
],
"remotes": {
"analytics.poi": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0faadc2f9ed92bc00003b.json",
"messages": "https://assets.adobedtm.com/staging/42a6fc9b77cd9f29082cf19b787bae75b7d1f9ca/scripts/satellite-53e0f9e2c2f9ed92bc000032.json"
}
}
messages ノードは Adobe Mobile Services によって自動的に生成されます。通常は手動で変更する必要はありません。トラブルシューティングのために、以下の説明が提供されています。
"messageId"
"template"
"payload"
"html"
"画像"
"altImage"
image
に指定された URL に到達できない場合に使用)"title"
"content"
"confirm"
"cancel"
"url"
"wait"
"showOffline"
"showRule"
"endDate"
"startDate"
"audiences"
メッセージの表示方法を定義するオブジェクトの配列です。
"key"
ヒット内で検索する変数名。必須項目です。
"matches"
比較の実行時に使用するマッチャーのタイプ。
"values"
次に示す変数の値と一致する値の配列。
"triggers"
audiences と同じ。audiences の代わりとなるアクションを次に示します。