Adăugarea conținutului dinamic la mesajele de e-mail

Sfat

Dacă doriți să încercați Dynamics 365 Customer Insights gratuit, vă puteți înscrie pentru o perioadă de încercare de 30 de zile.

Important

Acest articol se aplică numai pentru marketingul orientat spre exterior.

Conținutul dinamic este rezolvat chiar înainte ca un mesaj să fie trimis unei anumite persoane. În mod obișnuit veți utiliza conținutul dinamic pentru a îmbina informații dintr-o înregistrare de persoană de contact a destinatarului (cum ar fi prenumele și numele de familie), pentru a plasa linkuri speciale și pentru a plasa informații și linkuri din setări de conținut. Dacă puteți lucra ușor în cod, puteți, de asemenea, să creați un algoritm particularizat care include declarații condiționale, bucle for-each etc. Puteți să utilizați conținut dinamic oriunde în corpul mesajului și să folosiți câteva tipuri de valori dinamice în câmpurile antetului de mesaj (subiect, adresă expeditor și nume expeditor).

Utilizarea setărilor de conținut pentru configurarea depozitelor de valori standard și obligatorii pentru mesajele de e-mail

Setările de conținut sunt seturi de valori standard și obligatorii care sunt disponibile pentru utilizarea în mesajele de e-mail de marketing. Fiecare include un link către centrul de abonare , un link de redirecționare către un prieten, linkuri către rețelele sociale, adresa poștală și alte informații care pot fi plasate în mesaj ca valori dinamice utilizând caracteristica de personalizare.

Dynamics 365 Customer Insights - Journeys este livrat cu o singură înregistrare implicită de setări de conținut, care este preconfigurată pentru a utiliza centrul de abonare implicit (inclus și predefinit). Puteți particulariza această înregistrare, după caz, și puteți, de asemenea, să creați înregistrări suplimentare. Veți seta fiecare călătorie a clientului să utilizeze un anumit set de setări de conținut, ceea ce înseamnă că toate mesajele transmise de către călătoria respectivă vor utiliza aceeași înregistrare. Cu toate acestea, fiecare călătorie poate utiliza o înregistrare diferită, ceea ce înseamnă că puteți folosi un proiect de e-mail de marketing identic în două sau mai multe călătorii ale clienților, fiecare specificând o înregistrare diferită de setări de conținut. Dacă aveți mai mult de o înregistare de setări de conținut, exact una dintre acestea va fi cea implicită și se va aplica în mod automat pentru fiecare călătorie a clientului pe care o creați.

Valorile pentru setările de conținut sunt evaluate mai întâi la data trimiterii, ceea ce înseamnă că puteți edita un set de setări de conținut în orice moment, iar toate mesajele de e-mail viitoare sau în așteptare vor utiliza în mod automat cele mai recente valori.

Fiecare înregistrare setări de conținut pe care o utilizați trebuie să fie disponibilă pentru serviciile externe de marketing, care gestionează asamblarea și livrarea e-mailului. Prin urmare, trebuie să publicați înregistrările setărilor de conținut alegând Trecere în direct ori de câte ori creați una nouă.

Notă

Dacă aveți alte tipuri de valori pe care le utilizați frecvent în mesajele e-mail, și/sau pe care doriți să le gestionați la nivel de călătorie client, atunci le puteți adăuga sub formă de câmpuri personalizate la entitatea setări de conținut la fel cum puteți pentru alte tipuri de entități în Dynamics 365. Cu toate acestea, în versiunea curentă, toate câmpurile particularizate pentru entitatea setări de conținut trebuie să fie de tip text (șir). Informații suplimentare: Particularizare Customer Insights - Journeys

