Översikt över tillägget Cloud Connector

Med tillägget för händelsevidarebefordran i Cloud Connector kan du skapa anpassade HTTP-begäranden för att skicka data till ett mål eller hämta data från ett mål. Cloud Connector-tillägget fungerar som att ha Postman på Adobe Experience Platform Edge Network och kan användas för att skicka data till en slutpunkt som ännu inte har något dedikerat tillägg.

Använd den här referensen för information om de alternativ som är tillgängliga när du använder det här tillägget för att skapa en regel.

Åtgärdstyp för Cloud Connector-tillägg

I det här avsnittet beskrivs åtgärdstypen Skicka data som finns i tillägget Adobe Experience Platform Cloud Connector.

Typ av begäran

Om du vill välja vilken typ av begäran som krävs av slutpunkten väljer du lämplig typ i listrutan Request Type.

URL för slutpunkt

I textfältet bredvid listrutan Typ av begäran anger du URL:en för den slutpunkt som du skickar data till.

Frågeparametrar, rubriker och konfiguration av brödtext

Använd var och en av dessa flikar (Query Params, Headers och Body Data Elements) för att styra vilka data som skickas till en viss slutpunkt.

Frågeparametrar

Definiera en nyckel och ett värde för varje nyckelvärdepar som du vill skicka som en frågesträngsparameter. Om du vill ange ett dataelement manuellt använder du klammerparentesens dataelementtokenisering för vidarebefordran av händelser. Om du vill referera till värdet för ett dataelement med namnet"siteSection" som en nyckel eller ett värde anger du {{siteSection}}. Du kan också markera det dataelement som skapades tidigare genom att markera det i listrutan.

Om du vill lägga till fler frågeparametrar väljer du Add Another.

Sidhuvuden

Definiera en nyckel och ett värde för varje nyckelvärdepar som du vill skicka som en rubrik. Om du vill ange ett dataelement manuellt använder du klammerparentesens dataelementtokenisering för vidarebefordran av händelser. Om du vill referera till värdet för ett dataelement med namnet"pageName" som en nyckel eller ett värde anger du {{pageName}}. Du kan också markera det dataelement som skapades tidigare genom att markera det i listrutan.

Om du vill lägga till fler rubriker väljer du Add Another.

I följande tabell visas de fördefinierade rubrikerna. Du är inte begränsad till dessa rubriker och kan lägga till egna rubriker om det behövs, men de är tillgängliga för att underlätta.

Brödtext som JSON

Definiera en nyckel och ett värde för varje nyckelvärdepar som du vill skicka i själva förfrågningen. Om du vill ange ett dataelement manuellt använder du klammerparentesens dataelementtokenisering för vidarebefordran av händelser. Om du vill referera till värdet för ett dataelement med namnet"appSection" som en nyckel eller ett värde anger du {{appSection}}. Du kan också markera det dataelement som skapades tidigare genom att markera det i listrutan.

Om du vill lägga till fler nyckelvärdepar väljer du Add Another.

Brödtext som Raw

Definiera en nyckel och ett värde för varje nyckelvärdepar som du vill skicka i själva förfrågningen. Om du vill ange ett dataelement manuellt använder du klammerparentesens dataelementtokenisering för vidarebefordran av händelser. Om du vill referera till värdet för ett dataelement med namnet"appSection" som en nyckel eller ett värde anger du {{appSection}}. Du kan också markera det dataelement som skapades tidigare genom att markera det i listrutan. Du kan lägga till ett eller flera dataelement.

Avancerat

Åtgärder i regler för vidarebefordran av händelser utförs sekventiellt. Det kan finnas situationer där du vill hämta data från en extern källa som inte finns i den inkommande händelsen från klienten och sedan ta detta svar och antingen omvandla eller skicka dessa data till ett slutmål i en efterföljande åtgärd i en enda regel. Det här aktiveras av"Spara begäransvaret" i det avancerade avsnittet.

Om du vill spara svarstexten från en slutpunkt markerar du rutan Save the request response och definierar en svarsnyckel i textfältet.

Om du definierade svarsnyckeln som productDetails refererar du till dessa data i ett dataelement och refererar sedan detta dataelement i en efterföljande åtgärd i samma regel. Om du vill skapa ett dataelement som refererar till productDetail skapar du ett dataelement av typen path och anger följande sökväg:

arc.ruleStash.[EXTENSION-NAME-HERE].responses.[RESPONSE-KEY-HERE]

arc.ruleStash.adobe-cloud-connector.reponses.productDetails

Lägg till en säkerhetsregel för lager för ömsesidig transport (mTLS) i biblioteket för vidarebefordran av händelser mtls-rules

Certifikatet mTLS är en digital autentiseringsuppgift som bevisar identiteten på en server eller klient i säker kommunikation. När du använder tjänst-API:t mTLS hjälper dessa certifikat dig att verifiera och kryptera din interaktion med Adobe Experience Platform Event Forwarding. Denna process skyddar inte bara dina data, utan säkerställer även att alla anslutningar kommer från en betrodd partner.

Installera Adobe Cloud Connector-tillägget install

Om du vill installera tillägget skapar du en egenskap för vidarebefordring av händelser eller väljer en befintlig egenskap att redigera i stället.

Välj Extensions i den vänstra panelen. Välj Catalog-kortet på fliken Adobe Cloud Connector och välj sedan Install.

Konfigurera en regel för vidarebefordran av händelser rule

När du har installerat tillägget kan du skapa en regel för vidarebefordran av händelser som använder mTLS och lägga till den i biblioteket.

Skapa en ny händelsevidarebefordring av regel i din händelsevidarebefordringsegenskap. Ange ett namn för regeln, lägg sedan till en ny åtgärd under Actions och ange tillägget till Adobe Cloud Connector. Välj sedan Make Fetch Call för Action Type.

När du har gjort ditt val visas ytterligare kontroller för att konfigurera metoden och målet för mTLS-begäran. Om du vill aktivera användning av aktiva certifikat i miljöer väljer du Enable in mTLS och sedan Keep Changes för att spara regeln.

Din nya regel är nu klar. Välj Save to Library och välj sedan Build för att distribuera den. mTLS-begäran är nu aktiv och tillgänglig i ditt bibliotek.

Nästa steg

I den här guiden beskrivs hur du konfigurerar mTLS-regler vid vidarebefordran av händelser. Mer information om hur du konfigurerar mTLS för en miljö finns i guiden mTLS om säkerhet för transportlager ​.

Mer information om funktioner för vidarebefordran av händelser i Experience Platform finns i översikten över vidarebefordran av händelser.