**支援終止通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon Pinpoint 中建置客群
若要聯繫行銷活動的目標對象，請根據您的應用程式所報告的資料來建置客群。例如，若要聯繫最近沒有使用您的應用程式的使用者，您可以為過去 30 天沒有使用您的應用程式的使用者，定義一個客群。
如需更多程式碼範例，請參閱[程式碼範例](https://docs.aws.amazon.com/pinpoint/latest/developerguide/service_code_examples.html)。
## 使用 建置客群 適用於 Java 的 AWS SDK
以下範例示範如何使用 適用於 Java 的 AWS SDK建置客群。此範例會建立團隊是 `Lakers`且在過去 30 天內處於作用中狀態的使用者客群。建立客群後，您就可以將其用作行銷活動或旅程的一部分。如需搭配行銷活動使用客群的範例，請參閱 [以程式設計方式建立 Amazon Pinpoint 行銷活動](campaigns.md)。
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.AttributeDimension;
import software.amazon.awssdk.services.pinpoint.model.SegmentResponse;
import software.amazon.awssdk.services.pinpoint.model.AttributeType;
import software.amazon.awssdk.services.pinpoint.model.RecencyDimension;
import software.amazon.awssdk.services.pinpoint.model.SegmentBehaviors;
import software.amazon.awssdk.services.pinpoint.model.SegmentDemographics;
import software.amazon.awssdk.services.pinpoint.model.SegmentLocation;
import software.amazon.awssdk.services.pinpoint.model.SegmentDimensions;
import software.amazon.awssdk.services.pinpoint.model.WriteSegmentRequest;
import software.amazon.awssdk.services.pinpoint.model.CreateSegmentRequest;
import software.amazon.awssdk.services.pinpoint.model.CreateSegmentResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.HashMap;
import java.util.Map;
```
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.AttributeDimension;
import software.amazon.awssdk.services.pinpoint.model.SegmentResponse;
import software.amazon.awssdk.services.pinpoint.model.AttributeType;
import software.amazon.awssdk.services.pinpoint.model.RecencyDimension;
import software.amazon.awssdk.services.pinpoint.model.SegmentBehaviors;
import software.amazon.awssdk.services.pinpoint.model.SegmentDemographics;
import software.amazon.awssdk.services.pinpoint.model.SegmentLocation;
import software.amazon.awssdk.services.pinpoint.model.SegmentDimensions;
import software.amazon.awssdk.services.pinpoint.model.WriteSegmentRequest;
import software.amazon.awssdk.services.pinpoint.model.CreateSegmentRequest;
import software.amazon.awssdk.services.pinpoint.model.CreateSegmentResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.HashMap;
import java.util.Map;
/**
* 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 CreateSegment {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
appId - The application ID to create a segment for.
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String appId = args[0];
PinpointClient pinpoint = PinpointClient.builder()
.region(Region.US_EAST_1)
.build();
SegmentResponse result = createSegment(pinpoint, appId);
System.out.println("Segment " + result.name() + " created.");
System.out.println(result.segmentType());
pinpoint.close();
}
public static SegmentResponse createSegment(PinpointClient client, String appId) {
try {
Map segmentAttributes = new HashMap<>();
segmentAttributes.put("Team", AttributeDimension.builder()
.attributeType(AttributeType.INCLUSIVE)
.values("Lakers")
.build());
RecencyDimension recencyDimension = RecencyDimension.builder()
.duration("DAY_30")
.recencyType("ACTIVE")
.build();
SegmentBehaviors segmentBehaviors = SegmentBehaviors.builder()
.recency(recencyDimension)
.build();
SegmentDemographics segmentDemographics = SegmentDemographics
.builder()
.build();
SegmentLocation segmentLocation = SegmentLocation
.builder()
.build();
SegmentDimensions dimensions = SegmentDimensions
.builder()
.attributes(segmentAttributes)
.behavior(segmentBehaviors)
.demographic(segmentDemographics)
.location(segmentLocation)
.build();
WriteSegmentRequest writeSegmentRequest = WriteSegmentRequest.builder()
.name("MySegment")
.dimensions(dimensions)
.build();
CreateSegmentRequest createSegmentRequest = CreateSegmentRequest.builder()
.applicationId(appId)
.writeSegmentRequest(writeSegmentRequest)
.build();
CreateSegmentResponse createSegmentResult = client.createSegment(createSegmentRequest);
System.out.println("Segment ID: " + createSegmentResult.segmentResponse().id());
System.out.println("Done");
return createSegmentResult.segmentResponse();
} catch (PinpointException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
return null;
}
}
```
執行此範例時，下列內容會列印至 IDE 的主控台視窗：
```
Segment ID: 09cb2967a82b4a2fbab38fead8d1f4c4
```
如需完整的 SDK 範例，請參閱 [GitHub](https://github.com/) 上的 [CreateSegment.java](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javav2/example_code/pinpoint/src/main/java/com/example/pinpoint/CreateSegment.java)。