使用Adobe Experience Platform Platform SDK

本教程提供了有關轉換的資訊 data_access_sdk_python 新蟒蛇隊 platform_sdk 在Python和R本教程提供了以下操作的資訊：

• 生成身份驗證
• 資料的基本讀取
• 基本資料寫入

生成身份驗證

調用時需要身份驗證 Adobe Experience Platform，由API密鑰、IMS組織ID、用戶令牌和服務令牌組成。

蟒

如果您使用的是Jupyter筆記本，請使用以下代碼生成 client_context:

client_context = PLATFORM_SDK_CLIENT_CONTEXT

如果您未使用Jupyter筆記本或需要更改IMS組織，請使用以下代碼示例：

from platform_sdk.client_context import ClientContext
client_context = ClientContext(api_key={API_KEY},
              org_id={ORG_ID},
              user_token={USER_TOKEN},
              service_token={SERVICE_TOKEN})

R

如果您使用的是Jupyter筆記本，請使用以下代碼生成 client_context:

library(reticulate)
use_python("/usr/local/bin/ipython")
psdk <- import("platform_sdk")

py_run_file("../.ipython/profile_default/startup/platform_sdk_context.py")
client_context <- py$PLATFORM_SDK_CLIENT_CONTEXT

如果您未使用Jupyter筆記本或需要更改IMS組織，請使用以下代碼示例：

library(reticulate)
use_python("/usr/local/bin/ipython")
psdk <- import("platform_sdk")
client_context <- psdk$client_context$ClientContext(api_key={API_KEY},
              org_id={ORG_ID},
              user_token={USER_TOKEN},
              service_token={SERVICE_TOKEN})

資料的基本讀取

新 Platform SDK，最大讀取大小為32 GB，最大讀取時間為10分鐘。

如果您的讀取時間太長，可以嘗試使用以下篩選選項之一：

• 按偏移和限制篩選資料
• 按日期篩選資料
• 按列篩選資料
• 獲取排序結果

蟒

要在Python中讀取資料，請使用以下代碼示例：

from platform_sdk.dataset_reader import DatasetReader
dataset_reader = DatasetReader(client_context, "{DATASET_ID}")
df = dataset_reader.limit(100).read()
df.head()

R

要讀取R中的資料，請使用以下代碼示例：

DatasetReader <- psdk$dataset_reader$DatasetReader
dataset_reader <- DatasetReader(client_context, "{DATASET_ID}")
df <- dataset_reader$read()
df

按偏移和限制篩選

由於不再支援按批ID篩選，因此，為了確定資料讀取的範圍，您需要使用 offset 和 limit。

蟒

df = dataset_reader.limit(100).offset(1).read()
df.head

R

df <- dataset_reader$limit(100L)$offset(1L)$read()
df

按日期篩選

日期篩選的粒度現在由時間戳定義，而不是按日設定。

蟒

df = dataset_reader.where(\
    dataset_reader['timestamp'].gt('2019-04-10 15:00:00').\
    And(dataset_reader['timestamp'].lt('2019-04-10 17:00:00'))\
).read()
df.head()

R

df2 <- dataset_reader$where(
    dataset_reader['timestamp']$gt('2018-12-10 15:00:00')$
    And(dataset_reader['timestamp']$lt('2019-04-10 17:00:00'))
)$read()
df2

新 Platform SDK支援以下操作：

按選定列篩選

要進一步細化資料讀取，還可以按列名進行篩選。

蟒

df = dataset_reader.select(['column-a','column-b']).read()

R

df <- dataset_reader$select(c('column-a','column-b'))$read()

獲取排序結果

接收的結果可以按目標資料集的指定列和它們的順序(asc/desc)分別排序。

在以下示例中，資料幀首先按"column-a"的升序排序。 對於"column-a"具有相同值的行按"column-b"按降序排序。

蟒

df = dataset_reader.sort([('column-a', 'asc'), ('column-b', 'desc')])

R

df <- dataset_reader$sort(c(('column-a', 'asc'), ('column-b', 'desc')))$read()

基本資料寫入

要在Python和R中寫入資料，請使用以下示例之一：

蟒

from platform_sdk.models import Dataset
from platform_sdk.dataset_writer import DatasetWriter

dataset = Dataset(client_context).get_by_id("{DATASET_ID}")
dataset_writer = DatasetWriter(client_context, dataset)
write_tracker = dataset_writer.write({PANDA_DATAFRAME}, file_format='json')

R

dataset <- psdk$models$Dataset(client_context)$get_by_id("{DATASET_ID}")
dataset_writer <- psdk$dataset_writer$DatasetWriter(client_context, dataset)
write_tracker <- dataset_writer$write({PANDA_DATAFRAME}, file_format='json')

後續步驟

配置 platform_sdk 資料載入器，資料經過準備，然後被拆分到 train 和 val 資料集。 要瞭解資料準備和功能工程，請訪問 資料準備與特徵工程 在教程中使用 JupyterLab 筆記本。

Business.Adobe.com 資源

Recommendation Engine Content Insights Responsive Forms Omnichannel Marketing Predictive Analytics Enterprise Search Tools