Pardotは現在、Salesforce Marketing CloudのAccount Engagementという名称になっています。
動画チュートリアル:Pardotにメールをアップロードする
この動画では、FigmaのEmailifyプラグインからPardotにHTMLメールをアップロードする方法を紹介しています。
テキストの段落でAMPscriptのリンク(例:%%=v(@url)=%%)が必要な場合、Figma標準のリンク欄では無効なURLとしてブロックされます。これを回避するには、代わりにEmailify独自のAMPscript用リンク形式https://ampscript.invalid/?%%=v(@url)=%%を使ってください。エクスポートしたHTMLには、AMPscriptのタグがそのまま出力されます。
1. PardotでConnected Appを作成する
まだ設定していない場合は、Pardotで新しいConnected Appを作成する必要があります。これにより、ステップ3(Pardotで認証する)でプラグインに貼り付けるConsumer KeyとConsumer Secretを取得できます。
- Pardotの管理画面の右上にあるSettings Iconをクリックし、Setupをクリックします。
- 設定の検索バーで「App Manager」を検索し、検索結果のApp Managerをクリックします。
- New Connected Appボタンをクリックします。
- Connected Appの名前(例:Emailify Integration)を入力します。
- Connected Appの所有者の連絡先情報を入力します。
- Enable OAuth Flowsチェックボックスをオンにします。
- Callback URLとして
https://figma.com/を追加します。 - Selected OAuth Scopesで、以下のスコープを追加します。これにより、アプリがPardotにアクセスして認証できるようになります。
Access content resources (content)Access the identity URL service (id, profile, email, address, phone)Manage Pardot services (pardot_api)Perform requests at any time (refresh _token, offline_access)
- Require Secret for Web Server Flowチェックボックスをオンにします。
- Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows が表示されている場合は、オフになっていることを確認します。
- Saveをクリックします。
2. PardotのBusiness Unit IDを確認する
Business Unit IDは「0Uv」で始まる18文字のIDです。PardotのBusiness Unit IDは、以下の手順で確認できます。
- Pardotへのログインに使っているものと同じアカウントでSalesforceにログインします。
- Setupタブをクリックします。
- Pardotドロップダウンを見つけ、Pardot Account Setupをクリックします。
- Pardotのビジネスユニットが複数ある場合は、Emailifyで使用するビジネスユニットのBusiness Unit IDを選んでください。
3. Pardotで認証する
Emailifyのエクスポートパネルで、ドロップダウンリストからPardot (API) オプション、またはPardotのテストアカウント用オプションを選択し、以下のPardotの認証情報と詳細をEmailifyのエクスポート設定の入力欄にコピー&ペーストします。
- Pardot Business Unit ID(例:
0UvXXXXXXXXXXXXXXX) - ログインに使用するPardot Username(例:
[email protected]) - ログインに使用するPardot Password(例:
*********) - 作成したConnected AppのConsumer Key(例:
y0Zd2jVHJ5Cc1wQg0l5yMJsXpPs...) - 作成したConnected AppのConsumer Secret(例:
8C8F8D11A3B7B026A90C5C3...)
これらの情報をすべて貼り付けると、EmailifyがPardotのインスタンスで認証を行います。
EmailifyのPardot APIエンドポイントのオプション
テスト環境やサンドボックスのインスタンスを使っている場合は、Emailifyのエクスポートオプションから別のPardot APIエクスポートオプションを選択できます。各オプションが呼び出すエンドポイントは以下のとおりです。
| Emailifyのオプション | 認可ドメイン | コンテンツドメイン |
|---|---|---|
| Pardot API | login.salesforce.com/services/oauth2/token?grant_type=password | pi.pardot.com |
| Pardot Test API | test.salesforce.com/services/oauth2/token?grant_type=password | pi.demo.pardot.com |
| Pardot Dev API | login.salesforce.com/services/oauth2/token?grant_type=password | pi.demo.pardot.com |
Pardotの認証に関する問題のトラブルシューティング
Pardotのユーザー名とパスワードで認証できない場合、最も多い原因は、連携で使用しているSalesforceユーザーでSalesforceの多要素認証(MFA)が有効になっていることです。
Pardotでの認証に失敗する最も一般的な理由は2要素認証に関する問題ですが、多くの場合、Pardotで次の設定を行うと解決できます。
- IP Relaxationの設定をRelax IP Restrictionsに変更する
- Permitted Usersの設定をAll users may self-authorizeに変更する
- OAuth and OpenID Connect SettingsでAllow OAuth Username-Password Flowsトグルを有効にする
- パスワードには特殊文字(例:
#%&など)を使用できません。 使えるのは英字と数字のみです(例:mypa55word1234)
API連携ユーザーをSalesforceのMFAに対応させる
SalesforceのMFAは、主にユーザーインターフェースへの対話型ログインに適用されます。APIベースの連携は通常、対話型のMFAの確認なしで引き続き動作しますが、Salesforceの管理者が連携ユーザーを正しく設定する必要があります。
EmailifyのPardot APIアップロードでは、共有の個人ログインではなく、専用のSalesforce連携ユーザーアカウントを使うことをおすすめします。
推奨:Salesforce Integrationユーザーライセンスを使う
ご利用のSalesforceエディションにSalesforce Integrationユーザーライセンスが含まれている場合は、Emailifyが使用する専用の連携ユーザーにそのライセンスを割り当ててください。
メリット:
- これらのユーザーはAPI専用のアクセス向けに設計されています。
- SalesforceのUIにログインできないため、UIでのMFAの確認は元から対象外です。
- 連携を通常のユーザーアカウントと分けて管理しやすくなります。
- API専用のプロファイルでは、通常API Enabledがデフォルトで設定されています。
これらのライセンスが利用できるかどうかを確認するには:
- SalesforceでSetupに移動します。
- Company Informationを検索します。
- Company Informationを開きます。
- User Licensesの一覧にSalesforce Integrationがあるか確認します。
代替策:標準のSalesforceユーザーでUIのMFAを免除する
Salesforce Integrationユーザーライセンスを使えず、連携で標準のSalesforceユーザーを使っている場合は、Salesforceの管理者がWaive Multi-Factor Authentication for Exempt Usersシステム権限を含むPermission Setを割り当てることで、その専用の連携ユーザーをUIのMFAの対象外にできます。
設定手順:
- SalesforceでSetupに移動します。
- Permission Setsを検索します。
- 連携ユーザー用に新しいPermission Setを作成します。
- System Permissionsを開き、Editをクリックします。
- Waive Multi-Factor Authentication for Exempt Usersを有効にします。
- Permission Setを保存します。
- そのPermission Setを専用の連携ユーザーに割り当てます。
連携に標準のSalesforceユーザーライセンスを使っている場合は、ユーザーのProfileのSystem PermissionsでAPI Enabledがオンのままになっていることも確認してください。
その他の推奨事項
- 個人のユーザーアカウントではなく、専用の連携ユーザーを使ってください。
- ユーザー名とパスワードによる認証を使う場合は、その認証情報とセキュリティトークンを安全に保管してください。
- 本番環境でMFA関連の変更を有効にする前に、サンドボックスでPardotとの接続をテストしてください。
- MFAの導入後に認証が失敗するようになった場合は、SalesforceユーザーのLogin Historyで失敗の具体的な理由を確認してください。
Salesforceの参考資料
4. Pardotにメールテンプレートをアップロードする
Pardot APIとの接続の認証に成功すると、表示される入力欄とドロップダウンで、以下の必須項目を指定できるようになります。
Sender Name
Sender Address
Campaign Name
Folder Name
Domain Tracking Name
エクスポートするテンプレートには、Pardotのコンテンツ領域タグを追加することもできます(任意)。
- Editable Regions:テキスト、画像、ボタンを編集できるようにします。
- Repeatable Regions:ロックされていない最上位のコンテンツブロックをコピーまたは移動できるようにします。これらのブロックは1つの繰り返し領域名(
body_content)を共有するため、異なるブロック同士で位置を入れ替えられます。 - Removable Regions:ロックされていない最上位のコンテンツブロックを削除できるようにします。
テンプレートをアップロードまたはエクスポートする前に、これらのオプションを自由に組み合わせて有効にしてください。Repeatable RegionsとRemovable Regionsの両方を有効にすると、Emailifyはロックされていない各ブロックの同じラッパーに両方の属性を付けます。繰り返し用のラッパーはbody_contentという名前を共有して隣り合って並ぶため、グループ内で異なるブロックを移動できます。繰り返し可能な各ブロックの周りに、削除用の別のラッパーが付くことはありません。
ヘッダーとフッターを固定する
エクスポートする前に、Figmaで、Emailifyのメールフレームの直下にあるヘッダー、フッター、その他の親レイヤーをロックしてください。Emailifyは、ロックされた最上位のレイヤーを、繰り返し領域タグや削除可能領域タグなしでエクスポートします。ロックされた親グループから生成されるすべてのブロックも同様です。Repeatable Regionsを有効にしてユーザーが本文のレイヤーを並べ替えられるようにするには、本文のレイヤーをロックしないでおきます。
ロックするのは最上位のレイヤーそのものです。入れ子になったテキストレイヤーや画像レイヤーだけをロックしても、その親ブロックはロックされません。この設定で制御できるのは、ブロック全体のコピー、移動、削除です。ブロック内のテキスト、画像、ボタンの編集は、引き続きEditable Regionsで制御されます。ブロックを再び繰り返し可能または削除可能にするには、親レイヤーのロックを解除して、もう一度エクスポートしてください。
上記で必要なオプションを選択し、準備ができたら、Upload To Pardotボタンをクリックすると、Figmaで選択したメールのHTMLへのエクスポートが始まり、Pardotのメールテンプレートに自動でアップロードされます。