宛先接続 your-destination
このテンプレートを使用する場合は、(この段落から始めて)斜体のすべての段落を置き換えるか削除します。
まず、ページ上部のメタデータ(タイトルと説明)を更新します。 このページの UICONTROL のインスタンスをすべて無視してください。 これは、機械翻訳プロセスが、サポートする複数の言語にページを正しく翻訳するのに役立つタグです。 ドキュメントを送信したら、タグをドキュメントに追加します。
- このテンプレートのすべてのセクションを、テンプレートで説明されている順序で入力します。
- このテンプレートは、パートナーのフィードバックに基づいて、まれに更新されます。 宛先用のドキュメントのオーサリングを開始する前に、テンプレートの最新バージョンをダウンロードしていることを確認してください。
概要 overview
顧客に提供する価値を含め、会社の概要を入力します。 さらに読むために、製品ドキュメントのホームページへのリンクを含めます。
support@YourDestination.com
などの更新にアクセスできます。ユースケース use-cases
YourDestination 宛先を使用する方法とタイミングをより深く理解するために、Adobe Experience Platformのお客様がこの宛先を使用して解決できるサンプルユースケースを以下に示します。
のユースケース#1 use-case-1
モバイルメッセージプラットフォームの場合:
ある住宅レンタルおよび販売プラットフォームは、顧客のAndroidおよびiOS機器にモバイル通知をプッシュして、以前にレンタルを検索したエリアに 100 件の更新されたリストがあることを知らせたいと考えています。
のユースケース#2 use-case-2
ソーシャルネットワークプラットフォームの場合:
アスレチックアパレルブランドは、ソーシャルメディアアカウントを通じて既存の顧客にリーチしたいと考えています。 アパレルブランドは、独自の CRM からAdobe Experience Platformにメールアドレスを取り込み、独自のオフラインデータからオーディエンスを作成し、これらのオーディエンスを YourDestination に送信して、顧客のソーシャルメディアフィードに広告を表示できます。
前提条件 prerequisites
Adobe Experience Platform ユーザーインターフェイスで宛先の設定を開始する前に、お客様が認識しておく必要がある情報については、この節を参照してください。 次に示す内容を使用できます。
- 許可リストに追加する必要があります
- メールハッシュの要件
- お客様側のアカウント詳細
- プラットフォームに接続するための API キーを取得する方法
顧客にとって役に立つ場合は、関連ドキュメントにリンクできます。
サポートされている ID supported-identities
宛先でサポートされている ID について、この節で情報を追加します。 テーブルには、いくつかの標準値が事前に入力されています。 宛先に適用されない値を削除したり、事前入力されていない値を追加したりします。
宛先 では、以下の表で説明する ID のアクティブ化をサポートしています。 ID についての詳細情報。
サポートされるオーディエンス supported-audiences
宛先でサポートされているオーディエンスに関する情報を、この節で追加します。 テーブルには、いくつかの標準値が事前に入力されています。 ✓
と X
の文字を使用して、オーディエンスタイプがこの宛先でサポートされているかどうかをマークします。
この節では、この宛先に書き出すことができるオーディエンスのタイプについて説明します。
書き出しのタイプと頻度 export-type-frequency
テーブルには、宛先に対応する行のみを保持します。 書き出しタイプに 1 行、書き出し頻度に 1 行が必要です。 宛先に適用されない値を削除します。
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先に対する認証 authenticate
宛先への認証時に顧客が入力する必要があるフィールドを追加します。 これらのフィールドは宛先固有であり、Destination SDKの設定によって異なります。 宛先のフィールドは、以下に示すものと同じではない可能性があります。 以下に示すサンプルスクリーンショットに類似したスクリーンショットも含めてください。
宛先に対して認証するには、必須フィールドに入力し、「宛先に接続」を選択します。
- ベアラートークン:宛先を認証するためのベアラートークンを入力します。
宛先の詳細の入力 destination-details
顧客が新しい宛先を設定する際に入力する必要があるフィールドを追加します。 これらのフィールドは宛先固有であり、Destination SDKの設定によって異なります。 宛先のフィールドは、以下に示すものと同じではない可能性があります。 以下に示すサンプルスクリーンショットに類似したスクリーンショットも含めてください。
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。
- 名前:今後この宛先を認識するための名前。
- 説明:今後この宛先を識別するのに役立つ説明。
- アカウント ID: YourDestination アカウント ID。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読に関するガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
必要に応じて削除 – 新しいストリーミング宛先をドキュメント化する場合は、以下の最初の段落を保持します。 新しいファイルベースの宛先をドキュメント化する場合は、2 番目の段落を残します。 データセットを書き出す宛先をドキュメント化する場合は、3 番目の段落を保持します。
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
この宛先に対してオーディエンスをアクティブ化する手順については、バッチプロファイル書き出し宛先に対するオーディエンスデータのアクティブ化を参照してください。
この宛先にデータセットを書き出す詳細な手順については 🔗 (Beta)データセットの書き出しを参照してください。
属性と ID のマッピング map
アクティベーションワークフローのマッピング手順で、ソースフィールドとターゲットフィールド間でサポートされるマッピングに関する情報を追加します。 宛先は、プロファイル属性、ID 名前空間、またはその両方の書き出しをサポートしている場合があります。 一部のフィールドは必須です。 ターゲット属性には、事前定義済みまたはカスタムがあります。 できればスクリーンショットを使用して、重要な注意事項と使用例を指摘してください。 参照として使用できる宛先ページの例は次の 2 つです。
書き出されたデータ/データ書き出しの検証 exported-data
データを宛先に書き出す方法に関する段落を追加します。 これは、顧客が、宛先と正しく統合されていることを確認するのに役立ちます。 例えば、以下のようなサンプル JSON を指定できます。 または、宛先のインターフェイスからスクリーンショットや情報を提供して、宛先プラットフォームでオーディエンスがどのように入力されると顧客が期待する必要があるかを示すこともできます。
{
"person": {
"email": "yourstruly@adobe.com"
},
"segmentMembership": {
"ups": {
"7841ba61-23c1-4bb3-a495-00d3g5fe1e93": {
"lastQualificationTime": "2020-05-25T21:24:39Z",
"status": "exited"
},
"59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae": {
"lastQualificationTime": "2020-05-25T23:37:33Z",
"status": "realized"
}
}
},
"identityMap": {
"ecid": [
{
"id": "14575006536349286404619648085736425115"
},
{
"id": "66478888669296734530114754794777368480"
}
],
"email_lc_sha256": [
{
"id": "655332b5fa2aea4498bf7a290cff017cb4"
},
{
"id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
}
]
}
}
データの使用とガバナンス data-usage-governance
Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのように データガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。
その他のリソース additional-resources
製品ドキュメントへの追加リンクや、お客様が成功するために重要と思われるその他のリソースを提供できます。