Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengaitkan pengguna dengan titik akhir Amazon Pinpoint
Endpoint dapat mencakup atribut yang mendefinisikan pengguna, yang mewakili seseorang di audiens Anda. Misalnya, pengguna mungkin mewakili seseorang yang menginstal aplikasi seluler Anda, atau seseorang yang memiliki akun di situs web Anda.
Anda menentukan pengguna dengan menentukan ID pengguna unik dan, secara opsional, atribut pengguna kustom. Jika seseorang menggunakan aplikasi Anda di beberapa perangkat, atau jika orang tersebut dapat mengirim pesan di beberapa alamat, Anda dapat menetapkan ID pengguna yang sama ke beberapa titik akhir. Dalam hal ini, Amazon Pinpoint menyinkronkan atribut pengguna di seluruh titik akhir. Jadi, jika Anda menambahkan atribut pengguna ke satu titik akhir, Amazon Pinpoint menambahkan atribut tersebut ke setiap titik akhir yang menyertakan ID pengguna yang sama.
Anda dapat menambahkan atribut pengguna untuk melacak data yang berlaku untuk individu dan tidak bervariasi berdasarkan perangkat yang digunakan orang tersebut. Misalnya, Anda dapat menambahkan atribut untuk nama, usia, atau status akun seseorang.
Jika aplikasi Anda menggunakan kumpulan pengguna Amazon Cognito untuk menangani autentikasi pengguna, Amazon Cognito dapat menambahkan ID pengguna dan atribut ke titik akhir Anda secara otomatis. Untuk nilai ID pengguna titik akhir, Amazon Cognito menetapkan nilai sub yang ditetapkan ke pengguna di kumpulan pengguna. Untuk mempelajari cara menambahkan pengguna dengan Amazon Cognito, lihat Menggunakan analitik pinpoint amazon dengan kumpulan pengguna amazon cognito di Panduan Pengembang Amazon Cognito.
Setelah Anda menambahkan definisi pengguna ke titik akhir Anda, Anda memiliki lebih banyak opsi untuk cara Anda mengelompokkan audiens Anda. Anda dapat menentukan segmen berdasarkan atribut pengguna, atau Anda dapat menentukan segmen dengan mengimpor daftar ID pengguna. Saat Anda mengirim pesan ke segmen yang didasarkan pada pengguna, tujuan potensial mencakup setiap titik akhir yang terkait dengan setiap pengguna di segmen tersebut.
Anda juga memiliki lebih banyak opsi untuk bagaimana Anda mengirim pesan kepada audiens Anda. Anda dapat menggunakan kampanye untuk mengirim pesan ke segmen pengguna, atau Anda dapat mengirim pesan langsung ke daftar ID pengguna. Untuk mempersonalisasi pesan, Anda dapat menyertakan variabel pesan yang diganti dengan nilai atribut pengguna.
Contoh
Contoh berikut menunjukkan cara menambahkan definisi pengguna ke titik akhir.
- AWS CLI
-
Anda dapat menggunakan Amazon Pinpoint dengan menjalankan perintah dengan file. AWS CLI
contoh Perbarui perintah titik akhir
Untuk menambahkan pengguna ke titik akhir, gunakan perintah update-endpoint. Untuk --endpoint-request parameter, Anda dapat menentukan titik akhir baru, yang dapat menyertakan pengguna. Atau, untuk memperbarui titik akhir yang ada, Anda hanya dapat memberikan atribut yang ingin Anda ubah. Contoh berikut menambahkan pengguna ke titik akhir yang ada dengan hanya menyediakan atribut pengguna:
$ aws pinpoint update-endpoint \
> --application-id application-id \
> --endpoint-id endpoint-id \
> --endpoint-request file://endpoint-request-file.json
Di mana:
-
application-id adalah ID proyek Amazon Pinpoint tempat Anda menambahkan atau memperbarui titik akhir.
-
endpoint-id adalah ID yang Anda tetapkan ke titik akhir baru, atau ID dari titik akhir yang ada yang Anda perbarui.
-
endpoint-request-file.json adalah path file ke file JSON lokal yang berisi input untuk parameter. --endpoint-request
contoh File permintaan titik akhir
update-endpointPerintah contoh menggunakan file JSON sebagai argumen untuk --endpoint-request parameter. File ini berisi definisi pengguna seperti berikut:
{
"User":{
"UserId":"example_user",
"UserAttributes":{
"FirstName":["Wang"],
"LastName":["Xiulan"],
"Gender":["Female"],
"Age":["39"]
}
}
}
Untuk atribut yang dapat Anda gunakan untuk mendefinisikan pengguna, lihat User objek dalam EndpointRequestskema di Referensi API Amazon Pinpoint.
- AWS SDK for Java
-
Anda dapat menggunakan Amazon Pinpoint API di aplikasi Java Anda dengan menggunakan klien yang disediakan oleh. AWS SDK for Java
contoh Kode
Untuk menambahkan pengguna ke titik akhir, inisialisasi EndpointRequest objek, dan meneruskannya ke updateEndpoint metode klien. AmazonPinpoint Anda dapat menggunakan objek ini untuk menentukan titik akhir baru, yang dapat menyertakan pengguna. Atau, untuk memperbarui titik akhir yang ada, Anda dapat memperbarui hanya properti yang ingin Anda ubah. Contoh berikut menambahkan pengguna ke endpoint yang ada dengan menambahkan EndpointUser objek ke EndpointRequest objek:
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.pinpoint.PinpointClient;
import software.amazon.awssdk.services.pinpoint.model.EndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.EndpointUser;
import software.amazon.awssdk.services.pinpoint.model.ChannelType;
import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointRequest;
import software.amazon.awssdk.services.pinpoint.model.UpdateEndpointResponse;
import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public static void updatePinpointEndpoint(PinpointClient pinpoint, String applicationId, String endPointId) {
try {
List<String> wangXiList = new ArrayList<>();
wangXiList.add("cooking");
wangXiList.add("running");
wangXiList.add("swimming");
Map myMapWang = new HashMap<>();
myMapWang.put("interests", wangXiList);
List<String> myNameWang = new ArrayList<>();
myNameWang.add("Wang ");
myNameWang.add("Xiulan");
Map wangName = new HashMap<>();
wangName.put("name", myNameWang);
EndpointUser wangMajor = EndpointUser.builder()
.userId("example_user_10")
.userAttributes(wangName)
.build();
// Create an EndpointBatchItem object for Mary Major.
EndpointRequest wangXiulanEndpoint = EndpointRequest.builder()
.channelType(ChannelType.EMAIL)
.address("wang_xiulan@example.com")
.attributes(myMapWang)
.user(wangMajor)
.build();
// Adds multiple endpoint definitions to a single request object.
UpdateEndpointRequest endpointList = UpdateEndpointRequest.builder()
.applicationId(applicationId)
.endpointRequest(wangXiulanEndpoint)
.endpointId(endPointId)
.build();
UpdateEndpointResponse result = pinpoint.updateEndpoint(endpointList);
System.out.format("Update endpoint result: %s\n", result.messageBody().message());
} catch (PinpointException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
Untuk contoh SDK lengkap, lihat AddExampleUser.java on. GitHub
- HTTP
-
Anda dapat menggunakan Amazon Pinpoint dengan membuat permintaan HTTP langsung ke REST API.
contoh Masukkan permintaan titik akhir dengan definisi pengguna
Untuk menambahkan pengguna ke titik akhir, keluarkan PUT permintaan ke sumber daya Endpoint di URI berikut:
/v1/apps/application-id/endpoints/endpoint-id
Di mana:
-
application-id adalah ID proyek Amazon Pinpoint tempat Anda menambahkan atau memperbarui titik akhir.
-
endpoint-id adalah ID yang Anda tetapkan ke titik akhir baru, atau ID dari titik akhir yang ada yang Anda perbarui.
Dalam permintaan Anda, sertakan header yang diperlukan, dan berikan EndpointRequestJSON sebagai badan. Badan permintaan dapat menentukan titik akhir baru, yang dapat menyertakan pengguna. Atau, untuk memperbarui titik akhir yang ada, Anda hanya dapat memberikan atribut yang ingin Anda ubah. Contoh berikut menambahkan pengguna ke titik akhir yang ada dengan hanya menyediakan atribut pengguna:
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
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20180501/us-east-1/mobiletargeting/aws4_request, SignedHeaders=accept;content-length;content-type;host;x-amz-date, Signature=c25cbd6bf61bd3b3667c571ae764b9bf2d8af61b875cacced95d1e68d91b4170
Cache-Control: no-cache
{
"User":{
"UserId":"example_user",
"UserAttributes":{
"FirstName":"Wang",
"LastName":"Xiulan",
"Gender":"Female",
"Age":"39"
}
}
}
Jika permintaan berhasil, Anda menerima tanggapan seperti berikut:
{
"RequestID": "67e572ed-41d5-11e8-9dc5-db288f3cbb72",
"Message": "Accepted"
}
Untuk informasi selengkapnya tentang sumber daya Endpoint di Amazon Pinpoint API, termasuk metode HTTP yang didukung dan parameter permintaan, lihat Endpoint di Referensi API Amazon Pinpoint.
Untuk informasi selengkapnya tentang mempersonalisasi pesan dengan variabel, lihat Variabel pesan di Panduan Pengguna Amazon Pinpoint.
Untuk mempelajari cara menentukan segmen dengan mengimpor daftar ID pengguna, lihat Mengimpor segmen di Panduan Pengguna Amazon Pinpoint.
Untuk informasi tentang mengirim pesan langsung ke hingga 100 ID pengguna, lihat Pesan pengguna di Referensi API Amazon Pinpoint.
Untuk informasi tentang kuota yang berlaku untuk titik akhir, termasuk jumlah atribut pengguna yang dapat Anda tetapkan, lihat. Kuota titik akhir
