ドキュメントExperience Platform宛先ガイド

SendGrid 接続

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • ユーザー

概要 overview

SendGrid は、トランザクションメールとマーケティングメール用の一般的な顧客コミュニケーションプラットフォームです。

この Adobe Experience Platform 宛先は SendGrid Marketing Contacts API を利用しているので、ファーストパーティのメールプロファイルを書き出し、ビジネスニーズに合わせて新しい SendGrid オーディエンス内でそれらをアクティブ化できます。

SendGrid は、SendGrid API と通信するための認証メカニズムとして API ベアラートークンを使用します。

前提条件 prerequisites

宛先の設定を開始する前に、次の項目が必要です。

  1. SendGrid アカウントが必要です。

    • SendGrid サインアップページに移動して、SendGrid アカウントをまだ持っていない場合は、登録して作成します。

  2. SendGrid ポータルにログインした後、API トークンも生成する必要があります。

  3. SendGrid web サイトに移動し、Settings / API Keys ページにアクセスします。 または、SendGrid ドキュメントを参照して、SendGrid アプリの適切なセクションにアクセスします。

  4. 最後に、「Create API Key」ボタンを選択します。

SendGrid 宛先へのデータをアクティブ化する前に、schema、dataset および segments を Experience Platform で作成する必要があります。 このページで後述する limits の節も参照してください。

IMPORTANT

  • メールプロファイルからメーリングリストを作成するために使用する SendGrid API では、プロファイルごとに一意のメールアドレスを指定する必要があります。 これは、電子メール または 代替電子メール の値として使用されるかどうかに関係しません。 SendGrid 接続では、電子メールと代替電子メールの両方の値のマッピングをサポートしているので、使用するすべての電子メールアドレスが データセット の各プロファイル内で一意であることを確認してください。 そうしないと、メールプロファイルが SendGrid に送信される際にエラーが発生し、そのメールプロファイルはデータの書き出しには表示されません。

  • 現在、Experience Platformでプロファイルがオーディエンスから削除された場合、SendGrid からプロファイルを削除する機能はありません。

サポートされている ID supported-identities

SendGrid では、以下の表に示す ID のアクティブ化をサポートしています。 ID についての詳細情報。

ターゲット ID
説明
注意点
メール
メールアドレス
メモ Adobe Experience Platform では、プレーンテキストと SHA256 でハッシュ化されたメールアドレスの両方がサポートされています。 ハッシュ化されていない属性が Experience Platform ソースフィールドに含まれている場合は、「変換を適用」オプションをオンにして、アクティブ化時にがデータ Platform 自動的にハッシュ化するように設定します。

SendGrid は、ハッシュ化されたメールアドレスをサポートしていないので、変換のないプレーンテキストデータのみが宛先に送信されます。

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
宛先のアクティベーションワークフローのプロファイル属性選択画面で選択した目的のスキーマフィールド（例：メールアドレス、電話番号、姓）と共に、セグメントのすべてのメンバーを書き出します。
書き出し頻度
ストリーミング
ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。ストリーミングの宛先の詳細についてはこちらを参照してください。

ユースケース use-cases

SendGrid 宛先を使用する方法とタイミングをより深く理解するために、Experience Platform 顧客がこの宛先を使用して解決できるサンプルユースケースを以下に示します。

複数のマーケティングアクティビティ用のマーケティングリストの作成

SendGrid を使用するマーケティングチームは、SendGrid 内にメーリングリストを作成し、メールアドレスを入力できます。 SendGrid 内で作成されたメーリングリストは、その後、複数のマーケティングアクティビティに使用できます。

宛先に接続 connect

IMPORTANT
宛先に接続するには、宛先の表示 および 宛先の管理 ​ アクセス制御権限が必要です。 詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

宛先に対する認証 authenticate

  1. Adobe Experience Platform コンソール内で、宛先 に移動します。

  2. カタログ タブを選択し、SendGrid を検索します。 次に、「設定」を選択します。 宛先への接続を確立すると、UI のラベルが「セグメントのアクティブ化」に変わります。

  3. SendGrid 宛先の設定に役立つウィザードが表示されます。 新しい宛先を設定 を選択して新しい宛先を作成します。

  4. 「新規アカウント」オプションを選択し、「Bearer トークン 値を入力します。 この値は、前述の 前提条件の節 で説明した API キーです。

  5. 宛先に接続 を選択します。 指定した SendGrid API キー が有効で、UI に 接続済み ステータスと緑色のチェックマークが表示された場合、次の手順に進んで、追加の情報フィールドに入力できます。

