宛先の設定

概要

この設定を使用すると、宛先名、カテゴリ、説明などの重要な情報を指定できます。 また、この設定では、Experience Platformユーザーが宛先に対して認証する方法、Experience Platformユーザーインターフェイスでの表示方法、宛先に書き出すことができる ID も決定します。

また、この設定は、宛先サーバーとオーディエンスメタデータの機能に必要な他の設定も、この設定に接続します。 2 つの設定を 下のセクション.

このドキュメントで説明する機能は、 /authoring/destinations API エンドポイント。 読み取り 宛先 API エンドポイントの操作 エンドポイントで実行できる操作の完全なリストについては、を参照してください。

設定例

次に、架空の宛先 Moviestar の設定例を示します。この宛先は、世界の 4 つの場所にエンドポイントを持っています。 宛先は、モバイル宛先カテゴリに属しています。 次の節では、この設定の構築方法を詳しく説明します。

{
   "name":"Moviestar",
   "description":"Moviestar is a fictional destination, used for this example.",
   "status":"TEST",
   "customerAuthenticationConfigurations":[
      {
         "authType":"BEARER"
      }
   ],
   "customerDataFields":[
      {
         "name":"endpointsInstance",
         "type":"string",
         "title":"Select Endpoint",
         "description":"Moviestar manages several instances across the globe for REST endpoints that our customers are provisioned for. Select your endpoint in the dropdown list.",
         "isRequired":true,
         "enum":[
            "US",
            "EU",
            "APAC",
            "NZ"
         ]
      },
      {
         "name":"customerID",
         "type":"string",
         "title":"Moviestar Customer ID",
         "description":"Your customer ID in the Moviestar destination (e.g. abcdef).",
         "isRequired":true,
         "pattern":"^[A-Za-z]+$"
      }
   ],
   "uiAttributes":{
      "documentationLink":"http://www.adobe.com/go/destinations-moviestar-en",
      "category":"mobile",
      "connectionType":"Server-to-server",
      "frequency":"Streaming"
   },
   "identityNamespaces":{
      "external_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true,
         "acceptedGlobalNamespaces":{
            "Email":{
               
            }
         }
      },
      "another_id":{
         "acceptsAttributes":true,
         "acceptsCustomNamespaces":true
      }
   },
   "schemaConfig":{
      "profileRequired":false,
      "segmentRequired":true,
      "identityRequired":true
   },
   "destinationDelivery":[
      {
         "authenticationRule":"CUSTOMER_AUTHENTICATION",
         "destinationServerId":"9c77000a-4559-40ae-9119-a04324a3ecd4"
      }
   ],
   "segmentMappingConfig":{
      "mapExperiencePlatformSegmentName":false,
      "mapExperiencePlatformSegmentId":false,
      "mapUserInput":false,
      "audienceTemplateId":"cbf90a70-96b4-437b-86be-522fbdaabe9c"
   },
   "aggregation":{
      "aggregationType":"CONFIGURABLE_AGGREGATION",
      "configurableAggregation":{
         "splitUserById":true,
         "maxBatchAgeInSecs":0,
         "maxNumEventsInBatch":0,
         "aggregationKey":{
            "includeSegmentId":true,
            "includeSegmentStatus":true,
            "includeIdentity":true,
            "oneIdentityPerGroup":false,
            "groups":[
               {
                  "namespaces":[
                     "IDFA",
                     "GAID"
                  ]
               },
               {
                  "namespaces":[
                     "EMAIL"
                  ]
               }
            ]
         }
      }
   },
   "backfillHistoricalProfileData":true
}

顧客認証設定

宛先設定のこのセクションは、 新しい宛先の設定 ページを開きます。このページでは、Experience Platformが、宛先のアカウントにExperience Platformを接続できます。 に指定する認証オプションに応じて、 authType 」フィールドに値を入力すると、Experience Platformページが次のように生成されます。

Bearer 認証

bearer 認証タイプを設定する場合、ユーザーは宛先から取得した bearer トークンを入力する必要があります。

OAuth 2 認証

ユーザーが選択 宛先に接続 を使用して、Twitter Cloud Audiences の宛先に対する次の例に示すように、OAuth 2 認証フローを宛先にトリガーします。 宛先エンドポイントに対する OAuth 2 認証の設定について詳しくは、専用の 宛先 SDK OAuth 2 認証ページ.

顧客データフィールド

