API de Data Warehouse - Adobe Marketing Cloud

Anuncio
Adobe© Digital Marketing Suite
API de Data Warehouse
Contents
API de Data Warehouse...........................................................................................3
Métodos de Data Warehouse..................................................................................................3
DataWarehouse.CancelRequest................................................................................................................3
DataWarehouse.CheckRequest.................................................................................................................3
DataWarehouse.CreateSegment...............................................................................................................4
DataWarehouse.GetReportData................................................................................................................4
DataWarehouse.GetSegment....................................................................................................................5
DataWarehouse.GetSegments..................................................................................................................5
DataWarehouse.ReplaceSegment.............................................................................................................6
DataWarehouse.Request...........................................................................................................................6
DataWarehouse.VerifySegment.................................................................................................................9
Tipos de datos personalizados...............................................................................................9
tns:data_warehouse_report.....................................................................................................................10
tns:data_warehouse_report_headings.....................................................................................................10
tns:data_warehouse_report_row..............................................................................................................10
tns:data_warehouse_report_row_list.......................................................................................................10
tns:data_warehouse_request...................................................................................................................10
tns:data_warehouse_segment.................................................................................................................13
tns:data_warehouse_segment_group......................................................................................................13
tns:data_warehouse_segment_rule.........................................................................................................15
tns:data_warehouse_segment_rule_list...................................................................................................17
tns:segment..............................................................................................................................................17
tns:segments............................................................................................................................................17
tns:segment_folder...................................................................................................................................17
tns:segment_folders.................................................................................................................................18
Código de ejemplo................................................................................................................18
Ejemplo de solicitud de cancelación de Data Warehouse........................................................................18
Ejemplo de solicitud de comprobación de Data Warehouse....................................................................18
Ejemplo de creación de segmentos de Data Warehouse........................................................................19
Ejemplo de solicitud de Data Warehouse.................................................................................................20
Last updated 2/21/2012
API de Data Warehouse
API de Data Warehouse
3
API de Data Warehouse
Data Warehouse le permite solicitar informes para mostrar las relaciones de datos avanzadas de los datos sin
procesar basándose en sus propias preguntas. Por ejemplo: puede utilizar Data Warehouse para informar las
páginas de salida de los visitantes que compraron un cierto artículo en el sitio.
Los informes de Data Warehouse se envían por correo electrónico o FTP y su procesamiento puede llevar 72 horas
o más, dependiendo de la complejidad de la consulta y la cantidad de datos solicitada.
Note: Adobe no ofrece Acuerdos de nivel de servicio (SLA, Service Level Agreements) ni se compromete
en lo que respecta al nivel de servicio en relación con los segmentos de Data Warehouse.
Métodos de Data Warehouse
La API de Data Warehouse incluye estos métodos.
Crear llamadas de métodos desde SOAP y REST empleando el nombre del método y los nombres de parámetro
aquí descritos. Si desea más información acerca de cómo usar los servicios Web con SOAP y REST, consulte
Introducción.
DataWarehouse.CancelRequest
Cancela un segmento de Data Warehouse solicitado anteriormente.
Parámetros de DataWarehouse.CancelRequest
Parámetro
Tipo
Request_Id
xsd:int
Descripción
El ID de solicitud de Data Warehouse que se cancelará.
Respuesta DataWarehouse.CancelRequest
Tipo
Descripción
xsd:string
Confirma la cancelación de la solicitud de segmento de Data Warehouse.
DataWarehouse.CheckRequest
Envía una solicitud de informe una sola vez que se entregará por correo electrónico o FTP.
Parámetros de DataWarehouse.CheckRequest
Parámetro
Tipo
Request_Id
xsd:int
Descripción
El ID de solicitud de Data Warehouse para el cual se devuelve
el estado.
Solo puede comprobar el estado de una solicitud que usted
haya enviado.
API de Data Warehouse
4
Respuesta DataWarehouse.CheckRequest
Tipo
Descripción
tns:data_warehouse_request
Una estructura que contiene información sobre el segmento de datos especificado. Si el
Request_Id especificado no contiene ningún dato, el método devuelve la siguiente
respuesta:
Empty data set. No data for Request ID <Request_Id>.
DataWarehouse.CreateSegment
Crea una definición de segmento que determina los datos del conjunto de informes que el Data Warehouse incluye
en el nuevo segmento de Data Warehouse.
Parámetros de DataWarehouse.CreateSegment
Parámetro
Tipo
Descripción
rsid
xsd:int
segment
tns:data_warehouse_segment
El conjunto de informes utilizado para generar el segmento.
La definición de segmento utilizada para definir el nuevo
segmento.
Respuesta DataWarehouse.CreateSegment
Tipo
Descripción
xsd:int
Un ID único de segmento para el nuevo segmento. Si se produce un error al crear el
segmento, el marco SOAP devuelve un error de entorno que describe el error.
DataWarehouse.GetReportData
Indica al Data Warehouse que recupere un archivo de segmento que una llamada a DataWarehouse.Request
creó anteriormente usando el parámetro send_via_api.
Parámetros de DataWarehouse.GetReportData
Parámetro
Tipo
Request_Id
xsd:int
rsid
xsd:string
start_row
xsd:int
Descripción
El identificador de solicitud que devuelve la llamada a
DataWarehouse.Request .
El conjunto de informes asociado a la solicitud de Data Warehouse.
Este parámetro no está en uso actualmente. Especifique un valor de 0
o 1.
API de Data Warehouse
5
Respuesta DataWarehouse.GetReportData
Tipo
Descripción
tns:data_warehouse_report
Una tabla que contiene la llamada a DataWarehouse.Request especificada.
DataWarehouse.GetSegment
Crea un filtro de segmentos que determina los datos de conjuntos de informes que Data Warehouse incluirá en la
respuesta de archivos de datos para una solicitud de Data Warehouse.
Parámetros de DataWarehouse.GetSegment
Parámetro
Tipo
Descripción
rsid
xsd:int
segment
xsd:int
El conjunto de informes usado para generar el segmento.
El ID de segmento. Data Warehouse genera este valor después
de crear un nuevo segmento.
Respuesta DataWarehouse.GetSegment
Tipo
Descripción
tns:data_warehouse_segment
Una estructura que contiene los datos de segmento de Data Warehouse.
DataWarehouse.GetSegments
Recupera segmentos de un Data Warehouse para el intervalo de fechas especificado.
Parámetros de DataWarehouse.GetSegments
Parámetro
Tipo
Descripción
rsid
xsd:int
start_date
xsd:date
end_date
xsd:date
El ID de conjunto de informes en el que se desea generar un
segmento de Data Warehouse.
La fecha de inicio del segmento de Data Warehouse.
La fecha de fin del segmento de Data Warehouse.
Respuesta DataWarehouse.GetSegments
Tipo
Descripción
tns:segment_folders
Una lista de segmentos para el intervalo de fechas especificado.
API de Data Warehouse
6
DataWarehouse.ReplaceSegment
Elimina el segmento de Data Warehouse especificado y crea un nuevo segmento de Data Warehouse de la estructura
especificada.
Parámetros de DataWarehouse.ReplaceSegment
Parámetro
Tipo
Descripción
id
xsd:int
rsid
xsd:int
segment
tns:data_warehouse_segment
El ID del segmento que se eliminará. Data Warehouse proporciona
este valor en la respuesta a una operación de creación de segmento.
El conjunto de informes usado para crear el nuevo segmento.
La definición del segmento usada para definir el conjunto de datos del
segmento nuevo.
Respuesta DataWarehouse.ReplaceSegment
Tipo
Descripción
xsd:int
Un identificador único de segmento para el nuevo segmento.
Si se produce un error al crear el segmento, el marco SOAP devuelve un error de entorno
que describe el error.
DataWarehouse.Request
Envía una solicitud de informe una sola vez que se entregará por correo electrónico o FTP.
Parámetros de DataWarehouse.Request
Parámetro
Tipo
rsid
xsd:string
Contact_Name
xsd:string
Contact_Phone
xsd:string
Email_To
xsd:string*
Descripción
El ID del conjunto de informes que se utilizará con la solicitud
de Data Warehouse. El conjunto de informes debe tener
habilitado Data Warehouse y el usuario necesita tener
derechos en el conjunto de informes.
El nombre de la persona que realiza la solicitud de Data
Warehouse.
El número de teléfono de la persona que realiza la solicitud
de Data Warehouse.
La dirección de correo electrónico en la que se desea que
Data Warehouse envíe el archivo de datos. El modo de envío
API de Data Warehouse
Parámetro
7
Tipo
Descripción
predeterminado es el correo electrónico, pero también se
puede utilizar el FTP si se desea.
Email_Subject
xsd:string
Report_Name
xsd:string
Report_Description
xsd:string
File_Name
xsd:string
Date_Type
xsd:string
El texto que Data Warehouse incluye en la línea de asunto
del correo electrónico.
El nombre de solicitud de Data Warehouse tal como se desea
que aparezca en el correo electrónico.
(Opcional) Una descripción de la solicitud de Data Warehouse
tal como se desea que aparezca en el correo electrónico.
(Opcional) El nombre del archivo de datos que contiene los
resultados de la solicitud de Data Warehouse. Por ejemplo,
especifique DW_Data para devolver un archivo de datos con
el nombre DW_Data.csv.
El tipo de intervalo de datos utilizado con la solicitud de Data
Warehouse. Los valores admitidos son:
range: Especifica que se desea utilizar un intervalo de datos
personalizado. Para ello, especifique la fecha de inicio del
informe utilizando el parámetro Date_From y la fecha de fin,
usando el parámetro Date_To.
preset: Especifica que se desea utilizar un intervalo de fechas
predefinido. Para ello, especifique la fecha predefinida del
informe usando el parámetro Date_Preset.
Date_Preset
xsd:string
(Opcional) El intervalo de fechas predefinido que se usará
con la solicitud del Data Warehouse. Especifique este
parámetro cuando Date_Type = preset.
Los valores admitidos son los siguientes (se distingue entre
mayúsculas y minúsculas): Last month, Last week, Last 2
weeks, Last 4 weeks, Last 7 days, Last 30 days, This
month, This week, Today, Yesterday.
Date_To
xsd:string
(Opcional) La fecha de fin del intervalo de fechas
personalizado para la solicitud de Data Warehouse.
Especifique este parámetro cuando Date_Type = range.
Los valores de fecha deben usar el formato MM/DD/YY.
API de Data Warehouse
8
Parámetro
Tipo
Date_From
xsd:string
Descripción
(Opcional) La fecha de inicio del intervalo de fechas
personalizado para la solicitud de Data Warehouse.
Especifique este parámetro cuando Date_Type = range.
Los valores de fecha deben usar el formato MM/DD/YY.
Date_Granularity
xsd:string
El grado de detalle de la solicitud de Data Warehouse.
Los valores admitidos son los siguientes: none, hour, day,
week, month, quarter, year.
Segment_Id
xsd:int
Metric_List
array(xsd:string)
Breakdown_List
array(xsd:string)
FTP_Host
xsd:string
(Opcional) El segmento que se usará con esta solicitud de
Data Warehouse. Este valor debe ser un ID de segmento
global válido. Use DataWarehouse.GetSegments para obtener
una lista de ID de segmento válidos.
(Opcional) Las métricas que se incluirán en la solicitud de
Data Warehouse. Una solicitud válida debe contener al menos
una métrica o un desglose.
UseReportSuite.GetAvalableMetrics para obtener una lista
de las métricas disponibles para este conjunto de informes.
(Opcional) El desglose que se incluirá en la solicitud de Data
Warehouse. Una solicitud válida debe contener al menos una
métrica o un desglose. UseReportSuite.GetAvalableElements
para obtener una lista de los desgloses disponibles para un
conjunto de informes.
(Opcional) La ubicación de entrega del segmento de Data
Warehouse. Los valores admitidos son:
Leave Blank: No especifique ningún valor para este parámetro
si desea que Data Warehouse entregue el archivo de
segmento por correo electrónico. El correo electrónico es el
modo de entrega predeterminado.
FTP Host Name: Especifique un nombre de host FTP para
que Data Warehouse entregue el segmento por FTP.
send_via_api: Especifique el valor send_via_api para que
Data Warehouse entregue el segmento utilizando su interfaz
REST. En este caso, cuando el segmento concluye,
DataWarehouse.CheckRequest proporciona la URL de REST
en la que se puede descargar el segmento.
FTP_Port
xsd:int
(Opcional) El número de puerto FTP.
API de Data Warehouse
9
Parámetro
Tipo
Descripción
FTP_Dir
xsd:string
FTP_UserName
xsd:string
FTP_Password
xsd:string
(Opcional) El directorio del FTP en el que Data Warehouse
deja el archivo de datos (Por ejemplo, /reports/here).
(Opcional) Nombre de usuario utilizado para iniciar sesión en
el servidor FTP especificado en FTP_Host.
(Opcional) Contraseña correspondiente al usuario de FTP
especificado en FTP_UserName.
Respuesta DataWarehouse.Request
Tipo
Descripción
xsd:int
El ID de solicitud que los servidores Adobe asignan a esta solicitud de Data Warehouse.
DataWarehouse.VerifySegment
Verifica la definición del segmento especificado sin crear un segmento de Data Warehouse nuevo.
Resulta útil para comprobar la sintaxis del segmento antes de crear el segmento nuevo en Data Warehouse.
Parámetros de DataWarehouse.VerifySegment
Parámetro
Tipo
Descripción
segment
tns:data_warehouse_segment
La definición del segmento que hay que verificar.
Respuesta DataWarehouse.VerifySegment
Tipo
Descripción
xsd:boolean
Devuelve True si la sintaxis del filtro de segmentos es válida. De lo contrario, devuelve un
error de entorno en el primer error de sintaxis en la definición del segmento.
Tipos de datos personalizados
La API de Data Warehouse utiliza estas estructuras de datos personalizadas, incluidos los tipos enumerados.
El tipo de datos define la estructura para organizar y contener un conjunto específico de datos. Los tipos de datos
pueden constar de dos o más elementos, cada uno de los cuales puede ser una matriz, una enumeración, una
estructura o un elemento “primitivo”. Adobe define los tipos de datos utilizando la siguiente convención:
<namespace>:<type>
Por ejemplo:
API de Data Warehouse
10
• xsd:int indica que el tipo de datos es parte del xsd espacio de nombre (Definición de esquema XML) y que el
tipo es int (Entero). XML define ciertos tipos de datos primitivos (comunes) como entero, cadena o fecha. En
Definición de esquema XML se describen todos los tipos de datos primitivos.
• tns:code_items indica que el tipo de datos es parte del espacio de nombre tns (un espacio de nombre Adobe
privado) y que el tipo de datos personalizado es code_items. El espacio de nombre tns aparece como prefijo en
todos los tipos de datos personalizados de Online Marketing Suite.
tns:data_warehouse_report
Estructura de datos que contiene información sobre un informe de Data Warehouse.
Nombre
Tipo
Descripción
start_row
xsd:int
end_row
xsd:int
headings
tns:data_warehouse_report_headings
row
tns:data_warehouse_report_row_list
finished
xsd:boolean
La primera fila de datos que se incluirá en el informe. Este valor
debe ser siempre 1.
La última fila de datos que se incluirá en el informe. Este valor
debe ser siempre igual al número de elementos de row_list.
Una lista de encabezados de columna de este informe.
Una lista de filas de datos de este informe.
Este elemento no está actualmente habilitado, por lo que siempre
devuelve True.
Indica que hay más datos disponibles (un informe paginado).
tns:data_warehouse_report_headings
Una matriz de xsd:string.
tns:data_warehouse_report_row
Una matriz de xsd:string.
tns:data_warehouse_report_row_list
Una matriz de tns:data_warehouse_report_row .
tns:data_warehouse_request
Estructura de datos que contiene las opciones de configuración para una fuente de datos de procesamiento completo.
Nombre
status
Tipo
Descripción
xsd:int
Un código que representa el estado del segmento de datos. Los
valores de estado admitidos son:
API de Data Warehouse
Nombre
11
Tipo
Descripción
Código
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
Mensaje
Esperando para comenzar (se ha creado la
solicitud y se están valorando las necesidades de
procesamiento)
En curso
Finalizado
Detenido
Cancelado
Error
Esperando para comenzar (se ha asignado el
servidor y se está esperando a que el servidor
inicie el procesamiento)
Demasiado grande
Esperando para comenzar (se ha terminado la
valoración y se espera a que haya un servidor
disponible)
Esperando los datos
Esperando a enviar
Esperando a verificar
Esperando a enviar
Enviado a producto
Enviando
Esperando para continuar (desaprobado)
Esperando para continuar (desaprobado)
Continuando
API de Data Warehouse
Nombre
12
Tipo
Descripción
Código
18
mensaje
filesize
data_url*
Mensaje
No entregado
xsd:string
Una breve descripción del parámetro de estado. La cadena de
mensaje se presenta arriba, junto al código de estado.
xsd:string
Solo se rellena cuando status = 2. El tamaño del segmento de
datos solicitados, en MB.
xsd:string
Solo se rellena cuando status = 2. Contiene la URL en la que
se puede descargar el segmento de datos completado.
*Una vez completado un segmento de datos, el valor de data_url en una solicitud HTTP GET para recuperar el
segmento de datos. Cuando se solicita un segmento de datos mediante data_url, hay que facilitar las credenciales
de Online Marketing Suite igual que se haría al usar cualquier otra llamada de API de Online Marketing Suite. Si
desea más información sobre WSSE, consulte <<Autenticación de servicios Web>>.
El siguiente código de ejemplo muestra cómo usar cURL* para generar la solicitud GET desde una estación de
trabajo Linux:
curl "<Genesis REST URL>" -H "$(php <wsse.php> <username> <secret>)
Una solicitud REST correcta incluye los componentes siguientes:
Nombre
data URL
username
secret
wsse.php
Descripción
La URL asociada a un segmento de datos específico (por ejemplo,
https://api.omniture.com/rest/?id=123456).
El nombre de usuario de Online Marketing Suite.
La clave secreta (contraseña) para Online Marketing Suite.
Un archivo de secuencias de comandos que contiene los datos de autenticación WSSE para la
solicitud de Data Warehouse. Este archivo debe tener la siguiente forma:
#!/usr/local/bin/php
<?
date_default_timezone_set('America/Denver');
$mode='header';
if ($argv[1] == '-q') {
$mode='qs';
array_shift($argv);
}
$username = $argv[1];
$secret = $argv[2];
$created = date('c');
$nonce = md5(rand(), true);
API de Data Warehouse
Nombre
13
Descripción
$base64_nonce = base64_encode($nonce);
$password_digest = base64_encode(sha1($nonce.$created.$secret, true));
if ($mode == 'header') {
echo "X-WSSE: UsernameToken Username=\"$username\",
PasswordDigest=\"$password_digest\", Nonce=\"$base64_nonce\",
Created=\"$created\"";
} else {
echo http_build_query(array(
'auth_digest' => $password_digest,
'auth_nonce' => $base64_nonce,
'auth_created' => $created,
'auth_username' => $username,
));
}
tns:data_warehouse_segment
Estructura de datos que contiene las opciones de configuración para una fuente de datos de procesamiento completo.
Nombre
Tipo
name
xsd:string
Descripción
Un nombre descriptivo para el segmento de Data
Warehouse.
El nombre no puede superar los 255 caracteres.
group_include
tns:data_warehouse_segment_group
group_exclude
tns:data_warehouse_segment_group
Especifica datos que deben incluirse
explícitamente en el archivo de datos. Aunque
debe incluir el elemento group_include, puede
dejarlo vacío si no quiere usar una regla de
inclusión.
Especifica los datos que deben excluirse
explícitamente del archivo de datos. Aunque
debe incluir el elemento group_exclude, puede
dejarlo vacío si no quiere usar una regla de
exclusión.
tns:data_warehouse_segment_group
Una estructura (llamada Grupo) que contiene reglas, e información sobre la combinación de estas reglas, para crear
una definición de segmento.
Nombre
Tipo
type
xsd:string
Descripción
Especifica el tipo de segmento. Los valores admitidos, en los que
se distingue entre mayúsculas y minúsculas, son:
API de Data Warehouse
Nombre
14
Tipo
Descripción
ROOT: El grupo de segmentos de nivel superior. El grupo de
segmentos de nivel superior debe ser ROOT.
VISITOR: Contenedor de los cálculos de visitante.
VISIT: Contenedor de los cálculos de visita.
PAGE: Contenedor de los cálculos de página.
EVENT: Contenedor de eventos.
name
xsd:string
El nombre de grupo del segmento. El nombre de grupo de
segmentos de nivel superior debe ser Include. A los grupos de
segmentos animados se les puede dar un nombre que consista
en una cadena descriptiva.
El nombre no puede superar los 255 caracteres.
group_operator
xsd:string
Operador booleano usado para combinar grupos en el parámetro
group_list. Los valores admitidos son:
AND: Combina grupos usando el operador booleano AND.
OR: Combina grupos usando el operador booleano OR.
rule_operator
xsd:string
Operador booleano usado para combinar reglas en el parámetro
rule_list. Los valores admitidos son:
AND: Combina grupos usando el operador booleano AND.
OR: Combina grupos usando el operador booleano OR.
rule_list
tns:data_warehouse_segment_rule_list
Una lista de reglas combinadas por el objeto Group. Las siguientes
restricciones se aplican a las listas de reglas de los grupos de
segmento:
• La lista de reglas de un grupo de segmentos ROOT no puede
contener ninguna regla.
• La lista de reglas de un grupo de segmentos EVENT puede
contener exactamente una regla de estilo EVENT.
• La lista de reglas EVENT puede contener todas las reglas de
estilo diferente a EVENT que se quiera.
group_list
tns:data_warehouse_segment_group_list
Una lista de grupos de segmentos contenida en este grupo. Para
la anidación de grupos de segmentos se aplican las siguientes
restricciones:
• Un grupo ROOT debe ser el objeto de grupo superior y no puede
tener un objeto principal.
API de Data Warehouse
Nombre
15
Tipo
Descripción
• Un grupo EVENT no puede tener un elemento principal de tipo
EVENT.
• Un grupo VISIT no puede tener un elemento principal de tipo
PAGE, VISIT ni EVENT.
• Un grupo VISITOR no puede tener un elemento principal de tipo
PAGE, VISIT, VISITOR ni EVENT.
• Un grupo PAGE no puede tener un elemento principal de tipo
PAGE ni EVENT.
tns:data_warehouse_segment_rule
Una estructura que define una sola regla de segmento.
Nombre
Tipo
operator
xsd:string
Descripción
El operador booleano usado para esta regla. Los valores admitidos son los
siguientes: También puede dejar operator en blanco.
= (igual a)
!= (no es igual a)
> (mayor que)
< (menor que)
>= (mayor que o igual a)
<= (menor que o igual a)
NOT CONTAINS (no contiene)
CONTAINS ALL OF (contiene todo)
NOT CONTAINS ALL OF (no contiene todo)
CONTAINS ONE OF (contiene alguno)
NOT CONTAINS ONE OF (no contiene ninguno)
type
xsd:string
Propiedad que se usará para la comparación de reglas. Por ejemplo, column.
El tipo no puede superar los 100 caracteres.
value
xsd:string
Valor que se usará para la comparación de reglas.
El valor no puede superar los 255 caracteres.
event
xsd:int
El ID del evento que se desea escuchar. Al crear una regla de evento, se deben
observar las siguientes convenciones:
API de Data Warehouse
Nombre
16
Tipo
Descripción
- Cuando se especifica un evento, todos los demás valores (operator, type y
value) deben dejarse en blanco (una cadena de caracteres 0 o un valor NULL).
- Cuando no se especifica un evento, el valor event debe dejarse en blanco
(una cadena de caracteres 0 o un valor NULL). - Las reglas de evento deben
estar contenidas en una rule_list de un grupo de segmentos de tipo EVENT.
El parámetro event acepta los siguientes valores admitidos:
ID de evento
1
2
10
11
12
13
14
20
100
101
102
103
104
105
106
107
108
Descripción
PURCHASE
PRODUCT_VIEW
SHOPPING_CART_OPEN
SHOPPING_CART
SHOPPING_CART_ADD
SHOPPING_CART_REMOVE
SHOPPING_CART_VIEW
Instancia de campaña
Instancia de la eVar1
Instancia de la eVar2
Instancia de la eVar3
Instancia de la eVar4
Instancia de la eVar5
Instancia de la eVar6
Instancia de la eVar7
Instancia de la eVar8
Instancia de la eVar9
API de Data Warehouse
Nombre
17
Tipo
Descripción
ID de evento
Descripción
109
Instancia de la eVar10
110
Instancia de la eVar11
111
Instancia de la eVar12
tns:data_warehouse_segment_rule_list
Una matriz de tns:data_warehouse_segment_rule .
tns:segment
Estructura de datos que contiene un solo segmento de datos.
Nombre
Tipo
id
xsd:string
name
xsd:string
definition
xsd:string
Descripción
El identificador único de segmento.
El nombre de segmento.
La definición de segmento usada para especificar los datos que
se incluirán en este segmento.
tns:segments
Una matriz de tns:segment .
tns:segment_folder
Estructura de datos que contiene información sobre una colección de segmentos de datos.
Nombre
Tipo
namespace
xsd:string
folder_name
xsd:string
segments
tns:segments
Descripción
El espacio de nombre asociado a esta carpeta de segmentos.
El nombre de la carpeta de segmentos.
Una lista de segmentos asociados a la carpeta de segmentos.
API de Data Warehouse
18
tns:segment_folders
Una matriz de tns:segment_folder .
Código de ejemplo
La API de Data Warehouse incluye estos códigos de ejemplo.
El siguiente código se proporciona únicamente para fines de demostración. Utilice sus propios valores, nombres,
ubicaciones de archivos, etcétera, al preparar el código de su empresa.
Ejemplo de solicitud de cancelación de Data Warehouse
Un ejemplo de llamada al método DataWarehouse.CancelRequest y la respuesta asociada.
Solicitud DataWarehouse.CancelRequest
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:omn="http://www.omniture.com/">
<soapenv:Header/>
<soapenv:Body>
<omn:DataWarehouse.CancelRequest
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<Request_Id xsi:type="xsd:int">69760</Request_Id>
</omn:DataWarehouse.CancelRequest>
</soapenv:Body>
</soapenv:Envelope>
Respuesta DataWarehouse.CancelRequest
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:DataWarehouse.CancelRequestResponse xmlns:ns1="http://www.omniture.com/">
<return xsi:type="xsd:string">Request Cancelled</return>
</ns1:DataWarehouse.CancelRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ejemplo de solicitud de comprobación de Data Warehouse
Un ejemplo de llamada al método DataWarehouse.CheckRequest y la respuesta asociada.
Solicitud DataWarehouse.CheckRequest
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:omn="http://www.omniture.com/">
<soapenv:Header/>
<soapenv:Body>
<omn:DataWarehouse.CheckRequest
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<Request_Id xsi:type="xsd:int">669</Request_Id>
</omn:DataWarehouse.CheckRequest>
API de Data Warehouse
19
</soapenv:Body>
</soapenv:Envelope>
Respuesta DataWarehouse.CheckRequest
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:DataWarehouse.CheckRequestResponse xmlns:ns1="http://www.omniture.com/">
<return xsi:type="xsd:string">Complete</return>
</ns1:DataWarehouse.CheckRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Ejemplo de creación de segmentos de Data Warehouse
Un ejemplo de llamada al método DataWarehouse.CreateSegment y la respuesta asociada.
Solicitud DataWarehouse.CreateSegment
<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:omn="http://www.omniture.com/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:sopenc="sopenc">
<soapenv:Header/>
<soapenv:Body>
<omn:DataWarehouse.CreateSegment
soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<rsid xsi:type="xsd:string">my_report_suite</rsid>
<segment xsi:type="omn:data_warehouse_segment">
<!--You may enter the following 3 items in any order-->
<name xsi:type="xsd:string">SOAP API Event Test Segment</name>
<group_include xsi:type="omn:data_warehouse_segment_group">
<!--You may enter the following 6 items in any order-->
<type xsi:type="xsd:string">ROOT</type>
<name xsi:type="xsd:string">Include</name>
<group_operator xsi:type="xsd:string">UNKNOWN</group_operator>
<rule_operator xsi:type="xsd:string">AND</rule_operator>
<rule_list xsi:type="omn:data_warehouse_segment_rule_list"
soapenc:arrayType="omn:data_warehouse_segment_rule[]"/>
<group_list xsi:type="omn:data_warehouse_segment_group_list"
soapenc:arrayType="omn:data_warehouse_segment_group[]">
<item xsi:type="mon:data_warehouse_segment_group">
<type xsi:type="xsi:string">VISIT</type>
<name xsi:type="xsi:string">Visit</name>
<group_operator xsi:type="xsd:string">UNKNOWN</group_operator>
<rule_operator xsi:type="xsd:string">AND</rule_operator>
<group_list xsi:type="omn:data_warehouse_segment_group_list"
sopenc:arrayType="omn:data_warehouse_segment_group[]">
<item xsi:type="omn:data_warehouse_segment_group">
<type xsi:type="xsd:string">EVENT</type>
<name xsi:type="xsd;string">Checkout</name>
<group_operator xsi:type="xsd:string">UNKNOWN</group_operator>
<rule_operator xsi:type="xsd:string">AND</rule_operator>
<rule_list xsi:type="omn:data_warehouse_segment_rule_list"
soapenc:arrayType="omn:data_warehouse_segment_rule[]">
<item xsi:type="tns:data_warehouse_segment_rule">
<operator xsi:type="xsd:string"/>
<item xsi:type="xsd:string"/>
<value xsi:type="xsd:string"/>
<event xsi:type="xsd:int">11</event>
</item>
</rule_list>
API de Data Warehouse
20
<group_list xsi:type="omn:data_warehouse_segment_group_list"
soapenc:arrayType="omn:data_warehouse_segment_group[]"/>
</item>
</group_list>
<rule_list xsi:type="omn:data_warehouse_segment_rule_list"
soapenc:arrayType="omn:data_warehouse_segment_rule[]"/>
</item>
</group_list>
</group_include>
<group_exclude xsi:type="omn:data_warehouse_segment_group">
<!--You may enter the following 6 items in any order-->
<type xsi:type="xsd:string">ROOT</type>
<name xsi:type="xsd:string">Exclude</name>
<group_operator xsi:type="xsd:string">UNKNOWN</group_operator>
<rule_operator xsi:type="xsd:string">AND</rule_operator>
<rule_list xsi:type="omn:data_warehouse_segment_rule_list"
soapenc:arrayType="omn:data_warehouse_segment_rule[]"/>
<group_list xsi:type="omn:data_warehouse_segment_group_list"
soapenc:arrayType="omn:data_warehouse_segment_group[]"/>
</group_exclude>
</segment>
</omn:DataWarehouse.CreateSegment>
</soapenv:Body>
</soapenv:Envelope>
Ejemplo de solicitud de Data Warehouse
Un ejemplo de llamada al método DataWarehouse.Request y la respuesta asociada.
Solicitud DataWarehouse.Request
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:omn="http://www.omniture.com/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/">
<soapenv:Header/>
<soapenv:Body>
<omn:DataWarehouse.Request soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<Breakdown_List xsi:type="omn:string_array" soapenc:arrayType="xsd:string[]">
<item xsi:type="xsd:string">browser_height</item>
</Breakdown_List><Contact_Name xsi:type="xsd:string">John Jones</Contact_Name>
<Contact_Phone xsi:type="xsd:string">801-888-8888</Contact_Phone>
<Contact_Name xsi:type="xsd:string">John Jones</Contact_Name>
<Contact_Phone xsi:type="xsd:string">801-000-0000</Contact_Phone>
<Date_Granularity xsi:type="xsd:string">none</Date_Granularity>
<Date_Preset xsi:type="xsd:string">Yesterday</Date_Preset>
<Date_Type xsi:type="xsd:string">preset</Date_Type>
<Email_Subject xsi:type="xsd:string">Periodic Revenue</Email_Subject>
<Email_To xsi:type="xsd:string">jjones@somecompany.com</Email_To>
<File_Name>xsi:type="xsd:string">Report</File_Name>
<Metric_List xsi:type="omn:string_array" soapenc:arrayType="xsd:string[2]">
<item xsi:type="xsd:string">revenue</item>
<item xsi:type="xsd:string">page_views</item>
</Metric_List>
<Report_Description xsi:type="xsd:string">My API Request</Report_Description>
<Report_Name xsi:type="xsd:string">Periodic Revenue</Report_Name>
<Segment_Id xsi:type="xsd:int">729</Segment_Id>
<rsid xsi:type="xsd:string">reportSuite00000</rsid>
</omn:DataWarehouse.Request>
</soapenv:Body>
</soapenv:Envelope>
Respuesta DataWarehouse.Request
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
API de Data Warehouse
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:DataWarehouse.RequestResponse xmlns:ns1="http://www.omniture.com/">
<Request_Id xsi:type="xsd:int">669</Request_Id>
</ns1:DataWarehouse.RequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
21
Descargar