ID サービスから Adobe Experience Cloud Device Co-op にデータを送信するかどうかを指定する任意のブール型設定です。
内容:
isCoopSafe
を使用するには、以下の要件を満たす必要があります。
バージョン 2.4 以降の ID サービスコードを使用する。
Experience Cloud Device Co-op に参加する。Co-op への参加を検討している場合は、このドキュメントをよく読み、デバイスグラフの作成にデータがどのように使用されるかに関する懸念に isCoopSafe
で対処できるかどうかを確認する必要があります。
Adobeコンサルタントに依頼して、Device Co-op アカウントにホワイトリストまたはブラックリストのフラグを設定する。これらのフラグをセルフサービスで有効にする方法はありません。
isCoopSafe
は、Device Co-op に既に参加しているお客様や、参加を検討しているお客様によるデータ収集に関連した 2 つのユースケースの解決に役立ちます。これらのユースケースは、サイト訪問者のデータが Device Co-op にどのように渡され、デバイスグラフの作成にどのように役立てられるかということに関連しています。これらのユースケースで isCoopSafe
がデータをどのようにブロックまたは送信するかを次の表で説明します。
使用例 | 説明 |
---|---|
認証済み訪問者 |
isCoopSafe を ID サービスコードに追加して、使用規約同意書に同意した(または同意していない)認証済み訪問者のデータを Device Co-op がデバイスグラフの作成にどのように使用するかを管理します。 |
サードパーティサイトの DIL |
isCoopSafe を ID サービスコードに追加して、以下の場合にサードパーティサイトで使用します。
|
構文: isCoopSafe: true | false
Device Co-op で顧客データを利用するか利用しないかをブール型オプションで指定します。
isCoopSafe: true
:モバイル SDK または Web サイトが収集した訪問者データをデバイスグラフの作成に利用できます。
isCoopSafe: false
:モバイル SDK または Web サイトが収集した訪問者データをデバイスグラフの作成に利用できません。
コードサンプル
ID サービスコードをインスタンス化する際には、次のように設定します。
var visitor = Visitor.getInstance("Insert Experience Cloud organization ID here",{
...
isCoopSafe: true
});
設定したフラグ(true
または false
)に応じて、ID サービスは isCoopSafe
をこれらの POST パラメーターに変換し、イベント呼び出しで Adobe に送信します。
d_coop_safe=1
d_coop_unsafe=1
POST パラメーターは、ユーザーデータをデバイスグラフに含めてもよいかどうかを Experience Cloud Device Co-op に通知します。次の表で isCoopSafe
のブール型フラグとイベント呼び出し時に渡される POST パラメーターの関係について説明します。isCoopSafe
を使用しない場合、イベント呼び出しにおいて、これらのいずれも渡されません。
設定ステータス | POST パラメーター |
---|---|
isCoopSafe: true |
d_coop_safe=1 Device Co-op は訪問者データをデバイスグラフの作成に利用できます。 |
isCoopSafe: false |
d_coop_unsafe=1 Device Co-op は訪問者データをデバイスグラフの作成に利用できません。 |
これらの API を使用すると isCoopSafe
のステータスを変更できます。これらを使用すると、ページが更新されない場合にサイトやシングルページアプリで訪問者のインスタンス化後またはログイン後のステータスを変更できます。例えば、ユーザーがサイトやアプリで認証をおこない、後で Device Co-op によるデータ利用を許可する使用規約ポリシーに同意した場合に、これらの API を呼び出す必要があります。
API | 説明 |
---|---|
visitor.setAsCoopSafe(); |
後続のすべてのイベント呼び出しで POST パラメーター d_coop_safe=1 を設定します。 |
visitor.setAsCoopUnsafe(); |
後続のすべてのイベント呼び出しで POST パラメーター d_coop_unsafe=1 を設定します。 |