Salesforce Marketing Cloud

Esempio: elenca tutti gli asset

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Assets dall'elenco Entity.
3. Seleziona l'operazione List, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, puoi impostare la filterClause in base ai requisiti del cliente.

Devi utilizzare gli apici singoli ("'") per racchiudere il valore di una clausola di filtro e deve essere passato direttamente, ad esempio CategoryName='Content Builder'. In questo caso, CategoryName è il nome della colonna e Content Builder è il valore.

Puoi utilizzare la clausola di filtro per filtrare i record in base alle colonne. Ad esempio, per filtrare i record, utilizza la seguente clausola di filtro: Location='US' e region='us-east1'

In alcuni casi, il passaggio di un ID entità potrebbe generare un errore. In questi casi, puoi utilizzare la clausola di filtro, ad esempio id=172.

Esempio: recuperare un record Assets

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Assets dall'elenco Entity.
3. Seleziona l'operazione Get, quindi fai clic su Fine.
4. Imposta l'ID entità su 49851.0, ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 49851.0 nel campo Valore predefinito.

   Il valore dell'ID entità deve essere passato direttamente, ad esempio Id= 49851.0. In questo caso, 49851.0 è il valore univoco della chiave primaria, che deve essere passato.

Esempio: elimina un record Asset

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Assets dall'elenco Entity.
3. Seleziona l'operazione Delete, quindi fai clic su Fine.
4. Imposta l'ID entità su 49851.0, ovvero la chiave da trasferire. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su EntityId e poi inserisci 49851.0 nel campo Valore predefinito.

   Il valore dell'ID entità deve essere passato direttamente, ad esempio ID= 49851.0. In questo caso, 49851.0 è il valore univoco della chiave primaria, che deve essere passato.

Esempio: creare un record DataExtensionObject_Custom

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DataExtensionObject_Custom dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "StudentName":"Cruz",
   "StudentID":"1",
   "Rank":"1"}
   

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "StudentID": 1
   } 

Esempio: creare un record Asset

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Assets dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Name": "Googlecloud_Created_HTMLEmail_Testing_V1",
     "TypeName": "htmlemail",
     "TypeId": 208.0
   }

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Id": 60188.0
   }

Esempio: creare un record Campagne

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Campaigns dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Name": "Campaigns - Tested via Googlecloud",
     "CampaignCode": "annual2023",
     "Color": "0000ff",
     "Favorite": false
   }

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Id": 247.0
   } 

Esempio: creare un record di percorsi

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Journeys dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Version": 1.0,
     "Name": "API_Journey_Googlecloud_Retest_1",
     "CreatedDate": "2023-04-26 04:20:29.87",
     "ModifiedDate": "2023-05-10 07:45:06.04",
     "LastPublishedDate": "2023-04-26 04:37:18.0",
     "Description": "API_Journey_Googlecloud_Retest_1",
     "WorkFlowApiVersion": 1.0,
     "Tags": null,
     "Goals": "",
     "Triggers": "[{\"id\": \"c79154a3-a0d2-435e-a6ad-bed46474620a\", \"key\": \"TRIGGER\", \"name\": \"API_Journey_Googlecloud\", \"description\": \"\", \"type\": \"APIEvent\", \"outcomes\": [], \"arguments\": {\"startActivityKey\": \"{Context.StartActivityKey}\", \"dequeueReason\": \"{Context.DequeueReason}\", \"lastExecutedActivityKey\": \"{Context.LastExecutedActivityKey}\", \"filterResult\": \"true\"}, \"configurationArguments\": {\"schemaVersionId\": 0, \"criteria\": \"\", \"filterDefinitionId\": \"00000000-0000-0000-0000-000000000000\"}, \"metaData\": {\"sourceInteractionId\": \"00000000-0000-0000-0000-000000000000\", \"eventDefinitionId\": \"8153cf00-ebf6-4c18-b52f-573eb724df87\", \"eventDefinitionKey\": \"APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c\", \"chainType\": \"None\", \"configurationRequired\": false, \"iconUrl\": \"/images/icon_journeyBuilder-event-api-blue.svg\", \"title\": \"\", \"entrySourceGroupConfigUrl\": \"jb:///data/entry/api-event/entrysourcegroupconfig.json\"}}",
     "Defaults": "[{\"email\": [\"{Event.APIEvent-4d84e619-a629-6b17-945f-9a6e78a1982c.\"Email"}\"], \"properties\": {\"analyticsTracking\": {\"enabled\": false, \"analyticsType\": \"google\", \"urlDomainsToTrack\": []}}}]"
   }

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Id": "aa03afe4-6a28-481f-bec4-564712127414"
   }

Esempio: creare un record Elenco

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona List dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "ID": "04052023.0",
     "ObjectID": "82349658-b482-404f-8c67-e555aadee0f4",
     "PartnerKey": "null",
     "CreatedDate": "2023-03-16 10:52:48.097",
     "ModifiedDate": "2023-03-17 10:30:34.497",
     "Client_ID": "5.14012689E8",
     "Client_PartnerClientKey": null,
     "ListName": "Googlecloud_Created_Subscriber_List",
     "Description": "null",
     "Category": "15449.0",
     "Type": "Public",
     "CustomerKey": "Googlecloud_BCONE",
     "ListClassification": "ExactTargetList",
     "AutomatedEmail_ID": "null"
   }

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Id": 4052023.0
   }

Esempio: creare un record Abbonato

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Subscriber dall'elenco Entity.
3. Seleziona l'operazione Create, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "EmailAddress": "baklavainthebalkans@gmail.com",
     "SubscriberKey": "KB1"
   }

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Success": true
   }

Esempio: aggiorna un record DataExtensionObject_Custom

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DataExtensionObject_Custom dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
   "StudentName":"Charlie",
   "Rank":"1"
   }
   

5. Imposta l'ID entità su Ad esempio: 103032, che è la chiave primaria da trasferire. Per impostare l'ID entità, nella sezione Input attività dell'attività Connettori, fai clic su entityId e poi inserisci 10 nel campo Valore predefinito.

   Se l'entità ha chiavi aziendali o primarie composite, anziché specificare entityId, puoi anche impostare filterClause su Rank='1' and StudentID='10'.

Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

{
    "StudentID": 1
}

Esempio: aggiornare un record Asset

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Asset dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Description": "June2023-Updated"
   }
   

5. Imposta l'ID entità sull'entità degli asset . Per impostare l'ID entità, fai clic su entityId e poi inserisci 52080 nel campo Valore predefinito.

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Id": 52080.0
   }
   

Esempio: aggiornare un record di Spostamenti

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Journeys dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Name": "SFMC_CRETAE_JOURNEY_FROM_Googlecloud_Updated_V1"
   }
   

5. Imposta l'ID entità sull'entità di Journeys . Per impostare l'ID entità, fai clic su entityId e poi inserisci 0868BF36-3107-460E-9EF1-09633A0592E8 nel campo Valore predefinito.

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "Id": "0868bf36-3107-460e-9ef1-09633a0592e8"
   }
   

Esempio: aggiornare un record Elenco

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona List dall'elenco Entity.
3. Seleziona l'operazione Update, quindi fai clic su Fine.
4. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "Description": "UpdatedDescription"
   }
   

5. Imposta l'ID entità sull'entità dell'elenco . Per impostare l'ID entità, fai clic su entityId e poi inserisci 1234 nel campo Valore predefinito.

   Se l'integrazione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività del connettore avrà un valore simile al seguente:

   {
     "ID": 1234.0
   }