宛先接続 your-destination

このテンプレートを使用する場合は、(この段落から始めて)斜体のすべての段落を置き換えるか削除します。

まず、ページ上部のメタデータ(タイトルと説明)を更新します。 このページの UICONTROL のインスタンスをすべて無視してください。 これは、機械翻訳プロセスが、サポートする複数の言語にページを正しく翻訳するのに役立つタグです。 ドキュメントを送信したら、タグをドキュメントに追加します。

IMPORTANT
  • このテンプレートのすべてのセクションを、テンプレートで説明されている順序で入力します。
  • このテンプレートは、パートナーのフィードバックに基づいて、まれに更新されます。 宛先用のドキュメントのオーサリングを開始する前に、テンプレートの最新バージョンをダウンロードしていることを確認してください。

概要 overview

顧客に提供する価値を含め、会社の概要を入力します。 さらに読むために、製品ドキュメントのホームページへのリンクを含めます。

IMPORTANT
この宛先コネクタとドキュメントページは、YourDestination チームが作成および管理します。 お問い合わせや更新のリクエストについては、リンクまたはメールアドレスを挿入してください。ここで、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 についての詳細情報。

ターゲット ID
説明
注意点
GAID
GOOGLE ADVERTISING ID
ソース ID が GAID 名前空間の場合は、GAID ターゲット ID を選択します。
IDFA
Apple の広告主 ID
ソース ID が IDFA 名前空間の場合は、IDFA ターゲット ID を選択します。
ECID
Experience Cloud ID
ECID を表す名前空間。 この名前空間は、「Adobe Marketing Cloud ID」、「Adobe Experience Cloud ID」、「Adobe Experience Platform ID」という別名で呼ばれることもあります。詳しくは、ECID に関する次のドキュメントを参照してください。
phone_sha256
SHA256 アルゴリズムでハッシュ化された電話番号
Adobe Experience Platform では、プレーンテキストと SHA256 でハッシュ化された電話番号の両方がサポートされています。ハッシュ化されていない属性がソースフィールドに含まれている場合は、「変換を適用」オプションをオンにして、アクティブ化時に Platform がデータを自動的にハッシュ化するように設定します。
email_lc_sha256
SHA256 アルゴリズムでハッシュ化されたメールアドレス
Adobe Experience Platform では、プレーンテキストと SHA256 でハッシュ化されたメールアドレスの両方がサポートされています。ハッシュ化されていない属性がソースフィールドに含まれている場合は、「変換を適用」オプションをオンにして、アクティブ化時に Platform がデータを自動的にハッシュ化するように設定します。
extern_id
カスタムユーザー ID
ソース ID がカスタム名前空間の場合は、このターゲット ID を選択します。

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

宛先でサポートされているオーディエンスに関する情報を、この節で追加します。 テーブルには、いくつかの標準値が事前に入力されています。 X の文字を使用して、オーディエンスタイプがこの宛先でサポートされているかどうかをマークします。

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

オーディエンスオリジン
サポートあり
説明
Segmentation Service
Experience Platform セグメント化サービスを通じて生成されたオーディエンス。
カスタムアップロード
X
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

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

テーブルには、宛先に対応する行のみを保持します。 書き出しタイプに 1 行、書き出し頻度に 1 行が必要です。 宛先に適用されない値を削除します。

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

項目
タイプ
メモ
書き出しタイプ
オーディエンスの書き出し
YourDestination 宛先で使用される識別子(名前、電話番号など)を使用して、オーディエンスのすべてのメンバーを書き出します。
書き出しタイプ
プロファイルベース
宛先のアクティベーションワークフローのプロファイル属性選択画面で選択したように、目的のスキーマフィールド(例:メールアドレス、電話番号、姓)と共に、オーディエンスのすべてのメンバーを書き出しています。
書き出しタイプ
データセットの書き出
オーディエンスの関心や選定別にグループ化または構造化されていない未加工のデータセットを書き出しています。
書き出し頻度
ストリーミング
ストリーミングの宛先は常に、API ベースの接続です。オーディエンス評価に基づいて Experience Platform 内でプロファイルが更新されるとすぐに、コネクタは更新を宛先プラットフォームに送信します。ストリーミングの宛先の詳細についてはこちらを参照してください。
書き出し頻度
バッチ
バッチ宛先では、ファイルが 3 時間、6 時間、8 時間、12 時間、24 時間の単位でダウンストリームプラットフォームに書き出されます。 詳しくは、バッチ(ファイルベース)宛先を参照してください。

宛先への接続 connect

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

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

宛先に対する認証 authenticate

宛先への認証時に顧客が入力する必要があるフィールドを追加します。 これらのフィールドは宛先固有であり、Destination SDKの設定によって異なります。 宛先のフィールドは、以下に示すものと同じではない可能性があります。 以下に示すサンプルスクリーンショットに類似したスクリーンショットも含めてください。

宛先に対して認証するには、必須フィールドに入力し、「宛先に接続」を選択します。

宛先への認証方法を示すサンプルスクリーンショット

  • ベアラートークン:宛先を認証するためのベアラートークンを入力します。

宛先の詳細の入力 destination-details

顧客が新しい宛先を設定する際に入力する必要があるフィールドを追加します。 これらのフィールドは宛先固有であり、Destination SDKの設定によって異なります。 宛先のフィールドは、以下に示すものと同じではない可能性があります。 以下に示すサンプルスクリーンショットに類似したスクリーンショットも含めてください。

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横のアスタリスクは、そのフィールドが必須であることを示します。

宛先の詳細を入力する方法を示すサンプルスクリーンショット

  • 名前:今後この宛先を認識するための名前。
  • 説明:今後この宛先を識別するのに役立つ説明。
  • アカウント ID: YourDestination アカウント ID。

アラートの有効化 enable-alerts

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

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

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

IMPORTANT
  • データをアクティブ化するには、宛先の表示宛先のアクティブ化プロファイルの表示 および セグメントの表示 アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。

  • ID を書き出すには、ID グラフの表示 アクセス制御権限が必要です。

    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

必要に応じて削除 – 新しいストリーミング宛先をドキュメント化する場合は、以下の最初の段落を保持します。 新しいファイルベースの宛先をドキュメント化する場合は、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

製品ドキュメントへの追加リンクや、お客様が成功するために重要と思われるその他のリソースを提供できます。

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