DokumentationJourney OptimizerJourney Optimizer Guide

Exempel på leverantörskonfigurationer vendor-integration

Senast uppdaterad: 27 april 2026

Skapat för:

  • Intermediate
  • User

Kunderna ansvarar för att se till att deras användning av AJO Integrations-funktionen och alla tillhörande tredjepartsleverantörer eller integreringar uppfyller alla tillämpliga lagar och bestämmelser, som HIPAA.

style
shade-box

Snabb navigering quick-navigation

Använd de här grupperade länkarna för att snabbt gå till det relevanta leverantörsmönstret:

Innehåll och CMS content-and-cms

Innehållsmedveten contentful

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Contentful. Bekräfta aktuell API-information med dokumentation om innehållet.

Contentful är en headless CMS för strukturerade tävlingsbidrag och mediefiler över REST eller GraphQL, så Journey Optimizer kan hämta innehåll när det skickas eller öppnas.

Exempel på användningsområden är lokaliserade hjälteblock, alternativ text och CTA i e-postmeddelanden samt produkt- eller kampanjposter i dynamiska moduler. Ett annat vanligt mönster är att hämta en viss post med ID för personaliserade meddelanden.

style
shade-box
Läs mer om krav och begränsningar för Innehållsmedveten.

Följande krav gäller:

  • Innehållsligt utrymme med åtkomst till leverans-API och en läsorienterad API-nyckel.
  • Rensa innehållstyper och fält-ID; administratörsåtkomst i Journey Optimizer för att skapa integreringar.

Följande begränsningar och undantag gäller:

  • En bred lista eller sidnumrerade innehållsanpassade API:er passar dåligt för det här mönstret. föredrar hämtningsanrop som avser en viss post eller resurs.
  • Återskrivnings- eller tvåvägssynkronisering ligger utanför omfånget för det här exemplet.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Konfigurera GET med innehållets leverans-API och din leveranstoken, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med CDA-URL (Content Delivery API): https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}

  5. Välj HTTP-metod: GET.

  6. Lägg till autentisering. Ange parametern access_token query till din Content Delivery API-token, vilket visas i Exempel på integreringsfält nedan. Contentful accepterar även samma token i en Authorization: Bearer-rubrik; använd det som integreringsfälten stöder.

  7. Lägg till sökvägsvariabler om det behövs (t.ex. post-ID, språkområde).

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj obligatoriska fält för personalisering.

  10. Konfigurera timeout och cachning efter behov.

  11. Testa anslutningen och aktivera.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempelintegrationsfält (justera med API:t för innehållsleverans för ditt space och din miljö):

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://cdn.contentful.com/spaces/{{spaceID}}/environments/{{environment_id}}/entries/{{entry_id}}
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.
HTTP-metod GET

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3 3-row-3
Sökvägsparameter Namn Standardvärde
spaceID spaceID <YOUR_SPACE_ID>
environment_id environment_id <YOUR_ENV_ID>
entry_id entry_id <YOUR_ENTRY_ID>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel access_token <YOUR_API_KEY> Frågeparameter

Sitecore sitecore

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Sitecore. Bekräfta aktuell API-information med dokumentationen för Sitecore.

Sitecore Content Hub och relaterade moln-API:er stöder nedladdning och metadataflöden i DAM-stil. exempelmönstret nedan centrerar sig på en hämtningsorder per ID.

Vanliga användningsexempel är resurser eller nedladdningsmetadata i e-postinnehåll och anpassning till DAM-arbetsflöden som hanteras i Sitecore.

style
shade-box
Läs mer om förutsättningarna och begränsningarna för SiteStore.

Följande krav gäller:

  • Klient-URL och autentiseringsuppgifter (innehavare eller token per API-yta).
  • Administratörsåtkomst i Journey Optimizer för att skapa integreringar.

Följande begränsningar och undantag gäller:

  • Värdnamn och sökvägar varierar beroende på Sitecore-produkt. Använd bara slutpunkter som din klient exponerar.
  • OAuth-åtkomsttoken, uppdatering och livstider måste följa webbplatsens säkerhetsprincip.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Konfigurera GET på din hämtningsordersökväg, ange auktoriseringsrubriker per Sitecore, mappa id från kontext, klistra in exempel-JSON, kartfält och justera tidsgränser för resursfördröjning.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Content Hub API (exempel: nedladdningsorder efter ID). Exempel på URL-mönster:

    https://xmapps-api.sitecorecloud.io/api/v1/downloadorders/{id}

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Använd följande fält när du konfigurerar det här exempelsamtalet i Journey Optimizer. Bekräfta värdnamn och API-version för din produkt (Content Hub, XM Cloud och så vidare) i SiteStore-dokumentation.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://xmapps-api.sitecorecloud.io/api/v1/downloadorders/{{id}}
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
id id <id_of_download_order>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)
Behörighet Behörighet Konstant Bärare <token> Ja (på)
If-Modified-Since If-Modified-Since Variabel 2019-08-24T14:15:22Z Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel X-Auth-Token <token> Sidhuvud

Salsify salsify

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Salsify. Bekräfta aktuell API-information med Salsify-dokumentation.

Salsify är en PIM med API:er för produkter, kanaler och digitala resurser.

Vanliga användningsområden är produktattribut eller medie-URL:er i e-post och meddelanden som är anpassade till syndikerade katalogdata.

style
shade-box
Läs mer om krav och begränsningar för Salsify.

Följande krav gäller:

  • API-token och organisationskontext; produkt-ID:n som kan matchas från profil eller kontext.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Mycket stora kataloger: Undvik slutpunkter för grupplistor om integreringar förväntar sig hämtning per enhet.
  • Attributsynligheten kan begränsas av rollbehörigheter i Salsify.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Föredra hämtning av en enstaka produkt framför anrop av bulkkataloger, ange innehavarautentisering, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med produkt-API:t för Salsify. Exempel på URL-mönster:

    https://api.salsify.com/v1/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Vissa äldre referenser återanvände en hämtningsordstilsökväg för Salsify; din klient kan i stället använda https://app.salsify.com/api/v1/orgs/{org_id}/products/{salsify_id} eller liknande. Bekräfta i Salsify-utvecklare.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://app.salsify.com/api/v1/orgs/{{org_id}}/products/{{salsify_id}}
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
org_id org_id <org_id>
salsify_id salsify_id <salsify_id>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standardparam) Content-Type Konstant application/json Ja (på)
Behörighet Behörighet Konstant Bearer <YOUR_TOKEN_HERE> Ja (på)
If-Modified-Since If-Modified-Since Variabel 2019-08-24T14:15:22Z Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel apiKey <your_api_key> Sidhuvud

