**Avviso di fine del supporto:** il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta [Fine del supporto di Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Nota: per quanto** APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da End User Messaging. AWS 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Aggiungi endpoint ad Amazon Pinpoint
<a name="audience-define-endpoints"></a>

Un *endpoint* rappresenta una destinazione alla quale puoi inviare messaggi, ad esempio un dispositivo mobile, un numero di telefono o un indirizzo e-mail. Prima di inviare messaggi a un membro del gruppo di destinatari, è necessario definire uno o più endpoint per quella persona. 

Man mano che aggiungi endpoint in Amazon Pinpoint, viene creato un repository sempre più ricco di dati relativi al pubblico. Questi dati sono composti da:
+ Endpoint aggiunti da te o aggiornati usando l'API Amazon Pinpoint.
+ Endpoint aggiunti o aggiornati dal codice client man mano che si aggiungono utenti alla tua applicazione.

Per definire un endpoint, devi specificare il *canale* e l'*indirizzo*. Il canale è il tipo di piattaforma usata per inviare messaggi all'endpoint, ad esempio un servizio di notifica push, SMS o e-mail. L'indirizzo specifica dove inviare il messaggio all'endpoint, ad esempio un token di dispositivo, un numero di telefono o un indirizzo e-mail.

Per aggiungere ulteriori dettagli sui destinatari, puoi arricchire gli endpoint con attributi personalizzati o standard. Questi attributi includono dati sugli utenti, le loro preferenze, i loro dispositivi, le versioni del client che utilizzano o le loro posizioni. L'aggiunta di dati di questo tipo agli endpoint ti consente di:
+ Visualizzare grafici relativi al pubblico nella console Amazon Pinpoint.
+ Segmentare il gruppo di destinatari in base agli attributi degli endpoint, in modo da inviare messaggi al target appropriato.
+ Personalizzare i messaggi incorporando variabili dei messaggi che vengono sostituite con i valori degli attributi degli endpoint.

Un'applicazione mobile o JavaScript client registra automaticamente gli endpoint se integri Amazon Pinpoint utilizzando AWS la libreria Mobile SDKs o Amplify. AWS JavaScript Il client registra un endpoint per ogni nuovo utente e aggiorna gli endpoint per gli utenti già registrati. Per registrare gli endpoint da un dispositivo mobile o da un client, consulta. JavaScript [Registra gli endpoint Amazon Pinpoint nella tua applicazione](integrate-endpoints.md)

## Esempi
<a name="audience-define-endpoints-examples"></a>

Gli esempi seguenti illustrano come aggiungere un endpoint a un progetto Amazon Pinpoint. L'endpoint rappresenta un membro del gruppo di destinatari che abita a Seattle e usa un iPhone. Questa persona può ricevere messaggi tramite il servizio Apple Push Notification ()APNs. L'indirizzo dell'endpoint è il token del dispositivo fornito da. APNs

------
#### [ AWS CLI ]

Puoi utilizzare Amazon Pinpoint eseguendo i comandi con l' AWS CLI.

**Example Comando per l'aggiornamento di endpoint**  
Per aggiungere o aggiornare un endpoint, usa il comando [update-endpoint](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/update-endpoint.html):  

```
$ aws pinpoint update-endpoint \
> --application-id application-id \
> --endpoint-id endpoint-id \
> --endpoint-request file://endpoint-request-file.json
```
Dove:  
+ *application-id* è l'ID del progetto Amazon Pinpoint in cui vuoi aggiungere o aggiornare di un endpoint.
+ *example-endpoint* è l'ID da assegnare a un nuovo endpoint oppure l'ID di un endpoint esistente da aggiornare.
+ *endpoint-request-file.json* è il percorso del file di un file JSON locale che contiene l'input per il parametro. `--endpoint-request`

**Example File di richiesta endpoint**  
Il comando `update-endpoint` di esempio usa un file JSON come argomento per il parametro `--endpoint-request`. Questo file contiene una definizione di endpoint come la seguente:  

```
{
  "ChannelType": "APNS",
  "Address": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7a8b9c0d1e2f",
  "Attributes": {
    "Interests": [
      "Technology",
      "Music",
      "Travel"
    ]
  },
  "Metrics": {
    "technology_interest_level": 9.0,
    "music_interest_level": 6.0,
    "travel_interest_level": 4.0
  },
  "Demographic": {
    "AppVersion": "1.0",
    "Make": "apple",
    "Model": "iPhone",
    "ModelVersion": "8",
    "Platform": "ios",
    "PlatformVersion": "11.3.1",
    "Timezone": "America/Los_Angeles"
  },
  "Location": {
    "Country": "US",
    "City": "Seattle",
    "PostalCode": "98121",
    "Latitude": 47.61,
    "Longitude": -122.33
  }
}
```
Per gli attributi che puoi utilizzare per definire un endpoint, consulta [EndpointRequest](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-schemas)lo schema nell'*Amazon Pinpoint* API Reference.

------
#### [ AWS SDK per Java ]

Puoi utilizzare l'API Amazon Pinpoint nelle applicazioni Java utilizzando il client fornito da AWS SDK per Java.

**Example Codice**  
Per aggiungere un endpoint, inizializza un oggetto [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/EndpointRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/EndpointRequest.html) e passalo al metodo [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/UpdateEndpointRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/pinpoint/model/UpdateEndpointRequest.html) del client `AmazonPinpoint`:  

```
import com.amazonaws.regions.Regions;
import com.amazonaws.services.pinpoint.AmazonPinpoint;
import com.amazonaws.services.pinpoint.AmazonPinpointClientBuilder;
import com.amazonaws.services.pinpoint.model.*;
import java.util.Arrays;

public class AddExampleEndpoint {

	public static void main(String[] args) {

		final String USAGE = "\n" +
				"AddExampleEndpoint - Adds an example endpoint to an Amazon Pinpoint application." +
				"Usage: AddExampleEndpoint <applicationId>" +
				"Where:\n" +
				"  applicationId - The ID of the Amazon Pinpoint application to add the example " +
				"endpoint to.";

		if (args.length < 1) {
			System.out.println(USAGE);
			System.exit(1);
		}

		String applicationId = args[0];

		// The device token assigned to the user's device by Apple Push Notification
		// service (APNs).
		String deviceToken = "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7a8b9c0d1e2f";

		// Initializes an endpoint definition with channel type and address.
		EndpointRequest wangXiulansIphoneEndpoint = new EndpointRequest()
				.withChannelType(ChannelType.APNS)
				.withAddress(deviceToken);

		// Adds custom attributes to the endpoint.
		wangXiulansIphoneEndpoint.addAttributesEntry("interests", Arrays.asList(
				"technology",
				"music",
				"travel"));

		// Adds custom metrics to the endpoint.
		wangXiulansIphoneEndpoint.addMetricsEntry("technology_interest_level", 9.0);
		wangXiulansIphoneEndpoint.addMetricsEntry("music_interest_level", 6.0);
		wangXiulansIphoneEndpoint.addMetricsEntry("travel_interest_level", 4.0);

		// Adds standard demographic attributes.
		wangXiulansIphoneEndpoint.setDemographic(new EndpointDemographic()
				.withAppVersion("1.0")
				.withMake("apple")
				.withModel("iPhone")
				.withModelVersion("8")
				.withPlatform("ios")
				.withPlatformVersion("11.3.1")
				.withTimezone("America/Los_Angeles"));

		// Adds standard location attributes.
		wangXiulansIphoneEndpoint.setLocation(new EndpointLocation()
				.withCountry("US")
				.withCity("Seattle")
				.withPostalCode("98121")
				.withLatitude(47.61)
				.withLongitude(-122.33));

		// Initializes the Amazon Pinpoint client.
		AmazonPinpoint pinpointClient = AmazonPinpointClientBuilder.standard()
				.withRegion(Regions.US_EAST_1).build();

		// Updates or creates the endpoint with Amazon Pinpoint.
		UpdateEndpointResult result = pinpointClient.updateEndpoint(new UpdateEndpointRequest()
				.withApplicationId(applicationId)
				.withEndpointId("example_endpoint")
				.withEndpointRequest(wangXiulansIphoneEndpoint));

		System.out.format("Update endpoint result: %s\n", result.getMessageBody().getMessage());

	}
}
```

------
#### [ HTTP ]

Puoi utilizzare Amazon Pinpoint effettuando richieste HTTP direttamente alla REST API.

**Example Richiesta PUT per l'endpoint**  
Per aggiungere una richiesta di endpoint, invia una richiesta `PUT` alla risorsa [Endpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html) all'URI seguente:  
`/v1/apps/application-id/endpoints/endpoint-id`  
Dove:  
+ *application-id* è l'ID del progetto Amazon Pinpoint in cui vuoi aggiungere o aggiornare di un endpoint.
+ *endpoint-id* è l'ID che vuoi assegnare a un nuovo endpoint oppure l'ID di un endpoint esistente che vuoi aggiornare.
Nella richiesta, includi le intestazioni richieste e fornisci il codice [EndpointRequest](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html#apps-application-id-endpoints-endpoint-id-schemas)JSON come corpo:  

```
PUT /v1/apps/application_id/endpoints/example_endpoint HTTP/1.1
Host: pinpoint.us-east-1.amazonaws.com
X-Amz-Date: 20180415T182538Z
Content-Type: application/json
Accept: application/json
X-Amz-Date: 20180428T004705Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20180428/us-east-1/mobiletargeting/aws4_request, SignedHeaders=accept;content-length;content-type;host;x-amz-date, Signature=c25cbd6bf61bd3b3667c571ae764b9bf2d8af61b875cacced95d1e68d91b4170
Cache-Control: no-cache

{
  "ChannelType": "APNS",
  "Address": "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7a8b9c0d1e2f",
  "Attributes": {
    "Interests": [
      "Technology",
      "Music",
      "Travel"
    ]
  },
  "Metrics": {
    "technology_interest_level": 9.0,
    "music_interest_level": 6.0,
    "travel_interest_level": 4.0
  },
  "Demographic": {
    "AppVersion": "1.0",
    "Make": "apple",
    "Model": "iPhone",
    "ModelVersion": "8",
    "Platform": "ios",
    "PlatformVersion": "11.3.1",
    "Timezone": "America/Los_Angeles"
  },
  "Location": {
    "Country": "US",
    "City": "Seattle",
    "PostalCode": "98121",
    "Latitude": 47.61,
    "Longitude": -122.33
  }
}
```
Se la richiesta va a buon fine, riceverai una risposta analoga alla seguente:  

```
{
    "RequestID": "67e572ed-41d5-11e8-9dc5-db288f3cbb72",
    "Message": "Accepted"
}
```

------

## Informazioni correlate
<a name="audience-define-endpoints-related"></a>

Per ulteriori informazioni sulla risorsa Endpoint nell'API Amazon Pinpoint, compresi i metodi HTTP supportati e i parametri della richiesta, consulta [Endpoint](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-endpoints-endpoint-id.html) nella *documentazione di riferimento dell'API Amazon Pinpoint*.

Per ulteriori informazioni sulla personalizzazione dei messaggi con variabili, consulta la sezione relativa alle [variabili dei messaggi](https://docs.aws.amazon.com/pinpoint/latest/userguide/campaigns-message.html#campaigns-message-variables.html) nella *Guida per l'utente di Amazon Pinpoint*.

Per informazioni sulle quote applicabili agli endpoint, ad esempio il numero di attributi che è possibile assegnare, consulta [Quote per gli endpoint](quotas.md#quotas-endpoint).