(API) Oracle Eloqua verbinding

Oracle Eloqua laat marketers toe om campagnes te plannen en uit te voeren terwijl het leveren van een gepersonaliseerde klantenervaring voor hun vooruitzichten. Dankzij geïntegreerd beheer van leads en het eenvoudig maken van campagnes, kunnen marketers op het juiste moment het juiste publiek betrekken bij de reis van hun koper en schalen ze elegant om het publiek te bereiken via verschillende kanalen, zoals e-mail, display, search, video en mobile. Verkoopteams kunnen meer deals sluiten in een sneller tempo, waardoor het marketingrendement toeneemt dankzij realtime inzicht.

Dit Adobe Experience Platform doel gebruikt de Een contactpersoon bijwerken van de Oracle Eloqua REST API, waarmee u identiteiten bijwerken binnen een publiek in Oracle Eloqua.

Oracle Eloqua gebruik Basisverificatie om te communiceren met Oracle Eloqua REST API. Instructies voor verificatie aan uw Oracle Eloqua de instantie is verder onderaan, in de Verifiëren voor bestemming sectie.

Gebruik hoofdletters use-cases

De marketingafdeling van een onlineplatform wil een marketingcampagne op basis van e-mail uitzenden naar een publiek met nieuwsberichten. Het marketingteam van het platform kan bestaande informatie over leads bijwerken via Adobe Experience Platform, een publiek opbouwen op basis van hun eigen offline gegevens en deze doelgroep naar sturen Oracle Eloqua, die vervolgens kan worden gebruikt om de marketingcampagne per e-mail te verzenden.

Vereisten prerequisites

Voorwaarden voor Experience Platforms prerequisites-in-experience-platform

Voordat u gegevens activeert naar de Oracle Eloqua doel, u moet een schema, gegevensset, en segmenten gemaakt in Experience Platform.

Raadpleeg de documentatie bij het Experience Platform voor Publiek Lidmaatschap Details schema groep als u hulp over publieksstatus nodig hebt.

Oracle Eloqua voorwaarden prerequisites-destination

Als u gegevens van Platform naar uw wilt exporteren Oracle Eloqua account die u nodig hebt Oracle Eloqua account.

Bovendien hebt u minimaal de "Advanced Users - Marketing permissions" voor uw Oracle Eloqua -instantie. Zie de "Beveiligingsgroepen" de Beveiligde gebruikerstoegang pagina voor hulp. De toegang wordt vereist door de bestemming programmatically de basis-URL bepalen wanneer het aanroepen van Oracle Eloqua API.

Gather Oracle Eloqua geloofsbrieven gather-credentials

Noteer de onderstaande items voordat u deze verifieert voor de Oracle Eloqua bestemming:

Credentials
Beschrijving
Company Name
De bedrijfsnaam die aan uw Oracle Eloqua account.
U gebruikt later de Company Name en Oracle Eloqua Username als een samengevoegde tekenreeks die als de Username wanneer authenticeren aan de bestemming.
Username
De gebruikersnaam van uw Oracle Eloqua account.
Password
Het wachtwoord van uw Oracle Eloqua account.
Pod
Oracle Eloqua ondersteunt meerdere datacenters, elk met een unieke domeinnaam. Oracle Eloqua Deze worden "pods" genoemd. Momenteel zijn er in totaal zeven - p01, p02, p03, p04, p06, p07 en p08. Meld u aan om te bepalen welke POD u hebt ingeschakeld Oracle Eloqua en noteer de URL in uw browser nadat u zich met succes hebt aangemeld. Als de URL van uw browser bijvoorbeeld secure.p01.eloqua.com uw pod is p01. Zie de de POD bepalen pagina voor aanvullende instructies.

Zie de Aanmelden bij Oracle Eloqua ter begeleiding.

Guardrails guardrails