Contentstack contentstack

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Contentstack. Bekräfta aktuell API-information med ContentStack-dokumentation.

Contentstack är en CMS utan rubriker. REST-leverans är typiskt för JSON-fältmappning i Journey Optimizer.

Ett typiskt exempel är att använda poster för banners eller promotor med parametrar som innehåller språkområde.

style
shade-box
Läs mer om krav och begränsningar för Contentstack.

Följande krav gäller:

  • Stapla API-nyckel, leveranstoken, miljönamn och innehållstypens UID.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Det här mönstret använder REST JSON för fältmappning. Leveransen till GraphQL följer en annan integrationsväg.
  • Använd produktionskänsliga leveranstokens. förhandsgranskning och publicerade flöden är inte utbytbara.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Lägg till både api_key- och access_token-huvuden när Contentstack kräver, ta med frågeparametern environment, klistra in exempel-JSON, mappningsfält, test, activate.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Content Delivery API. Exempel på URL-mönster:

    https://cdn.contentstack.io/v3/content_types/{content_type_uid}/entries/{entry_uid}

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel på integreringsfält. Se ContentStack Content Delivery API.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Fält Värde
URL https://cdn.contentstack.io/v3/content_types/{{content_type_uid}}/entries/{{entry_uid}}
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.
Sidhuvuden Inga extra rubriker behövs.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
content_type_uid Content Type UID <your_content_type_uid>
entry_uid UID <your_entry_uid>

Autentisering

table 0-row-3 1-row-3 2-row-3
Nyckelnamn Nyckelvärde Lägg till i
api_key <YOUR_STACK_API_KEY> Sidhuvud
access_token <YOUR_DELIVERY_TOKEN> Sidhuvud

Contentstack förväntar sig båda nycklar som huvuden för leveransbegäranden.

Frågeparametrar

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
environment Miljönamn Variabel <your_environment_name> Ja (på)

Akeneo akeneo

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av Akeneo eller stöds formellt inte. Bekräfta aktuell API-information med Akeneo-dokumentation.

Akeneo PIM visar REST API:er för produkter, attribut och media.

Vanliga användningsområden är styrda produktdata i e-postmoduler och attribut för en viss kanal under resor.

style
shade-box
Läs mer om förutsättningarna och begränsningarna för Akeneo.

Följande krav gäller:

  • PIM-bas-URL och OAuth-klient; produkt-UID eller identifieringsstrategi.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • PIM-svar kan vara stora. Mappa endast de attribut som krävs för personalisering.
  • Skrivåtgärder ligger utanför omfånget för vanliga skrivskyddade personaliseringsexempel.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd GET med innehavartoken, begär endast nödvändiga attributalternativ i frågeflaggor, klistra in exempel-JSON, mappa en minimal attributuppsättning, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Akeneo REST API. Exempel på URL-mönster:

    https://{pim-host}/api/rest/v1/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel: https://{pim-host}/api/rest/v1/products-uuid/{uuid} med Accept: application/json. Se Akeneo API.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://{{your-akeneo-domain}}.com/api/rest/v1/products-uuid/{{uuidProduct}}
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
uuidProduct UUID <product_uuid>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
Behörighet Behörighet Konstant Bearer <YOUR_TOKEN> Ja (på)
Acceptera Acceptera Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
with_attribute_options Inkludera attributalternativ Variabel false Nej (av)
with_quality_scores Inkludera kvalitetsmoment Variabel false Nej (av)
with_completenesses Inkludera slutföranden Variabel false Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel Behörighet Bearer <YOUR_ACCESS_TOKEN> Sidhuvud

Magnolia magnolia

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av Magnolia eller stöds formellt inte. Bekräfta aktuell API-information med Magnolia-dokumentation.

Magnolia erbjuder headless och REST-slutpunkter beroende på driftsättning.

Ett typiskt användningsexempel är att leverera innehållsnoder eller fragment för marknadsföringsmoduler.

style
shade-box
Läs mer om krav och begränsningar för Magnolia.

Följande krav gäller:

  • Instans-URL och token eller grundläggande autentisering. arbetsyta och leveransvägar.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • REST-leverans-URL:er är beroende av installerade Magnolia-moduler och konfiguration.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd det URL-mönster för offentlig leverans som modulerna visar, autentisera enligt Magnolia-vägledning (anonym leverans jämfört med token för skyddat innehåll), klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Magnolia REST (leverans). Exempel på URL-mönster:

    https://{author-or-public}/.rest/delivery/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel: https://{domain}/magnoliaAuthor/.rest/delivery/... eller URL:er i offentlig leveransstil. Dina sökvägar är beroende av installerade moduler. Se Magnolia-dokumentation.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL http://{{your-domain}}/magnoliaAuthor/.rest/delivery/<myEndpoint>/travel/@nodes
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sidhuvuden

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
Content-Type Content-Type Konstant application/json Ja (på)
Acceptera Acceptera Konstant application/json Ja (på)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel Behörighet <bearer_token> Sidhuvud

Obs! Leverans-API är att använda den övriga anonyma rollen för innehåll som inte kräver inloggning. För säker åtkomst till skyddade data rekommenderas en mer robust metod som API-tokens eller OAuth 2.0.

Lojalitet och belöningar loyalty-and-rewards

Voucherify voucherify

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Voucherify. Bekräfta aktuell API-information med Voucherify-dokumentation.

Voucherify tillhandahåller reklam och REST API:er för lojalitet (kampanjer, vouchers, lojalitetsprogram).

