ドキュメントExperience Platformソースコネクタガイド

[ベータ版]{class="badge informative"}

Oracle NetSuite

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者
NOTE
Oracle NetSuite ソースはベータ版です。ベータラベル付きソースの使用について詳しくは、 ソースの概要を参照してください。

Adobe Experience Platform を使用すると、外部ソースからデータを取り込みながら、Platform サービスを使用して受信データの構造化、ラベル付けおよび拡張を行うことができます。アドビのアプリケーション、クラウドベースのストレージ、データベースなど、様々なソースからデータを取り込むことができます。

Experience Platformでは、データのサードパーティのマーケティング自動化システムの取り込みがサポートされています。 マーケティング自動化プロバイダーのサポートには、Oracle NetSuite が含まれます。

Oracle NetSuite は、ERP/金融、CRM、e コマースソリューションを含むクラウドベースのビジネス管理スイートです。

2 つの異なるソースを使用して、Oracle NetSuite からExperience Platformにデータを取り込むことができます。

  • Oracle NetSuite Activities ソースを使用してイベントデータを取り込みます。
  • Oracle NetSuite Entities ソースを使用して、顧客および連絡先データを取り込みます。

2 つの Oracle NetSuite ソースについて詳しくは、次の表を参照してください。

ソース
タイプ
説明
Oracle NetSuite Activities
イベント
カレンダーに追加されたスケジュール済みアクティビティを取得します。
Oracle NetSuite Entities
顧客
顧客名、住所、キー識別子などの詳細を含む、特定の顧客データを取得します。
Oracle NetSuite Entities
連絡先
連絡先名、メール、電話番号、顧客に関連付けられたカスタム連絡先関連フィールドを取得します。

IP アドレス許可リスト ip-allow-list

ソースコネクタを操作する前に、IP アドレスのリストを許可リストに追加する必要がある場合があります。 地域固有の IP アドレスを許可リストに追加しないと、ソースを使用する際にエラーが発生したり、パフォーマンスが低下する場合があります。 詳しくは、IP アドレスの許可リストページを参照してください。

前提条件 prerequisites

Oracle NetSuite データをExperience Platformに取り込む前に、まず次の点を確認する必要があります。

  • Oracle NetSuite アカウント。

    • 有効なアカウントをお持ちでない場合は、Oracle NetSuite にお問い合わせください。

  • Oracle NetSuite の製品の アクティブな購読。

  • アカウント ID。

    • Oracle NetSuite ソースは、OAuth 2.0 を使用して Oracle NetSuite API と通信します。 アカウント ID がない場合は、 アカウント ID の取得方法に関する Oracle ドキュメントを参照してください。

  • クライアント ID と クライアントシークレット の組み合わせ。

    • Oracle NetSuite API にアクセスするには、クライアント ID とクライアントシークレットが必要です。 この手順では、管理者が以下を保有していることも確認する必要があります。

      • OAuth 2.0 機能を有効にし、適切な OAuth 2.0 役割を設定しました。
      • ユーザーを OAuth 2.0 の役割に割り当て、必要な統合レコードを作成しました。

  • アクセストークン および 更新トークン。

必要な資格情報の収集 gather-credentials

Oracle NetSuite を Platform に接続するには、次の接続プロパティの値を指定する必要があります。

資格情報
説明
例
クライアント ID
Oracle NetSuite で統合レコードを作成する際に生成されるクライアント ID 値。 詳しくは、 統合レコードの作成方法に関する Oracle ガイドを参照してください。
7fce.....b42f
値は 64 文字の文字列です。
クライアントシークレット
統合レコードの作成時に生成されるクライアントシークレット値。 詳しくは、 統合レコードの作成方法に関する Oracle ガイドを参照してください。
5c98.....1b46
値は 64 文字の文字列です。
認証テスト URL
（任意） NetSuite 認証テスト URL。
https://{ACCOUNT_ID}.app.netsuite.com<br>/app/login/oauth2/authorize.nl?response_type=code<br>&redirect_uri=https%3A%2F%2Fapi.github.com<br>&scope=rest_webservices<br>&state=ykv2XLx1BpT5Q0F3MRPHb94j<br>&client_id={CLIENT_ID}
アクセストークン
アクセストークンは JSON web トークン（JWT）形式で、60 分間のみ有効です。 アクセストークンの取得方法について詳しくは、NetSuite の OAuth 2.0 認証に関する Oracle ガイドを参照してください。
eyJr......f4V0
値は、JSON web トークン（JWT）形式の 1024 文字の文字列です。
更新トークン
アクセストークンの有効期限が切れた後は、更新を使用して新しいアクセストークンを生成します。 更新トークンは 7 日間有効です。 アクセストークンの取得方法について詳しくは、NetSuite の OAuth 2.0 認証に関する Oracle ガイドを参照してください。
eyJr......dmxM
値は、JSON web トークン（JWT）形式の 1024 文字の文字列です。
アクセストークン URL
アプリケーションがPOSTリクエストを送信するトークンエンドポイント。
https://{ACCOUNT_ID}.suitetalk.api.netsuite.com<br>/services/rest/auth/oauth2/v1/token
IMPORTANT
更新トークンの有効期限が切れた後、更新されたトークンとExperience Platformして新しいアカウントを作成する必要があります。

Oracle NetSuite Activities を Platform に接続 oracle-netsuite-activities

以下のドキュメントでは、API やユーザーインターフェイスを使用して Oracle NetSuite Activities と Platform を接続する方法について説明します。

Oracle NetSuite Entities を Platform に接続 oracle-netsuite-entities

以下のドキュメントでは、API やユーザーインターフェイスを使用して Oracle NetSuite Entities と Platform を接続する方法について説明します。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089