Pentru a vizualiza, a edita sau a crea o înregistrare de setări de conținut:

  1. Accesați Șabloane>de>marketing de ieșire Setări de conținut.

  2. Se deschide o pagină de listă standard, unde puteți vizualiza, sorta sau filtra lista și puteți căuta în ea pentru a găsi o anumită înregistrare și puteți utiliza butoanele din bara de comenzi pentru a adăuga sau a elimina o înregistrare. Selectați o înregistrare pentru a o deschide pentru editare sau selectați Nou pe bara de comenzi pentru a crea una nouă.

  3. Se deschide formularul Setări de conținut. Dacă editați o înregistrare care este deja live, trebuie să alegeți Editare în bara de comenzi înainte de a o putea edita. Dacă creați unul nou, puteți începe să completați câmpurile.

    Formularul de setări de conținut.

  4. Faceți următoarele setări după caz:

    • Nume: introduceți un nume pentru înregistrarea setărilor clientului. Acesta este numele afișat când atribuiți setările de conținut la o previzualizare a unei călătorii a clientului sau a unui mesaj de e-mail.
    • Proprietar: Afișează Dynamics 365 Customer Insights - Journeys utilizatorul care a creat înregistrarea.
    • Adresa principală: introduceți partea principală a adresei poștale a organizației dvs. Toate mesajele de e-mail de marketing trebuie să includă o adresă principală valabilă provenind dintr-un set de setări de conținut. Selectați butonul pentru Butonul de personalizare. a utiliza personalizarea pentru a introduce o expresie care face referire la un câmp dintr-o înregistrare existentă (cum ar fi un câmp de adresă dintr-o anumită înregistrare de cont).
    • Adresa 2: introduceți informații suplimentare despre adresa poștală (dacă este necesar). Selectați butonul pentru Butonul de personalizare. a utiliza personalizarea pentru a introduce o expresie care face referire la un câmp dintr-o înregistrare existentă (cum ar fi un câmp de adresă dintr-o anumită înregistrare de cont).
    • Implicit: setați la Da pentru ca setările curente de conținut să înregistreze valoarea implicită pentru toate călătoriile clienților noi. Trebuie să existe întotdeauna exact o singură neîndeplinire a obligațiilor; dacă modificați valoarea implicită, valoarea implicită existentă va fi schimbată automat la Nu.
    • Implicit pentru deținerea unei unități de business: Această setare este disponibilă numai atunci când este activată stabilirea domeniului unității de business. Setați această opțiune la Da pentru ca înregistrarea setărilor curente de conținut să fie implicită pentru toate călătoriile clienților noi din unitatea de business. Trebuie să existe întotdeauna exact o setare de conținut implicită pentru domeniul de aplicare al unității de business; dacă modificați valoarea implicită, valoarea implicită existentă va fi schimbată automat la Nu.
    • Adresa URL LinkedIn, adresa URL Twitter, adresa URL, adresa URL Instagram, adresa URL și adresa URL Google Plus: Pentru fiecare dintre aceste servicii de rețele sociale, introduceți adresa URL Facebook YouTube pentru pagina de destinație a organizației dvs.
    • Centru de abonare: Specificați un pagină de marketing existent care este configurat ca centru de abonare. Toate mesajele de e-mail de marketing trebuie să includă un link către un centru de abonare valabil care provine dintr-o înregistrare de setări de conținut. Selectați butonul pentru Butonul de personalizare. a utiliza personalizarea pentru a introduce o expresie care face referire la câmpul URL pagină completă pentru pagina specifică pe care doriți să o utilizați. Expresia rezultată arată cam așa (unde GUID-ul variază în funcție de înregistrarea pe care o alegeți utilizând personalizarea):
      {{msdyncrm_marketingpage(3343053c-8daf-e911-a85e-000d3a3155d5).msdyncrm_full_page_url}}
    • Redirecționați către un prieten: Specificați un pagină de marketing existent care este înregistrat ca pagină de redirecționare către un prieten. Butonul de personalizare.Selectați butonul pentru a alege dintr-o listă de pagini disponibile. Selectați butonul pentru Butonul de personalizare a utiliza personalizarea pentru a introduce o expresie care face referire la câmpul URL pagină completă pentru pagina specifică pe care doriți să o utilizați. Expresia rezultată arată cam așa (unde GUID-ul variază în funcție de înregistrarea pe care o alegeți utilizând personalizarea):
      {{msdyncrm_marketingpage(36458a9e-72af-e911-a859-000d3a3159df).msdyncrm_full_page_url}}
  5. Selectați Salvare în colțul din dreapta jos al ferestrei pentru a salva setările.

  6. Dacă editați o înregistrare cu setări de conținut care era deja live, atunci înregistrarea este republicată automat atunci când o salvați. În cazul în care creați o înregistrare nouă, selectați Trecere în direct pe bara de comenzi pentru a o publica în serviciile de marketing, astfel încât să puteți începe să o utilizați.

Utilizarea personalizării pentru a plasa valori dinamice de câmp

Personalizarea vă ajută să construiți expresii dinamice valide pentru a poziționa valorile câmpurilor din înregistrările persoanelor de contact ale destinatarilor, setările conținutului mesajului și alte valori ale bazei de date. Acest buton este furnizat pe bara de instrumente de formatare de text ori de câte ori selectați un element de text din proiectantul grafic. Butonul este, de asemenea, furnizat pentru unele câmpuri de setări, cum ar fi câmpurile de subiect, de adresă „De la” și de nume „De la”.

Notă

Caseta de dialog de personalizare afișează numai entitățile și relațiile care sunt sincronizate cu serviciul detalii de marketing. Dacă aveți nevoie să afișați informații sau să utilizați relații pentru una sau mai multe entități care nu sunt enumerate, adresați-vă administratorului să adauge entitățile relevante la serviciul Detalii de marketing. Dacă sunteți administrator, consultați Alegerea entităților de sincronizat cu serviciul Detalii de marketing pentru instrucțiuni.

Utilizarea personalizării pentru a plasa o expresie dinamică