Exempel på vanliga användningsområden är att läsa lojalitet eller kampanjstatus för erbjudanden i innehållet och visa nivå eller balans där det är lämpligt.

style
shade-box
Läs mer om krav och begränsningar för Voucherify.

Följande krav gäller:

  • Program-ID och hemlighet (per region/kluster); tydlighet om vilka lojalitets- eller kampanjslutpunkter ni anropar.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Undvik att exponera interna kampanj- eller kampanjidentifierare för kundmotstående fel eller meddelandeinnehåll.
  • Gränsvärden för ansökningsnivå gäller. Konfigurera återförsök och cachelagring per Voucherify-vägledning.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Ange bas-URL för ditt kluster, lägg till nödvändiga huvuden (X-APP-ID, X-APP-TOKEN), begränsa listslutpunkter med filter eller ID, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Loyalty/REST API:er. Ange värddatorn Cluster och sökvägarna för din region per Voucherify. Exempel på URL-mönster:

    https://{cluster}.voucherify.io/

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel på integreringsfält. Fullständig referens: Verifiera API.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://{{cluster}}.voucherify.io/v1/loyalties/{{campaignId}}/members
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
cluster cluster <your_cluster>
campaignId campaignId <loyalty_campaign_Id>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)
X-APP-ID X-APP-ID Konstant <YOUR-APP-ID> Ja (på)
X-Voucherify-Channel X-Voucherify-Channel Konstant Verifiera dokumentation Nej (av)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5
Parameter Namn Typ Värde Obligatoriskt
limit limit Variabel 10 Nej (av)
page page Variabel 1 Nej (av)
customer customer Variabel <customer_identifier> Nej (av)
created_at created_at Variabel <iso8601_date> Nej (av)
updated_at updated_at Variabel <iso8601_date> Nej (av)
order order Variabel <sort_field> Nej (av)
code code Variabel <loyalty_card_code> Nej (av)
ids ids Variabel <array_of_ids> Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel X-APP-TOKEN <YOUR-APP-TOKEN> Sidhuvud

Talon.One talon-one

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Talon.One. Bekräfta aktuell API-information med Talon.One-dokumentation.

Talon.One är en motor för marknadsföring och lojalitetsregler med REST API:er för sessioner, effekter och profiler.

Exempel på typiska användningsområden är kampanjer på kundvagn- eller profilnivå i personaliserat innehåll och lojalitetsutveckling eller belöningsdisplayannonsering.

style
shade-box
Läs mer om krav och begränsningar för Talon.One.

Följande krav gäller:

  • API-nyckel och distributionsspecifik bas-URL, identifierare för program- eller kampanjomfattning.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Sessionskrävande flöden kan kräva noggrann mappning till modellen för integreringsbegäran.
  • Observera Talon.Engångsgränser och vägledning om hur stor del av bidraget som finns.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd GET på den profil eller resultatsökväg du behöver, ange Authorization: ApiKey-v1 <key> som dokumenterad, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med hjälp av API:t för integrering med Talon.One. Exempel på URL-mönster:

    https://{your-domain}.talon.one/v1/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält
table 0-row-2 1-row-2 2-row-2
Fält Värde
URL https://{{your-deployment}}.talon.one/v1/customer_profiles/{{integrationId}}/achievements/{{achievementId}}
HTTP-metod GET

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3 3-row-3
Sökvägsparameter Namn Standardvärde
your-deployment your-deployment <your_deployment>
integrationId integrationId <integrationId>
achievementId achievementId <achievementId>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5
Parameter Namn Typ Värde Obligatoriskt
progressStatus progressStatus Variabel pågående/slutförd/utgången Nej (av)
startDate startDate Variabel 2024-05-29T15:04:05+07:00 Nej (av)
endDate endDate Variabel 2024-05-29T15:04:05+07:00 Nej (av)
pageSize pageSize Variabel <default_page_size> Nej (av)
skip skip Variabel <items_to_skip> Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel Behörighet ApiKey-v1 <YOUR_API_KEY> Sidhuvud

Antavo antavo

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Antavo. Bekräfta aktuell API-information med Antavo-dokumentation.

Antavo är en lojalitetsplattform för företag med REST API:er för medlemmar, belöningar och händelser.

Vanliga användningsområden är poäng, nivå eller belöningar i e-post eller push-meddelanden och erbjudanden som styrs av lojalitetsstatus.

style
shade-box
Läs mer om krav och begränsningar för Antavo.

Följande krav gäller:

  • Stapla URL- och API-autentiseringsuppgifter; program- eller butiksidentifierare efter behov.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Kund-PII måste hanteras enligt Antavo-avtal och din sekretesspolicy.
  • Bekräfta API-versioner och stabila slutpunkter med Antavo för din miljö.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Konfigurera GET med leverantörens autentisering (till exempel API-nyckel i fråga), undvik att exponera PII mot princip, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Antavo Enterprise API.

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempelintegrationsfält använder värden för staging; produktionen använder ditt värdnamn för Antavo-stacken. Se Antavo-dokumentation.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://api.staging.antavo.com/customers/{{customer_id}}/activities/offers
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
customer_id customer_id <customer_id>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)
Acceptera Acceptera Konstant application/json Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel api_key <YOUR_API_KEY> Frågeparameter

Salesforce Loyalty salesforce-loyalty

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Salesforce. Bekräfta aktuell API-information med Salesforce-dokumentation.

Salesforce Loyalty Management visar REST API:er på Salesforce-plattformen för medlemmar, program och transaktioner.

Exempel på typisk användning är ytaktnivå, poäng eller fördelar på resorna och att anpassa meddelanden till CRM och lojalitetsdata.

style
shade-box
Läs mer om krav och begränsningar för Salesforce lojalitet.

