Show Menu
トピック×

API によるデータ取り込みのトリガー

Adobe Experience Platform Data Connectorは、現在ベータ版です。この機能は、予告なく頻繁にアップデートされる場合があります。 これらの機能にアクセスするには、お客様はAzureでホストされる必要があります(現在、北米向けベータ版のみ)。 アドビカスタマーケアにお問い合わせの際は、アドビカスタマーケアにご連絡ください。
Adobe Campaign標準を使用すると、APIを介したデータマッピングの即時取り込みをトリガーし、取り込みリクエストのステータスを取得できます。
このページでは、データマッピングのインジェストステータスをトリガーおよび取得する方法について説明します。 Campaign StandardAPIのグローバル情報については、 この節を参照してください

前提条件

APIを使用する前に、Campaign Standardインターフェイス内でデータマッピングを設定および公開しておく必要があります。 詳しくは、以下の節を参照してください。
データマッピングを作成したら、実行を停止して、APIからいつでもトリガーできるようにする必要があります。 それには、次の手順に従います。
  1. Campaign Standardで、// Administration / Development メニューに移動し Platform Status of data export to platform ます。
  2. 重複を押しながらデータマッピングをクリックして開き、 Stop ボタンをクリックします。
  3. 変更を保存する
現在、データマッピングの実行が停止しています。 Campaign StandardAPIを使用して手動でトリガーできます。

データマッピングの即時取り込みの開始

XDMマッピングをAdobe Experience Platformに直ちに取り込むと、POST操作によって次のようにトリガーされます。
POST https://mc.adobe.io/<ORGANIZATION>/campaign/dataIngestion/xdmIngestion/<XDM Mapping ID>/ingest
取り込みPOST API呼び出しを実行するには、 ​SQL関数の実行役割が必要です。この役割は、Campaign Standard管理者が次のJSスクリプトを実行することで提供できます。
var sqlRoleObj = REST.head.roleBase.sql.get(); REST.head.securityGroup.Administrators.roles.post(sqlRoleObj);
POST操作は、作成された要求ステータスに関する情報を返します。
  • XDMマッピングの要求は正常に送信されました:
{
"requestId": <value>,
"info": "Ingestion request submitted successfully for the Mapping ID: <value>",
"status":"Success"
}

  • XDMマッピングの要求は既に進行中です:
{
"requestId": <value>,
"info": "Ingestion request already in progress for the Mapping ID: <value>",
"status":"In Progress"
}

  • XDMマッピングが発行されていないか、または停止されているため、要求に失敗しました:
{
"info": "Unable to submit data ingestion request, XDM Mapping ID: <value> is not stopped",
"status": "Failed"
}
{
"info": "Unable to submit data ingestion request, XDM Mapping ID: <value> is not published",
"status": "Failed"
}

取り込み要求のステータスの取得

取り込み要求のステータスは、GET操作と、パラメータ内の目的の要求IDを使用して取得できます。
GET https://mc.adobe.io/<ORGANIZATION>/campaign/dataIngestion/xdmIngestion/<XDM Mapping ID>/ingest
{"requestId"="<value>"}

XDMマッピング要求のステータスと関連ジョブに関する詳細な情報は、Campaign Standardインターフェイスの「Status of data export to platform # ​マッピングアクティベーションを参照 マッピングの有効化 )。
GET操作は、次の情報を返します。
  • batchId : このフィールドは、バッチの準備とアップロードの後にエラーが発生した場合にのみ入力されます。
  • info : XDMマッピングID、
  • numRecords : 取り込まれた記録の数(成功状況のみ)
  • status : 取り込み要求の状態(成功/失敗/進行中)
GET操作に対する応答は次のとおりです。
  • 取り込み要求が正常に完了しました:
    {
    "batchId": "",
    "info": "Mapping Id: <value>. ",
    "numRecords": 15,
    "requestId": 3520,
    "status": "Success"
    }
    
    
  • 取り込み要求は0レコードの取り込みで失敗しました:
    {
    "batchId": "",
    "info": "Mapping Id: <value>. ACP-880056 Failed to fetch the record from the database.",
    "numRecords": 0,
    "requestId": 3520,
    "status": "Failed"
    }
    
    
  • 取り込み要求が失敗し、いくつかのレコードがバッチにアップロードされました:
    {
    "batchId": "<value>",
    "info": "Mapping Id: <value>. ACP-880096 Sync Job failed to upload. Please check the error in the Platform UI.",
    "numRecords": 0,
    "requestId": <value>,
    "status": "Failed"
    }
    
    
  • 一部のレコードを取り込んだ後で取り込み要求が中止されました(クラッシュシナリオで発生する場合があります)。
    {
    "batchId": "",
    "info": "Mapping Id: <value>. Ingestion request aborted due to some issue with data ingestion service. Please submit a new request",
    "numRecords": 0,
    "requestId": <value>,
    "status": "Aborted"
    }
    
    
  • 取り込み要求が進行中です(要求がデータをバッチでアップロードした場合、またはバッチが要求の準備を行う場合)。
    {
    "batchId": "",
    "info": "Mapping Id: <value>.",
    "numRecords": 0,
    "requestId": <value>,
    "status": "In Progress"
    }