Pentru a utiliza personalizarea:

  1. Poziționați cursorul în câmpul sau elementul text în care doriți să inserați textul dinamic, apoi selectați butonul Personalizare Butonul de personalizare. Se deschide dialogul de personalizare.

    Personalizare, pagina 1.

  2. Alegeți una dintre următoarele variante:

    • Selectați Conținut dinamic pentru a plasa o valoare care se poate modifica în funcție de contextul în care utilizați mesajul, apoi alegeți una dintre următoarele din lista verticală de aici:
      • Persoană de contact: Plasează o valoare de câmp, cum ar fi un prenume, din înregistrarea persoanei de contact a destinatarului. Aceste valori variază în funcție de destinatar.
      • ContentSettings: Plasează o valoare de câmp din setările de conținut. Aici sunt disponibile valori precum adresa URL a unui centru de abonare, adresa URL de redirecționare și adresa poștală a expeditorului. Aceste valori pot să difere în funcție de călătoria clientului unde este folosit mesajul.
      • FormDoiSubmission: Plasează un câmp dinamic pentru formularul dublu opt-in. Acest câmp nu necesită o valoare a relației, așa cum se discută mai jos.
      • Mesaj: Plasează valori care se referă la mesajul în sine; în prezent, aceasta include adresa URL deschisă ca pagină web și diferitele valori dinamice utilizate în e-mailurile cu înscriere dublă.
    • Selectați Conținut static pentru a plasa o valoare fixă dintr-o anumită înregistrare (cum ar fi numele unui eveniment viitor). Această valoare este aceeași, indiferent unde folosiți mesajul sau cine îl primește. Apoi efectuați următoarele setări pentru a identifica entitatea și înregistrarea care conține valoarea de care aveți nevoie:
      • Selectați o opțiune (caseta combo de sus): Selectați entitatea (cum ar fi evenimentul sau contul). Pentru a căuta o entitate, plasați cursorul în această casetă și începeți să tastați numele său până când este afișată entitatea pe care o doriți.
      • Alegeți o înregistrare (lista verticală de jos): Selectați înregistrarea specifică după nume. Această listă afișează toate înregistrările din entitatea selectată. La fel ca în cazul entității, puteți căuta aici.
  3. Acum trebuie să identificați câmpul specific pe care doriți să îl plasați. Alegeți una dintre următoarele variante:

    • Selectați Entitate corelată pentru a găsi un câmp dintr-o entitate care este corelat cu cel pe care l-ați ales pe pagina anterioară. Apoi efectuați următoarele setări pentru a identifica relația și câmpul pe care doriți să îl afișați:
      • Selectați relația: Relația definește a doua entitate la care doriți să săriți și calea pe care o veți urma pentru a ajunge acolo. Pentru a căuta o relație, plasați cursorul în această casetă și începeți să tastați numele său până când este afișată relația pe care o doriți iar apoi selectați-o. Pentru mai multe informații despre cum să înțelegeți modul în care sunt reprezentate relațiile aici, consultați secțiunea următoare.
      • Selectați câmpul: Alegeți numele câmpului pe care doriți să îl afișați. La fel ca în cazul relației, puteți căuta aici. Această listă verticală este disponibilă numai dacă ați ales o relație N:1.
  4. În partea de jos a casetei de dialog, vedeți acum expresia finală. Selectați Inserare pentru a plasa expresia respectivă.

    Personalizare, pagina 2.

Important

Listele create utilizând buclele for-each nu sunt redate într-o anumită ordine și nu pot fi sortabile după niciun câmp.

Modul în care personalizarea prezintă relațiile dintre bazele de date

Când selectați o relație în personalizare, opțiunile sunt afișate utilizând una dintre următoarele convenții de denumire:

  • FieldName (PrimaryEntity) -> SecondaryEntity
    Atunci când entitatea principală este între paranteze și afișează un nume de câmp, este o relație multi-la-unu (N:1) care duce la o singură înregistrare de la entitatea secundară. Prin urmare, ar trebui să utilizați, de obicei, a doua listă derulantă pentru a alege un câmp de la entitatea secundară pentru a afișa cu expresia dvs.
  • PrimaryEntity -> FieldName (SecondaryEntity)
    Atunci când entitatea secundară este între paranteze și afișează un nume de câmp, este o relație unu-la-mai-mulți (1:N) care poate duce la mai multe înregistrări de la entitatea secundară. Prin urmare, nu puteți alege un câmp (a doua listă verticală este dezactivată) și trebuie să utilizați în schimb această relație ca parte a unei bucle pentru/fiecare buclă pentru a afișa valori din fiecare înregistrare corelată disponibilă.
  • PrimaryEntity -> SecondaryEntity
    Când niciuna dintre entități nu este între paranteze, este o relație mai-mulți-la-mai-mulți (N:N), care poate conecta mai multe înregistrări în ambele direcții. Prin urmare, nu puteți alege un câmp (a doua listă verticală este dezactivată) și nu puteți utiliza această relație pentru personalizare. Acest lucru se datorează faptului că relația este menținută de o entitate intermediară și aveți posibilitatea să treceți numai la entitatea intermediară din entitatea principală.

