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

SendGrid 接続

Last update: Mon Apr 06 2026 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 API キーの設定ページに「API キーを作成」ボタンが表示されています。

SendGrid宛先にデータをアクティブ化する前に、で作成された スキーマ 、 データセット 、および セグメント Experience Platformが必要です。 このページの下にある制限 セクションも参照してください。

IMPORTANT

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

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

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

SendGridは、以下の表に記載されているIDのアクティベーションをサポートしています。 ID についての詳細情報。

ターゲット ID
説明
注意点
メール
電子メールアドレス
プレーンテキストとSHA256 ハッシュ化された電子メールアドレスの両方がAdobe Experience Platformでサポートされていることに注意してください。 Experience Platform ソースフィールドにハッシュ化されていない属性が含まれる場合は、Apply transformation オプションをチェックして、Experience Platformがアクティベーション時にデータを自動的にハッシュします。

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

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。

オーディエンスの由来
サポートあり
説明
Segmentation Service
○
Experience Platform ​ セグメント化サービス ​を通じて生成されたオーディエンス。
その他すべてのオーディエンスの生成元
×

このカテゴリには、Segmentation Serviceを通じて生成されたオーディエンス以外のすべてのオーディエンスのオリジンが含まれます。 様々なオーディエンスの起源について読みます。 次に例を示します。

  • カスタムアップロードオーディエンス がCSV ファイルからExperience Platformにをインポートしました。
  • 類似オーディエンス，
  • 連合オーディエンス，
  • Adobe Journey Optimizerなどの他のExperience Platform アプリで生成されたオーディエンス
  • その他。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

オーディエンスのデータタイプ
サポートあり
説明
ユースケース
人物オーディエンス ​
○
顧客プロファイルにもとづいて、マーケティング施策の特定のグループをターゲットにすることができます。
買い物客やカートの放棄が多い
​ アカウントオーディエンス ​
×
アカウントベースドマーケティング戦略のために、特定の組織内の個人をターゲットにします。
B2B マーケティング
見込みオーディエンス ​
×
まだ顧客ではないが、ターゲットオーディエンスと特徴を共有する個人をターゲットにします。
サードパーティデータによる見込み顧客の開拓
​ データセットの書き出し
×
Adobe Experience Platform データ レイクに保存されている構造化データのコレクション。
レポート，データサイエンスワークフロー

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

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

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

ユースケース use-cases

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

複数のマーケティング活動に対応するマーケティングリストの作成 create-marketing-list

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

宛先に接続 connect

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

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

宛先に対する認証 authenticate

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

  2. 「カタログ」タブを選択し、SendGrid​を検索します。 次に、設定​を選択します。 宛先への接続を確立すると、UI ラベルが​ セグメントのアクティブ化 ​に変わります。
    「設定」ボタンがハイライト表示されたExperience Platform宛先カタログの SendGrid宛先カード。

  3. SendGridの宛先の設定を支援するウィザードが表示されます。 新しい宛先を設定​を選択して、新しい宛先を作成します。
    SendGrid宛先設定ウィザードに「新しい宛先を設定」オプションが表示されます。

  4. 「新規アカウント」オプションを選択し、ベアラートークン​の値を入力します。 この値は、前提条件セクション​で前述したSendGrid API キーです。
    新しいアカウントオプションとベアラートークン フィールドを表示するSendGrid認証画面。

  5. 「宛先に接続」を選択します。 指定したSendGrid API キー​が有効な場合、UIに緑色のチェックマークが付いた​ Connected ​状態が表示されます。次の手順に進むと、追加情報フィールドに入力できます。

SendGridの宛先に、認証が成功した後、緑色のチェックマークが付いた接続済みステータスが表示されます。

宛先の詳細の入力 destination-details

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

  • Name：今後この宛先を認識する際に使用する名前。
  • Description：今後この宛先を特定するのに役立つオプションの説明。

SendGridの宛先の詳細フォームに、名前と説明のフィールドが表示されています。

