

 适用于 Java 的 Amazon SDK 1.x 已于 2025 年 12 月 31 日终止支持。我们建议您迁移到 [Amazon SDK for Java 2.x](https://docs.amazonaws.cn/sdk-for-java/latest/developer-guide/home.html) 以继续获得新功能、可用性改进和安全更新。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Pinpoint 中创建市场活动
<a name="examples-pinpoint-create-campaign"></a>

您可以使用市场活动来帮助增加应用程序与用户之间的互动。您可以创建市场活动，通过定制消息或特殊促销吸引特定的用户分段。此示例演示如何创建新的标准市场活动，以向特定的分段发送自定义推送消息。

## 创建市场活动
<a name="create-a-campaign"></a>

创建新的市场活动之前，您必须定义[计划](https://docs.amazonaws.cn/sdk-for-java/v1/reference/com/amazonaws/services/pinpoint/model/Schedule.html)和[消息](https://docs.amazonaws.cn/sdk-for-java/v1/reference/com/amazonaws/services/pinpoint/model/Message.html)，并在 [WriteCampaignRequest](https://docs.amazonaws.cn/sdk-for-java/v1/reference/com/amazonaws/services/pinpoint/model/WriteCampaignRequest.html) 对象中设置这些值。

 **导入**。

```
import com.amazonaws.services.pinpoint.AmazonPinpoint;
import com.amazonaws.services.pinpoint.AmazonPinpointClientBuilder;
import com.amazonaws.services.pinpoint.model.CreateCampaignRequest;
import com.amazonaws.services.pinpoint.model.CreateCampaignResult;
import com.amazonaws.services.pinpoint.model.Action;
import com.amazonaws.services.pinpoint.model.CampaignResponse;
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;
```

 **代码** 

```
Schedule schedule = new Schedule()
        .withStartTime("IMMEDIATE");

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

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

WriteCampaignRequest request = new WriteCampaignRequest()
        .withDescription("My description.")
        .withSchedule(schedule)
        .withSegmentId(segmentId)
        .withName("MyCampaign")
        .withMessageConfiguration(messageConfiguration);
```

然后通过将具有市场活动配置的 Amazon PinpointWriteCampaignRequest[ 提供给 ](https://docs.amazonaws.cn/sdk-for-java/v1/reference/com/amazonaws/services/pinpoint/model/WriteCampaignRequest.html)CreateCampaignRequest[ 对象，在 ](https://docs.amazonaws.cn/AWSJavaSDK/latest/javadoc/com/amazonaws/services/pinpoint/model/CreateCampaignRequest.html) 中创建新的市场活动。最后，将 CreateCampaignRequest 对象传递到 AmazonPinpointClient 的 `createCampaign` 方法。

 **代码** 

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

CreateCampaignResult result = client.createCampaign(createCampaignRequest);
```

请参阅 GitHub 上的[完整示例](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/java/example_code/pinpoint/src/main/java/com/example/pinpoint/CreateApp.java)。

## 更多信息
<a name="more-information"></a>
+  《Amazon Pinpoint User Guide》中的 [Amazon Pinpoint Campaigns](https://docs.amazonaws.cn/pinpoint/latest/userguide/campaigns.html)
+  《Amazon Pinpoint Developer Guide》中的 [Creating Campaigns](https://docs.amazonaws.cn/pinpoint/latest/developerguide/campaigns.html)。
+  《Amazon Pinpoint API Reference》中的 [Campaigns](https://docs.amazonaws.cn/pinpoint/latest/apireference/rest-api-campaigns.html)
+  《Amazon Pinpoint API Reference》中的 [Campaign](https://docs.amazonaws.cn/pinpoint/latest/apireference/rest-api-campaign.html)
+  《Amazon Pinpoint API Reference》中的 [Campaign Activities](https://docs.amazonaws.cn/pinpoint/latest/apireference/rest-api-campaign-activities.html)
+  《Amazon Pinpoint API Reference》中的 [Campaign Versions](https://docs.amazonaws.cn/pinpoint/latest/apireference/rest-api-campaign-versions.html)
+  《Amazon Pinpoint API Reference》中的 [Campaign Version](https://docs.amazonaws.cn/pinpoint/latest/apireference/rest-api-campaign-version.html)