Définition d'implémentation pour les cibles et les actions

La définition d'implémentation correspond à un code XML dans une définition de modèle d'élément de campagne. Toutes les cibles et les actions doivent comporter une définition d'implémentation.

Le segment XML de définition d'implémentation définit les informations suivantes pour une cible ou une action :
  • Le nom unique du modèle d'élément de campagne pour la cible ou l'action.
  • La commande de tâche associée à la cible ou à l'action. Pour plus d'informations, voir Commandes de tâche d'élément de campagne.
  • Les paramètres de modèle d'élément de campagne à transmettre à la commande de tâche. Pour plus d'informations, voir Paramètres de modèle d'élément de campagne.
    • Dans le cas d'une cible, les paramètres qui définissent les critères de la cible. Par exemple, une cible peut requérir qu'un client appartienne au segment de clientèle Client privilégié. Si le client répond aux critères de la cible, la commande de tâche renvoie alors la valeur true.
    • Dans le cas d'une action, les paramètres qui définissent l'action, comme envoyer au client un courrier électronique ou afficher un contenu dans un emplacement e-marketing.

Emplacement de stockage des définitions d'implémentation

Format des définitions d'implémentation

Les définitions d'implémentation utilisent le format suivant :


<FlowElementImplementation type="UNIQUE_NAME">
 <Implementation invocationType="TaskCommand">
  <Class name="TASK_COMMAND_CLASS_NAME">
   <Argument name="paramName1" value="MARKETING_paramName1"/>
   <Argument name="paramName2" value="paramValue2"/>
  </Class>
 </Implementation>
</FlowElementImplementation>

Paramètres dans les définitions d'implémentation

Chaque paramètre pouvant être contenu dans une définition d'implémentation, comme illustré dans l'exemple de format précédent, est décrit ci-après :

type
Nom unique du modèle d'élément de campagne pour cette cible ou cette action.
invocationType
Cette valeur est toujours TaskCommand.

Pour l'élément <Class> : Chaque action et chaque cible ont une commande de tâche associée. Cette valeur doit être une classe qui implémente l'interface MarketingCampaignElementTaskCmd.

nom
Nom de la classe de commande de tâche d'élément de campagne pour cet élément de campagne. Dans le cas d'une nouvelle cible ou action, la valeur que vous spécifiez doit correspondre à celle de la commande de tâche personnalisée que vous créez pour prendre en charge le nouvel élément de campagne. Par exemple :
com.your_company_name.marketing.commands.elements.CustomLevelOfSupportTargetTaskCmd

Pour l'élément <Argument> : Le code XML de définition d'implémentation peut comporter zéro ou plusieurs paramètres de modèle d'élément de campagne. Lorsqu'un client accède à une cible ou à un élément d'action dans une activité marketing, les services marketing transmettent les paramètres à l'commande de tâche d'élément de campagne. La commande de tâche extrait les paramètres à l'aide de la méthode getElementParameters, puis les utilise afin d'évaluer la cible ou d'effectuer l'action.

nom
Nom du paramètre devant être transmis pour traitement à la commande de tâche afin que la cible ou l'action puisse effectuer son travail.
valeur
La valeur du paramètre. Si cette valeur provient de l'interface utilisateur, elle doit suivre le format MARKETING_paramName. Si elle provient d'un autre endroit, elle ne requiert alors pas le préfixe MARKETING_.

Exemples

Les fragments de code suivants montrent des exemples de fragments XML pour les définitions d'implémentation :
  • Exemple de fragment XML dans le cas d'une action qui affiche une recommandation de catégorie dans un emplacement e-marketing sur une page de magasin.
    
    <FlowElementImplementation type="Category">
        <Implementation invocationType="TaskCommand">
            <Class name="com.ibm.commerce.marketing.commands.elements.DisplayCategoryActionTaskCmd">
                <Argument name="categoryIdList" value="MARKETING_categoryIdList"/>
            </Class>
        </Implementation>
    </FlowElementImplementation>
  • Exemple de fragment XML dans le cas d'une cible qui vérifie si un client appartient à un segment de clientèle donné :
    
    <FlowElementImplementation type="Customer Segment">
        <Implementation invocationType="TaskCommand">
            <Class name="com.ibm.commerce.marketing.commands.elements.CustomerSegmentTargetTaskCmd">
                <Argument name="segmentIdList" value="MARKETING_segmentIdList"/>
                <Argument name="anyOrAll" value="MARKETING_anyOrAll"/>
                <Argument name="containsOperator" value="MARKETING_containsOperator"/>
            </Class>
        </Implementation>
    </FlowElementImplementation>