ランディングページのリダイレクトルール
Marketo は、ランディングページのリダイレクト URL で CRUD 操作を実行する一連の REST API を備えています。これらの API は、クエリ、作成、更新、削除のオプションを提供するアセット API の標準インターフェイスパターンに従います。
ランディングページのリダイレクトルールは、ランディングページ URL を別のページ URL にリダイレクトする機能を提供します。Marketo ランディングページ、Marketo 以外のランディングページ、そしてこれらの組み合わせをリダイレクトできます。ランディングページのリダイレクトルールに関する情報について詳しくは、こちらを参照してください。
クエリ
ランディングページのリダイレクトルールのクエリは、ID 別および参照のアセットに対する標準のクエリタイプに従います。
ID 別
ID によるランディングページのリダイレクトルールを取得エンドポイントは、単一のランディングページルールのリダイレクト id パスパラメーターを受け取り、単一のランディングページのリダイレクトルールレコードを返します。
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"
}
]
}
参照
ランディングページのリダイレクトルールを取得エンドポイントは、ランディングページのリダイレクトルールレコードのリストを返します。
結果をフィルタリングするために渡すことができるオプションのクエリパラメーターがいくつかあります。
offset パラメーターは、返されるエントリの最大数を指定する整数です（デフォルトは 20）。最大値は 200 です。maxReturn パラメーターは、エントリの取得を開始する場所を指定する整数です。offset と併用できます（デフォルトは 0）。
hostname パラメーターを使用すると、ランディングページのホスト名をフィルタリングできます。
redirectToLandingPageId は、リダイレクト先のランディングページの ID をフィルタリングするために使用できる整数です。redirectToPath を使用すると、リダイレクト先のランディングページのパスに基づいてフィルタリングできます。
earliestUpdatedAt および latestUpdatedAt パラメーターを使用すると、指定した範囲内で更新されたか最初に作成されたランディングページのリダイレクトルールを返すための低および高の日時透かしを設定できます。
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"
}
]
}
作成
ランディングページのリダイレクトルールを作成エンドポイントは、次の 3 つの必須パラメーターを持つ application/x-www-form-urlencoded POST で実行されます。
hostname パラメーターは、ランディングページのホスト名を指定します。これは、ブランディングドメインまたはエイリアスに属している必要があります。最大長は 255 文字です。
redirectFrom パラメーターは、ソースランディングページを指定します。これは、ソースが Marketo ランディングページであるか、Marketo 以外のランディングページであるかを決定するタイプおよび値のペアを含む JSON オブジェクトです。type 属性は "landingPageId" または "path" のいずれかを指定できます。
redirectTo パラメーターは、ターゲットランディングページを指定します。これは、ソースが Marketo ランディングページであるか、Marketo 以外のランディングページであるかを決定するタイプおよび値のペアを含む JSON オブジェクトです。type 属性は「landingPageId」または「url」のいずれかを指定できます。
ランディングページのリダイレクトルールの作成について詳しくは、こちらを参照してください。
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"
}
]
}
更新
ランディングページのリダイレクトルールを更新エンドポイントは、単一のランディングページのリダイレクトルール id パスパラメーターを受け取ります。このエンドポイントは、application/x-www-form-urlencoded POST で実行されます。
上記の作成呼び出しと同様に、更新するルールの属性を指定するのに、hostname、redirectFrom、redirectTo の 1 つ以上のクエリパラメーターが渡されます。
更新したランディングページのリダイレクトルールレコードが応答で返されます。
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"
}
]
}
削除
ID によるランディングページのリダイレクトルールを削除エンドポイントは、単一のランディングページのルールリダイレクト id パスパラメーターを受け取ります。
POST /rest/asset/v1/redirectRule/{id}/delete.json
{
"success": true,
"warnings": [],
"errors": [],
"requestId": "d505#154d01c8364",
"result": [
{
"id": 2
}
]
}
ランディングページのドメインの参照
ランディングページのドメインを取得エンドポイントは、ランディングページのドメインレコードのリストを返します。
結果をフィルタリングするのに渡すことができるオプションのクエリパラメーターが 2 つあります。
offset パラメーターは、返されるエントリの最大数を指定する整数です（デフォルトは 20、最大は 200）。
maxReturn パラメーターは、エントリの取得を開始する場所を指定する整数です。offset と併用できます（デフォルトは 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"
}
]
}