OData SDK for PHP を使ってAdobe Target のデータを取得

CData Connect AI はAdobe Target のデータをWeb サービスとして公開します。 この記事の手順を実行することで、Adobe Target のデータをPHP オブジェクトとして扱うことができるようになります。

CData Connect AI はAdobe Target のデータへのクラウドベースのOData インターフェースを提供し、ODataPHP SDK からAdobe Target のデータへのリアルタイム連携を実現します。

Connect AI を構成

ODataPHP SDK でAdobe Target のデータを操作するには、Connect AI からAdobe Target に接続し、コネクションにユーザーアクセスを提供してAdobe Target のデータのOData エンドポイントを作成する必要があります。

Adobe Target に接続したら、目的のテーブルのOData エンドポイントを作成します。

（オプション）新しいConnect AI ユーザーの追加

必要であれば、Connect AI 経由でAdobe Target に接続するユーザーを作成します。

1. 「Users」ページに移動し、 Invite Users をクリックします。
2. 新しいユーザーのE メールアドレスを入力して、 Send をクリックしてユーザーを招待します。
3. 「Users」ページからユーザーを確認および編集できます。

パーソナルアクセストークンの追加

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

1. Connect AI アプリの右上にあるユーザー名をクリックし、「User Profile」をクリックします。
2. 「User Profile」ページで「Access Token」セクションにスクロールし、 Create PAT をクリックします。
3. PAT の名前を入力して Create をクリックします。
4. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect AI からAdobe Target に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

1. Connect AI にログインし、 Add Connection をクリックします。
2. 「Add Connection」パネルから「Adobe Target」を選択します。
3. 必要な認証プロパティを入力し、Adobe Target に接続します。

   Adobe Target に接続するには、以下に記載されているOAuth 接続プロパティとともにTenant プロパティを指定する必要があります。他の接続プロパティは処理動作に影響を与える可能性がありますが、接続には影響しません。

   以下のステップでTenant 名を確認できます。

   1. Adobe Experience にログインします。URL は「https://experience.adobe.com/#/@mycompanyname/preferences/general-section」です。
   2. 「/#/@」の後の値を抽出します。この例では「mycompanyname」です。
   3. Tenant 接続プロパティをその値に設定します。

   ユーザーアカウント（OAuth）

   すべてのユーザーアカウントフローでAuthScheme をOAuthClient に設定する必要があります。

   注意：OAuth を介したAdobe 認証では、2週間ごとにトークンを更新する必要があります。

   すべてのアプリケーション

   CData では、OAuth 認証を簡素化する組み込みOAuth アプリケーションを提供しています。または、カスタムOAuth アプリケーションを作成することもできます。詳細については、ヘルプドキュメントの「カスタムOAuthアプリの作成」をご確認ください。

   OAuth アクセストークンの取得

   接続するには以下のプロパティを設定します：

   • InitiateOAuth：GETANDREFRESH に設定して、OAuth 交換を自動的に実行し、必要に応じてOAuthAccessToken を更新します。
   • OAuthClientId：アプリを登録した際に割り当てられたクライアントID に設定します。
   • OAuthClientSecret：アプリを登録した際に割り当てられたクライアントシークレットに設定します。
   • CallbackURL：アプリを登録した際に定義されたリダイレクトURI に設定します。例：https://localhost:3333

   これらの設定により、CData 製品はAdobe Target からアクセストークンを取得し、それを使用してデータを要求します。OAuth値はOAuthSettingsLocation で指定された場所に保存され、接続間で確実に保持されます。

   
4. Create & Test をクリックします。
5. 「Add Adobe Target Connection」ページの「Permissions」タブに移動し、ユーザーベースのアクセス許可を更新します。

Connect AI にAdobe Target OData エンドポイントを追加する

Adobe Target に接続したら、目的のテーブルのOData エンドポイントを作成します。

1. OData ページに移動し、 Add をクリックして新しいOData エンドポイントを作成します。
2. Adobe Target 接続（例：AdobeTarget1）を選択し、Next をクリックします。
3. 使用するテーブルを選択し、「Confirm」をクリックします。

コネクションとOData エンドポイントを設定したら、ODataPHP SDK からAdobe Target のデータに接続できます。

1. まずは、ODataPHP SDK を使用してCData Connect AI が公開したWeb サービスに接続するプロキシクラスを作成します。

   URI 部分を書き換えて、次のようなコマンドを実行してください。

   
   php C:\PHPLib\ODataphp\PHPDataSvcUtil.php /uri=https://your-server:8032/api.rsc/@your-personal-access-token/ /out=C:\PHPLib\ODataphp\AdobeTargetEntities.php
   	    

   このコマンドは、OData エンドポイントが返すメタデータからクラスを定義して、指定したフォルダにクラスの定義を出力します。

   CData Connect AI およびOData SDK for PHP は、どちらもフォームとWindows 認証をサポートします。CData Connect AI はOData エンドポイントへのアクセスが認可されたユーザーの認証に、パーソナルアクセストークンを使用します。パーソナルアクセストークンはHTTP Basic 認証の際に渡したり、OData URL に付加することで使用できます。

   認証済みのユーザーは、CData Connect AI の管理コンソールのUsers セクションで設定できます。

2. これで、PHP のオブジェクト指向インターフェースを使ってAdobe Target のデータにアクセスできます。以下のコードはActivities テーブルのレコードを作成してリアルタイムデータを取得し、新しく作成したレコードを表示します。

   
   require_once 'AdobeTargetEntities.php';
   try{
     $svc = new CDataAPI();
     $activities = new Activities();
     $activities->Type = 'AB';
     $svc->AddToActivities($activities);
     $svc->SetSaveChangesOptions(SaveChangesOptions::None);
     $svc->SaveChanges();
     $response = $svc->activities()->Execute();
     foreach($response->Result as $activities)
       echo $activities->Id."
   ";
   } catch (Exception $e) {    //CData Connect AI からのエラーをキャッチ
     echo $e->getError(), "\n";
   }