Personyze Wiki Personyze Wiki docs
Nederlands
Open Personyze
Docs/ CRM & Marketing/ Oracle Eloqua-integratie: contactgegevens erin, leads en doelgroepen eruit
CRM & Marketing

Oracle Eloqua-integratie: contactgegevens erin, leads en doelgroepen eruit

Personaliseer uw website met Eloqua-contactgegevens en stuur formulierleads en gebruikerslijsten uit Personyze naar Eloqua.

4 min read Updated 2 hours ago

Koppel Personyze aan Oracle Eloqua om uw website te personaliseren met uw Eloqua-contactgegevens, en om leads en doelgroepen uit Personyze terug te sturen naar Eloqua.

In beide richtingen Eloqua-contactvelden — bedrijf, functie, branche, leadscore — komen op uw bezoekers terecht voor targeting en content. Formulierleads en gebruikerslijsten uit Personyze gaan naar Eloqua-contacten en gedeelde lijsten.

Wat er wordt gesynchroniseerd, in elke richting

Van Eloqua naar Personyze

  • Komt er een bezoeker op uw site die Personyze aan zijn e-mailadres kan herkennen, dan zoekt Personyze zijn Eloqua-contact op. Bezoekers worden herkend aan een formulier dat ze invulden, een login of een e-mailparameter in een link.
  • U kiest welke contactvelden op de bezoeker komen: standaardvelden zoals e-mail, voor- en achternaam, bedrijf, functie, land, stad en branche, of elk aangepast veld, ook een leadscore of rating.
  • Die velden worden bezoekerskenmerken. Target campagnes erop in de targetingregels, bekijk ze op het profiel van de bezoeker en toon ze in content — “Welkom terug, {first name} van {company}” — als dynamische variabelen.

Van Personyze naar Eloqua

  • Formulierleads. Een Lead Capture Form van Personyze kan elke inzending naar Eloqua sturen. Personyze maakt het contact aan, of werkt het bij als het al bestaat, op basis van het e-mailadres. Het vult naam, bedrijf, functie, telefoon en land in, plus elk formulierveld dat naar een van uw Eloqua-velden is genoemd, en kan het contact ook aan een gedeelde lijst toevoegen.
  • Gebruikerslijsten. Voeg de mensen uit een gebruikerslijst van Personyze (een doelgroep) toe aan een gedeelde lijst in Eloqua. Contacten die Eloqua nog niet heeft, worden aangemaakt. Er wordt niemand uit de Eloqua-lijst verwijderd.

Voordat u begint: een API-gebruiker in Eloqua

Gebruik een aparte Eloqua-gebruiker voor Personyze, niet iemands eigen login. Zo blijft het werken als iemand vertrekt of zijn wachtwoord wijzigt.

  1. Ga in Eloqua naar Settings → Users en maak een gebruiker aan, bijvoorbeeld personyze.api.
  2. Voeg die toe aan deze beveiligingsgroepen:
    • API Users, met de machtiging Consume API. Zonder die machtiging kan de API helemaal niet worden gebruikt.
    • Advanced Users – Marketing.

    Of gebruik een eigen groep met Consume API en lees- en schrijfrechten op contacten en gedeelde lijsten.

  3. Noteer drie dingen: uw bedrijfsnaam (de “Company” die u op de loginpagina van Eloqua boven uw gebruikersnaam intypt), de gebruikersnaam en het wachtwoord. Bewaar het wachtwoord veilig.

Instellen

  1. Ga in Personyze naar Instellingen → Integraties → Oracle Eloqua.
  2. Vul de Bedrijfsnaam, de Gebruikersnaam en het Wachtwoord in en klik op Verbinden. Personyze controleert ze bij Eloqua voordat ze worden opgeslagen; daarna wordt het wachtwoord nooit meer getoond.
  3. Kies onder Eigenschapstoewijzing welke Eloqua-velden op uw bezoekers komen. Aanbevolen configuratie wijst de nuttigste in één klik toe: e-mail, naam, bedrijf, functie, land, stad, en branche en leadscore als uw Eloqua die heeft.
  4. Optioneel: formulierleads. Open een Lead Capture Form, ga naar de stap Where the data goes en voeg Oracle Eloqua toe. Wilt u elke lead ook aan een gedeelde lijst toevoegen, vul dan het ID van de lijst in bij Ook toevoegen aan gedeelde lijst (ID, optioneel); het staat in de URL van de lijst in Eloqua. Formulieren zonder e-mailveld worden overgeslagen.
  5. Optioneel: gebruikerslijsten. Open in hetzelfde Eloqua-paneel Een gebruikerslijst naar Eloqua sturen, kies een gebruikerslijst in Personyze en een gedeelde lijst in Eloqua, en klik op Naar Eloqua sturen.
Het Oracle Eloqua-paneel in Personyze
Instellingen → Integraties → Oracle Eloqua, vóór het verbinden: de bedrijfsnaam, de API-gebruiker en zijn wachtwoord. Klik om te vergroten.

Goed om te weten

  • Koppelen gaat op e-mailadres. Personyze koppelt bezoekers aan Eloqua-contacten op e-mailadres. Kent het het e-mailadres van een bezoeker niet, dan kan het hem toch koppelen als aan twee voorwaarden is voldaan: uw site gebruikt de first-party trackingcookie van Eloqua, en Eloqua heeft die browser al aan een contact gekoppeld, bijvoorbeeld nadat de bezoeker op een Eloqua-e-mail klikte.
  • Zuinig met uw Eloqua-API-tegoed. Personyze vraagt Eloqua hooguit één keer per bezoek naar een bezoeker, plus nog één keer als zijn e-mailadres tijdens het bezoek verandert. Het vraagt nooit bij elke paginaweergave.
  • Grote lijsten. Tot 50 mensen worden één contact tegelijk verstuurd. Grotere lijsten gaan via de Bulk API van Eloqua: Eloqua voegt ze op de achtergrond toe, meestal binnen enkele minuten, en met Voortgang bekijken volgt u dat. Eén verzending neemt tot 100.000 mensen met een e-mailadres; mensen zonder e-mailadres worden overgeslagen.
  • Als Eloqua het wachtwoord weigert — gewijzigd of verlopen — stopt Personyze er meteen mee, zodat de Eloqua-gebruiker niet wordt geblokkeerd, en het Eloqua-paneel meldt dat. Vul het wachtwoord opnieuw in om weer te verbinden.
  • Een formulier testen. Send test bij een formulier controleert de verbinding met Eloqua en de gedeelde lijst. Er wordt geen testcontact in uw Eloqua aangemaakt.
  • Verbinding verbreken. Klik op Verbinding verbreken in het Eloqua-paneel. Personyze stopt dan met het lezen van Eloqua-contacten en met het versturen van leads.

Beperkingen

  • Wijzigingen die u in Eloqua maakt, bereiken Personyze bij het volgende bezoek van de bezoeker, niet direct.
  • Een gebruikerslijst versturen voegt mensen toe, maar verwijdert niemand. Wilt u een Eloqua-lijst gelijk houden, maak die dan in Eloqua leeg voordat u opnieuw verstuurt.
  • Een formulierveld gaat alleen naar een aangepast Eloqua-veld als het naar dat veld is genoemd — naar de weergavenaam van het Eloqua-veld of naar de interne naam, zoals C_Industry1.
Did this page answer your question?
Thank you — that goes to whoever maintains this page.