Unde:

  • PrimaryEntity este o entitate aflată la începutul relației. Este întotdeauna afișat în partea stângă a săgeții. Aceasta este entitatea pe care ați ales-o pe pagina anterioară a dialogului de personalizare. De exemplu, o persoană de contact (entitate principală) poate fi legată de un cont (entitate secundară) prin câmpul Nume firmă al persoanei de contact (nume câmp); acesta ar fi afișat ca: Nume firmă (persoană de contact ) -> Cont.
  • Numecâmp este afișat întotdeauna lângă un nume de entitate (care este în paranteză). Acesta este numele câmpului prin care se stabilește relația. Câmpul numit aparține entității din paranteză și afișează o valoare de la entitatea de cealaltă parte a săgeții (dar conține de fapt ID-ul înregistrării aferente din care este extrasă valoarea). În unele cazuri veți observa o relație dintre aceleași două entități, fiecare dintre ele trecând printr-un câmp diferit.
  • SecondaryEntity este destinația relației. Este întotdeauna afișat în partea dreaptă a săgeții. Valoarea/valorile pe care le afișați cu expresia finală vor proveni dintr-un câmp aparținând entității secundare.

Notă

Pentru relațiile N:N, nu este afișată nicio valoare a câmpului. Aceasta înseamnă că, dacă aveți mai mult de o relație N:N între aceleași două entități, veți vedea mai multe relații identice în lista derulantă. Această situație este foarte rară, dar dacă o vedeți, va trebui să folosiți medota încercare-și-eroare pentru a identifica relația corectă de utilizat. Pentru a confirma, puteți verifica expresia rezultată pentru a vedea dacă pare că ați ales relația corectă (relațiile sunt afișate diferit aici și pot oferi un indiciu) sau puteți configura un mesaj de test care include ambele versiuni ale relației N: N și utilizați un test călătoria clientului pentru a vi-l livra.

Iată câteva avantaje exemple:

  • Nume firmă (persoană de contact) -> Cont: Această relație este utilizată de entitatea Persoană de contact pentru a afișa informații de la entitatea Cont în câmpul Nume firmă al înregistrării unei persoane decontact . Cu alte cuvinte, acesta îl leagă de compania (contul) pentru care lucrează persoana de contact.
  • Managing Partner (Contact) -> Cont: Această relație este utilizată de entitatea Persoană de contact pentru a afișa informații de la entitatea Cont în câmpul Managing Partner al înregistrării unei persoane decontact . Cu alte cuvinte, aceasta leagă la compania (contul) care este partenerul de gestionare pentru o persoană de contact.
  • Persoană de contact -> Persoană de contact principală (Cont): Această relație este utilizată de entitatea Cont pentru a afișa informații de la entitatea Persoană de contact în câmpul Persoană de contactprincipală a unei înregistrări de cont. Cu alte cuvinte, acesta găsește toate conturile în care contactul curent este atribuit drept contact principal.
  • Contact -> Contact (Înregistrare eveniment): Această relație este utilizată de entitatea Înregistrare eveniment pentru a afișa informații de la entitatea Persoană decontact în câmpul Contact al înregistrării unui eveniment. Cu alte cuvinte, acesta găsește toate înregistrările evenimentului realizate de (sau pentru) contactul curent.

Expresii create prin personalizare

Personalizarea creează o expresie care utilizează un format, cum ar fi următorul:

  • {{EntityName.FieldName}}
  • {{EntityName(RecordID).FieldName}}
  • {{EntityName.RelationshipName.FieldName}}
  • {{EntityName(RecordID).RelationshipName.FieldName}}

Rețineți că notația utilizată pentru numele relațiilor în expresiile rezultate nu se potrivește cu modul în care sunt reprezentate în dialogul de personalizare. Iată unele exemple de expresii rezultate:

  • {{contact.firstname}}
    Plasează prenumele destinatarului.
  • {{msdyncrm_marketingpage(3343053c-8daf-e911-a85e-000d3a3155d5).msdyncrm_full_page_url}}
    Plasează valoarea câmpului msdyncrm_full_page_url din înregistrarea pagină de marketing specificată de GUID în paranteză. De obicei, este posibil să utilizați o expresie a acestui formular într-o înregistrare de setări de conținut pentru a specifica un centru de abonare sau o pagină de redirecționare către un prieten.
  • {{msdyncrm_contentsettings.msdyncrm_subscriptioncenter}}
    Plasează URL-ul pentru pagina centrului de abonare identificat în setările de conținut configurate pentru călătoria clientului care trimite mesajul.
  • {{msdyncrm_contentsettings.msdyncrm_forwardtoafriend}}
    Plasează adresa URL către pagina de redirecționare identificată în setările de conținut configurate pentru călătoria clientului care trimite mesajul.
  • {{Message.ViewAsWebpageURL}}
    Plasează URL-ul pentru deschiderea mesajului curent într-un browser web.
  • {{msevtmgt_event(8a519395-856c-4e22-b560-650ce6d6a79d).msevtmgt_webinarurl}}
    Plasează URL-ul webinarului pentru evenimentul identificat de ID-ul evenimentului specificat (între paranteze).
  • {{msdyn_survey(39128da2-c968-4627-9595-f030b6571be4).msdyn_name}}
    Plasează numele chestionarului identificat de ID-ul chestionarului specificat (între paranteze).
  • {{contact.contact_account_parentcustomerid.name}}
    Această expresie găsește numele contului pentru compania unde lucrează o persoană de contact.
  • {{contact.contact_account_msa_managingpartnerid.name}}
    Această expresie găsește numele partenerului de gestionare pentru contul corespunzător companiei unde lucrează o persoană de contact.

