DocumentazioneGuida per sviluppatori di Marketo

Pagine di destinazione

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:
  • Pagine di destinazione

Creato per:

  • Amministratore

Riferimento endpoint pagina di destinazione

Le pagine di destinazione sono pagine web ospitate da Marketo.

Query

Come la maggior parte delle altre risorse, è possibile eseguire una query sulle pagine di destinazione per nome, per ID e esplorando. Queste query restituiranno solo i metadati e l’elenco delle sezioni di contenuto per una pagina di destinazione deve essere interrogato separatamente dall’ID della pagina di destinazione.

La query del contenuto della pagina di destinazione restituirà un elenco di sezioni di contenuto disponibili nella pagina di destinazione. Una sezione deve essere presente nell’elenco dei contenuti di una pagina per aggiornare il contenuto:

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"
            }
        }
    ]
}

I risultati differiscono tra i modelli in formato guidato e quelli in formato libero, in quanto le pagine di destinazione guidate presentano un set di sezioni definite dal modello da cui derivano, mentre le pagine in formato libero non includono sezioni predefinite ed è necessario aggiungerne il contenuto prima di modificarle.  Il formato dell’attributo "content" può variare a seconda dell’attributo "type" e del fatto che il campo sia statico o dinamico.

Crea e aggiorna

Le pagine di destinazione vengono create facendo riferimento a un modello. Gli unici campi obbligatori per la creazione sono nome, modello (l’ID del modello) e la cartella in cui inserire la pagina. Per ulteriori metadati che possono essere compilati, vedi il riferimento all’endpoint.

I tipi di contenuto validi per il contenuto della pagina di destinazione sono: richText, HTML, Form, Image, Rectangle, Snippet.

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"
        }
    ]
}

I metadati della pagina di destinazione possono essere aggiornati con l'endpoint Aggiorna metadati pagina di destinazione.

Approvazione

Le pagine di destinazione seguono il modello standard approvato dalla bozza, in cui può essere presente una bozza di versione e/o una versione approvata. Ogni volta che si applicano aggiornamenti a una pagina, questi vengono sempre applicati prima alla versione della bozza e vengono visualizzati in diretta solo dopo che la pagina è stata approvata.

Elimina

Per eliminare una pagina di destinazione, prima deve essere non utilizzata e non deve essere utilizzata come riferimento da altre risorse Marketo, oltre a non essere approvata. Le pagine vengono eliminate singolarmente con l'endpoint Elimina pagina di destinazione. Questa API non consente di eliminare le pagine di destinazione con pulsanti social incorporati.

Duplica

Marketo fornisce un metodo semplice per clonare una pagina di destinazione. Si tratta di una richiesta POST con codifica application/x-www-url-formencoded.

Il parametro percorso id specifica l'ID della pagina di destinazione di origine da clonare.

Il parametro name viene utilizzato per specificare il nome della nuova pagina di destinazione.

Il parametro folder viene utilizzato per specificare la cartella padre in cui viene creata la nuova pagina di destinazione. È un oggetto JSON incorporato contenente id e type.

Il parametro template viene utilizzato per specificare l'ID del modello della pagina di destinazione di origine.

Il parametro facoltativo description viene utilizzato per descrivere la nuova pagina di destinazione.

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"
        }
    ]
}

Sezione Gestisci contenuto

Le sezioni di contenuto sono ordinate in base alla loro proprietà di indice e infine strutturate in base alle regole CSS applicate al momento della visualizzazione da parte del client. Le sezioni di contenuto sono incluse e gestite con gli endpoint corrispondenti della sezione del contenuto della Aggiungi, Aggiorna e Elimina e possono essere interrogate utilizzando Ottieni contenuto pagina di destinazione. Ogni sezione ha un tipo e un parametro di valore. Il tipo determina cosa deve essere inserito nel valore.  Per questi endpoint, i dati vengono passati come POST x-www-form-urlencoded, non come JSON.

Tipi di sezione

Tipo
Valore
DynamicContent
ID della segmentazione.
Modulo
ID del modulo.
HTML
Contenuto di Text HTML.
Immagine
ID della risorsa immagine.
Rettangolo
Vuoto.
RichText
Contenuto di Text HTML.  Può contenere solo elementi in formato Rich Text.
Frammento
ID del frammento.
Pulsante social
ID di  il pulsante social.
Video
ID del video.

Per le pagine in formato libero, è necessario aggiungere tutte le sezioni di contenuto desiderate che verranno incorporate nell'elemento div con ID mktoContent. Per le pagine guidate, un elenco di elementi predefiniti potrebbe essere presente nell'elenco dall'endpoint Ottieni contenuto pagina di destinazione. Puoi aggiungere altri contenuti o aggiornarne il contenuto tramite i rispettivi endpoint.

Contenuto dinamico

Per creare una sezione di contenuto dinamico, questa deve essere già presente nell’elenco del contenuto della pagina di destinazione. L'endpoint Aggiorna sezione contenuto pagina di destinazione deve quindi essere utilizzato per impostare il tipo su 'DynamicContent'. Quando una sezione è impostata sul contenuto dinamico, crea sezioni dinamiche sottostanti all’interno della sezione del contenuto che ereditano tutte il tipo di base dell’elemento convertito. Ogni sezione dinamica eredita anche il contenuto dalla sezione convertita.

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"
        }
      ]
    }
  ]
}

L'aggiornamento del contenuto per ogni singolo segmento viene eseguito in base all'ID del segmento.

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

Variabili

Una delle funzioni introdotte nelle pagine di destinazione guidate sono le variabili modificabili.  Le variabili contengono valori per gli elementi di una pagina di destinazione.  Le variabili possono essere modificate facilmente utilizzando l’editor di pagine di destinazione come mostrato di seguito:

Variabili della pagina di destinazione

Le variabili sono definite come meta tag all'interno dell'elemento <head> di un modello di pagina di destinazione in modalità guidata. Sono disponibili tre tipi di variabili: String, Color e Boolean.  Di seguito è riportato un esempio di tre definizioni di variabili:

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

Per ulteriori informazioni, consulta la sezione "Variabile modificabile" nella documentazione di Creazione di un modello di pagina di destinazione guidata.

Query

Recupera le variabili per una pagina di destinazione guidata passando l’ID della pagina di destinazione all’endpoint "Get Landing Page Variables".

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 entrata  in questo esempio, la pagina di destinazione guidata contiene 3 variabili: stringVar, colorVar, boolVar.

Aggiornamento

Aggiorna una variabile per una pagina di destinazione guidata passando l’ID della pagina di destinazione, l’ID della variabile e il valore della variabile all’endpoint "Update Landing Page Variables".

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"
        }
    ]
}

Anteprima pagina di destinazione

Marketo fornisce l'endpoint Ottieni contenuto pagina di destinazione completo per recuperare un'anteprima in tempo reale di una pagina di destinazione come verrebbe rappresentata in un browser. Esiste un parametro obbligatorio, il parametro percorso id, che è l'ID della pagina di destinazione da visualizzare in anteprima. Sono disponibili due parametri di query facoltativi aggiuntivi:

  • segmentazione: accetta un array di oggetti JSON che contengono gli attributi segmentationId e segmentId. Con questa impostazione, visualizza in anteprima la pagina di destinazione come se fossi un lead corrispondente a tali segmenti.
  • leadId:  Accetta l’ID intero di un lead. Con questa impostazione, visualizza in anteprima la pagina di destinazione come se fosse visualizzata dal lead designato.
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"
    }
  ]
}
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59