Creación de modelos con Adobe Experience Platform Platform SDK

Este tutorial le proporciona información sobre la conversión data_access_sdk_python al nuevo Python platform_sdk en Python y R. Este tutorial proporciona información sobre las siguientes operaciones:

• Generar autenticación
• Lectura básica de los datos
• Escritura básica de datos

Generar autenticación

La autenticación es necesaria para realizar llamadas a Adobe Experience Platform, y se compone de clave de API, ID de organización de IMS, un token de usuario y un token de servicio.

Python

Si está utilizando Jupyter Notebook, utilice el siguiente código para crear el client_context:

client_context = PLATFORM_SDK_CLIENT_CONTEXT

Si no utiliza Jupyter Notebook o necesita cambiar la organización de IMS, utilice el siguiente ejemplo de código:

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

Si está utilizando Jupyter Notebook, utilice el siguiente código para crear el 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

Si no utiliza Jupyter Notebook o necesita cambiar la organización de IMS, utilice el siguiente ejemplo de código:

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})

Lectura básica de los datos

Con el nuevo Platform SDK, el tamaño máximo de lectura es de 32 GB, con un tiempo máximo de lectura de 10 minutos.

Si el tiempo de lectura está tardando demasiado, puede intentar utilizar una de las siguientes opciones de filtrado:

• Filtrado de datos por desplazamiento y límite
• Filtrado de datos por fecha
• Filtrado de datos por columna
• Obtención de resultados ordenados

Python

Para leer datos en Python, utilice el siguiente ejemplo de código:

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

R

Para leer los datos en R, utilice el siguiente ejemplo de código:

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

Filtrar por desplazamiento y límite

Dado que ya no se admite el filtrado por ID de lote, para ampliar el ámbito de lectura de los datos, debe utilizar offset y limit.

Python

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

R

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

Filtrar por fecha

La granularidad del filtrado de fechas ahora se define mediante la marca de tiempo, en lugar de configurarse por día.

Python

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

El nuevo Platform El SDK admite las siguientes operaciones:

Filtrar por columnas seleccionadas

Para restringir aún más la lectura de los datos, también puede filtrar por nombre de columna.

Python

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

R

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

Obtener resultados ordenados

Los resultados recibidos se pueden ordenar por columnas especificadas del conjunto de datos de destino y en su orden (asc/desc) respectivamente.

En el siguiente ejemplo, dataframe se ordena primero por "column-a" en orden ascendente. Las filas que tienen los mismos valores para la "columna-a" se ordenan por "columna-b" en orden descendente.

Python

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

R

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

Escritura básica de datos

Para escribir datos en Python y R, utilice uno de los siguientes ejemplos:

Python

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')

Pasos siguientes

Una vez que haya configurado la variable platform_sdk cargador de datos, los datos se preparan y luego se dividen en el train y val conjuntos de datos. Para obtener más información sobre la preparación de datos y la ingeniería de características, visite la sección de preparación de datos e ingeniería de características en el tutorial para crear una fórmula con JupyterLab portátiles.