宛先の詳細の入力 destination-details

この宛先を設定するとき、次の情報を指定する必要があります。

  • 名前：今後この宛先を認識するための名前。
  • 説明：今後この宛先を識別するのに役立つオプションの説明。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の入力を終えたら「次へ」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示 および セグメントの表示 ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID を書き出すには、ID グラフの表示 ​ アクセス制御権限が必要です。
    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

この宛先に固有の詳細については、以下の画像を参照してください。

  1. SendGrid にエクスポートする 1 つ以上のオーディエンスを選択します。

  2. マッピング ステップでは、「新しいマッピングを追加」を選択すると、マッピングページが表示され、ソース XDM フィールドを SendGrid API ターゲットフィールドにマッピングできます。 以下の画像は、Experience Platformと SendGrid の間で ID 名前空間をマッピングする方法を示しています。 以下に示すように、Source フィールド Email を Target フィールド external_id にマッピングする必要があります。



  3. 同様に、SendGrid 宛先に書き出す目的の Adobe Experience Platform 属性をマッピングします。

  4. マッピングが完了したら、「次へ」を選択してレビュー画面に進みます。

  5. 「完了」を選択して、設定を完了します。

SendGrid マーケティング連絡先/連絡先を追加または更新 API 用に設定できる、サポートされる属性マッピングの包括的なリストを以下に示します。

ソースフィールド
ターゲットフィールド
タイプ
説明
制限
xdm:
homeAddress.street1
xdm:
address_line_1
文字列
アドレスの最初のライン。
最大長：
100 文字
xdm:
homeAddress.street2
xdm:
address_line_2
文字列
住所の 2 行目（オプション）。
最大長：
100 文字
xdm:
_extcondev.alternate_emails
xdm:
alternate_emails
文字列の配列
連絡先に関連付けられている追加の E メール。
  • 最大：5 項目
  • 最小：0 項目
xdm:
homeAddress.city
xdm:
city
文字列
連絡先の市区町村です。
最大長：
60 文字
xdm:
homeAddress.country
xdm:
country
文字列
連絡先の国。 フルネームまたは略語を指定できます。
最大長：
50 文字
identityMap:
Email
ID:
external_id
文字列
連絡先のプライマリメール。 これは有効なメールである必要があります。
最大長：
254 文字
xdm:
person.name.firstName
xdm:
first_name
文字列
連絡先の名前
最大長：
50 文字
xdm:
person.name.lastName
xdm:
last_name
文字列
連絡先の姓
最大長：
50 文字
xdm:
homeAddress.postCode
xdm:
postal_code
文字列
連絡先の郵便番号。
xdm:
homeAddress.stateProvince
xdm:
state_province_region
文字列
連絡先の都道府県または地域。
最大長：
50 文字

SendGrid 内のデータエクスポートの検証 validate

宛先が正しく設定されていることを検証するには、次の手順に従います。

  1. 宛先／参照 を選択して、宛先のリストに移動します。

  2. 宛先を選択し、ステータスが「 有効」であることを確認します。

  3. 「Activation data」タブに切り替えて、オーディエンス名を選択します。

  4. オーディエンスの概要を監視し、プロファイルの数がデータセット内で作成された数に対応していることを確認します。

  5. SendGrid マーケティングリスト/リスト API の作成は、list_name 属性の値とデータエクスポートのタイムスタンプを結合して、SendGrid 内に一意の連絡先リストを作成するために使用されます。 SendGrid サイトに移動し、名前パターンに準拠する新しい連絡先リストが作成されているかどうかを確認します。

  6. 新しく作成した連絡先リストを選択し、作成したデータセットの新しいメールレコードが新しい連絡先リスト内に入力されているかどうかを確認します。

  7. さらに、いくつかのメールをチェックして、フィールドマッピングが正しいかどうかを検証します。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

その他のリソース additional-resources

この SendGrid 宛先は、以下の API を利用します。

制限 limits

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6