このセクションでは、パートナーがカスタムフィールドを導入できます。 上記の例の設定では、 customerDataFields では、ユーザーは認証フローでエンドポイントを選択し、顧客 ID と宛先を指定する必要があります。 次に示すように、設定は認証フローに反映されます。

UI 属性

この節では、Adobe Experience Platformユーザーインターフェイスの宛先にAdobeが使用する必要がある、上記の設定の UI 要素について説明します。 次を参照してください。

マッピング手順のスキーマ設定

のパラメーターを使用します。 schemaConfig ：宛先のアクティベーションワークフローのマッピング手順を有効にします。 以下に説明するパラメーターを使用することで、Experience Platformユーザーがプロファイル属性や ID を宛先の側の目的のスキーマにマッピングできるかどうかを判断できます。

ID と属性

この節のパラメーターは、宛先が受け入れる ID を決定します。 また、この設定により、 マッピング手順 を使用します。

どちらを指定するかを指定する必要があります Platform id 顧客は、を宛先に書き出すことができます。 以下に例を示します。 Experience Cloud ID，ハッシュ化された電子メール，デバイス ID (IDFA, GAID) をクリックします。 これらの値は次のとおりです。 Platform ユーザーが宛先の id 名前空間にマッピングできる id 名前空間。 また、顧客が宛先でサポートされている ID にカスタム名前空間をマッピングできるかどうかを指定することもできます。

ID 名前空間では、 Platform および宛先
例えば、お客様は Platform IDFA 名前空間を IDFA 名前空間を宛先から作成するか、同じ名前空間をマッピングできます。 Platform IDFA 名前空間を Customer ID 名前空間を使用します。

詳しくは、 ID 名前空間の概要.

宛先の配信

セグメントマッピングの設定

宛先設定のこのセクションは、セグメント名や ID などのセグメントメタデータをExperience Platformと宛先の間で共有する方法に関連しています。

を通じて audienceTemplateIdの場合、この節では、この設定を オーディエンスメタデータ設定.

上記の設定で示されたパラメーターは、 宛先エンドポイント API リファレンス.

集計ポリシー

このセクションでは、宛先にデータをエクスポートする際にExperience Platformが使用する集計ポリシーを設定できます。

集計ポリシーは、データエクスポートでエクスポートされたプロファイルを組み合わせる方法を決定します。 次の選択肢があります。

• ベストエフォート集計
• 設定可能な集計（上記の設定で表示）

の節を読む テンプレートの使用 そして 集計の主な例 を参照して、選択した集計ポリシーに基づいて、メッセージ変換テンプレートに集計ポリシーを含める方法を理解してください。

ベストエフォート集計

このオプションは、リクエストあたりのプロファイル数が少ない宛先で最適で、より少ないデータでより多くのリクエストを取得する方が、より少ないデータでより少ないリクエストを取得する方が効果的です。

以下を使用： maxUsersPerRequest パラメーターを使用して、宛先がリクエストで取得できるプロファイルの最大数を指定します。

設定可能な集計

このオプションは、同じ呼び出しで数千のプロファイルを含む大きなバッチを取る場合に最も適しています。 また、このオプションを使用すると、複雑な集計ルールに基づいて、書き出されたプロファイルを集計できます。

このオプションを使用すると、次のことができます。

• 宛先に対する API 呼び出しがおこなわれるまでに集計するプロファイルの最大時間と最大数を設定します。
• 次の条件に基づいて、宛先にマッピングされたエクスポート済みプロファイルを集計します。
  • Segment ID;
  • セグメントのステータス。
  • ID または ID のグループ。

集計パラメータの詳細については、 宛先 API エンドポイントの操作 参照ページ。各パラメータについて説明します。

過去のプロファイルの選定

以下を使用して、 backfillHistoricalProfileData パラメーターを使用して、過去のプロファイル選定を宛先に書き出す必要があるかどうかを指定します。

この設定により、宛先に必要なすべての情報が接続される仕組み

一部の宛先設定は、 宛先サーバー または オーディエンスメタデータ設定. ここで説明する宛先設定では、次のように、他の 2 つの設定を参照することで、これらの設定をすべて接続します。

• 以下を使用： destinationServerId を使用して、目的の宛先に対して設定された宛先サーバーおよびテンプレート設定を参照します。
• 以下を使用： audienceMetadataId を使用して、目的の宛先に対して設定されたオーディエンスメタデータを参照します。