Landingspagina’s
Referentie eindpunt bestemmingspagina
Openingspagina’s zijn webpagina’s die worden gehost door Marketo.
Query
Zoals de meeste andere activa, kunnen de Aanvoerende Pagina’s door naam worden gevraagd, door identiteitskaart , en door doorbladerend . Deze query’s retourneren alleen metagegevens en de lijst met inhoudssecties voor een bestemmingspagina moet afzonderlijk worden opgevraagd door de id van de bestemmingspagina.
Door de inhoud van de bestemmingspagina op te vragen, wordt een lijst geretourneerd met inhoudssecties die beschikbaar zijn op de bestemmingspagina. Er moet een sectie aanwezig zijn in de inhoudslijst van een pagina om de inhoud bij te werken:
GET /rest/asset/v1/landingPage/{id}/content.json
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "6307#154ea1689d7",
"result": [
{
"id": "67",
"type": "Form",
"index": 1,
"content": {
"content": "189",
"contentType": "Form",
"contentUrl": "https://app-devlocal1.marketo.com/#FO189A1ZN13LA1"
},
"formattingOptions": {
"zIndex": 15,
"left": "359px",
"top": "122px"
}
}
]
}
De resultaten verschillen per geleide en vrije vormmalplaatjes, aangezien de geleide het landen pagina’s met een reeks secties komen die door het malplaatje worden bepaald waarvan zij worden afgeleid, terwijl de vrije vormpagina’s niet met vooraf bepaalde secties komen, en hun inhoud moet vóór het uitgeven worden toegevoegd. De indeling van het kenmerk “content” kan variëren afhankelijk van het kenmerk “type” en of het veld statisch of dynamisch is.
Maken en bijwerken
het Bestaan van pagina’s wordt gecreeerd door terug naar een malplaatje van verwijzingen te voorzien. De enige velden die u hoeft te maken, zijn naam, sjabloon (de id van de sjabloon) en de map waarin u de pagina wilt plaatsen. Voor extra meta-gegevens die kunnen worden bevolkt, zie de eindpuntverwijzing.
Geldige inhoudstypes voor het landen pagina inhoud eindpunten zijn: richText, HTML, Vorm, Beeld, Rechthoek, Fragment.
POST rest/asset/v1/landingPages.json
Content-Type: application/x-www-form-urlencoded
name=createLandingPage&folder={"type": "Folder", "id": 11}&template=1&description=this is a test&workspace=default&title=test create&keywords=awesome&formPrefill=false
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "7a39#154cf7922c6",
"result": [
{
"id": 27,
"name": "createLandingPage",
"description": "this is a test",
"createdAt": "2016-05-20T18:41:43Z+0000",
"updatedAt": "2016-05-20T18:41:43Z+0000",
"folder": {
"type": "Folder",
"value": 11,
"folderName": "Landing Pages"
},
"workspace": "Default",
"status": "draft",
"template": 1,
"title": "test create",
"keywords": "awesome",
"robots": "index, nofollow",
"formPrefill": false,
"mobileEnabled": false,
"URL": "https://app-devlocal1.marketo.com/lp/622-LME-718/createLandingPage.html",
"computedUrl": "https://app-devlocal1.marketo.com/#LP27B2"
}
]
}
De landende paginametagegevens kunnen met het Update Landing Metadata eindpunt van de Pagina worden bijgewerkt.
Goedkeuring
Aanlandingspagina’s voldoen aan het standaard conceptgoedgekeurde model, indien er een ontwerpversie en/of een goedgekeurde versie kan zijn. Wanneer updates op een pagina worden toegepast, worden ze altijd eerst toegepast op de conceptversie en worden ze alleen live weergegeven wanneer de pagina is goedgekeurd.
Verwijderen
Als u een bestemmingspagina wilt verwijderen, moet deze eerst buiten gebruik zijn en niet door andere Marketo-elementen worden genoemd. De bestemmingspagina moet bovendien niet zijn goedgekeurd. De pagina’s worden geschrapt individueel met het Schrapping Landing het eindpunt van de Pagina . Pagina’s met ingesloten sociale knoppen kunnen niet worden verwijderd via deze API.
Klonen
Marketo biedt een eenvoudige methode voor het klonen van een bestemmingspagina. Dit is een POST-aanvraag via application/x-www-url-formencoded.
De padparameter id geeft de id op van de bestemmingspagina van de bron die moet worden gekloond.
De parameter name wordt gebruikt om de naam van de nieuwe bestemmingspagina te specificeren.
De parameter folder wordt gebruikt om de bovenliggende map op te geven waar de nieuwe bestemmingspagina wordt gemaakt. Dit gebeurt in de vorm van een ingesloten JSON-object met id en type .
De parameter template wordt gebruikt om bron te specificeren die het Malplaatje van de Pagina van de Landing identiteitskaart
De optionele parameter description wordt gebruikt om de nieuwe bestemmingspagina te beschrijven.
POST /rest/asset/v1/landingPage/{id}/clone.json
Content-Type: application/x-www-form-urlencoded
name=MyNewLandingPage&folder={"type":"Program","id":1119}&template=57
{
"success": true,
"errors": [],
"requestId": "1078d#1683e4881c6",
"warnings": [],
"result": [
{
"id": 3291,
"name": "MyNewLandingPage",
"createdAt": "2019-01-11T18:59:25Z+0000",
"updatedAt": "2019-01-11T18:59:25Z+0000",
"folder": {
"type": "Program",
"value": 1119,
"folderName": "DefaultProgramWithGuidedLP"
},
"workspace": "Default",
"status": "draft",
"template": 57,
"robots": "index, nofollow",
"formPrefill": false,
"mobileEnabled": false,
"URL": "http://na-abm.marketo.com/lp/284-RPR-133/DefaultProgramWithGuidedLPPerkutoTestLP-Clone-1.html",
"computedUrl": "https://app-abm.marketo.com/#LP3291A1LA1"
}
]
}
Sectie Inhoud beheren
Inhoudssecties worden gerangschikt op basis van hun indexeigenschap en worden uiteindelijk ingedeeld volgens de CSS-regels die worden toegepast wanneer ze door de client worden weergegeven. De secties van de inhoud zijn inbegrepen en beheerd met het corresponderende toevoegen, Update en schrap het Landing de inhoudseindpoints van de Pagina, en kunnen worden gevraagd gebruikend krijgen het Bestaan Inhoud van de Pagina . Elke sectie heeft een type- en een waardeparameter. Het type bepaalt wat in de waarde moet worden gezet. Voor deze eindpunten worden gegevens doorgegeven als POST x-www-form-urlencoded en niet als JSON.
Types van Sectie
Voor vrije-formulierpagina’s moeten alle gewenste inhoudssecties worden toegevoegd en worden deze met de id mktoContent ingesloten in het div-element. Voor geleide pagina’s, kan een lijst van vooraf bepaalde elementen in de lijst van aanwezig zijn krijgt het Bestaan van de Inhoud van de Pagina eindpunt. Meer kan worden toegevoegd of hun inhoud die via hun respectieve eindpunten wordt bijgewerkt.
Dynamische inhoud
Als u een sectie Dynamische inhoud wilt maken, moet deze al voorkomen in de inhoudslijst van de bestemmingspagina. Het 🔗 eindpunt van de Sectie van de Inhoud van de Pagina van 0} Update Landing {moet dan worden gebruikt om het type aan "DynamicContent"te plaatsen. Wanneer een sectie op dynamische inhoud wordt geplaatst, leidt het tot onderliggende dynamische secties binnen de inhoudssectie die allen het basistype van het omgezette element erven. Elke dynamische sectie neemt ook de inhoud van de omgezette sectie over.
GET /rest/asset/v1/landingPage/{id}/dynamicContent/RVMtNDg=.json
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "46e#1560fa169d9",
"result": [
{
"createdAt": "2016-07-21",
"updatedAt": "2016-07-21",
"segmentation": 1007,
"segments": [
{
"segmentId": 1018,
"segmentName": "Default",
"type": "RichText",
"content": "\n\t\t\t\t\t\t\tAlice was beginning to get very tired of sitting by her sister on the bank, and having nothing to do: once or twice she had peeped into the book her sister was reading, but it had no pictures or conversations in it.\n\t\t\t\t\t\t"
},
{
"segmentId": 1017,
"segmentName": "New Segment",
"type": "RichText",
"content": "\n\t\t\t\t\t\t\tAlice was beginning to get very tired of sitting by her sister on the bank, and having nothing to do: once or twice she had peeped into the book her sister was reading, but it had no pictures or conversations in it.\n\t\t\t\t\t\t"
}
]
}
]
}
Bijwerkend de inhoud voor elk individueel segment wordt gedaan op basis van segmentidentiteitskaart
POST /rest/asset/v1/landingPage/{id}/dynamicContent/{dynamicContentId}.json
Content-Type: application/x-www-form-urlencoded
segment=New Segment&value=New Content
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "7516#14e08fe7cbbc",
"result": [
{
"id": 1012
}
]
}
Variabelen
Een van de nieuwe functies in instructiepagina’s voor landen is bewerkbare variabelen. Variabelen bevatten waarden voor elementen op een landingspagina. Variabelen kunnen eenvoudig worden gewijzigd met de editor voor de bestemmingspagina, zoals hieronder wordt weergegeven:
Variabelen worden gedefinieerd als metatags binnen het <head> -element van een landingspagina in de modus Met instructies. Er zijn drie typen variabelen beschikbaar: Tekenreeks, kleur en Boolean. Hier volgt een voorbeeld van drie definities van variabelen:
<head>
<meta charset="utf-8">
<meta class="mktoString" mktoName="My String Variable" id="stringVar" default="Hello World!">
<meta class="mktoColor" mktoName="My Color Variable" id="colorVar" default="#ffffff">
<meta class="mktoBoolean" mktoName="My Boolean Variable" id="boolVar" default="true">
</head>
Voor meer informatie zie "Bewerkbare Veranderlijke"sectie in creeer een Geleide Landing de documentatie van het Malplaatje van de Pagina .
Query
Haal variabelen voor een geleide het landen pagina terug door landende pagina ID over te gaan om het eindpunt van de Variabelen van de Pagina van de Landing te krijgen.
GET /rest/asset/v1/landingPage/{id}/variables.json
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "10843#15a6d7e5fa1",
"result": [
{
"id": "stringVar",
"value": "Hello World!",
"type": "string"
},
{
"id": "colorVar",
"value": "#FFFFFF",
"type": "color"
},
{
"id": "boolVar",
"value": "true",
"type": "boolean"
}
]
}
In dit voorbeeld bevat de pagina met instructies drie variabelen: stringVar, colorVar, boolVar.
Bijwerken
Werk een variabele voor een geleide het landen pagina bij door landende paginaaid, veranderlijke identiteitskaart, en de veranderlijke waarde door te gaan om het Landing van het eindpunt van de Variabelen van de Pagina bij te werken.
POST /rest/asset/v1/landingPage/{id}/variable/{variableId}.json?value={newValue}
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "2b07#15a6db77da3",
"result": [
{
"id": "stringVar",
"value": "Hello Brave New World!",
"type": "String"
}
]
}
Voorvertoning openingspagina
Marketo verstrekt het krijgen het Openende Volledige eindpunt van de Pagina van de Pagina om een levende voorproef van een het landen pagina terug te winnen aangezien het in browser zou worden teruggegeven. Er is één vereiste parameter, de id padparameter die de id is van de bestemmingspagina die u wilt voorvertonen. Er zijn twee extra optionele queryparameters:
- segmentatie: Accepteert een array van JSON-objecten die segmentationId- en segmentId-kenmerken bevatten. Als deze optie is ingesteld, wordt de landingspagina voorvertoond alsof u een lead bent die overeenkomt met die segmenten.
- leadId: Accepteert de integer-id van een lead. Als deze optie is ingesteld, wordt de landingspagina weergegeven alsof deze door de aangewezen lead is bekeken.
GET /rest/asset/v1/landingPage/{id}/fullContent.json?leadId=1001&segmentation=[{"segmentationId":1030,"segmentId":1103}]
{
"success": true,
"errors": [],
"requestId": "119ab#17692849f1e",
"warnings": [],
"result": [
{
"id": 1023,
"content": "<!DOCTYPE html>\n<html>\n <head>\n <meta charset=\"utf-8\">\n \n \n <meta name=\"robots\" content=\"index, nofollow\">\n <title></title>\n <style>\n body {background:#FFFFFF} \n #myConditionalDisplayArea {\n display: true;\n }\n </style>\n <link rel=\"shortcut icon\" href=\"/favicon.ico\" type=\"image/x-icon\" >\n<link rel=\"icon\" href=\"/favicon.ico\" type=\"image/x-icon\" >\n\n\n<style>.mktoGen.mktoImg {display:inline-block; line-height:0;}</style>\n </head>\n <body id=\"bodyId\">\n \n Hello Brave New World!\n <div class=\"mktoText\" id=\"exampleText\"><div>This is an example editable text area.</div>\n<div>Lead Full Name = Hanna Crawford</div>\n<div><br /></div>\n <script type=\"text/javascript\" src=\"//munchkin.marketo.net//munchkin.js\"></script><script>Munchkin.init('123-ABC-456', {customName: 'Test-Landing-Page-APIs_Guided-Landing-Page---deverly', PURL_VISIT_TOKEN, wsInfo: 'j1RR'});</script>\n<div id=\"mktoClickBlockingDiv\"></div>\n </body>\n</html>\n"
}
]
}