NOTE
  • Oracle Eloqua aangepaste contactvelden worden automatisch gemaakt met de namen van de doelgroepen die tijdens het Select segments stap.
  • Oracle Eloqua heeft een maximale limiet van 250 aangepaste contactvelden.

  • Voordat u nieuwe doelgroepen exporteert, moet u ervoor zorgen dat het aantal doelgroepen van het platform en het aantal bestaande doelgroepen binnen Oracle Eloqua deze limiet niet overschrijden.

  • Als deze limiet wordt overschreden, treedt er een fout op in het Experience Platform. Dit komt omdat de Oracle Eloqua API kan de aanvraag niet valideren en reageert met een - 400: Er is een validatiefout opgetreden - foutbericht met een beschrijving van het probleem.

  • Als u de hierboven opgegeven limiet hebt bereikt, moet u bestaande toewijzingen verwijderen uit uw bestemming en de bijbehorende aangepaste contactvelden in uw Oracle Eloqua voordat u meer segmenten kunt exporteren.

  • Zie de Oracle Eloqua Contactvelden maken pagina voor informatie over extra limieten.

Ondersteunde identiteiten supported-identities

Oracle Eloqua ondersteunt het bijwerken van de identiteiten die in de onderstaande tabel worden beschreven. Meer informatie over identiteiten.

Doelidentiteit
Beschrijving
Verplicht
EloquaId
Unieke id van het contact.
Ja

Type en frequentie exporteren export-type-frequency

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item
Type
Notities
Exporttype
Profile-based
  • U exporteert alle leden van een segment samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam), op basis van uw veldtoewijzing.
  • Voor elk geselecteerd publiek in Platform, het overeenkomstige Oracle Eloqua de segmentstatus wordt bijgewerkt met de publieksstatus van Platform.
Exportfrequentie
Streaming
  • Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Meer informatie over streaming doelen.

Verbinden met de bestemming connect

IMPORTANT
Om met de bestemming te verbinden, hebt u nodig View Destinations en Manage Destinations toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.

Als u verbinding wilt maken met dit doel, voert u de stappen uit die in het dialoogvenster zelfstudie over doelconfiguratie. In vormen bestemmingswerkschema, vul de gebieden in die in de twee hieronder secties worden vermeld.

Within Destinations > Catalog zoeken naar (API) Oracle Eloqua. U kunt de locatie ook onder de Email Marketing categorie.

Verifiëren voor bestemming authenticate

Vul de vereiste velden hieronder in. Zie de Gather Oracle Eloqua geloofsbrieven voor eventuele richtsnoeren.

  • Password: Het wachtwoord van uw Oracle Eloqua account.
  • Username: Een samengevoegde tekenreeks die bestaat uit uw Oracle Eloqua Bedrijfsnaam en de Oracle Eloqua Gebruikersnaam
    De samengevoegde waarde bestaat uit: {COMPANY_NAME}\{USERNAME}.
    Let op: gebruik geen accolades of spaties en bewaar de \.
    Als u bijvoorbeeld Oracle Eloqua Bedrijfsnaam is MyCompany en Oracle Eloqua Gebruikersnaam is Username, de samengevoegde waarde die u in het dialoogvenster Username field is MyCompany\Username.

Om voor authentiek te verklaren aan de bestemming, uitgezocht Connect to destination.
Schermopname van de gebruikersinterface van het platform waarin wordt getoond hoe te voor authentiek te verklaren.

Als de verstrekte gegevens geldig zijn, geeft de interface een Connected status met een groen vinkje. Vervolgens kunt u verdergaan met de volgende stap.

Doelgegevens invullen destination-details

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.
Platform UI het schermschot die de bestemmingsdetails tonen.

  • Name: Een naam waarmee u dit doel in de toekomst wilt herkennen.
  • Description: Een beschrijving die u zal helpen deze bestemming in de toekomst identificeren.
  • Pod: te verkrijgen pod u bent aan, login aan Oracle Eloqua en noteer de URL in uw browser nadat u zich met succes hebt aangemeld. Als de URL van uw browser bijvoorbeeld secure.p01.eloqua.com de pod waarde die u moet selecteren, is p01. Zie de Gather Oracle Eloqua geloofsbrieven voor aanvullende richtsnoeren.

Waarschuwingen inschakelen enable-alerts

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Zie de handleiding voor meer informatie over waarschuwingen abonneren op bestemmingen die het alarm gebruiken UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next.

Soorten publiek naar dit doel activeren activate