Följande krav gäller:

  • Salesforce-instans, ansluten app eller integreringsanvändare och OAuth som passar din organisation.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Salesforce API-begränsningar och OAuth-tokenuppdatering måste utformas i integreringen.
  • Fältnivåsäkerhet och delningsregler styr vilka fält som visas i API-svar.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd den slutpunkt för lojalitetsintegration som teamet godkänner, slutför Salesforce OAuth, klistra in exempel-JSON, kartfält, följ sammansatta API-gränser, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Salesforce Loyalty Management REST. Exempel på URL-mönster:

    https://{instance}.salesforce.com/services/data/vXX.X/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Använd GET-åtgärden medlemsprofil för lojalitetshantering som dokumenterats för din organisations API-version; sökvägar innehåller program- och medlemsidentifierare. Se Salesforce-utvecklare.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://{{your-instance}}.my.salesforce.com/services/data/{{version}}/connect/loyalty/management/members
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
your-instance your-instance <your_instance>
version version version

Sidhuvuden

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)
Acceptera Acceptera Konstant application/json Nej (av)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
membershipNumber membershipNumber Variabel <membership_number> Nej (av) *
membershipId membershipId Variabel <membership_id> Nej (av) *
posMemId posMemId Variabel <pos_mem_id> Nej (av) *

* Minst en av tre krävs.

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel Behörighet <access_token> Sidhuvud

Kapillär capillary

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Capillary. Bekräfta aktuell API-information med Capillary-dokumentation.

Capillary tillhandahåller de lojalitets- och engagemangs-API:er som är vanliga i butiksstackar.

Exempel på typiska användningsområden är poäng, nivåer eller erbjudanden inom personaliserade resor.

style
shade-box
Läs mer om krav och begränsningar för Capillary.

Följande krav gäller:

  • API-värd och autentisering (ofta signerade begäranden) följ Kapillärdokument).
  • Programidentifierare för din slutpunkt.

Följande begränsningar och undantag gäller:

  • Autentiseringsscheman och regionala värdar varierar beroende på distribution. Bekräfta med Capillary för stacken.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Konfigurera rubriker som CAP-API-ACCESS-TOKEN efter behov, klistra in exempel-JSON, mappningsfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med kapillärprogrammeringsgränssnitten.

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel: https://ushc.intouch.capillarytech.com/api/v3/rewards/{reward_id} (värden varierar beroende på region). Validera värd- och autentiseringsschemat med Capillary.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://ushc.intouch.capillarytech.com/api/v3/rewards/{{reward_id}}
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
reward_id Belönings-ID <your_reward_id>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
Content-Type Content-Type Konstant application/json Ja (på)
CAP-API-ACCESS-TOKEN Åtkomsttoken Konstant <YOUR_ACCESS_TOKEN> Ja (på)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel CAP-API-ACCESS-TOKEN <YOUR_ACCESS_TOKEN> Sidhuvud

Mallar och meddelanden templates-and-messaging

Stensul stensul

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av Stensul eller stöds formellt inte. Bekräfta aktuell API-information med Stensul-dokumentation.

Stensul är en plattform för att skapa e-postmeddelanden för godkända mallar. Journey Optimizer kan förbruka mallmetadata och strukturerade regioner via sina API:er.

Exempel på vanliga användningsområden är att importera godkända mallar och mappningsområden till profilattribut och återanvända styrda block för skalbara kampanjbyggen.

style
shade-box
Läs mer om krav och begränsningar för Stensul.

Följande krav gäller:

  • Konto med API-åtkomst och publicerade mallar med definierade tokens.
  • Administratörsåtkomst i Journey Optimizer för att skapa integreringar.

Följande begränsningar och undantag gäller:

  • In-place WYSIWYG editing of Stensul templates within Journey Optimizer is not cover here.
  • Stora eller komplexa HTML i mallnyttolaster kan kräva säkerhetsgranskning och sanering.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  2. Ange ett integrationsnamn.

  3. Konfigurera slutpunkten med URL:en för programmeringsgränssnittet för stensul-mallar. Exempel på URL-mönster:

    https://api.stensul.com/v1/templates/{template_id}

  4. Konfigurera autentisering (API-nyckel eller OAuth per Stensul API-dokumentation).

  5. Definiera sökvägsvariabler, t.ex. mall-ID.

  6. Klistra in ett JSON-exempelsvar för fältidentifiering.

  7. Mappa obligatoriska mallfält till Journey Optimizer personaliseringsfält.

  8. Testa anslutningen och aktivera.

Marigold marigold

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Marigold. Bekräfta aktuell API-information med dokumentationen till Marigold.

Marigold visar lojalitet och engagemangs-API:er. Värdar skiljer sig åt beroende på geografisk belägenhet (värdnamn för modulen EU respektive USA).

Ett typiskt exempel på användningsområden är att berika meddelanden med lojalitets- eller inställningsdata från Marigold-program.

style
shade-box
Läs mer om krav och begränsningar för Marigold.

