<p data-line="0" class="code-line">本記事は、<a href="https://qiita.com/advent-calendar/2024/trocco" target="_blank" rel="nofollow noopener noreferrer">TROCCO® Advent Calendar 2024</a> の 1 日目の記事です。</p>
<aside class="msg message"><span class="msg-symbol">!</span><div class="msg-content">
<p data-line="2" class="code-line">※執筆時点の内容です。最新の情報は公式ドキュメントをご確認ください。</p>
</div></aside>
<p data-line="5" class="code-line">--</p>
<h2 id="1.-%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="7" class="code-line">
<a class="header-anchor-link" href="#1.-%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> 1. はじめに</h2>
<p data-line="8" class="code-line">Salesforceの製品群には、Marketing Cloud Account Engagement (旧 Pardot)という、はB2Bに特化したマーケティングオートメーション (MA)製品があります。<br>
CRMであるSalesforce Sales Cloud/Service Cloudとネイティブに連携することで、一気通貫で管理ができるという利点があります。</p>
<p data-line="11" class="code-line">今回は、Account EngagementのデータをTROCCOを使ってDWHに格納する際の注意点と、実際に活用する際に便利な各データの関係図について記載します。</p>
<p data-line="13" class="code-line">※Account Engagement自体の説明については省きます。</p>
<h2 id="2.-%E6%8E%A5%E7%B6%9A%E6%83%85%E5%A0%B1%E3%81%AE%E8%A8%AD%E5%AE%9A" data-line="17" class="code-line">
<a class="header-anchor-link" href="#2.-%E6%8E%A5%E7%B6%9A%E6%83%85%E5%A0%B1%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> 2. 接続情報の設定</h2>
<p data-line="19" class="code-line">まずは、Account Engagementの情報をTROCCO®に登録をします。<br>
基本的にはTROCCO公式のヘルプページを確認いただければ問題なく接続できるはずです。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__ee3700fd70c95" src="https://embed.zenn.studio/card#zenn-embedded__ee3700fd70c95" data-content="https%3A%2F%2Fdocuments.trocco.io%2Fdocs%2Fconnection-configuration-pardot%3Fhighlight%3DAccount%2520Engagement" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://documents.trocco.io/docs/connection-configuration-pardot?highlight=Account%20Engagement" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://documents.trocco.io/docs/connection-configuration-pardot?highlight=Account Engagement</a></p>
<p data-line="23" class="code-line">ただし、２点ほど、私がハマってしまった部分がありますので、どなたかが迷われないように記載しておきます。</p>
<h2 id="3.-%E6%8E%A5%E7%B6%9A%E6%83%85%E5%A0%B1%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9" data-line="27" class="code-line">
<a class="header-anchor-link" href="#3.-%E6%8E%A5%E7%B6%9A%E6%83%85%E5%A0%B1%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9" aria-hidden="true"></a> 3. 接続情報の注意点</h2>
<h3 id="3.1-%E5%80%8B%E4%BA%BA%E3%81%AE%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3" data-line="28" class="code-line">
<a class="header-anchor-link" href="#3.1-%E5%80%8B%E4%BA%BA%E3%81%AE%E3%82%BB%E3%82%AD%E3%83%A5%E3%83%AA%E3%83%86%E3%82%A3%E3%83%88%E3%83%BC%E3%82%AF%E3%83%B3" aria-hidden="true"></a> 3.1 個人のセキュリティトークン</h3>
<p data-line="29" class="code-line">1点目は、個人のセキュリティトークンです。<br>
外部とのアクセスをする場合、Salesforceではセキュリティトークンをパスワードに含める必要がある場合があります。<br>
設定方法は下記です。<sup class="footnote-ref"><a href="#fn-0344-1" id="fnref-0344-1">[1]</a></sup></p>
<ol data-line="33" class="code-line">
<li data-line="33" class="code-line">個人設定から、<code>クイック検索</code> ボックスに「リセット」と入力し、<code>私のセキュリティトークンのリセット</code> を選択</li>
<li data-line="34" class="code-line">
<code>セキュリティトークンのリセット</code> をクリック</li>
<li data-line="35" class="code-line">Salesforce 個人設定のメールアドレスに新しいセキュリティトークンがメールで送信される</li>
<li data-line="36" class="code-line">TROCCO®の接続設定のパスワードの後ろに追加</li>
</ol>
<p data-line="38" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/7f65c8862f07-20241201.png" loading="lazy" class="md-img"></p>
<h3 id="3.2-%E3%83%93%E3%82%B8%E3%83%8D%E3%82%B9%E3%83%A6%E3%83%8B%E3%83%83%E3%83%88id" data-line="43" class="code-line">
<a class="header-anchor-link" href="#3.2-%E3%83%93%E3%82%B8%E3%83%8D%E3%82%B9%E3%83%A6%E3%83%8B%E3%83%83%E3%83%88id" aria-hidden="true"></a> 3.2 ビジネスユニットID</h3>
<p data-line="44" class="code-line">2点目は、ビジネスユニットIDについてです。<br>
こちらは、ヘルプページにもわかりやすく記載されていて、迷う方はいらっしゃらないとは思います。<br>
（primeNumberさん、いつもFBを迅速にご繁栄いただき感謝です！！）</p>
<p data-line="48" class="code-line">私の勘違いは、ビジネスユニットIDが、Account Engagement設定にある<strong>数字6桁</strong>のビジネスユニットIDものと考えていたことです。</p>
<ul data-line="50" class="code-line">
<li data-line="50" class="code-line">https:// ＜組織のドメイン＞ .lightning.force.com/lightning/page/pardot/account</li>
</ul>
<p data-line="52" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/ac2c7f6e2279-20241201.png" loading="lazy" class="md-img"></p>
<p data-line="54" class="code-line">今回必要なIDは「設定 &gt; ビジネスユニット設定」にある<strong>英数字18桁</strong>のビジネスユニットIDです。</p>
<ul data-line="55" class="code-line">
<li data-line="55" class="code-line">https:// ＜組織のドメイン＞ .lightning.force.com/lightning/setup/PardotAccountSetup/home</li>
</ul>
<p data-line="57" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/6a8c2750be4a-20241201.png" loading="lazy" class="md-img"></p>
<p data-line="59" class="code-line">前者は、もともとはアカウントIDと呼ばれていたもので、B2BMAを設定するときに使用されるAccount Engagementインスタンスの一意の識別子であり、現在では、サポートチケットをオープンするときに利用します。<br>
後者は、今回のTROCCO®やZoom連携など、APIに使用する際に利用します。<sup class="footnote-ref"><a href="#fn-0344-2" id="fnref-0344-2">[2]</a></sup></p>
<h2 id="4.-%E8%BB%A2%E9%80%81%E8%A8%AD%E5%AE%9A" data-line="66" class="code-line">
<a class="header-anchor-link" href="#4.-%E8%BB%A2%E9%80%81%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> 4. 転送設定</h2>
<p data-line="67" class="code-line">接続設定が完了したら、早速データを転送すると思います。<br>
その際にも1つ注意点があります。</p>
<p data-line="70" class="code-line">TROCCO®で転送できるAccount Engagementのオブジェクトは、下記の4点です。</p>
<ul data-line="71" class="code-line">
<li data-line="71" class="code-line">訪問者アクティビティ(Visitor Activity)</li>
<li data-line="72" class="code-line">リストメール統計情報(Email Stats)</li>
<li data-line="73" class="code-line">見込み客情報(Prospect)</li>
<li data-line="74" class="code-line">訪問者情報(Visitor)</li>
</ul>
<p data-line="76" class="code-line">そして、それぞれの関係は下記のようになっています。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/176fbcfb6ef2-20241201.png" loading="lazy" class="md-img"><br>
<em>筆者作成</em></p>
<p data-line="80" class="code-line"><strong>訪問者アクティビティ</strong>はイベント種別ごとにログがたまっていくファクトテーブルです。<br>
そして、<strong>見込み客情報(Prospect)</strong> と<strong>訪問者情報(Visitor)</strong> がそれぞれユーザーの情報となり、そこをディメンションとして分析を実施することが可能です。<br>
特に、<strong>見込み客情報(Prospect)</strong> はSalesforceのCRMの重要なオブジェクトである取引先、および取引先責任者と接続が可能なため、様々な分析を実現することが可能となる重要なテーブルです。</p>
<h2 id="5.-%E8%BB%A2%E9%80%81%E8%A8%AD%E5%AE%9A%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9" data-line="86" class="code-line">
<a class="header-anchor-link" href="#5.-%E8%BB%A2%E9%80%81%E8%A8%AD%E5%AE%9A%E3%81%AE%E6%B3%A8%E6%84%8F%E7%82%B9" aria-hidden="true"></a> 5. 転送設定の注意点</h2>
<h3 id="5.1-%E5%88%9D%E5%9B%9E%E8%BB%A2%E9%80%81-%EF%BC%9D%E3%80%8C%E4%BD%9C%E6%88%90%E6%97%A5%E3%80%8D%E3%80%81%E4%BA%8C%E5%9B%9E%E7%9B%AE%E4%BB%A5%E9%99%8D-%3D-%E3%80%8C%E6%9C%80%E7%B5%82%E7%B7%A8%E9%9B%86%E6%97%A5%E3%80%8D" data-line="88" class="code-line">
<a class="header-anchor-link" href="#5.1-%E5%88%9D%E5%9B%9E%E8%BB%A2%E9%80%81-%EF%BC%9D%E3%80%8C%E4%BD%9C%E6%88%90%E6%97%A5%E3%80%8D%E3%80%81%E4%BA%8C%E5%9B%9E%E7%9B%AE%E4%BB%A5%E9%99%8D-%3D-%E3%80%8C%E6%9C%80%E7%B5%82%E7%B7%A8%E9%9B%86%E6%97%A5%E3%80%8D" aria-hidden="true"></a> 5.1 初回転送 ＝「作成日」、二回目以降 = 「最終編集日」</h3>
<p data-line="89" class="code-line">TROCCO®の転送設定では、Salesforceの<code>作成日</code>と<code>最終編集日</code>のどちらかを条件にして転送するデータ範囲を決めます。詳細はヘルプページをご確認ください。</p>
<p data-line="91" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__9f9e3287c20e2" src="https://embed.zenn.studio/card#zenn-embedded__9f9e3287c20e2" data-content="https%3A%2F%2Fdocuments.trocco.io%2Fdocs%2Fdata-source-pardot" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://documents.trocco.io/docs/data-source-pardot" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://documents.trocco.io/docs/data-source-pardot</a></p>
<p data-line="93" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/dd81f7641555-20241201.png" loading="lazy" class="md-img"><br>
<em>実際の設定画面</em></p>
<p data-line="96" class="code-line">Salesforceでは、レコードが作成されると「<code>作成日</code>=<code>最終編集日</code>」として保存されます。そのため、<code>最終編集日</code>が最も古い時間で設定すれば、過去の全データが送付できると考える人もいると思います（私はそうでした）。<br>
ですが、<strong>初回実行で過去データを転送する場合、最終編集日ではなく、作成日で転送しないと全データを転送することはできません</strong>。</p>
<p data-line="99" class="code-line">そのため、初回実行は<code>作成日</code>を軸に、Account Engagementに利用を開始した日をベースに転送し、二回目以降は、<code>作成日</code>を基準に転送すると最新のデータが更新されないため、<strong><code>最終更新日</code>が任意のデータ範囲のものについてを転送するように設定する</strong>と良いでしょう。</p>
<ul data-line="101" class="code-line">
<li data-line="101" class="code-line">初回は「作成日」で、Account Engagementの利用を開始した日を軸に転送</li>
<li data-line="102" class="code-line">二回目以降、最新データを転送する定期実行の場合は「編集日」で転送</li>
</ul>
<h2 id="6.-%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" data-line="106" class="code-line">
<a class="header-anchor-link" href="#6.-%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> 6. おわりに</h2>
<p data-line="107" class="code-line">最後までお読みいただきありがとうございました。</p>
<p data-line="109" class="code-line">今回は、Account Engagementの転送設定に関しての注意点をご紹介しました。<br>
少しでも、皆さまの力になれましたら幸いです。</p>
<section class="footnotes">
<span class="footnotes-title">脚注</span>
<ol class="footnotes-list">
<li id="fn-0344-1" class="footnote-item">
<p data-line="40" class="code-line">Salesforce ヘルプ「<a href="https://help.salesforce.com/s/articleView?id=sf.user_security_token.htm&amp;type=5" target="_blank" rel="nofollow noopener noreferrer">セキュリティトークンのリセット</a>」 <a href="#fnref-0344-1" class="footnote-backref">↩︎</a></p>
</li>
<li id="fn-0344-2" class="footnote-item">
<p data-line="62" class="code-line">Salesforce ヘルプ「<a href="https://help.salesforce.com/s/articleView?id=000381973&amp;type=1" target="_blank" rel="nofollow noopener noreferrer">Account Engagement ビジネスユニット ID の検索</a>」 <a href="#fnref-0344-2" class="footnote-backref">↩︎</a></p>
</li>
</ol>
</section>


TROCCO®でAccount Engagement（旧Pardot）のデータを転送する際の注意点

3.1 個人のセキュリティトークン

5.1 初回転送 ＝「作成日」、二回目以降 = 「最終編集日」

Discussion