DIL create メソッド dil-create

WARNING
2023 年 7 月以降、Adobeは Data Integration Library (DIL) と DIL の開発を廃止しました。
既存のお客様は、DIL 実装を引き続き使用できます。 ただし、Adobeはこの先 DIL は発展しません。 お客様は、長期的なデータ収集戦略について 🔗0}Experience Platform Web SDK} を評価することをお勧めします。
2023 年 7 月以降、新しいデータ収集統合機能の実装を検討しているお客様は、代わりに Experience Platform Web SDK を使用する必要があります。

DIL create dil-create-new

パートナー専用の DIL インスタンスを作成します。

関数シグネチャ:DIL.create: function (initConfig) {}

initConfig の要素

IMPORTANT
visitorService プロパティは​ 常に ​必須です。一覧にある他のプロパティは、別途指示がない限りオプションです。

initConfig では次の要素を使用できます。

名前
のタイプ
説明
containerNSID
整数

このプロパティは、ID 同期用に Audience Manager で使用されるコンテナ ID を設定します。DIL が複数のサイトにまたがってデプロイされている場合は、 containerNSID を設定します。このサイトのそれぞれに、個別のコンテナと ID 同期が設定されます。サイトが 1 つしかない場合は、コンテナ ID はデフォルトで 0 となり、このプロパティを設定する必要はありません。サイトと各サイトのコンテナ ID のリストについては、担当のコンサルタントにお問い合わせください。

Adobe Experience Platform ID サービスでは、プロパティ idSyncContainerID は DIL の containerNSID に対応します。複数のサイトで DIL ID サービスの両方を使用している場合は、次の点に注意してください。

  • 各サイトで、 containerNSID idSyncContainerID に同じコンテナ ID を設定します。
  • DIL と ID サービスの両方が、ID 同期をデータ収集 iFrame に送信しようと試みます。しかし、iFrame は DIL による ID 同期の実行を停止します。これにより、重複が防止されます。
  • DIL のみが URL の宛先にデータを送信します。

idSyncContainerID も参照してください。

declaredId
オブジェクト

declaredId は、次のいずれかを渡すために使用されます。

  • dpid :Audience Manager により割り当てられたデータパートナー ID。
  • dpuuid :ユーザーの一意の ID。

重要:エンコードされていない ID 値のみを使用してください。エンコードによって、識別子が二重にエンコードされます。

注意:Adobe Experience Platform ID サービスを使用している場合、DIL ではなく setCustomerIDs メソッドを使用して顧客 ID を設定します。詳しくは、顧客 ID と認証状態を参照してください。

delayAllUntilWindowLoad
ブール値
true の場合、 Page Load イベントが実行されるまで、すべてのリクエスト(IFRAME、イベント呼び出し、ID 同期、宛先設定)が遅延されます。初期設定は false です。
disableDeclaredUUIDCookie
ブール値
デフォルトは false です。この場合、Audience Manager はパートナーのドメインに Cookie (ファーストパーティの Cookie を設定)を設定します。
disableDestinationPublishingIframe
ブール値

重要:この要素は、DIL バージョン 8.0(2018 年 8 月にリリース)で非推奨(廃止予定)となりました。代わりに、Adobe Experience Platform ID サービスの visitor.disableIdSyncs 関数を使用してください。

true の場合、宛先パブリッシング IFRAME が DOM に付加されたり、宛先が有効になることはありません。初期設定は false です。

disableIDSyncs
ブール値

重要:この要素は、DIL バージョン 8.0(2018 年 8 月にリリース)で非推奨(廃止予定)となりました。代わりに、Adobe Experience Platform ID サービスの visitor.disableIdSyncs 関数を使用してください。

ID 同期を無効にします。DIL v6.2 以降と訪問者 ID サービスを使用する場合、ID 同期を無効にする必要があります。この操作は visitorService 関数でおこないます(以下のサンプルコードを参照)。

enableErrorReporting
ブール値
true に設定すると、ページ上のすべての DIL インスタンスのエラーレポートが有効になります。ブール値 true のみ機能します。
iframeAkamaiHTTPS
ブール値

重要:この要素は、DIL バージョン 8.0(2018 年 8 月にリリース)で非推奨(廃止予定)となりました。代わりに、Adobe Experience Platform ID サービスの visitor.idSyncSSLUseAkamai 関数を使用してください。

宛先の公開テンプレートで HTTPS 接続に Akamai を使用するかを指定します。パートナーごとに有効化されます。

mappings
オブジェクト
キー値ペアの値を、別のペアに関連付けます。キーと値の他のキーへのマッピングを参照してください。v2.4 でリリースされています。
namespace
文字列

必須。

namespace キー値ペアには、Experience Cloud の組織 ID が格納されます。この ID がわからない場合、Experience Cloud ダッシュボードの「Administration」セクションで確認できます。このダッシュボードを表示するには、管理者権限が必要です。製品の特長と機能の FAQ管理 - ユーザー管理と FAQ を参照してください。

partner
文字列

必須。

Audience Manager で指定されたパートナー名。

removeFinishedScriptsAndCallbacks
ブール値
スクリプトとコールバックを削除します。初期設定は False です。現在の DIL インスタンスにのみ適用されます。v3.3 でリリースされています。
uuidCookie
オブジェクト
Audience Manager により返された一意のユーザー ID を Cookie に設定します。uuidCookie プロパティを参照してください。
visitorService
オブジェクト

DIL 6.2 以降で必要です。

DIL では、Adobe Experience Platform ID サービスで setCustomerIDs 関数を使用して、宣言された ID を Audience Manager に渡します。詳しくは、顧客 ID および認証の状態を参照してください。

サンプルコード

サンプルの DIL 呼び出しとして、次のようなものが挙げられます。

var partnerObject1 = DIL.create({
  partner: "partner name",
  visitorService:{
    namespace: "INSERT-ORGANIZATION-ID-HERE"
  },
  containerNSID: 3,
  uuidCookie:{
    name:'ad_uuid',
    days:200,
    path:'/test',
    domain:'adobe.com',
    secure:true
  }
});

var partnerObject2 = DIL.create({
  partner: "partner name",
  visitorService:{
    namespace: "INSERT-MCORG-ID-HERE"
  },
  containerNSID: 3
});

成功すると、レスポンスで DIL インスタンスが返されます。コードの設定が適切でない場合や、エラーが発生した場合、処理は失敗し、エラーオブジェクト(スローなし)が返されます。

uuidCookie プロパティ uuidcookie-props

uuidCookie 変数で使用するプロパティを定義します。この変数は DIL.create メソッドの一部です。

uuidCookie には次のプロパティがあります。

名前
説明
name
Cookie の名前(デフォルトは aam_did)。
days
Cookie の有効期間(デフォルトは 100 日)。
path
Cookie のパス('/test' など。デフォルトは /)。
domain
Cookie が設定されているドメイン('adobe.com' など。デフォルトは '.'+document.domain)。
secure
データを HTTPS 接続経由でのみ送信するようフラグを設定します。

visitorService プロパティ visitor-service-props

visitorService 変数で使用するプロパティを定義します。この変数は DIL.create メソッドの一部です。

visitorService には次のプロパティがあります。

名前
のタイプ
説明
namespace
文字列
必須。Experience Cloud 組織 ID を表します。Experience Cloud コアサービス機能で必要となります。訪問者 ID 機能のインスタンス化に使用するパラメーターと同じです。

コードサンプル:

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695