IMPORTANT
  • Als u gegevens wilt activeren, hebt u de opdracht View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheermachtigingen. Lees de toegangsbeheeroverzicht of neem contact op met de productbeheerder om de vereiste machtigingen te verkrijgen.
  • Om te exporteren identiteiten, hebt u de View Identity Graph toegangsbeheermachtiging.
    Selecteer naamruimte voor identiteit die in de workflow wordt gemarkeerd om het publiek naar bestemmingen te activeren. {width="100" modal="regular"}

Lezen Profielen en doelgroepen activeren voor het streamen van doelgroepen voor het exporteren van bestanden voor instructies voor het activeren van het publiek naar deze bestemming.

Afbeeldingsoverwegingen en voorbeeld mapping-considerations-example

Als u uw publieksgegevens correct vanuit Adobe Experience Platform naar de Oracle Eloqua doel, moet u door de stap van de gebiedstoewijzing gaan. Toewijzing bestaat uit het maken van een koppeling tussen de schemavelden van uw Experience Data Model (XDM) in uw Platform-account en de bijbehorende equivalenten van de doelbestemming.

Uw XDM-velden toewijzen aan de Oracle Eloqua doelvelden, voer de volgende stappen uit:

  1. In de Mapping stap, selecteren Add new mapping. Er verschijnt een nieuwe toewijzingsrij op het scherm.

  2. In de Select source field venster, kiest u de Select attributes en selecteer het XDM-kenmerk of kies de Select identity namespace en selecteer een identiteit.

  3. In de Select target field venster, kiest u Select identity namespace en selecteer een identiteit of kies Select custom attributes en typ de gewenste kenmerknaam in het dialoogvenster Attribute name veld. De kenmerknaam die u opgeeft, moet overeenkomen met een bestaand contactkenmerk in Oracle Eloqua. Zie create a contact voor de exacte kenmerknamen die u kunt gebruiken in Oracle Eloqua.

    • Herhaal deze stappen om de vereiste en gewenste kenmerktoewijzingen toe te voegen tussen uw XDM-profielschema en Oracle Eloqua: | Bronveld | Doelveld | Verplicht | |—|—|—| |IdentityMap: Eid|Identity: EloquaId| Ja | |xdm: personalEmail.address|Attribute: emailAddress| Ja | |xdm: personName.firstName|Attribute: firstName| | |xdm: personName.lastName|Attribute: lastName| | |xdm: workAddress.street1|Attribute: address1| | |xdm: workAddress.street2|Attribute: address2| | |xdm: workAddress.street3|Attribute: address3| | |xdm: workAddress.postalCode|Attribute: postalCode| | |xdm: workAddress.country|Attribute: country| | |xdm: workAddress.city|Attribute: city| |

    • Hieronder ziet u een voorbeeld met de bovenstaande toewijzingen:

      Voorbeeld van schermopname voor platformgebruikersinterface met kenmerktoewijzingen.

IMPORTANT
  • Kenmerken die zijn opgegeven in het dialoogvenster Target field moet een naam hebben die exact overeenkomt met de naam die is opgegeven in het Create a contact aangezien deze kenmerken de aanvraaginstantie vormen.
  • Kenmerken die zijn opgegeven in het dialoogvenster Source field zich niet aan een dergelijke beperking houden. U kunt deze toewijzen op basis van uw behoefte, maar als de gegevensindeling niet correct is wanneer u naar Oracle Eloqua resulteert in een fout. U kunt bijvoorbeeld de Source field naamruimte identity contact key, ABC ID enz. tot Target field : EloquaId nadat de id-waarden overeenkomen met de indeling die is geaccepteerd door Oracle Eloqua.
  • De EloquaID toewijzen is verplicht om kenmerken bij te werken die overeenkomen met de identiteit.
  • De emailAddress toewijzing is vereist. Zonder deze API genereert de API een fout zoals hieronder wordt weergegeven:
code language-json
{
     "type":"ObjectValidationError",
     "container":{
           "type":"ObjectKey",
           "objectType":"Contact"
     },
     "property":"emailAddress",
     "requirement":{
           "type":"EmailAddressRequirement"
     },
     "value":"<null>"
}

Wanneer u klaar bent met het opgeven van de toewijzingen voor uw doelverbinding, selecteert u Next.

