API comercial são específicas para cada tipo de objeto. Têm um efeito sobre:
Deliveries:
Fluxos de trabalho:
iniciar um fluxo de trabalho,
verificação dos processos, etc.
Consulte métodos SOAP em JavaScript.
Gestão de conteúdo
Gerenciamento de subscrições, consulte Assinar (nms:subscrição) e Cancelar inscrição (nms:subscrição).
Processos de dados: importações, exportações.
Esta seção detalha o uso dos serviços "Assinar", "Cancelar inscrição" e "SubmeterEntrega".
A documentação JSAPI de campanha contém informações adicionais sobre chamadas SOAP e uso do Javascript no Adobe Campaign, bem como uma referência completa a todos os métodos e funções usados no aplicativo.
Esse serviço permite que você assine um recipient a um serviço de informação e atualize o perfil do recipient.
Os seguintes parâmetros são necessários para chamar o serviço:
Descrição do método "subscribe" no schema "nms:subscrição":
<method name="Subscribe" static="true">
<parameters>
<param name="serviceName" type="string" desc="List of information service names (comma separated)"/>
<param name="recipient" type="DOMElement" desc="Recipient"/>
<param name="create" type="Boolean" desc="Create recipient if it does not exist"/>
</parameters>
</method>
A definição da chave de reconciliação deve ser inserida por meio do atributo _key no elemento <recipient>
do documento XML. O conteúdo desse atributo é uma lista XPath separada por vírgulas.
Esta chamada não retorna nenhum dado, exceto erros.
Subscrição com chave de reconciliação do recipient no endereço de email: o documento XML de entrada deve fazer referência ao endereço de email e à definição da chave neste campo.
<recipient _key="email" email= "john.doe@adobe.com"/>
Atualização do recipient e da subscrição.
<recipient _key="email, [folder-id]" email= "john.doe@adobe.com" folder-id="1305" firstName="John" lastName="Doe"/>
Query:
<?xml version='1.0' encoding='ISO-8859-1'?>
<SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
<SOAP-ENV:Body>
<m:Subscribe xmlns:m='urn:nms:subscription' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
<sessiontoken xsi:type='xsd:string'/>
<service xsi:type='xsd:string'>SVC1</service>
<content xsi:type='' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
<recipient _key="@email" email= "john.doe@adobe.com/>
</content>
<create xsi:type='xsd:boolean'>true</create>
</m:Subscribe>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Resposta:
<?xml version='1.0' encoding='ISO-8859-1'?>
<SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
<SOAP-ENV:Body>
<m:SubscribeResponse xmlns:m='urn:nms:subscription' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
</m:SubscribeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Este serviço permite cancelar a inscrição de um recipient de um serviço de informação e atualizar o perfil do recipient.
Os seguintes parâmetros são necessários para chamar o serviço:
Descrição do método "Cancelar inscrição" no schema "nms:subscrição":
<method name="Unsubscribe" static="true">
<parameters>
<param name="serviceName" type="string" desc="List of information service names (comma separated)"/>
<param name="recipient" type="DOMElement" desc="Recipient"/>
</parameters>
</method>
A definição da chave de reconciliação deve ser inserida por meio do atributo _key no elemento <recipient>
do documento XML. O conteúdo desse atributo é uma lista XPath separada por vírgulas.
Se o recipient não estiver presente no banco de dados ou não estiver inscrito no serviço de informação em questão, o serviço não executará nenhuma ação e não gerará um erro.
Se o nome do serviço não for especificado como um parâmetro, o recipient será então automaticamente em (@blackList="1").
Esta chamada não retorna nenhum dado, exceto erros.
Query:
<?xml version='1.0' encoding='ISO-8859-1'?>
<SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
<SOAP-ENV:Body>
<m:Unsubscribe xmlns:m='urn:nms:subscription' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
<sessiontoken xsi:type='xsd:string'/>
<service xsi:type='xsd:string'>SVC1</service>
<content xsi:type='' SOAP-ENV:encodingStyle='http://xml.apache.org/xml-soap/literalxml'>
<recipient _key="@email" email= "john.doe@adobe.com/>
</content>
</m:Unsubscribe>
</SOAP-ENV:Body>
Resposta:
<?xml version='1.0' encoding='ISO-8859-1'?>
<SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema' xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='http://xml.apache.org/xml-soap' xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
<SOAP-ENV:Body>
<m:UnsubscribeResponse xmlns:m='urn:nms:subscription' SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'>
</m:UnsubscribeResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Esse serviço permite criar e enviar uma ação de delivery.
Os seguintes parâmetros são necessários para chamar o serviço:
Essa API não deve ser chamada em volume, pois pode haver problemas de desempenho.
Descrição do método no seu schema:
<method name="SubmitDelivery" static="true">
<parameters>
<param name="scenarioName" type="string" inout="in" desc="Internal name of the delivery template"/>
<param name="content" type="DOMElement" inout="in" desc="XML content of the delivery template" />
</parameters>
</method>
Um template do delivery deve ser criado a partir do console do cliente Adobe Campaign. Contém os parâmetros comuns a todos os delivery (endereço do remetente ou duração de validade da mensagem).
O documento XML de entrada é um fragmento de template do delivery que obedece à estrutura do schema "nms:delivery". Ele conterá todos os dados adicionais que não puderam ser definidos estaticamente no template do delivery (por exemplo, lista de recipient para público alvo).
Esta chamada não retorna nenhum dado, exceto erros.
Este exemplo é baseado em um template do delivery personalizado de uma fonte externa de dados (um arquivo nesse caso). A configuração está totalmente descrita no template do delivery, portanto, tudo o que ainda precisa ser enviado quando a chamada ocorrer é o conteúdo do arquivo do elemento <externalsource>
.
<delivery>
<targets fromExternalSource="true">
<externalSource>
MsgId|ClientId|Title|Name|FirstName| Mobile|Email| Market_segment|Product_affinity1 |Product_affinity2|Product_affinity3| Product_affinity4| Support_Number|Amount|Threshold1|000001234|M.| Doe|John|0650201020| john.doe@adobe.com
|1| A1|A2|A3|A4|E12|120000|100000
</externalSource>
</target>
</delivery>
Se você não tiver um template do delivery, poderá usar a seguinte amostra:
<delivery>
<targets fromExternalSource="true" targetMode="1" noReconciliation="true" addressField="Email" >
<fileFormat active="true">
<source format="text" type="text">
<dataSourceConfig >
<dataSourceColumn label="Email" name="Email" type="string"/>
</dataSourceConfig>
</source>
<destination type="xtkDataStore"/>
</fileFormat>
<externalSource><![CDATA[not-a-repicipient@domain.com]]></externalSource>
</targets>
</delivery>