Mailchimp イベント転送拡張機能の概要

Mailchimp ​ イベント転送拡張機能は、Mailchimp マーケティング APIにイベントを送信し、Mailchimp マーケティング キャンペーン、ジャーニー、トランザクションのメールをトリガーできます。

このドキュメントでは、イベントを追加アクションを使用して拡張機能を設定し、ルールを設定する方法について説明します。

前提条件

このドキュメントでは、拡張機能で活用される関連するMailchimp製品について理解していることを前提としています。 詳しくは、​ キャンペーン ​、​ ジャーニー、​ トランザクション ​のMailchimp ヘルプドキュメントを参照してください。

この拡張機能を使用するにはMailchimp アカウントが必要です。 アカウント ここに登録できます。 Mailchimp アカウントダッシュボードでは、このガイドで使用する次の値に注意してください。

Mailchimp アカウントプランによっては、Mailchimp カスタマージャーニーツールへのアクセスが制限されている場合があります。

ドメイン接頭辞

Mailchimpにログインしてダッシュボードビューに移動すると、ブラウザーのアドレスバーにhttps://us11.admin.mailchimp.comやus11.admin.mailchimp.comなどのURLが表示されます。 この例では、接頭辞us11はプレースホルダーに過ぎず、値が異なります。 後の手順でURLを接頭辞と共に記録します。

API キー

アカウントのAPI キーを見つけるには、Mailchimp UIでプロファイルアイコンを選択し、プロファイル​を選択します。 https://us11.admin.mailchimp.com/account/profile/のようなURLが表示されますが、ではなく​あなたのus11接頭辞が付いています。

Extras​を選択してから、API キー​を選択します。

お使いのAPI キー​で、既存のキーを選択するか、キーを作成​を選択して新しいキーを作成できます。 この拡張機能で特に使用する新しいキーを作成できます。 API キーをコピーし、後の手順のために保存します。 詳しくは、API キーを生成する方法に関するMailchimpのドキュメントを参照してください。

オーディエンス IDと差出人アドレス

左側のナビゲーションで「オーディエンス」、「オーディエンスダッシュボード」を選択します。 次に、この拡張機能で使用するオーディエンスを選択します。 詳しくは、​ オーディエンスの作成に関するMailchimp ドキュメントを参照してください。

オーディエンスを作成して選択した状態で、オーディエンスを管理 ドロップダウンを選択し、設定​を選択します。 この画面には、オーディエンスのさまざまな設定が表示されます。

設定画面の下部にUnique id for audience [audience name]が表示されます。[audience name]は実際のオーディエンスの名前です。 オーディエンス IDをコピーし、後の手順のために保存します。

オーディエンス名とデフォルト​を選択し、デフォルトの送信元メールアドレス​がキャンペーンに適した値であることを確認します。 オーディエンス IDも、このページの上部に表示され、最後の手順でコピーした値と同じであることに注意してください。

Mailchimpの自動化

Mailchimp プラン、トランザクションメール、カスタマージャーニー、その他のMailchimp自動処理のいずれを使用しているかによって、特定のジャーニー設定は異なる場合があります。

インストールと設定

この節では、拡張機能をインストールして設定する手順を示します。 Mailchimp API キーを安全に保存するには、イベント転送secretsを使用する必要があります。

秘密鍵とデータ要素の作成

イベント転送プロパティで、はTokenという シークレット Mailchimp API Keyを作成します。

次に、作成した秘密鍵を参照するために、Core拡張機能とSecret データ要素タイプを使用して、Mailchimp API Key データ要素を作成します。 データ要素名としてMailchimp Tokenを入力します。

拡張機能のインストールと設定

同じイベント転送プロパティで、Extensions、、Catalog​を選択して、インストールに使用できる拡張機能を表示します。 ここから、Mailchimp拡張機能を検索し、Install​を選択します。

設定画面が表示されます。 Mailchimp Server Prefix Domain Name​で、Mailchimp アカウントから先ほどコピーしたドメイン（一意のドメイン プレフィックスを含む）を入力します。

Mailchimp token​で、データ要素アイコンを選択し、前に作成したMailchimp Token データ要素を選択します。 Save​を選択して変更を保存します。

拡張機能がインストールされ、プロパティで使用できるように設定されました。

データ収集

この拡張機能を​ ルール ​で使用する場合、拡張機能が各イベントでMailchimpに送信するデータ値がいくつかあります。 一般的な実装では、Adobe Experience Platform Web SDK拡張機能を設定して、そのデータをExperience Platform Edge Networkに送信し、イベント転送プロパティで拡張機能で使用するように設定できます。

この拡張機能で必要なデータは、Web SDKからXDM データ（xdm オブジェクトを使用）または非XDM データ（data オブジェクトを使用）として送信できます。

たとえば、顧客がサイトでのイベントを購入したり登録したりした場合、この拡張機能を使ってMailchimpを通じて確認メールを送ることができます。 Web SDKからEdge Networkに必要な情報を送信すると、拡張機能はMailchimpでメールをトリガーします。

データ要素

前のセクションのスクリーンショットは、この拡張機能からMailchimpに各イベントで送信できるデータを示しています。 このデータをEdge Networkに送信するようにWeb SDKを設定したら、イベント転送プロパティにデータ要素を作成して、拡張機能がこれらの値にアクセスできるようにします。

次の表に、可能な各値の詳細を示します。

イベント転送プロパティでは、上記の各フィールドのデータ要素を作成できます。 作成したら、この拡張機能のAdd Event アクションでデータ要素を参照できます。

この拡張機能と「イベントを追加」アクションを使用して、オーディエンスのMailchimp メールをトリガーできるようになりました。

データ検証

イベント転送拡張機能を使用する場合、Adobe Experience Platform Debuggerは非常に便利です。 「ログ」セクションの「Edge ログ」で、イベント転送ルールがトリガーされた後に行われたリクエストを確認できます。 次のスクリーンショットは、拡張機能によってMailchimp APIに対して行われるリクエストを示しています。

Mailchimp ダッシュボードのオーディエンスまたはオーディエンスメンバーのアクティビティフィードのビューに、そのオーディエンスまたはオーディエンスメンバーのイベントのリストが表示されます。 これは、拡張機能によって送信されたイベントと一致し、送信されたオプションのデータと、受信したメールまたはキャンペーンを表示する必要があります。 詳しくは、Mailchimp Automation ヘルプガイド ​を参照してください。