API de campagne FFDA spécifiques gs-new-api
Dans le contexte d’un déploiement Grands comptes (FFDA), Campaign v8 est fourni avec deux nouvelles API pour gérer les données entre la base de données locale Campaign et la base de données cloud. Les conditions préalables à leur utilisation sont l'activation du mécanisme d'évaluation sur le schéma. En savoir plus
-
API d'ingestion : xtk.session.ingest
Cette API est dédiée uniquement à l'insertion de données. En savoir plus
-
API de mise à jour/suppression des données : xtk.session.ingestExt
Cette API est utilisée pour mettre à jour ou supprimer des données. En savoir plus
Un workflow intégré dédié synchronise les données dans la base de données cloud.
Insérer les données data-insert-api
L'API xtk.session.ingest est réservée à l'insertion de données uniquement. Aucune mise à jour/suppression.
Insertion sans réconciliation insert-no-reconciliation
Dans un workflow
Utilisez le code suivant dans une activité Code JavaScript pour insérer des données dans la base de données Cloud sans réconciliation :
var xmlStagingSampleTable = <sampleTableStg
testcol1="testValue1"
testcol2="testValue2"
xtkschema="dem:sampleTableStg">
</sampleTableStg>;
strUuid = xtk.session.Ingest(xmlStagingSampleTable);
logInfo(strUuid);
Une fois le workflow exécuté, la table d'évaluation est alimentée comme prévu.
À partir d'un appel SOAP
-
Obtenez le jeton d'authentification.
-
Déclenchez l'API. La payload est la suivante :
code language-none <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> -
UUID est renvoyé à la réponse SOAP :
code language-none <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>
Par conséquent, le tableau d'évaluation est alimenté comme prévu.
Insertion avec réconciliation
Dans un workflow
Utilisez le code suivant dans une activité Code JavaScript pour insérer des données dans la base de données Cloud avec réconciliation :
var xmlStagingSampleTable = <sampleTableStg _key="@id" id="ABC12345"
testcol1="testValue1"
testcol2="testValue2"
xtkschema="dem:sampleTableStg">
</sampleTableStg>;
strUuid = xtk.session.Ingest(xmlStagingSampleTable);
logInfo(strUuid);
Une fois le workflow exécuté, la table d'évaluation est alimentée comme prévu.
À partir d'un appel SOAP
-
Obtenez le jeton d'authentification.
-
Déclenchez l'API. La payload est la suivante :
code language-none <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> -
Dans ce cas, l'UUID n'est pas renvoyé à la réponse, car il a été fourni dans la payload. La réponse est :
code language-none <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>
Par conséquent, le tableau d'évaluation est alimenté comme prévu.
Mise à jour ou suppression de données data-update-api
L'API xtk.session.IngestExt est optimisée pour la mise à jour/suppression des données. Pour insérer uniquement, préférez xtk.session.ingest. L'insertion fonctionne si la clé d'enregistrement ne se trouve pas dans la table d'évaluation.
Insertion/mise à jour
Dans un workflow
Utilisez le code suivant dans une activité Code JavaScript pour mettre à jour les données de la base de données Cloud :
var xmlStagingRecipient = <sampleTableStg _key="@id" id="ABC12345"
testcol1="testValue A (updated)"
testcol2="testValue B (updated)"
xtkschema="dem:sampleTableStg">
</sampleTableStg>;
xtk.session.IngestExt(xmlStagingRecipient);
Une fois le workflow exécuté, la table d'évaluation est mise à jour comme prévu.
À partir d'un appel SOAP
-
Obtenez le jeton d'authentification.
-
Déclenchez l'API. La payload est la suivante :
code language-none <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> -
La réponse SOAP est la suivante :
code language-none <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>
Par conséquent, le tableau d'évaluation est mis à jour comme prévu.
Gestion des abonnements sub-apis
La gestion des abonnements dans Campaign est décrite dans cette page.
L'insertion des données d'abonnement et de désabonnement repose sur le mécanisme d'évaluation de la base de données locale de Campaign. Les informations sur les abonnés sont temporaires et stockées dans des tables intermédiaires de la base de données locale. Le workflow de synchronisation envoie ces données de la base locale vers la base de données Cloud. Par conséquent, les processus d'abonnement et de désabonnement sont asynchrones. Les demandes d'opt-in et d'opt-out sont traitées toutes les heures par le biais d'un workflow technique spécifique. En savoir plus
Rubriques connexes