Odață ce aveți o expresie care funcționează, o puteți copia și lipi oriunde. Nu trebuie să utilizați personalizarea de fiecare dată.

Important

Puteți avea, cel mult, două salturi (perioade) în expresiile dvs. de câmp. Nu încercați să creați expresii mai complexe adăugând mai multe salturi expresiilor produse cu personalizare.

Sfat

Dacă aveți nevoie de tipurile de date care sunt acceptate de personalizare, atunci este de obicei mai bine să utilizați caracteristica de personalizare pentru a plasa codul, mai degrabă decât să încercați să îl tastați de la zero. Astfel vă asigurați că numele entității, relației și câmpului corespund celor utilizate în baza de date și puteți evita erorile de ortografie.

Notă

Dynamics 365 Customer Insights - Journeys Funcționalitatea de trimitere a e-mailurilor nu acceptă câmpuri calculate.

Valorile dinamice din câmpurile Către, numele De la, adresa De la și Răspuns către

În fila Rezumat a formularului e-mail de marketing , puteți efectua diverse setări care nu au legătură cu conținutul mesajului în secțiunea Expeditor și destinatar . Aceasta include valori și expresii pentru stabilirea valorilor Către, numele De la, adresa De la și Răspuns către pe care le va utiliza mesajul.

Setări expeditor și destinatar pentru mesajele de e-mail.

O modalitate tipică de a profita de această caracteristică este să setați numele De la și Adresa De la la proprietarul înregistrării persoanei de contact. Apoi, prin atribuirea proprietarului fiecărei înregistrări de contact agentului de vânzări care gestionează acel contact, destinatarii vor primi e-mailuri de marketing care să arate o adresă de la cineva cunoscut, ceea ce poate crește considerabil gradul de deschidere. Iată cum:

  1. Dacă instanța dvs Customer Insights - Journeys . nu este deja configurată să sincronizeze entitatea Utilizator (systemuser) cu serviciul Detalii de marketing, discutați cu administratorul despre configurarea acesteia. Dacă sunteți administratorul, consultați Alegerea entităților de sincronizat cu serviciul Statistici de marketing pentru instrucțiuni.
  2. Deschideți mesajul de e-mail și accesați fila Rezumat .
  3. Ștergeți conținutul câmpului De la nume, apoi selectați butonul Personalizare de lângă acest Butonul de personalizarecâmp.
  4. Pe prima pagină a dialogului de personalizare, selectați Contextual și setați-l la Persoană de contact. Apoi selectați Următorul.
  5. Pe a doua pagină a dialogului de personalizare, selectați Entitate asociată , apoi:
    • Setați lista derulantă de sus (relație) la utilizator proprietar (Contact) -> Utilizator.
    • Setați lista verticală de jos (câmp) la Numele complet.
  6. Selectați OK pentru a plasa expresia, care ar trebui să fie: {{contact.contact_systemuser_owninguser.fullname}}.
  7. Ștergeți conținutul câmpului Din adresă , apoi selectați butonul Personalizare Butonul de personalizarede lângă acest câmp.
  8. Pe prima pagină a dialogului de personalizare, selectați Contextual și setați-l la Persoană de contact. Apoi selectați Următorul.
  9. Pe a doua pagină a dialogului de personalizare, selectați Entitate asociată , apoi:
    • Setați lista derulantă de sus (relație) la utilizator proprietar (Contact) -> Utilizator.
    • Setați lista verticală de jos (câmp) la E-mail principal.
  10. Selectați OK pentru a plasa expresia, care ar trebui să fie: {{contact.contact_systemuser_owninguser.internalemailaddress}}.

Puteți utiliza tehnici similare pentru a plasa numele sau adresa de e-mail a utilizatorului oriunde în conținutul mesajului. Puteți face acest lucru folosind personalizarea sau puteți copia / lipi expresiile ghidonului sau chiar puteți tasta manual expresiile ghidonului.

Puteți utiliza o expresie dinamică pentru a defini adresa URL sursă pentru elementele de imagine. Pentru a face acest lucru, selectați elementul imagine, accesați panoul Proprietăți și apoi selectați butonul Personalizare Butonul de personalizarede lângă câmpul Sursă pentru a plasa text dinamic ca parte a adresei URL. De obicei veți amesteca acesta cu text static ca să semene cu un URL complet. De exemplu, ați putea include ID-ul persoanei de contact sau numele firmei destinatarului pentru a selecta o imagine care este relevantă pentru fiecare destinatar individual.

