Langkah 3: Kirim permintaan tambahan - Amazon Pinpoint

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Langkah 3: Kirim permintaan tambahan

Setelah selesai mengonfigurasi dan menguji Postman, Anda dapat mulai mengirim permintaan tambahan ke Amazon Pinpoint API. Bagian ini mencakup informasi yang harus Anda ketahui sebelum mulai mengirim permintaan. Ini juga mencakup dua permintaan sampel yang menjelaskan cara menggunakan koleksi Amazon Pinpoint.

penting

Saat Anda menyelesaikan prosedur di bagian ini, Anda mengirimkan permintaan ke Amazon Pinpoint API. Permintaan ini membuat sumber daya baru di akun Amazon Pinpoint Anda, mengubah sumber daya yang ada, mengirim pesan, mengubah konfigurasi proyek Amazon Pinpoint Anda, dan menggunakan fitur Amazon Pinpoint lainnya. Berhati-hatilah saat Anda melaksanakan permintaan ini.

Anda harus mengonfigurasi sebagian besar operasi dalam koleksi Amazon Pinpoint Postman sebelum Anda dapat menggunakannya. Untuk GET dan DELETE operasi, Anda biasanya hanya perlu memodifikasi variabel yang diatur pada tab Pra-permintaan Script.

catatan

Bila Anda menggunakan kebijakan IAM yang ditampilkan di Buat kebijakan IAM, Anda tidak dapat menjalankan DELETE permintaan apa pun yang disertakan dalam koleksi ini.

Misalnya, GetCampaign operasi mengharuskan Anda untuk menentukan a projectId dan acampaignId. Pada tab Pra-permintaan Script, kedua variabel ini hadir, dan diisi dengan nilai contoh. Hapus nilai contoh dan ganti dengan nilai yang berlaku untuk proyek dan kampanye Amazon Pinpoint Anda.

Dari variabel-variabel ini, yang paling umum digunakan adalah projectId variabel. Nilai untuk variabel ini harus menjadi pengidentifikasi unik untuk proyek yang permintaan Anda terapkan. Untuk mendapatkan daftar pengidentifikasi ini untuk proyek Anda, lihat respons terhadap GetApps permintaan yang Anda kirim pada langkah sebelumnya dari tutorial ini. Dalam tanggapan itu, Id bidang menyediakan pengenal unik untuk sebuah proyek. Untuk mempelajari lebih lanjut tentang GetApps operasi dan arti dari setiap bidang dalam respons, lihat Aplikasi di Referensi API Amazon Pinpoint.

catatan

Di Amazon Pinpoint, “proyek” sama dengan “aplikasi” atau “aplikasi”.

Untuk POST dan PUT operasi, Anda juga harus memodifikasi badan permintaan untuk menyertakan nilai yang ingin Anda kirim ke API. Misalnya, ketika Anda mengirimkan CreateApp permintaan, yang merupakan POST permintaan, Anda harus menentukan nama untuk proyek yang Anda buat. Anda dapat memodifikasi permintaan pada tab Tubuh. Dalam contoh ini, ganti nilai di sebelahnya "Name" dengan nama proyek. Jika Anda ingin menambahkan tag ke proyek, Anda dapat menentukannya di tags objek. Atau, jika Anda tidak ingin menambahkan tag, Anda dapat menghapus seluruh tags objek.

catatan

UntagResourceOperasi ini juga mengharuskan Anda untuk menentukan parameter URL. Anda dapat menentukan parameter ini pada tab Params. Ganti nilai di kolom VALUE dengan tag yang ingin Anda hapus untuk sumber daya yang ditentukan.

Sebelum Anda membuat segmen dan kampanye di Amazon Pinpoint, Anda harus terlebih dahulu membuat proyek. Di Amazon Pinpoint, sebuah proyek terdiri dari segmen, kampanye, konfigurasi, dan data yang disatukan oleh tujuan bersama. Misalnya, Anda dapat menggunakan proyek untuk memuat semua konten yang terkait dengan aplikasi tertentu, atau dengan merek atau inisiatif pemasaran tertentu. Saat Anda menambahkan informasi pelanggan ke Amazon Pinpoint, informasi tersebut terkait dengan proyek.

Untuk membuat proyek dengan mengirimkan permintaan CreateApp API

  1. Pada menu Lingkungan, pilih tempat Wilayah AWS Anda ingin membuat proyek.

    Menu Lingkungan terbuka yang menampilkan Wilayah yang tersedia.

    Dalam contoh ini, Postman telah dikonfigurasi sehingga menu Lingkungan menunjukkan empat opsi berikut:

    • AS Timur (Virginia Utara)

    • AS Barat (Oregon)

    • Eropa (Frankfurt)

    • Eropa (Irlandia)

  2. Di folder Aplikasi, pilih CreateAppoperasi>.

    Folder Apps dalam koleksi Amazon Pinpoint Postman.

    Folder Apps dalam koleksi Amazon Pinpoint Postman diperluas dan menampilkan permintaan berikut:

    • GetApp

    • GetApps

    • CreateApp

    • DeleteApp

  3. Pada tab Body, di samping"Name", ganti nilai placeholder ("string") dengan nama untuk kampanye, seperti. "MySampleProject"

  4. Hapus koma setelah nama kampanye, lalu hapus seluruh tags objek pada baris 3 hingga 5. Ketika Anda selesai, permintaan Anda harus menyerupai contoh yang ditampilkan dalam cuplikan kode berikut.

    {
    "Name": "MySampleProject"
}

    Postman dikonfigurasi untuk mengirim permintaan sebagai payload JSON mentah.

  5. Pilih Kirim. Jika kampanye berhasil dibuat, panel respons akan menampilkan status. 201 Created

    {
    "Name": "MySampleProject"
    "Id": "12345678901234567890123456789012",
    "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012",
    "tags": {}
}