Följande krav gäller:

  • Bas-URL och autentiseringsuppgifter från ditt kontrakt; API-användare med lägst behörighet när det är möjligt.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Slutpunkterna varierar beroende på Marigold-produkt. Validera med Marigold-support för din driftsättning.
  • Personuppgifter i svar måste följa era dataskyddsbestämmelser och lagringspolicyer.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Peka på Marigold-värden för din region, ange autentisering (exemplet nedan använder X-Api-Key med nyckel och hemlighet), klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med hjälp av Marigold REST API.

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

  12. Marigold använder två slutpunkter som baseras på det geografiska område där kundinstansen är aktiv:

    • Europa: https://{{customername}}.module.slgnt.eu
    • USA: https://{{customername}}.module.slgnt.us

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Basvärden är beroende av region (till exempel https://{{customername}}.module.slgnt.eu eller https://{{customername}}.module.slgnt.us). Bekräfta sökvägarna med Marigold för driftsättningen.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://{{customername}}.module.slgnt.{{locale}}/Portal/Api/organizations/{{organization}}/content/{{api_name}}
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
Sökvägsparameter Namn Standardvärde
customername customername <your_name>
locale locale eu / us
organization organization <your_organization>
api_name api_name <api_name>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel X-API-tangent <apiKey>:<apiSecret> Sidhuvud

Adobe Target Recommendations adobe-target-recommendations

IMPORTANT
Den här konfigurationen är ett illustrativt mönster som testats av Adobe Journey Optimizer team. Adobe Target Recommendations är en separat Adobe-produkt med en egen releasecykel och API-versionshantering. Bekräfta alltid aktuell API-information med Adobe Target-utvecklardokumentationen innan du distribuerar i produktionen.

Adobe Target innehåller rekommendationer och API:er för leverans för upplevelser på serversidan eller integrerade, beroende på vad som gäller.

Vanliga användningsområden är bland annat att injicera rekommendationer i upplevelser som du skriver i Journey Optimizer och att anpassa nycklarna efter profilen eller Experience Platform-sammanhanget.

style
shade-box
Läs mer om krav och begränsningar för Adobe Target Recommendations.

Följande krav gäller:

  • Rikta in er mot rekommendationer. IMS-organisation och autentisering som stöds.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Rekommendations- och leverans-API:er kräver specifika parametrar (till exempel mbox eller produktidentifierare). Följ Adobe Target dokumentation.
  • Finjustera latens och cachning för din sändningsvolym och användningsfall.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Leveransanrop är ofta POST med en JSON-brödtext. Konfigurera OAuth per målautentisering, klistra in ett exempelsvar, mappningsfält, testa under förväntad volym.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Target Recommendations/delivery APIs.

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält
table 0-row-2 1-row-2 2-row-2 3-row-2
Fält Värde
URL https://{{client}}.tt.omtrdc.net/rest/v1/delivery
Policy Konfigurera principnivåinformation efter behov.
HTTP-metod POST

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
client client <client_name>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
klient klient Variabel <customer_client_code> Ja (på)
sessionId sessionId Variabel <session_identifier> Ja (på)

Autentisering

Se Målautentiseringskonfiguration och lägg till JSON i nyttolasten.

Begär nyttolast

code language-sample 
{
  "id": {
    "tntId": "<YOUR_TENANT_ID>"
  },
  "context": {
    "channel": "web",
    "address": {
      "url": "https://example.com/store.html"
    },
    "screen": {
      "width": 1200,
      "height": 1400
    }
  },
  "experienceCloud": {
    "analytics": {
      "logging": "server_side",
      "supplementalDataId": "<supDataId>",
      "trackingServer": "sstats.adobe.com"
    }
  },
  "execute": {
    "pageLoad": {
      "parameters": {
        "pageType": "checkout",
        "preferredCurrency": "$"
      }
    },
    "mboxes": [
      {
        "index": 1,
        "name": "orderConfirmPage"
      }
    ]
  },
  "prefetch": {
    "views": [
      {
        "parameters": {
          "ad": "view"
        }
      }
    ],
    "mboxes": {
      "index": 1,
      "name": "SummerOffer"
    }
  }
}

Data, väder och drift data-weather-and-operations

AccuWeather accuweather

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av AccuWeather. Bekräfta aktuell API-information med AccuWeather-dokumentation.

AccuWeather visar prognos och plats för REST-API:er så att meddelanden kan innehålla vädermedvetna kodfragment.

Vanliga användningsexempel är korta prognoser i e-post eller push- och skräddarsydda innehåll med hjälp av prognosvärden som är kopplade till profil eller kontext.

style
shade-box
Läs mer om krav och begränsningar för AccuWeather.

Följande krav gäller:

  • API-prenumeration och nyckel; platsnyckel eller sökflöde för stad.
  • Administratörsåtkomst i Journey Optimizer för att skapa integreringar.

Följande begränsningar och undantag gäller:

  • Bekräfta JSON-svarsformen för din AccuWeather-prenumerationsnivå. Integrering mappar fält från JSON-svar.
  • Observera hastighetsbegränsningar för AccuWeather och rekommenderad cachelagring.
  • För att matcha locationKey krävs ofta en separat geolocation- eller city-search-begäran före prognosanrop.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd GET om inte din prenumeration kräver något annat bifogar du frågeparametern apiKey, kartan locationKey och andra variabler från profil/kontext, klistrar in exempel-JSON, kartfält och testar sedan.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med hjälp av API:t för daglig prognos. Exempel på URL-mönster:

    https://dataservice.accuweather.com/forecasts/v1/daily/{days}day/{locationKey}

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel på integreringsfält. Information och nivåer beskrivs i API:er för AccuWeather. Du löser ofta locationKey med ett separat sökanrop för platser (till exempel .../locations/v1/cities/search?q={{cityName}}).

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://dataservice.accuweather.com/forecasts/v1/daily/{{days}}day/{{locationKey}}
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
days days 15
locationKey locationKey <desired_location_key>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5
Parameter Namn Typ Värde Obligatoriskt
format format Variabel json Nej (av)
language language Variabel en-US Nej (av)
details details Variabel Falskt Nej (av)
metric metric Variabel Falskt Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel apiKey <YOUR_API_KEY> Frågeparameter

ShipStation shipstation

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av ShipStation. Bekräfta aktuell API-information med dokumentationen för ShipStation.

ShipStation erbjuder API:er för frakt och beställning för transportörer, etiketter och spårning.

Vanliga användningsexempel är orderstatus, spårningslänkar eller leveransrelaterade e-postmeddelanden i transaktionsmeddelanden.

style
shade-box
Läs mer om krav och begränsningar för ShipStation.

Följande krav gäller:

  • API-nyckel och hemlighet (grundläggande autentisering per ShipStation-dokument).
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Visa inte ShipStation-API-nycklar i meddelandeinnehåll. endast behålla inloggningsuppgifter i integrationskonfigurationen.
  • Slutpunkter för sidnumrerade listor kan vara dåligt anpassade för integreringar. föredrar du single-resource-GET när det är möjligt.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Ange den resurs du behöver (order eller leveranser), autentisera per ShipStation API, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med ShipStation REST API. Exempel på URL-mönster:

    https://ssapi.shipstation.com/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

I följande Get Timer-exempel visas ett timinganrop för ShipStation-automatisering. Använd den exakta sökvägen och autentiseringen från ShipStation-integreringsguiden när du återskapar den i Journey Optimizer.

table 0-row-2 1-row-2 2-row-2 3-row-2
Fält Värde
URL https://dashboard.sendtric.com/api/v1/timers/{{id}}
HTTP-metod POST
Princip Konfigurera principnivåinformation efter behov.

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel apiKey <your_api_key> Sidhuvud

Begär nyttolast

code language-sample 
{
    "external_batch_id": "se-28529731",
    "batch_notes": "This is my batch",
    "shipment_ids": [
      "se-28529731"
    ],
    "rate_ids": [
      "se-28529731"
    ]
}

IntäkterKat revenuecat

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av RevenueCat. Bekräfta aktuell API-information med dokumentationen för RevenueCat.

RevenueCat tillhandahåller prenumerationsstatus och API:er för berättiganden för appar.

Ett typiskt användningsfall är att det återspeglar prenumerationsstatus i livscykelkampanjer där policyn tillåter det.

style
shade-box
Läs mer om krav och begränsningar för RevenueCat.

Följande krav gäller:

  • Hemlig API-nyckel och appidentifierare; stabil mappning mellan profiler och RevenueCat kund-ID.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Skydda hemliga API-nycklar och följ dina rotationsprinciper.
  • Prenumerations- och tillståndsdata är känsliga. Uppfyll kraven på integritet och samtycke.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Anropa REST GET enligt nedanstående modell, autentisera med det hemliga nyckelhuvudet, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med hjälp av RevenueCat REST API. Exempel på URL-mönster:

    https://api.revenuecat.com/v1/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel: använd RevenueCats Hämta en produkt (eller motsvarande produkt/berättigande GET) från RevenueCat docs med ditt projekts bas-URL och version.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://api.revenuecat.com/projects/{{project_id}}/products/{{product_id}}
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
project_id project_id <project_id>
product_id product_id <product_id>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
country country Variabel <iso_country_code> Nej (av)
locale locale Variabel <locale_code> Nej (av)
parentId parentId Variabel <parent_category_id> Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel Behörighet Bearer <token> Sidhuvud

Databricks databricks

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Databricks. Bekräfta aktuell API-information med dokumentationen för databaser.

Databricks tillhandahåller SQL- och REST-API:er över lagrade data. tidigare utkast kombinerar körningsvägledning för programsats med ett jobb/get -exempel.

Ett typiskt användningsexempel är att använda små, normaliserade attribut från styrda tabeller för personalisering med strikt privilegium.

style
shade-box
Läs mer om krav och begränsningar för databaser.

Följande krav gäller:

  • Workspace värd, token eller OAuth per organisationsprofil; tjänstens huvudnamn med minimal omfattning.
  • Administratörsåtkomst i Journey Optimizer.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Föredra smala läsbanor. Om du använder POST -satskörning inkluderar du det JSON-innehåll som API kräver, klistrar in ett exempel på lyckat svar för mappning, testfördröjning noggrant och aktiverar.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med hjälp av SQL-satskörnings-API:t för databaser. Exempel på URL-mönster:

    https://{workspace-host}/api/2.0/sql/statements/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Jobbexemplet GET nedan är illustrativt; för SQL-driven personalisering bör du använda det ​ API för satskörning ​ som arbetsytan stöder.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Fält Värde
URL https://<databricks-instance>/api/2.0/jobs/get
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.
Autentisering OAuth

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Acceptera Acceptera Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
job_id job_id Variabel 12 Ja

Bynder bynder

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av Bynder eller stöds formellt inte. Bekräfta aktuell API-information med Bynder-dokumentation.

Bynder är en DAM med REST API:er; integreringar använder ofta OAuth 2.0 för skrivskyddade metadata eller resurs-URL:er.

Vanliga användningsexempel är att dra in metadata för mediefiler eller leverans-URL:er i meddelanden och att hålla materialet godkänt i Bynder efter resor.

style
shade-box
Läs mer om krav och begränsningar för Bynder.

Följande krav gäller:

  • Portaldomän och OAuth-klient (eller godkänd tokenmetod).
  • Omfattningar för skrivskyddad åtkomst. administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Pagination och OAuth-tokenuppdatering måste följa Bynders API-regler.
  • Stora sidnumrerade svar: mappa endast de fält som krävs för personalisering.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Konfigurera GET på den valda slutpunkten (ett vanligt mönster är en användarlista), fyll i OAuth per Bynder, undvik att dra i onödiga sidor av data, mappa fält, testa och sedan aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med API:t v4 för Bynder. Exempel på URL-mönster:

    https://{your-bynder-domain}/api/v4/users/

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel på integreringsfält. Mer information om OAuth 2.0-nyttolast finns i API-dokumentationen för Bynder.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://{{your-bynder-domain}}/api/v4/users/
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
your-bynder-domain your-bynder-domain <your-bynder-domain>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)
Behörighet Behörighet Konstant Bärare <token> Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
includeInActive includeInActive Variabel Falskt Nej (av)
limit limit Variabel 100 Nej (av)
page page Variabel 1 Nej (av)

