Erstellen von Kampagnen

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, konfigurieren Sie Ihre Kampagne als A/B-Test. 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.

Weitere Informationen finden Sie unter Kampagnen im Amazon Pinpoint REST API Guide oder Campaigns im Amazon Pinpoint User Guide.

Erstellen von Standardkampagnen

Eine Standardkampagne sendet eine benutzerdefinierte Push-Benachrichtigung an ein bestimmtes Segment entsprechend einem von Ihnen festgelegten Zeitplan.

Erstellen von Kampagnen mit dem AWS SDK for Java

Das folgende Beispiel veranschaulicht das Erstellen einer Kampagne mit dem AWS SDK for Java. Ein Beispiel für die Erstellung eines Segments zur Weitergabe finden Sie unterErstellen von Segmenten.

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 Ihres ausgegebenIDE:

Campaign ID: b1c3de717aea4408a75bb3287a906b46

Das vollständige SDK Beispiel finden Sie unter CreateCampaign.java on GitHub.

Erstellen von A/B-Test-Kampagnen

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.

Erstellen von A/B-Testkampagnen mit dem AWS SDK for Java

Das folgende Beispiel veranschaulicht das Erstellen einer A/B-Test-Kampagne mit dem AWS SDK for Java.

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 Ihres IDE ausgegeben:

Campaign ID: b1c3de717aea4408a75bb3287a906b46