De asemenea, puteți utiliza personalizarea pentru a ajuta la construirea unei expresii dinamice pentru setarea unei destinații Link pentru imagine.

Notă

Biblioteca Dynamics 365 Customer Insights - Journeys de fișiere generează o cale de fișier unică bazată pe GUID pentru fiecare imagine pe care o încărcați, ceea ce înseamnă că imaginile din biblioteca de fișiere au adrese URL imprevizibile care nu includ numele fișierului original. Ca urmare, pentru a utiliza tehnica descrisă aici, trebuie să vă găzduiți imaginile pe propriul site web sau orice serviciu de găzduire terță parte unde adresele URL sunt previzibile și pot include o valoare pe care o puteți extrage cu ușurință dintr-un câmp Dynamics 365.

Găsirea ID-urilor înregistrărilor

Expresiile de câmp non-contextuale (care utilizează formularul {{EntityName(RecordID).FieldName}}) necesită un ID de înregistrare pentru a identifica înregistrarea specifică din care trebuie să provină valoarea. De obicei, personalizarea vă ajută să găsiți aceste ID-uri, dar uneori poate fi necesar să găsiți manual un ID în timp ce proiectați caracteristici dinamice pentru un mesaj. Pentru a găsi ID-ul oricărei înregistrări:

  1. Deschideți înregistrarea la care doriți să vă referiți.
  2. Priviți URL-ul afișat în bara de adrese a browserului dvs., care ar trebui să afișeze un URL precum:
    https://<MyOrg>.crm.dynamics.com/main.aspx?appid=c8cba597-4754-e811-a859-000d3a1be1a3&pagetype=entityrecord&etn=msevtmgt_event&id=5acc43d5-356e-e811-a960-000d3a1cae35
  3. Găsiți partea din URL care începe cu &id=, care este urmată de numărul de identificare al înregistrării curente. Copiați numărul (doar valoarea) și utilizați-l în expresia dvs.

Conținut dinamic complex

Puteți să adăugați procesarea logică complexă la designurile dvs. de e-mail, ceea ce poate face conținutul și mai receptiv la destinatari, date demografice și context. Acest tip de particularizare necesită să aveți o înțelegere de bază privind scriptarea și programarea.

După cum ați văzut în exemplele anterioare, conținutul dinamic este înconjurat de acolade duble ( {{ și }} ). Aceasta include atât valorile de câmp standard pe care le adăugați utilizând caracteristica de personalizare , cât și construcțiile de programare mai complexe descrise în această secțiune.

Sfat

Dacă doriți să afișați acolade duble într-un mesaj, în loc să le utilizați pentru a indica începutul sau sfârșitul unui bloc de cod, atunci fixați (scăpați) prima acoladă cu o bară oblică inversă, cum \{{ ar fi sau \}}. Barele oblice nu vor apărea în mesajul dvs. redat final, spre deosebire de acoladele duble.

Declarații condiționale și comparații

Declarațiile condiționale (if-then-else) afișează conținut în funcție de rezolvarea la Adevărat sau Fals a uneia sau mai multor expresii condiționale. Puteți adăuga codul necesar pentru a crea aceste declarații, plasându-l într-un element de text, sau prin introducerea de elemente de cod personalizat între alte elemente de design. Informații suplimentare: Cum se introduce conținut dinamic complex în proiectant

Declarațiile condiționale au următoarea formă:

