宛先設定の作成
このページでは、/authoring/destinations
API エンドポイントを使用して、独自の宛先設定を作成するために使用できる API リクエストおよびペイロードの例を示します。
このエンドポイントを通じて設定できる機能について詳しくは、以下の記事を参照してください。
宛先設定 API 操作の概要 get-started
続行する前に、「はじめる前に」を参照し、API の呼び出しを正常に行うために必要となる重要な情報(必要な宛先オーサリング権限および必要なヘッダーの取得方法など)を確認してください。
宛先設定の作成 create
/authoring/destinations
エンドポイントに POST リクエストを行うことで、新しい宛先設定を作成できます。
platform.adobe.io/data/core/activation/authoring/destinations
API 形式
POST /authoring/destinations
以下のリクエストは、ペイロードで提供されるパラメーター設定に基づいて、新しい Amazon S3 宛先設定を作成します。以下のペイロードには、/authoring/destinations
エンドポイントで指定できる、ファイルベースの宛先のすべてのパラメーターが含まれます。
API 呼び出しにすべてのパラメーターを追加する必要はなく、ペイロードは API 要件に応じてカスタマイズできることに注意してください。
code language-shell |
---|
|
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 layout-auto | ||
---|---|---|
パラメーター | タイプ | 説明 |
name |
文字列 | Experience Platform カタログ内の宛先のタイトルを示します。 |
description |
文字列 | アドビが宛先カードの Experience Platform 宛先カタログで使用する説明を入力します。4 ~ 5 文以下を目指します。 {width="100" modal="regular"} |
status |
文字列 | 宛先カードのライフサイクルステータスを示します。指定できる値は、TEST 、PUBLISHED 、DELETED です。最初に宛先を設定する際に TEST を使用します。 |
customerAuthenticationConfigurations.authType |
文字列 | 宛先サーバーに対して Experience Platform 顧客を認証するために使用される設定を示します。サポートされる認証タイプについて詳しくは、顧客認証設定を参照してください。 |
customerDataFields.name |
文字列 | 導入するカスタムフィールドの名前を指定します。 これらの設定について詳しくは、顧客データフィールドを参照してください。 {width="100" modal="regular"} |
customerDataFields.type |
文字列 | 導入するカスタムフィールドのタイプを示します。使用できる値は、string 、object 、integer です。これらの設定について詳しくは、顧客データフィールドを参照してください。 |
customerDataFields.title |
文字列 | Experience Platform のユーザーインターフェイスで顧客に表示される、フィールドの名前を示します。 これらの設定について詳しくは、顧客データフィールドを参照してください。 |
customerDataFields.description |
文字列 | カスタムフィールドの説明を入力します。これらの設定について詳しくは、顧客データフィールドを参照してください。 |
customerDataFields.isRequired |
ブール値 | このフィールドが宛先設定ワークフローで必須かどうかを示します。 これらの設定について詳しくは、顧客データフィールドを参照してください。 |
customerDataFields.enum |
文字列 | カスタムフィールドをドロップダウンメニューとしてレンダリングし、ユーザーが使用できるオプションを一覧表示します。 これらの設定について詳しくは、顧客データフィールドを参照してください。 |
customerDataFields.default |
文字列 | デフォルト値を enum リストから定義します。 |
customerDataFields.pattern |
文字列 | 必要に応じて、カスタムフィールドのパターンを適用します。正規表現を使用して、パターンを適用します。例えば、顧客 ID に数字やアンダースコアが含まれない場合は、このフィールドに「^[A-Za-z]+$ 」と入力します。これらの設定について詳しくは、顧客データフィールドを参照してください。 |
uiAttributes.documentationLink |
文字列 | 宛先用の宛先のカタログにあるドキュメントページを参照します。https://www.adobe.com/go/destinations-YOURDESTINATION-en を使用します。ここでは、YOURDESTINATION は宛先の名前です。Moviestar という宛先の場合、https://www.adobe.com/go/destinations-moviestar-en を使用します。 このリンクは、アドビが宛先をライブに設定してドキュメントが公開された後でのみ機能することに注意してください。これらの設定について詳しくは、UI 属性を参照してください。 {width="100" modal="regular"} |
uiAttributes.category |
文字列 | Adobe Experience Platform で宛先に割り当てられたカテゴリを参照します。詳しくは、宛先のカテゴリをお読みください。以下のいずれかの値を使用します:adobeSolutions, advertising, analytics, cdp, cloudStorage, crm, customerSuccess, database, dmp, ecommerce, email, emailMarketing, enrichment, livechat, marketingAutomation, mobile, personalization, protocols, social, streaming, subscriptions, surveys, tagManagers, voc, warehouses, payments 。これらの設定について詳しくは、UI 属性を参照してください。 |
uiAttributes.connectionType |
文字列 |
宛先に応じた接続のタイプ。サポートされている値:
|
uiAttributes.frequency |
文字列 | 宛先でサポートされているデータ書き出しのタイプを指します。API ベースの統合の場合は Streaming に設定し、宛先にファイルを書き出す場合は Batch に設定する。 |
identityNamespaces.externalId.acceptsAttributes |
ブール値 | 顧客が標準的なプロファイル属性を設定中の ID にマッピングできるかどうかを示します。 |
identityNamespaces.externalId.acceptsCustomNamespaces |
ブール値 | 顧客がカスタム名前空間に属する ID を設定中の ID にマッピングできるかどうかを示します。 |
identityNamespaces.externalId.transformation |
文字列 | サンプル設定には表示されません。例えば、Platform の顧客がプレーンなメールアドレスを属性として持っており、プラットフォームがハッシュ化されたメールのみを受け取る場合に使用します。ここで、適用する必要のある変換(例えば、メールを小文字に変換してからハッシュ化するなど)を行います。 |
identityNamespaces.externalId.acceptedGlobalNamespaces |
- | 設定中の ID に顧客がマッピングできる標準的な ID 名前空間(例えば、IDFA)を示します。acceptedGlobalNamespaces を使用する場合、"requiredTransformation":"sha256(lower($))" を使用すれば、メールアドレスまたは電話番号を小文字に変換してハッシュ化できます。 |
destinationDelivery.authenticationRule |
文字列 |
Platform の顧客が宛先に接続する方法を示します。使用できる値は
|
destinationDelivery.destinationServerId |
文字列 | この宛先に使用される宛先サーバーテンプレートの instanceId 。 |
backfillHistoricalProfileData |
ブール値 | 宛先に対してオーディエンスをアクティブ化する際に、履歴プロファイルデータを書き出すかどうかを制御します。常にこれを true に設定します。 |
segmentMappingConfig.mapUserInput |
ブール値 | 宛先アクティベーションワークフローのオーディエンスマッピング ID をユーザーが入力するかどうかを制御します。 |
segmentMappingConfig.mapExperiencePlatformSegmentId |
ブール値 | 宛先アクティベーションワークフローのオーディエンスマッピング ID が Experience Platform のオーディエンス ID かどうかを制御します。 |
segmentMappingConfig.mapExperiencePlatformSegmentName |
ブール値 | 宛先アクティベーションワークフローのオーディエンスマッピング ID が Experience Platform のオーディエンス名かどうかを制御します。 |
segmentMappingConfig.audienceTemplateId |
文字列 | この宛先に使用されるオーディエンスメタデータテンプレートの instanceId 。 |
schemaConfig.profileFields |
配列 | 上記の設定に示すように、定義済みの profileFields を追加する際、ユーザーは Adobe Experience Platform 属性を宛先側の定義済み属性にマッピングするオプションを選択できます。 |
schemaConfig.profileRequired |
ブール値 | 上記の設定例に示すように、ユーザーが Experience Platform から宛先側のカスタム属性にプロファイル属性をマッピングできる場合、true を使用します。 |
schemaConfig.segmentRequired |
ブール値 | 常に segmentRequired:true を使用します。 |
schemaConfig.identityRequired |
ブール値 | ユーザーが、Adobe Experience Platform から目的のスキーマに ID 名前空間をマッピングできるようにする場合、true を使用します。 |
API エラー処理
Destination SDK API エンドポイントは、一般的な Experience Platform API エラーメッセージの原則に従います。Platform トラブルシューティングガイドの API ステータスコードおよびリクエストヘッダーエラーを参照してください。
次の手順
このドキュメントでは、Destination SDK /authoring/destinations
API エンドポイントを使用した、新しい宛先設定の作成方法を確認しました。
このエンドポイントでできることについて詳しくは、以下の記事を参照してください。
このエンドポイントが宛先オーサリングプロセスのどこに適合するかを把握するには、以下の記事を参照してください。