Reglas de redireccionamiento de la página de destino
Referencia de extremo de reglas de redireccionamiento de páginas de aterrizaje
Marketo ofrece un conjunto de API de REST para realizar operaciones de CRUD en direcciones URL de redireccionamiento de páginas de aterrizaje. Estas API siguen el patrón de interfaz estándar para las API de recursos que proporcionan las opciones de Consulta, Crear, Actualizar y Eliminar.
Las reglas de redireccionamiento de páginas de aterrizaje permiten redirigir la dirección URL de una página de aterrizaje a otra dirección URL de página. Puede redirigir páginas de aterrizaje de Marketo, páginas de aterrizaje que no sean de Marketo o combinaciones de ellas. Encontrará información adicional sobre las reglas de la página de aterrizaje de redireccionamiento aquí.
Consulta
La consulta de las reglas de redirección de páginas de aterrizaje sigue los tipos de consulta estándar para los recursos de por id y exploración.
Por ID
El punto de conexión Obtener reglas de redireccionamiento de páginas de aterrizaje por identificador toma un único parámetro de ruta de redireccionamiento de reglas de páginas de aterrizaje id y devuelve un único registro de regla de redireccionamiento de páginas de aterrizaje.
GET /rest/asset/v1/redirectRule/{id}.json
{
"success": true,
"errors": [],
"requestId": "3d0#1707b2521e4",
"warnings": [],
"result": [
{
"id": 20,
"redirectFromUrl": "https://calqeauto.com/DefDelPro1_LandingPage1.html",
"hostname": "calqeauto.com",
"redirectFrom": {
"type": "landingPageId",
"value": 5483
},
"redirectTo": {
"type": "landingPageId",
"value": 5559
},
"redirectToUrl": "https://calqeauto.com/DefDelPro1_LandingPage2.html",
"createdAt": "2020-02-25T06:56:44Z+0000",
"updatedAt": "2020-02-25T06:56:44Z+0000"
}
]
}
Examinar
El extremo Obtener reglas de redireccionamiento de páginas de aterrizaje devuelve una lista de registros de reglas de redireccionamiento de páginas de aterrizaje.
Existen varios parámetros de consulta opcionales que se pueden pasar a los resultados del filtro.
El parámetro offset es un entero que especifica el número máximo de entradas que se van a devolver (el valor predeterminado es 20). El máximo es 200. El parámetro maxReturn es un entero que especifica dónde comenzar a recuperar entradas. Se puede utilizar junto con el desplazamiento (el valor predeterminado es 0).
El parámetro hostname se puede usar para filtrar por nombre de host de las páginas de aterrizaje.
redirectToLandingPageId es un entero que se puede usar para filtrar el identificador de la página de aterrizaje a la que está redirigiendo. redirectToPath se puede usar para filtrar la ruta de las páginas de aterrizaje a las que está redirigiendo.
Los parámetros earliestUpdatedAt y latestUpdatedAt le permiten establecer marcas de agua de fecha y hora bajas y altas para devolver reglas de redireccionamiento de páginas de aterrizaje que se actualizaron o crearon inicialmente dentro del intervalo dado.
GET /rest/asset/v1/redirectRules.json&maxReturn=3
{
"success": true,
"errors": [],
"requestId": "12213#1707b27efb5",
"warnings": [],
"result": [
{
"id": 5,
"redirectFromUrl": "https://www.kirtideep.contact/LandingPage2.html",
"hostname": "www.kirtideep.contact",
"redirectFrom": {
"type": "landingPageId",
"value": 5406
},
"redirectTo": {
"type": "landingPageId",
"value": 5404
},
"redirectToUrl": "https://www.kirtideep.contact/www.showLogs.com.html",
"createdAt": "2019-11-14T06:26:29Z+0000",
"updatedAt": "2019-11-14T06:26:29Z+0000"
},
{
"id": 6,
"redirectFromUrl": "https://www.kirtideep.contact/www.showLogs.com.html",
"hostname": "www.kirtideep.contact",
"redirectFrom": {
"type": "landingPageId",
"value": 5404
},
"redirectTo": {
"type": "url",
"value": "www.contactLogs.com"
},
"redirectToUrl": "www.contactLogs.com",
"createdAt": "2019-11-14T06:27:10Z+0000",
"updatedAt": "2019-11-14T06:27:10Z+0000"
},
{
"id": 7,
"redirectFromUrl": "https://www.kirtideep.contact/contact/log/check",
"hostname": "www.kirtideep.contact",
"redirectFrom": {
"type": "path",
"value": "/contact/log/check"
},
"redirectTo": {
"type": "landingPageId",
"value": 5404
},
"redirectToUrl": "https://www.kirtideep.contact/www.showLogs.com.html",
"createdAt": "2019-11-14T06:27:49Z+0000",
"updatedAt": "2019-11-14T06:27:49Z+0000"
}
]
}
Crear
El extremo Crear regla de redireccionamiento de página de aterrizaje se ejecuta con un POST application/x-www-form-urlencoded que tiene los tres parámetros obligatorios siguientes.
El parámetro hostname especifica el nombre de host de la página de aterrizaje. Debe pertenecer a un alias o dominio de personalización de marca. La longitud máxima es de 255 caracteres.
El parámetro redirectFrom especifica la página de aterrizaje de origen. Es un objeto JSON que contiene un par tipo/valor que determina si el origen es una página de aterrizaje de Marketo o una página de aterrizaje que no sea de Marketo. El atributo type puede ser "landingPageId" o "path".
El parámetro redirectTo especifica la página de aterrizaje de destino. Es un objeto JSON que contiene un par tipo/valor que determina si el origen es una página de aterrizaje de Marketo o una página de aterrizaje que no sea de Marketo. El atributo type puede ser "landingPageId" o "url".
Encontrará más información sobre la creación de reglas de redireccionamiento de páginas de aterrizaje aquí.
POST /rest/asset/v1/redirectRules.json
Content-Type: application/x-www-form-urlencoded
hostname=calqeauto.com&redirectFrom={"type":"landingPageId", "value":"5483"}&redirectTo={"type":"landingPageId", "value":"5559"}
{
"success": true,
"errors": [],
"requestId": "d7c6#1707b223522",
"warnings": [],
"result": [
{
"id": 20,
"redirectFromUrl": "https://calqeauto.com/DefDelPro1_LandingPage1.html",
"hostname": "calqeauto.com",
"redirectFrom": {
"type": "landingPageId",
"value": 5483
},
"redirectTo": {
"type": "landingPageId",
"value": 5559
},
"redirectToUrl": "https://calqeauto.com/DefDelPro1_LandingPage2.html",
"createdAt": "2020-02-25T06:56:44Z+0000",
"updatedAt": "2020-02-25T06:56:44Z+0000"
}
]
}
Actualización
El extremo Actualizar reglas de redireccionamiento de páginas de aterrizaje toma un único parámetro de ruta de acceso de la regla de redireccionamiento de páginas de aterrizaje id. Este extremo se ejecuta con un POST application/x-www-form-urlencoded.
Al igual que con la llamada de creación descrita anteriormente, se pasan uno o más de los siguientes parámetros de consulta para especificar qué atributo de la regla se va a actualizar: hostname, redirectFrom, redirectTo.
El registro actualizado de la regla de redirección de página de aterrizaje se devuelve en la respuesta.
POST /rest/asset/v1/redirectRule/{id}.json
Content-Type: application/x-www-form-urlencoded
redirectTo={"type":"landingPageId", "value":"5561"}
{
"success": true,
"errors": [],
"requestId": "57b2#1707b3852d7",
"warnings": [],
"result": [
{
"id": 20,
"redirectFromUrl": "https://calqeauto.com/DefDelPro1_LandingPage1.html",
"hostname": "calqeauto.com",
"redirectFrom": {
"type": "landingPageId",
"value": 5483
},
"redirectTo": {
"type": "landingPageId",
"value": 5561
},
"redirectToUrl": "https://calqeauto.com/DefDelPro1_LandingPage3.html",
"createdAt": "2020-02-25T06:56:44Z+0000",
"updatedAt": "2020-02-25T07:20:53Z+0000"
}
]
}
Eliminar
La regla de redireccionamiento de página de aterrizaje Delete por Id toma un único parámetro de ruta de redireccionamiento de regla de página de aterrizaje id.
POST /rest/asset/v1/redirectRule/{id}/delete.json
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "d505#154d01c8364",
"result": [
{
"id": 2
}
]
}
Explorar dominios de página de aterrizaje
El extremo Obtener dominios de página de aterrizaje devuelve una lista de registros de dominio de página de aterrizaje.
Existen dos parámetros de consulta opcionales que se pueden pasar a los resultados del filtro.
El parámetro offset es un entero que especifica el número máximo de entradas que se van a devolver (el valor predeterminado es 20, el máximo es 200).
El parámetro maxReturn es un entero que especifica dónde comenzar a recuperar entradas. Se puede usar junto con offset (el valor predeterminado es 0).
POST /rest/asset/v1/landingPageDomains.json?maxReturn=3
{
"success": true,
"errors": [],
"requestId": "6eb8#1707b43d3cb",
"warnings": [],
"result": [
{
"hostname": "calqeauto.com",
"type": "domain"
},
{
"hostname": "www.google.com",
"type": "domain-alias"
},
{
"hostname": "www.kirti.com",
"type": "domain-alias"
}
]
}