{{#if (<operator> <value1> <value2>)}}
   Content displayed when the expression is true
{{else if (<operator> <value1> <value2>)}}
   Content displayed when the first expression is false and the second one is true
.
.
.
{{else}}
   Content displayed when all expressions are false
{{/if}}

Unde:

  • Blocul condițional trebuie să se deschidă întotdeauna cu {{#if … }}.
  • Expresiile condiționale trebuie incluse între paranteze.
  • Expresiile condiționale încep cu un <operator>, care trebuie să fie una dintre valorile listate în tabelul următor. Acesta determină modul în care prima valoare trebuie comparată cu a doua valoare.
  • <value1> și value2 <sunt valori care trebuie comparate prin expresia condițională și> fiecare poate fi valori dinamice sau constante. Dacă valoare1 <> sau valoare2 <este o valoare constantă a șirului (nu un număr sau> o expresie), atunci trebuie să fie înconjurată de ghilimele simple ('); pentru numere reale, utilizați un punct (.) ca delimitare zecimală.
  • Dacă <value1> este un câmp boolean (cunoscut și ca un câmp cu două opțiuni în Dynamics 365), atunci nu includeți un <operator>, < valoare2> sau paranteze. Câmpurile booleene au întotdeauna o valoare fie adevărată, fie falsă, deci ar trebui să le utilizați direct pentru a stabili starea, cum ar fi: {{#if contact.is_vip}}
  • {{else}} iar {{else if … }} clauzele sunt opționale.
  • Blocul condițional trebuie să se închidă întotdeauna cu {{/if}}.

Tabelul următor prezintă toți operatorii pe care îi puteți utiliza în expresiile condiționale. Alți operatori nu sunt disponibili momentan și nici nu puteți utiliza expresii booleene complexe (cum ar fi cu operatorii AND sau OR) în expresiile condiționale.

Dynamics 365 Customer Insights - Journeys sintaxă (sensibilă la litere mari și mici) Operator
eq Egal cu
ne Nu este egal cu
lt Mai mic decât
gt Mai mare decât
lte Mai mic sau egal cu
gte Mai mare sau egal cu

De exemplu, această declarație condițională poate fi utilizată pentru stabilirea limbii utilizate în formula de salut a unui mesaj, în funcție de țara fiecărui destinatar al mesajului:

<p>{{#if (eq contact.address1_country 'Denmark')}}
    Hej
{{else if (eq contact.address1_country 'US')}}
    Hi
{{/if}} {{contact.firstname}}!</p>

Iată un exemplu de instrucțiune condițională bazată pe un câmp boolean (două opțiuni) numit; is_vip rețineți că, deoarece câmpurile booleene returnează întotdeauna o valoare adevărată sau falsă, niciun operator, nicio valoare de comparație sau paranteze nu sunt incluse în condiție:

<!-- {{#if contact.is_vip}} -->
    <h3>Be sure to show your VIP card to receive a 20% discount!</h3>
<!-- {{/if}} -->

Sfat

Puteți testa dacă există valori de câmp goale utilizând:

{{#if (eq contact.lastname '')}}

Unde '' sunt două ghilimele simple, nu ghilimele duble. Aceasta găsește câmpurile goale, și nu câmpurile nule.

Sfat

Deși nu puteți utiliza expresii booleene complexe în expresiile dvs. condiționale, puteți implementa funcționalități similare astfel:

Neacceptat:

{{#if A and B}}<DisplayedContent>{{/if}

Este echivalent cu (acceptat):

{{#if A}}{{#if B}}<DisplayedContent>{{/if}}{{/if}}

 
Neacceptat:

{{#if A or B}}<DisplayedContent>{{/if}

Este echivalent cu (acceptat):

{{#if A}}<DisplayedContent>{{/if}} {{#if B}}<DisplayedContent>{{/if}}

Sfat

Atunci când testați pentru valorile care sunt stocate ca un set de opțiuni în baza de date, utilizați valorile index pentru setul de opțiuni, nu valorile de afișare. De exemplu, este posibil să aveți un câmp apelat contact.customertypecode, care conține un număr întreg pentru a identifica tipul de client care este. Fiecare cod de tip client are de asemenea un nume afișat, astfel încât 0 = „cupru”, 1 = „argint” și 2 = „aur”. În acest caz, trebuie să configurați expresia pentru a utiliza respectivul index (întreg), nu valoarea afișată corespondentă. Prin urmare, dacă sunteți în căutarea de clienții aur, trebuie să utilizați:

{{#if (eq contact.customertypecode 2)}}

Sfat

Când testați valori numerice mari, cum ar fi "1.932.333", nu introduceți separatorul de mii (,) în declarația de comparație, chiar dacă deseori le puteți vedea prezentate în UI. Pentru a testa pentru această valoare, expresia ar trebui să arate ceva de genul:

{{#if (eq contact.customernumber 1932333)}}

Bucle for-each

Buclele for-each vă permit să parcurgeți o colecție de înregistrări asociate unei anumite înregistrări curente—de exemplu, pentru a furniza lista tuturor tranzacțiilor recente asociate cu o anumită persoană de contact. Puteți adăuga codul necesar pentru a crea aceste declarații, plasându-l într-un element de text, sau prin introducerea de elemente de cod personalizat între alte elemente de design. Informații suplimentare: Cum se introduce conținut dinamic complex în proiectant

Buclele for-each au următoarea formă:

{{#each Entity.RelationshipName }}
   ...
   {{this.RelatedField1}}
   ...
   {{this.RelatedField2}}
   ...
{{/each}}

Unde:

  • Blocul buclă trebuie să se deschidă întotdeauna cu {{#each … }}.
  • Entity.RelationshipName Identifică setul de înregistrări asociate pe care bucla le va repeta.
  • Bucla începe cu prima înregistrare asociată disponibilă și se repetă pentru fiecare înregistrare asociată disponibilă până când sunt listate toate înregistrările asociate. Rețineți că înregistrările asociate vor fi returnate într-o ordine arbitrară și imprevizibilă.
  • {{this.RelatedField<n>}} Identifică un nume de câmp din înregistrarea corelată. Partea „this” a acestei expresii se referă la înregistrarea asociată în curs de procesare în iterația curentă a buclei și trebuie urmată de un nume de câmp valid pentru entitatea asociată. Puteți include orice număr de câmpuri în fiecare buclă.
  • Blocul buclei trebuie să se închidă {{/each}} întotdeauna.

De exemplu, baza dvs. de date poate include o listă de produse comandate de o persoană de contact. Le puteți lista într-un mesaj de e-mail folosind un cod precum:

<p>You have purchased:</p>
<ul>
<!-- {{#each contact.contact_product_productid}} -->
<li>{{this.name}}</li>
<!-- {{/each}} -->
</ul>

În acest exemplu, sistemul a fost particularizat pentru a include o entitate particularizată numită produs, Dynamics 365 Customer Insights - Journeys care este configurată cu o relație 1:N între entitățile decontact și entitățile de produs din câmpul productid . Pentru ca entitatea produsului să fie disponibilă pentru mesajele dvs. de e-mail, aceasta trebuie sincronizată și cu serviciul Detalii de marketing (ca de obicei).

Important

Doar primele 1.000 de elemente asociate sunt adăugate la relație în scopuri de redare a e-mailului. Utilizarea relațiilor cu mai mult de 1.000 de elemente nu este acceptată în șabloanele de e-mail și poate duce la rezultate neașteptate.

De asemenea, rețineți că relațiile de nivel secundar nu sunt acceptate. De aceea, următoarea sintaxă nu este permisă:

{{#each Entity.RelationshipOnEntity}} 
    ... 
    {{#each this.RelationshipOnRelatedEntity}}
        ...
    {{/each}}
    ... 
{{/each}}

Introducerea de conținut dinamic complex în proiectant

Trebuie să fiți atent atunci când introduceți cod dinamic complex în proiectant, deoarece există multe căi, uneori neașteptate, de a-l introduce greșit, ceea ce vă va afecta codul. Iată câteva sfaturi pentru introducerea și testarea codului:

  • Utilizați elemente de cod particularizat pentru a plasa fragmente de cod între elementele de proiectare de pe fila Proiectant . Acest lucru este mult mai vizibil și mai fiabil decât plasarea codului direct în HTML folosind fila HTML . Cu toate acestea, puteți utiliza, de asemenea, cod dinamic într-un element text, caz în care va trebui probabil să curățați codul respectiv în fila HTML , așa cum se menționează mai târziu în această listă. (Când lucrați în editorul depagini complete, selectați un element de cod particularizat pentru a-i edita conținutul.)
    Elementul de cod personalizat.
  • Când introduceți cod într-un element text din fila Proiectant , orice spații suplimentare și returnări de transport pe care le adăugați vor crea &nbsp;etichete în <p> codul dvs., ceea ce îl poate întrerupe. Accesați întotdeauna fila HTML după aceea, unde veți vedea toate aceste etichete suplimentare și asigurați-vă că le eliminați.
  • Când introduceți cod într-un element text, tot codul cu conținut dinamic trebuie să fie conținut fie într-un set de etichete de început și de sfârșit (cum <p> ar fi și </p>), fie într-un comentariu HTML (pentru un cod complet separat de textul afișat). Nu plasați cod în afara comentariilor sau a perechilor de etichete HTML valide (sau a elementelor de cod personalizat), deoarece acest lucru va deruta editorul (mai ales dacă comutați între filele HTML și Design ). Trebuie să lucrați la fila HTML, să inspectați și să corectați codul HTML din elementele textului.
  • Nu plasați retururile de transport între elementele de cod care fac parte din aceeași expresie (cum ar fi într-o buclă pentru fiecare buclă) decât dacă încadrați fiecare linie în propriul set de etichete HTML (așa cum este ilustrat în exemplul pentru fiecare buclă dat după această listă).
  • Caracteristica de personalizare este adesea utilă pentru construirea expresiilor care preiau valori din baza de date, deoarece vă ajută să găsiți nume de tabele, câmpuri și relații ale bazei de date. Acest instrument este disponibil atunci când lucrați într-un element text din fila Proiectant , iar atunci când introduceți valori sunt anumite câmpuri care îl acceptă (cum ar fi subiectul e-mailului). Personalizarea nu este disponibilă atunci când lucrați pe fila HTML sau într-un element de cod particularizat, astfel încât să puteți începe prin a utiliza personalizarea în orice element text, apoi să tăiați/lipiți expresia rezultată în elementul de cod particularizat sau în HTML .
  • Numele relației pe care o utilizați când creați bucle sau plasați valori de căutare trebuie să corespundă celui utilizat în cadrul serviciilor Detalii de marketing. Acest nume de relație nu este neapărat același cu cel utilizat pentru a particulariza Dynamics 365. Pentru a găsi numele corect al relației, utilizați caracteristica de personalizare .

De exemplu, puteți configura linia de salut a unui mesaj de e-mail introducând următoarele pe fila HTML a proiectantului (fie în interiorul, fie în afara unui element text):

<p>{{#if (eq contact.address1_country 'Denmark')}}Hej{{else if (eq contact.address1_country 'US')}}Hi{{/if}}{{contact.firstname}}!</p>

Următorul exemplu (prezentat și anterior) arată cum se utilizează comentariile pentru a include codul care există în întregime în afara conținutului afișat (și în fila HTML ):

<p>You have purchased:</p>
<ul>
<!-- {{#each contact.contact_product_productid}} -->
<li>{{this.name}}</li>
<!-- {{/each}} -->
</ul>