Autentisering

table 0-row-2 1-row-2
Typ Nyttolast
OAuth 2.0 OAuth 2.0-nyttolast (se Bynder-dokumentation)
code language-none 
{
    "type": "oauth2",
    "endpoint": {
        "uri": ""
    },
    "method": "get",
    "response": {
        "type": "json"
    },
    "request": {
        "header": [
            {
                "key": "client_id",
                "value": ""
            },
            {
                "key": "client_secret",
                "value": ""
            }
        ],
        "queryParams": [
            {
                "key": "grant_type",
                "value": ""
            },
            {
                "key": "scope",
                "value": ""
            }
        ],
        "payload": {
            "type": "json",
            "content": {}
        }
    },
    "credentialPaths": [
        "header.client_id",
        "header.client_secret",
        "queryParam.scope"
    ],
    "tokenPath": "message.token",
    "policy": {
        "timeoutInMilliseconds": 30000,
        "cache": {
            "enabled": true,
            "ttlInSeconds": 300
        },
        "retry": {
            "enabled": false
        }
    },
    "locationConfig": {
        "key": "x-token",
        "location": "query"
    }
}

Trustpilot trustpilot

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Trustpilot. Bekräfta aktuell API-information med Trustpilot-dokumentation.

Trustpilot tillhandahåller API:er för affärs- och granskningssammanfattningsdata där ditt användningsfall och kontrakt tillåter det.