Sangat umum untuk menggunakan Amazon Pinpoint SendMessages API untuk mengirim pesan transaksional. Salah satu keuntungan mengirim pesan dengan menggunakan SendMessages API sebagai lawan membuat kampanye, adalah Anda dapat mengirim pesan ke alamat apa pun, seperti alamat email, nomor telepon, atau token perangkat. Alamat yang Anda kirimi pesan tidak harus ada di akun Amazon Pinpoint Anda. Mari kita bandingkan metode ini dengan mengirim pesan dengan membuat kampanye. Sebelum mengirim kampanye di Amazon Pinpoint, Anda harus menambahkan titik akhir ke akun Amazon Pinpoint, membuat segmen, membuat kampanye, dan menjalankan kampanye.

Contoh di bagian ini menunjukkan cara mengirim pesan email transaksional langsung ke alamat email tertentu. Anda dapat mengubah permintaan ini untuk mengirim pesan melalui saluran lain, seperti SMS, push seluler, atau suara.

Untuk mengirim pesan email dengan mengirimkan permintaan SendMessages

  1. Verifikasi bahwa saluran email diaktifkan untuk proyek dan alamat email atau domain yang ingin Anda gunakan untuk mengirim dan menerima pesan dikonfigurasi. Untuk informasi selengkapnya, lihat Mengaktifkan dan menonaktifkan saluran email dan Memverifikasi identitas email di Panduan Pengguna Amazon Pinpoint.

    catatan

    Untuk menyelesaikan prosedur di bagian ini, Anda harus memverifikasi dan alamat email

  2. Pada menu Lingkungan, pilih Wilayah AWS yang ingin Anda kirimi pesan.

    Dalam contoh ini, Postman telah dikonfigurasi sehingga menu Lingkungan menunjukkan empat opsi berikut:

    • AS Timur (Virginia Utara)

    • AS Barat (Oregon)

    • Eropa (Frankfurt)

    • Eropa (Irlandia)

  3. Di folder Pesan, pilih SendMessagesoperasi.

    Folder Pesan dalam koleksi Amazon Pinpoint Postman. Isi folder diperluas, dan SendUsersMessages permintaan SendMessages dan ditampilkan.

  4. Pada tab Pra-permintaan Script, ganti nilai projectId variabel dengan ID proyek yang sudah ada di Wilayah yang Anda pilih di langkah 2 bagian ini.

  5. Pada tab Body, hapus permintaan contoh yang ditampilkan di editor permintaan. Tempel kode berikut:

    {
    "MessageConfiguration":{
        "EmailMessage":{
            "FromAddress":"sender@example.com",
            "SimpleEmail":{
                "Subject":{
                    "Data":"Sample Amazon Pinpoint message"
                },
                "HtmlPart":{
                    "Data":"<h1>Test message</h1><p>This is a sample message sent from <a href=\"https://aws.amazon.com/pinpoint\">Amazon Pinpoint</a> using the SendMessages API.</p>"
                },
                "TextPart":{
                    "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API."
                }
            }
        }
    },
    "Addresses":{
        "recipient@example.com": {
            "ChannelType": "EMAIL"
        }
    }
}

  6. Pada kode sebelumnya, ganti sender@example.com dengan alamat email terverifikasi Anda. Ganti recipient@example.com dengan alamat email terverifikasi yang ingin Anda kirimi pesan.

    catatan

    Jika akun Anda masih dalam kotak pasir email Amazon Pinpoint, Anda hanya dapat mengirim email ke alamat atau domain yang diverifikasi di akun Amazon Pinpoint Anda. Untuk informasi selengkapnya tentang menghapus akun Anda dari kotak pasir, lihat Meminta akses produksi untuk email di Panduan Pengguna Amazon Pinpoint.

  7. Pilih Kirim. Jika pesan berhasil dikirim, panel respons menampilkan status. 200 OK

    {
    "ApplicationId": "12345678901234567890123456789012",
    "RequestId": "<sampleValue>",
    "Result": {
        "recipient@example.com": {
            "DeliveryStatus": "SUCCESSFUL",
            "StatusCode": 200,
            "StatusMessage": "<sampleValue>",
            "MessageId": "<sampleValue>"
        }
    }
}