

**Hinweis zum Ende des Supports:** Am 30. Oktober 2026 AWS wird der Support für Amazon Pinpoint eingestellt. Nach dem 30. Oktober 2026 können Sie nicht mehr auf die Amazon-Pinpoint-Konsole oder die Amazon-Pinpoint-Ressourcen (Endpunkte, Segmente, Kampagnen, Journeys und Analytik) zugreifen. Weitere Informationen finden Sie unter [Ende des Amazon-Pinpoint-Supports](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Hinweis:** APIs In Bezug auf SMS sind Sprach-, mobile Push-, OTP- und Telefonnummernvalidierung von dieser Änderung nicht betroffen und werden von AWS End User Messaging unterstützt.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Programmgesteuertes Erstellen von Amazon Pinpoint Pinpoint-Kampagnen
<a name="campaigns"></a>

Um die Interaktion zwischen Ihrer App und deren Benutzer zu steigern, erstellen und verwalten Sie mit Amazon Pinpoint Push-Benachrichtigungskampagnen, die bestimmte Benutzersegmente erreichen.

Beispiel: Ihre Kampagne kann Benutzer, die die App seit längerem nicht ausgeführt haben, dazu anregen, zur App zurückzukehren, oder Benutzern, die seit einiger Zeit keinen Kauf mehr getätigt haben, Sonderangebote unterbreiten.

Eine Kampagne sendet eine maßgeschneiderte Nachricht an ein von Ihnen definiertes Benutzersegment. Die Kampagne kann die Nachricht an alle Benutzer im Segment senden oder Sie können unter den Benutzern einen Prozentsatz bestimmen, der keine Nachrichten erhält.

Sie können die Kampagne so planen, dass die Nachricht einmalig oder regelmäßig (z. B. einmal pro Woche) gesendet wird. Um zu verhindern, dass Benutzer die Meldung zu einem ungünstigen Zeitpunkt erhalten, kann der Zeitplan eine Leerlaufzeit umfassen, während der keine Nachrichten gesendet werden.

Um mit alternativen Kampagnenstrategien zu experimentieren, richten Sie Ihre Kampagne so ein, dass ein A/B test. An A/B Test zwei oder mehr Behandlungen der Nachricht oder des Zeitplans umfasst. Behandlungen sind Varianten der Nachricht oder des Zeitplans. Wenn die Benutzer auf die Kampagne reagieren, können Sie anhand der Kampagnen-Analysen die Effektivität jeder Behandlung vergleichen.

Weitere Informationen finden Sie unter [Kampagnen](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-campaigns.html) im *Amazon Pinpoint REST API-Leitfaden* oder [Kampagnen](https://docs.aws.amazon.com/pinpoint/latest/userguide/campaigns.html) im *Amazon Pinpoint Pinpoint-Benutzerhandbuch*.

# Erstellen Sie eine Amazon Pinpoint Pinpoint-Standardkampagne
<a name="campaigns-standard"></a>

Eine Standardkampagne sendet eine benutzerdefinierte Push-Benachrichtigung an ein bestimmtes Segment entsprechend einem von Ihnen festgelegten Zeitplan. Das folgende Beispiel veranschaulicht das Erstellen einer Kampagne mit dem AWS SDK für Java. Ein Beispiel für die Erstellung eines Segments zur Weitergabe finden Sie unter[Segmente in Amazon Pinpoint erstellen](segments-dimensional.md).

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.CampaignResponse;
import software.amazon.awssdk.services.pinpoint.model.Message;
import software.amazon.awssdk.services.pinpoint.model.Schedule;
import software.amazon.awssdk.services.pinpoint.model.Action;
import software.amazon.awssdk.services.pinpoint.model.MessageConfiguration;
import software.amazon.awssdk.services.pinpoint.model.WriteCampaignRequest;
import software.amazon.awssdk.services.pinpoint.model.CreateCampaignResponse;
import software.amazon.awssdk.services.pinpoint.model.CreateCampaignRequest;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
```

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.CampaignResponse;
import software.amazon.awssdk.services.pinpoint.model.Message;
import software.amazon.awssdk.services.pinpoint.model.Schedule;
import software.amazon.awssdk.services.pinpoint.model.Action;
import software.amazon.awssdk.services.pinpoint.model.MessageConfiguration;
import software.amazon.awssdk.services.pinpoint.model.WriteCampaignRequest;
import software.amazon.awssdk.services.pinpoint.model.CreateCampaignResponse;
import software.amazon.awssdk.services.pinpoint.model.CreateCampaignRequest;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;

/**
 * Before running this Java V2 code example, set up your development
 * environment, including your credentials.
 *
 * For more information, see the following documentation topic:
 *
 * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
 */
public class CreateCampaign {
    public static void main(String[] args) {

        final String usage = """

                Usage:   <appId> <segmentId>

                Where:
                  appId - The ID of the application to create the campaign in.
                  segmentId - The ID of the segment to create the campaign from.
                """;

        if (args.length != 2) {
            System.out.println(usage);
            System.exit(1);
        }

        String appId = args[0];
        String segmentId = args[1];
        PinpointClient pinpoint = PinpointClient.builder()
                .region(Region.US_EAST_1)
                .build();

        createPinCampaign(pinpoint, appId, segmentId);
        pinpoint.close();
    }

    public static void createPinCampaign(PinpointClient pinpoint, String appId, String segmentId) {
        CampaignResponse result = createCampaign(pinpoint, appId, segmentId);
        System.out.println("Campaign " + result.name() + " created.");
        System.out.println(result.description());
    }

    public static CampaignResponse createCampaign(PinpointClient client, String appID, String segmentID) {

        try {
            Schedule schedule = Schedule.builder()
                    .startTime("IMMEDIATE")
                    .build();

            Message defaultMessage = Message.builder()
                    .action(Action.OPEN_APP)
                    .body("My message body.")
                    .title("My message title.")
                    .build();

            MessageConfiguration messageConfiguration = MessageConfiguration.builder()
                    .defaultMessage(defaultMessage)
                    .build();

            WriteCampaignRequest request = WriteCampaignRequest.builder()
                    .description("My description")
                    .schedule(schedule)
                    .name("MyCampaign")
                    .segmentId(segmentID)
                    .messageConfiguration(messageConfiguration)
                    .build();

            CreateCampaignResponse result = client.createCampaign(CreateCampaignRequest.builder()
                    .applicationId(appID)
                    .writeCampaignRequest(request).build());

            System.out.println("Campaign ID: " + result.campaignResponse().id());
            return result.campaignResponse();

        } catch (PinpointException e) {
            System.err.println(e.awsErrorDetails().errorMessage());
            System.exit(1);
        }

        return null;
    }
}
```

Wenn Sie dieses Beispiel ausführen, wird Folgendes im Konsolenfenster Ihrer IDE ausgegeben:

```
Campaign ID: b1c3de717aea4408a75bb3287a906b46
```

Das vollständige SDK-Beispiel finden Sie unter [CreateCampaign.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javav2/example_code/pinpoint/src/main/java/com/example/pinpoint/CreateCampaign.java/) on [GitHub](https://github.com/).

# Erstellen Sie eine Amazon Pinpoint A/B Pinpoint-Testkampagne mit dem AWS SDK für Java
<a name="campaigns-abtest"></a>

Eine A/B Testkampagne verhält sich wie eine Standardkampagne, ermöglicht es Ihnen jedoch, unterschiedliche Behandlungen für die Kampagnennachricht oder den Kampagnenplan zu definieren. Dieser beinhaltet zwei oder mehr Behandlungen der Nachricht oder des Zeitplans. Behandlungen sind Varianten der Nachricht oder des Zeitplans. Wenn die Benutzer auf die Kampagne reagieren, können Sie anhand der Kampagnen-Analysen die Effektivität jeder Behandlung vergleichen.

Das folgende Beispiel zeigt, wie Sie eine A/B Testkampagne mit dem AWS SDK für Java erstellen.

```
import com.amazonaws.services.pinpoint.AmazonPinpointClient;
import com.amazonaws.services.pinpoint.model.Action;
import com.amazonaws.services.pinpoint.model.CampaignResponse;
import com.amazonaws.services.pinpoint.model.CreateCampaignRequest;
import com.amazonaws.services.pinpoint.model.CreateCampaignResult;
import com.amazonaws.services.pinpoint.model.Message;
import com.amazonaws.services.pinpoint.model.MessageConfiguration;
import com.amazonaws.services.pinpoint.model.Schedule;
import com.amazonaws.services.pinpoint.model.WriteCampaignRequest;
import com.amazonaws.services.pinpoint.model.WriteTreatmentResource;

import java.util.ArrayList;
import java.util.List;

public class PinpointCampaignSample {

    public CampaignResponse createAbCampaign(AmazonPinpointClient client, String appId, String segmentId) {
        Schedule schedule = new Schedule()
                .withStartTime("IMMEDIATE");

        // Default treatment.
        Message defaultMessage = new Message()
                .withAction(Action.OPEN_APP)
                .withBody("My message body.")
                .withTitle("My message title.");

        MessageConfiguration messageConfiguration = new MessageConfiguration()
                .withDefaultMessage(defaultMessage);

        // Additional treatments
        WriteTreatmentResource treatmentResource = new WriteTreatmentResource()
                .withMessageConfiguration(messageConfiguration)
                .withSchedule(schedule)
                .withSizePercent(40)
                .withTreatmentDescription("My treatment description.")
                .withTreatmentName("MyTreatment");

        List<WriteTreatmentResource> additionalTreatments = new ArrayList<WriteTreatmentResource>();
        additionalTreatments.add(treatmentResource);

        WriteCampaignRequest request = new WriteCampaignRequest()
                .withDescription("My description.")
                .withSchedule(schedule)
                .withSegmentId(segmentId)
                .withName("MyCampaign")
                .withMessageConfiguration(messageConfiguration)
                .withAdditionalTreatments(additionalTreatments)
                .withHoldoutPercent(10); // Hold out of A/B test

        CreateCampaignRequest createCampaignRequest = new CreateCampaignRequest()
                .withApplicationId(appId).withWriteCampaignRequest(request);

        CreateCampaignResult result = client.createCampaign(createCampaignRequest);

        System.out.println("Campaign ID: " + result.getCampaignResponse().getId());

        return result.getCampaignResponse();
    }

}
```

Wenn Sie dieses Beispiel ausführen, wird Folgendes im Konsolenfenster Ihrer IDE ausgegeben:

```
Campaign ID: b1c3de717aea4408a75bb3287a906b46
```