Ett typiskt användningsexempel är att visa antal recensioner eller omdömen i marknadsföringsmaterial som uppfyller villkoren för Trustpilot.

style
shade-box
Läs mer om krav och begränsningar för Trustpilot.

Följande krav gäller:

  • API-nyckel och godkänt användningsfall, affärsidentifierare för frågor.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Användning av data från Trustpilot måste följa riktlinjerna för Trustpilot branding och dataanvändning.
  • Hastighetsgränser gäller för granskningssammanfattning och relaterade slutpunkter.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Konfigurera GET med obligatorisk frågeautentisering, mappa identifierare från profil eller kontext, klistra in exempel-JSON, mappa fält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med hjälp av förvaltarpilotens API:er. Exempel på URL-mönster:

    https://api.trustpilot.com/v1/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Använd kategoriliståtgärden från Trustpilot-utvecklare för ditt integreringsmönster; parametrarna varierar beroende på resurs.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://api.trustpilot.com/v1/categories
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
country country Variabel <iso_country_code> Nej (av)
locale locale Variabel <locale_code> Nej (av)
parentId parentId Variabel <parent_category_id> Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel apiKey <your_api_key> Sidhuvud

Bazaarvoice bazaarvoice

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Bazarvoice. Bekräfta aktuell API-information med dokumentationen för Bazaarvoice.

Bazarvoice ger omdömen, recensioner och UGC API:er.

Ett typiskt användningsexempel är att visa sammanfattningar eller omdömen i e-postmeddelanden när policyn tillåter det.

style
shade-box
Läs mer om krav och begränsningar för Bazaarvoice.

Följande krav gäller:

  • API-nyckel och klientidentifierare från ditt kontrakt.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Visning av omdömen och recensioner måste följa policyer för basaarröstinnehåll.
  • Frekvensgränser och cachelagringsregler gäller per API-nyckel.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd GET med passkey som frågeparameter i konversations-API:t, ange Accept: application/json, klistra in exempel-JSON, kartfält, test, activate.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med API:t för Bazarvoice-konversationer. Exempel på URL-mönster:

    https://api.bazaarvoice.com/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel på startpunkt: https://api.bazaarvoice.com/data/products.json med version och filterfrågeparametrar. Se Bazaarvoice-utvecklare.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://api.bazaarvoice.com/data/products.json
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Acceptera Acceptera Konstant application/json Ja (på)

Autentisering

table 0-row-3 1-row-3
Typ Nyckelvärde Plats
nyckel <YOUR_ACCESS_TOKEN> Frågeparameter

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5
Parameter Namn Typ Värde Obligatoriskt
apiversion apiversionNumber Konstant 5.4 Ja (på)
filter filter Variabel ID:47950830 Nej (av)
stats stats Variabel alla Nej (av)

OneTrust onetrust

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av OneTrust. Bekräfta aktuell API-information med OneTrust-dokumentation.

OneTrust visar API:er för sekretess och samtycke (produktspecifika URL:er och scheman).

Ett typiskt användningsexempel är att läsa samtycke eller inställningssignaler för villkorat innehåll där arkitektur och juridisk granskning tillåter det.

style
shade-box
Läs mer om krav och begränsningar för OneTrust.

Följande krav gäller:

  • API-uppgifter och regional bas-URL, juridiskt godkännande för fält som används i meddelanden.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Samtycke- och inställningsdata är mycket reglerade. Samordna med privatpersoner och jurister.
  • API-sökvägar och nyttolaster skiljer sig åt mellan OneTrust-produkter. Använd dokumentation för prenumerationen.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd det publicerade schemat eller den inställningscentrerade sökvägen till dina prenumerationsdokument, fyll i OAuth om det behövs, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med OneTrust API. Din klientorganisation, produkt och sökväg kommer från OneTrust -dokumentationen för din prenumeration. Exempel på URL-mönster:

    https://{tenant}.my.onetrust.com/api/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Fält Värde
URL https://customer.my.onetrust.com/api/consentmanager/v2/preferencecenters/{{preferencecenterid}}/schema
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Autentisering OAuth

Sökvägsparametrar

table 0-row-3 1-row-3
Parameter Namn Värde
preferencecenterid preferencecenterid <pref-id>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Acceptera Acceptera Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
state state konstant PUBLICERAT Ja

Inställningscenterschema (publicerat)

Exempelmönster (fragment): https://{tenant}.my.onetrust.com/api/consentmanager/v2/preferencecenters/{preferencecenterid}/schema?state=PUBLISHED. Bekräfta den exakta sökvägen i OneTrust Developer.

Meta meta

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av Meta. Bekräfta aktuell API-information med Meta-dokumentation.

Meta Graph- och Marketing API:er visar kataloger och kampanjobjekt för auktoriserade affärsintegreringar.

Ett typiskt användningsexempel är att berika innehåll med attribut från Meta, där tokens och principer tillåter det.

style
shade-box
Läs mer om krav och begränsningar för Meta.

Följande krav gäller:

  • Systemanvändare eller programtoken med rätt behörigheter; Justering av Business Manager.
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Kortlivade åtkomsttokens kräver en förnyelsestrategi eller en långvarig strategi som passar för serverintegration.
  • Följ Meta plattformsvillkor, loggar inte token eller andra hemligheter i meddelandenyttolaster.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Diagramanrop är ofta GET med en versionshanterad sökväg; hantera förfallodatum för token, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Meta Graph API. Exempel på URL-mönster:

    https://graph.facebook.com/vXX.X/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel på integreringsfält. Se Diagram-API för versionshantering och åtkomsttoken.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Fält Värde
URL https://graph.facebook.com/{{API_VERSION}}/{{PRODUCT_CATALOG_ID}}/products
HTTP-metod GET
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.
Policy Konfigurera principnivåinformation efter behov.
Autentisering OAuth

Sökvägsparametrar

table 0-row-3 1-row-3 2-row-3
Sökvägsparameter Namn Standardvärde
API_VERSION API_VERSION v19.0
PRODUCT_CATALOG_ID PRODUCT_CATALOG_ID 12345

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Acceptera Acceptera Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5
Parameter Namn Typ Värde Obligatoriskt
fields fields Variabel id Nej
filter filter Variabel — Nej