アラートの有効化 enable-alerts

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

宛先接続の詳細の提供が完了したら、Next​を選択します。

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

IMPORTANT
  • データをアクティブ化するには、View Destinations、Activate Destinations、View Profiles​および​View Segments ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID​をエクスポートするには、View Identity Graph ​ アクセス制御権限が必要です。
    ​ ワークフローで強調表示されているID名前空間を選択して、オーディエンスを宛先にアクティブ化します。 {width="100" modal="regular"}

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

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

  1. SendGridに書き出す1つ以上のオーディエンスを選択します。
    SendGridへの書き出し用に選択された1つ以上のオーディエンスを示すオーディエンス選択画面。

  2. Mapping ステップでは、Add new mapping​を選択した後、ソース XDM フィールドをSendGrid API ターゲットフィールドにマッピングするマッピングページが表示されます。 以下の画像は、Experience PlatformとSendGrid間でID名前空間をマッピングする方法を示しています。 次に示すように、Source field 電子メール​を​Target field external_idにマッピングする必要があることを確認してください。
    SendGrid アクティベーションワークフローで選択された「新しいマッピングを追加」オプションを表示するマッピング手順。
    SendGridのexternal_id ターゲットフィールドにマッピングされた電子メールソースフィールドを示す マッピング画面。
    SendGrid ターゲットフィールドにマッピングするために選択されたXDM ソース属性を示す マッピング画面。
    Experience PlatformとSendGridの間で設定された追加のID名前空間マッピングを示すマッピング画面。

  3. 同様に、SendGridの宛先に書き出す目的のAdobe Experience Platform属性をマッピングします。
    SendGrid エクスポートのソースフィールドとして選択されたExperience Platform プロファイル属性を示す マッピング画面。
    Experience Platform XDM フィールドとSendGrid ターゲットフィールド間の完了した属性マッピングを示すマッピング画面。

  4. マッピングが完了したら、Next​を選択してレビュー画面に進みます。
    設定を完了する前に、設定されたマッピングの概要を示す SendGrid アクティベーションのレビュー画面。

  5. Finish​を選択して設定を完了します。
    終了ボタンを表示するSendGrid アクティベーション ワークフローの完了画面。

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

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

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

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

  1. 宛先のリストに移動するには、Destinations > Browse​を選択します。
    Experience Platformの「 宛先の参照」タブには、設定された宛先のリストが表示されます。

  2. 宛先を選択し、ステータスが​ enabled ​であることを検証します。
    「参照」タブの SendGridの宛先に、有効なステータスが表示されています。

  3. 「Activation data」タブに切り替えて、オーディエンス名を選択します。
    SendGrid宛先の アクティベーションデータ タブで、選択されたオーディエンス名が表示されています。

  4. オーディエンスの概要を監視し、プロファイルの数がデータセット内で作成された数に対応しているかどうかを確認します。
    選択したSendGrid オーディエンスのプロファイル数を表示する オーディエンスの概要パネル。

  5. SendGrid マーケティングリスト > リストを作成APIは、list_name属性の値とデータ書き出しのタイムスタンプを結合することで、SendGrid内に一意の連絡先リストを作成します。 SendGrid サイトに移動し、名前パターンに準拠した新しい連絡先リストが作成されているかどうかを確認します。
    SendGrid マーケティングリスト ページで、新しく作成された連絡先リストが、予想される名前パターンに従って表示されます。
    新しいリストが正しい名前で作成されたことを確認するSendGrid連絡先リストの詳細ビュー。

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

  7. さらに、フィールドマッピングが正しいかどうかを検証するために、いくつかのメールも確認してください。
    SendGridの連絡先詳細ビュー。書き出されたデータセットから入力された電子メールレコードフィールドが表示されます。
    SendGridの連絡先レコードに、Experience Platformからの正しいフィールドマッピングを確認する、マッピングされたフィールド値が表示されています。

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

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

その他のリソース additional-resources

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

制限 limits

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