特定FFDA促销活动API

企业(FFDA)部署, Campaign v8附带两个特定API,用于管理Campaign本地数据库和云数据库之间的数据。 使用这些功能的先决条件是在架构上启用暂存机制。 了解详情

  • 摄取API: xtk.session.ingest

    此API仅专用于数据插入。 了解详情

  • 数据更新/删除API: xtk.session.ingestExt

    此API用于更新或删除数据。 了解详情

专用的内置工作流将同步云数据库中的数据。

插入数据

xtk.session.ingest API仅专用于数据插入。 无更新/删除。

插入时不进行协调

在工作流中

Javascript代码 活动,在云数据库中插入数据而不进行协调:

var xmlStagingSampleTable = <sampleTableStg
                                testcol1="testValue1"
                                testcol2="testValue2"
                                xtkschema="dem:sampleTableStg">
                            </sampleTableStg>;
strUuid = xtk.session.Ingest(xmlStagingSampleTable);
logInfo(strUuid);

执行工作流后,将按预期提供暂存表。

通过SOAP调用

  1. 获取身份验证令牌。

  2. 触发API。 负载是:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:xtk:session">
    <soapenv:Header/>
    <soapenv:Body>
        <urn:Ingest>
            <urn:sessiontoken>___xxxxxxx-xxxx-xxx-xxx-xxxxxxxxxxx</urn:sessiontoken>
            <urn:domDoc>
                <sampleTableStg
                    testcol1="Test Value 1 (from SOAP)"
                    testcol2="Test Value 2 (from SOAP)"
                    xtkschema="dem:sampleTableStg">
                </sampleTableStg>
            </urn:domDoc>
        </urn:Ingest>
    </soapenv:Body>
    </soapenv:Envelope>
    
  3. UUID会发送回SOAP响应:

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="urn:wpp:default" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <IngestResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default">
            <pstrSUuids xsi:type="xsd:string">e1e7c8b3-6f79-44da-a72d-49ed0f73db2c</pstrSUuids>
        </IngestResponse>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

因此,将按照预期提供暂存表。

插入并协调

在工作流中

Javascript代码 活动,以将数据插入具有协调的云数据库:

var xmlStagingSampleTable = <sampleTableStg  _key="@id" id="ABC12345"
                              testcol1="testValue1"
                              testcol2="testValue2"
                              xtkschema="dem:sampleTableStg">
                            </sampleTableStg>;
strUuid = xtk.session.Ingest(xmlStagingSampleTable);
logInfo(strUuid);

执行工作流后,将按预期提供暂存表。

通过SOAP调用

  1. 获取身份验证令牌。

  2. 触发API。 负载是:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:xtk:session">
    <soapenv:Header/>
    <soapenv:Body>
      <urn:Ingest>
         <urn:sessiontoken>___5e71f4bf-d38a-4ba8-ac15-35a958f7f138</urn:sessiontoken>
         <urn:domDoc>
            <sampleTableStg  _key="@id" id="ABDCD321"
                 testcol1="Test Value 1 (from SOAP)"
                 testcol2="Test Value 2 (from SOAP)"
                 xtkschema="dem:sampleTableStg">
             </sampleTableStg>
         </urn:domDoc>
      </urn:Ingest>
     </soapenv:Body>
    </soapenv:Envelope>
    
  3. 在这种情况下,不会向响应提供UUID,因为已在有效负载中提供UUID。 响应是:

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="urn:wpp:default" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <IngestResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default">
            <pstrSUuids xsi:type="xsd:string"/>
        </IngestResponse>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

因此,将按照预期提供暂存表。

更新或删除数据

xtk.session.IngestExt 优化了API以进行数据更新/删除。 仅插入,首选 xtk.session.ingest. 无论记录键是否在暂存表中,插入操作都正在进行。

插入/更新

在工作流中

Javascript代码 用于更新云数据库中数据的活动:

var xmlStagingRecipient = <sampleTableStg  _key="@id" id="ABC12345"
                              testcol1="testValue A (updated)"
                              testcol2="testValue B (updated)"
                              xtkschema="dem:sampleTableStg">
                            </sampleTableStg>;
xtk.session.IngestExt(xmlStagingRecipient);

执行工作流后,将按预期更新暂存表。

通过SOAP调用

  1. 获取身份验证令牌。

  2. 触发API。 负载是:

    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:xtk:session">
    <soapenv:Header/>
    <soapenv:Body>
        <urn:IngestExt>
            <urn:sessiontoken>___444cd168-a1e2-4fb6-a2a8-73be9f133489</urn:sessiontoken>
            <urn:domDoc>
            <sampleTableStg  _key="@id" id="ABDCD321"
                    testcol1="Test Value E (from SOAP)"
                    testcol2="Test Value F (from SOAP)"
                    xtkschema="dem:sampleTableStg">
                </sampleTableStg>
            </urn:domDoc>
        </urn:IngestExt>
    </soapenv:Body>
    </soapenv:Envelope>
    
  3. SOAP响应为:

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="urn:wpp:default" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <IngestExtResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns="urn:wpp:default"/>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

因此,将按照预期更新暂存表。

订阅管理

有关Campaign中的订阅管理,请参阅 本页.

订阅和退订数据的插入取决于 分级机制 在Campaign本地数据库中。 订阅者信息临时存储在本地数据库的暂存表中,并且同步工作流会将此数据从本地数据库发送到云数据库。 因此,订购和退订流程 异步. 选择加入和选择退出请求每小时通过特定的技术工作流进行处理。 了解详情

相关主题

在此页面上