April aprimo

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av eller stöds formellt av aprimo. Bekräfta aktuell API-information med aprimdokumentation.

April kombinerar marknadsföringsåtgärder och API:er för DAM för register, resurser och metadata.

Exempel på användningsområden är godkända post- eller tillgångsfält i dynamiskt innehåll och styrda DAM-arbetsflöden i reglerade branscher.

style
shade-box
Läs mer om krav och begränsningar för April.

Följande krav gäller:

  • Klient-URL och autentiseringsuppgifter (OAuth- eller API-nyckel enligt konfigurationen).
  • Administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • aprimos fältnivåsäkerhet måste överensstämma med de attribut du mappar i Journey Optimizer.
  • Stora HAL- eller JSON-nyttolaster: begränsa mappade fält till den minsta obligatoriska uppsättningen.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Använd GET på den postsökväg du behöver, skicka obligatoriska rubriker som API-VERSION, klistra in exempel-JSON (HAL eller JSON som returnerat), mappa en minimalt fältuppsättning, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med April DAM/Records API. Använd API-bas-URL och arkivsökväg för din tenant (per aprimo). Exempel på URL-mönster:

    https://{tenant}.dam.aprimo.com/

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält
table 0-row-2 1-row-2 2-row-2
Fält Värde
URL https://productstrategy1.dam.aprimo.com/api/core/record/{{recordID}}
HTTP-metod GET

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
recordId recordId <record_identifier>

Sidhuvuden

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)
API-VERSION API-VERSION Konstant 1 Ja (på)
Acceptera Acceptera Konstant application/hal+json OR application/json Nej (av)
select-record select-record Variabel <selection_type> Nej (av)
select-record-fields select-record-fields Variabel <field_list> Nej (av)
select-field select-field Variabel <field_selection> Nej (av)

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel Behörighet Bärare <token> Sidhuvud

Epsilon (epsilon3) epsilon

IMPORTANT
Det här konfigurationsexemplet har testats separat av Adobe som ett exempelmönster. Den underhålls inte av Epsilon eller stöds formellt inte. Bekräfta aktuell API-information med Epsilon-dokumentation.

Epsilon exponerar API:er per företagsavtal. bas-URL:er och autentisering kommer från ditt kontoteam (exemplet med Events-API nedan är illustrativt).

Ett typiskt användningsexempel är att visa lojalitet eller erbjuda attribut via JSON-API:er som stöds.

style
shade-box
Läs mer om krav och begränsningar för Epsilon (Epsilon3).

Följande krav gäller:

  • Autentiseringsuppgifter och slutpunkter från Epsilon, administratörsåtkomst i Journey Optimizer.

Följande begränsningar och undantag gäller:

  • Slutpunkter och värdar är kundspecifika. Distribuera inte utan dokumentation från ditt Epsilon-kontoteam.

Använd proceduren nedan för att konfigurera integreringen i Journey Optimizer. Se Exempel på integreringsfält om du vill ha mer information och bekräfta värdena med leverantörsdokumentationen för din miljö.

  1. Följ Arbeta med integreringar. Gissa inte offentliga URL:er. Använd specifikationen från Epsilon, klistra in exempel-JSON, kartfält, testa, aktivera.

  2. I Journey Optimizer går du till Configurations > Manage och väljer sedan Create Integration.

  3. Ange ett integrationsnamn utan blanksteg.

  4. Konfigurera slutpunkten med Epsilon API (enligt din integreringsspecifikation). Bas-URL och resurssökvägar tillhandahålls av ditt Epsilon-kontoteam. Exempel på URL-mönster:

    https://{your-instance}.epsilon3.io/api/...

  5. Välj den HTTP-metod som visas i konfigurationstabellen, vanligtvis GET, om inget annat anges.

  6. Konfigurera autentisering (rubriker, frågeparametrar eller OAuth) exakt som anges i tabellen och i leverantörsdokumentationen.

  7. Definiera sökvägs-, fråge- och rubrikparametrar samt mappa variabler till profiler eller kontextuella data där det behövs.

  8. Klistra in ett JSON-exempelsvar så att fält kan identifieras och mappas.

  9. Välj de fält som krävs för personalisering i svarets nyttolastmappning.

  10. Konfigurera principer för timeout, återförsök och cachelagring baserat på förväntad volym.

  11. Testa anslutningen och aktivera sedan integreringen.

Tabellen nedan visar exempelvärden för denna integreringsbegäran.

Exempel på integreringsfält

Exempel: https://{your-instance}.epsilon3.io/api/v1/planning/events med start och end frågeparametrar och rubrikbaserad API-nyckel. Bekräfta med Epsilon före produktion.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Fält Värde
URL https://{{your-instance}}.epsilon3.io/api/v1/planning/events
HTTP-metod GET
Princip Konfigurera principnivåinformation efter behov.
Svarsnyttolast Välj och konfigurera önskade svarsfält för redigering, baserat på API-svaret.

Sökvägsparametrar

table 0-row-3 1-row-3
Sökvägsparameter Namn Standardvärde
your-instance your-instance <your_instance>

Sidhuvuden

table 0-row-5 1-row-5
Parameter Namn Typ Värde Obligatoriskt
Innehållstyp (standard) Content-Type Konstant application/json Ja (på)

Frågeparametrar

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5
Parameter Namn Typ Värde Obligatoriskt
start start Variabel 2019-08-24T14:15:22Z Ja (på) *
end end Variabel 2019-08-24T14:15:22Z Ja (på) *
eventType eventType Variabel schemalagd/ej schemalagd Nej (av)
exclude_recurrences exclude_recurrences Variabel true / false Nej (av)

* Valfritt för eventType = unscheduled och för exclude_recurrences = true.

Autentisering

table 0-row-4 1-row-4
Typ API-nyckelnamn API-nyckelvärde Plats
API-nyckel <your_username> <EPSILON3_API_KEY> Sidhuvud
recommendation-more-help
journey-optimizer-help