NOTE
Het doel plaatst automatisch een unieke id achter aan de geselecteerde publieksnamen bij elke uitvoering wanneer het verzenden van de informatie van het contactgebied naar Oracle Eloqua. Dit zorgt ervoor dat de namen van de contactgebieden die overeenkomen met uw publieksnamen elkaar niet overlappen. Zie de Gegevens exporteren valideren voorbeeld van een sectiescherm van een Oracle Eloqua De pagina van Details van het contact met het gebied van de douanecontcontact dat gebruikend de publieksnamen wordt gecreeerd.

Gegevens exporteren valideren exported-data

Volg onderstaande stappen om te controleren of u de bestemming correct hebt ingesteld:

  1. Selecteren Destinations > Browse en navigeer naar de lijst met bestemmingen.

  2. Selecteer vervolgens de bestemming en schakel over naar de Activation data en selecteert u vervolgens de naam van een publiek.
    Het het schermschot van het platform UI die de Gegevens van de Activering van Doelen toont.

  3. Controleer het publieksoverzicht en zorg ervoor dat de telling van profielen aan de telling binnen het segment beantwoordt.
    Voorbeeld van schermopname van platform-UI met segment.

  4. Aanmelden bij de Oracle Eloqua website, navigeer vervolgens naar de Contacts Overview pagina om te controleren of de profielen van het publiek zijn toegevoegd. Als u de status van het publiek wilt zien, gaat u naar een Contact Detail pagina en controleer of het contactveld met het geselecteerde publiek als voorvoegsel is gemaakt.

Schermopname Eloqua UI van het oracle die de pagina van de Details van het Contact met het gebied van het douanecontact toont dat met de publieksnaam wordt gecreeerd.

Gegevensgebruik en -beheer data-usage-governance

Alles Adobe Experience Platform de bestemmingen zijn volgzaam met het beleid van het gegevensgebruik wanneer het behandelen van uw gegevens. Voor gedetailleerde informatie over hoe Adobe Experience Platform handhaaft gegevensbeheer, zie Overzicht van gegevensbeheer.

Fouten en problemen oplossen errors-and-troubleshooting

Wanneer u het doel maakt, ontvangt u mogelijk een van de volgende foutberichten: 400: There was a validation error of 400 BAD_REQUEST. Dit gebeurt wanneer u de limiet van 250 aangepaste contactvelden overschrijdt, zoals wordt beschreven in het dialoogvenster guardrails sectie. Als u deze fout wilt corrigeren, moet u ervoor zorgen dat u de limiet van het aangepaste contactveld niet overschrijdt in Oracle Eloqua.
Fout in schermopname van platforminterface.

Zie de Oracle Eloqua HTTP-statuscodes en Oracle Eloqua Validatiefouten pagina's voor een uitgebreide lijst met status- en foutcodes met uitleg.

Aanvullende bronnen additional-resources

Zie voor meer informatie de Oracle Eloqua documentatie:

Changelog

Deze sectie vangt de functionaliteit en de significante documentatieupdates aan deze bestemmingsschakelaar worden aangebracht die.

Wijzigingen weergeven
table 0-row-3 1-row-3 2-row-3 layout-auto
Releasedatum Type bijwerken Beschrijving
April 2023 Documentatie bijwerken
  • We hebben de gebruikgevallen een duidelijker voorbeeld van wanneer de klanten van het gebruiken van deze bestemming zouden profiteren.
  • We hebben de toewijzing met duidelijke voorbeelden van zowel verplichte als optionele toewijzingen.
  • We hebben de Verbinden met de bestemming met een voorbeeld van hoe u de samengevoegde waarde voor de component Username veld met de Oracle Eloqua Bedrijfsnaam en de Oracle Eloqua Gebruikersnaam (PLATIR-28343)
  • We hebben de Gather Oracle Eloqua geloofsbrieven en de Doelgegevens invullen secties met richtsnoeren over Oracle Eloqua Pod selectie. De "Pod" De waarde wordt gebruikt door de bestemming om de basis-URL voor de API-aanroepen samen te stellen. De Oracle Eloqua voorwaarden dit gedeelte is ook bijgewerkt met richtlijnen voor het toewijzen van "Advanced Users - Marketing permissions" als vereist "Beveiligingsgroepen" voor uw Oracle Eloqua -instantie.
Maart 2023 Eerste release Oorspronkelijke doelversie en documentatie publiceren.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6