Halaman ini diterjemahkan oleh Cloud Translation API.

Meningkatkan model terlatih dengan data peristiwa klien

Cloud Talent Solution adalah layanan yang menghadirkan machine learning ke pengalaman penelusuran lowongan Anda, yang akan memberi pencari kerja akses ke hasil berkualitas tinggi yang jauh melampaui batasan metode berbasis kata kunci standar. Secara langsung, CTS menerapkan model relevansi dan ontologi pekerjaan/keterampilan ke detail pekerjaan Anda. Anda dapat meningkatkan hasil yang ditampilkan kepada pencari pekerjaan dengan merekam peristiwa klien berdasarkan aktivitas pencari kerja.

Merekam peristiwa klien menggunakan `createClientEventRequest`

Saat pencari kerja melakukan tindakan tertentu, Anda dapat menggunakan Penelusuran Lowongan untuk merekam tindakan tersebut. Misalnya, pencari kerja atau entitas lain yang berinteraksi dengan layanan telah memiliki lowongan (atau daftar lowongan) yang dirender dalam tampilan mereka, seperti dalam daftar hasil penelusuran dalam format yang dikompresi atau terpotong. Anda dapat mengirim peristiwa KESAN ke Cloud Talent Solution untuk memberikan data tentang konteks penelusuran dan hasil yang dapat dilihat oleh pencari kerja. Saat pencari kerja mengklik hasil lowongan untuk melihat deskripsi lowongan lengkap, Anda dapat mengirim peristiwa VIEW yang mendaftarkan minat pencari kerja pada posisi yang dipilih.

Contoh berikut mengilustrasikan cara mengirim pesan ke Cloud Talent Solution menggunakan API. Pencari kerja atau entitas lain yang berinteraksi dengan layanan telah memiliki lowongan (atau daftar lowongan) yang dirender dalam tampilan mereka, seperti dalam daftar hasil penelusuran dalam format yang dikompresi atau terpotong. Peristiwa ini biasanya dikaitkan dengan pencari kerja yang melihat daftar lowongan di satu halaman.

Go

Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat Library klien CTS. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi CTS Go API.

Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

import (
	"context"
	"fmt"
	"io"
	"time"

	talent "cloud.google.com/go/talent/apiv4beta1"
	"cloud.google.com/go/talent/apiv4beta1/talentpb"
	"github.com/golang/protobuf/ptypes"
)

// createClientEvent creates a client event.
func createClientEvent(w io.Writer, projectID string, requestID string, eventID string, relatedJobNames []string) (*talentpb.ClientEvent, error) {
	ctx := context.Background()

	// Create an eventService client.
	c, err := talent.NewEventClient(ctx)
	if err != nil {
		return nil, fmt.Errorf("talent.NewEventClient: %w", err)
	}
	defer c.Close()

	createTime, _ := ptypes.TimestampProto(time.Now())
	clientEventToCreate := &talentpb.ClientEvent{
		RequestId:  requestID,
		EventId:    eventID,
		CreateTime: createTime,
		Event: &talentpb.ClientEvent_JobEvent{
			JobEvent: &talentpb.JobEvent{
				Type: talentpb.JobEvent_VIEW,
				Jobs: relatedJobNames,
			},
		},
	}

	// Construct a createJob request.
	req := &talentpb.CreateClientEventRequest{
		Parent:      fmt.Sprintf("projects/%s", projectID),
		ClientEvent: clientEventToCreate,
	}

	resp, err := c.CreateClientEvent(ctx, req)
	if err != nil {
		return nil, fmt.Errorf("CreateClientEvent: %w", err)
	}

	fmt.Fprintf(w, "Client event created: %v\n", resp.GetEvent())

	return resp, nil
}

Java

Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat Library klien CTS. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi CTS Java API.

Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.


import com.google.cloud.talent.v4beta1.ClientEvent;
import com.google.cloud.talent.v4beta1.CreateClientEventRequest;
import com.google.cloud.talent.v4beta1.EventServiceClient;
import com.google.cloud.talent.v4beta1.JobEvent;
import com.google.cloud.talent.v4beta1.TenantName;
import com.google.protobuf.Timestamp;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;

public class JobSearchCreateClientEvent {

  public static void createClientEvent() throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "your-project-id";
    String tenantId = "your-tenant-id";
    String requestId = "your-req-id-from-response-metadata";
    String eventId = "your-unique-identifier-id";
    createClientEvent(projectId, tenantId, requestId, eventId);
  }

  // Creates a client event.
  public static void createClientEvent(
      String projectId, String tenantId, String requestId, String eventId) throws IOException {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests. After completing all of your requests, call
    // the "close" method on the client to safely clean up any remaining background resources.
    try (EventServiceClient eventServiceClient = EventServiceClient.create()) {
      TenantName parent = TenantName.of(projectId, tenantId);

      // The timestamp of the event as seconds of UTC time since Unix epoch
      // For more information on how to create google.protobuf.Timestamps
      // See:
      // https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
      long seconds = 3L;
      Timestamp createTime = Timestamp.newBuilder().setSeconds(seconds).build();

      // The type of event attributed to the behavior of the end user
      JobEvent.JobEventType type = JobEvent.JobEventType.VIEW;

      // List of job names associated with this event
      String jobsElement = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]";
      String jobsElement2 = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]";

      List<String> jobs = Arrays.asList(jobsElement, jobsElement2);
      JobEvent jobEvent = JobEvent.newBuilder().setType(type).addAllJobs(jobs).build();
      ClientEvent clientEvent =
          ClientEvent.newBuilder()
              .setRequestId(requestId)
              .setEventId(eventId)
              .setCreateTime(createTime)
              .setJobEvent(jobEvent)
              .build();
      CreateClientEventRequest request =
          CreateClientEventRequest.newBuilder()
              .setParent(parent.toString())
              .setClientEvent(clientEvent)
              .build();
      ClientEvent response = eventServiceClient.createClientEvent(request);
      System.out.println("Created client event. ");
      System.out.println(response.toString());
    }
  }
}

Node.js

Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat Library klien CTS. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi CTS Node.js API.

Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.


const talent = require('@google-cloud/talent').v4;

/**
 * Creates a client event
 *
 * @param projectId {string} Your Google Cloud Project ID
 * @param tenantId {string} Identifier of the Tenant
 * @param requestId {string} A unique ID generated in the API responses.
 * Value should be set to the request_id from an API response.
 * @param eventId {string} A unique identifier, generated by the client application
 */
function sampleCreateClientEvent(projectId, tenantId, requestId, eventId) {
  const client = new talent.EventServiceClient();
  // const projectId = 'Your Google Cloud Project ID';
  // const tenantId = 'Your Tenant ID (using tenancy is optional)';
  // const requestId = '[request_id from ResponseMetadata]';
  // const eventId = '[Set this to a unique identifier]';
  const formattedParent = client.tenantPath(projectId, tenantId);

  // The timestamp of the event as seconds of UTC time since Unix epoch
  // For more information on how to create google.protobuf.Timestamps
  // See: https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
  const seconds = 0;
  const createTime = {
    seconds: seconds,
  };

  // The type of event attributed to the behavior of the end user
  const type = 'VIEW';

  // List of job names associated with this event
  const jobsElement = 'projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]';
  const jobsElement2 =
    'projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]';
  const jobs = [jobsElement, jobsElement2];
  const jobEvent = {
    type: type,
    jobs: jobs,
  };
  const clientEvent = {
    requestId: requestId,
    eventId: eventId,
    createTime: createTime,
    jobEvent: jobEvent,
  };
  const request = {
    parent: formattedParent,
    clientEvent: clientEvent,
  };
  client
    .createClientEvent(request)
    .then(responses => {
      const response = responses[0];
      console.log('Created client event');
      console.log(`Response: ${response}`);
    })
    .catch(err => {
      console.error(err);
    });
}

Python

Untuk mempelajari cara menginstal dan menggunakan library klien untuk CTS, lihat Library klien CTS. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi CTS Python API.

Untuk melakukan autentikasi ke CTS, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, baca Menyiapkan autentikasi untuk lingkungan pengembangan lokal.


from google.cloud import talent
from google.cloud.talent import enums


def create_client_event(project_id, tenant_id, request_id, event_id):
    """
    Creates a client event

    Args:
      project_id Your Google Cloud Project ID
      tenant_id Identifier of the Tenant
      request_id A unique ID generated in the API responses.
      Value should be set to the request_id from an API response.
      event_id A unique identifier, generated by the client application
    """

    client = talent.EventServiceClient()

    # project_id = 'Your Google Cloud Project ID'
    # tenant_id = 'Your Tenant ID (using tenancy is optional)'
    # request_id = '[request_id from ResponseMetadata]'
    # event_id = '[Set this to a unique identifier]'

    if isinstance(project_id, bytes):
        project_id = project_id.decode("utf-8")
    if isinstance(tenant_id, bytes):
        tenant_id = tenant_id.decode("utf-8")
    if isinstance(request_id, bytes):
        request_id = request_id.decode("utf-8")
    if isinstance(event_id, bytes):
        event_id = event_id.decode("utf-8")
    parent = f"projects/{project_id}/tenants/{tenant_id}"

    # The timestamp of the event as seconds of UTC time since Unix epoch
    # For more information on how to create google.protobuf.Timestamps
    # See:
    # https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/timestamp.proto
    seconds = 0
    create_time = {"seconds": seconds}

    # The type of event attributed to the behavior of the end user
    type_ = enums.JobEvent.JobEventType.VIEW

    # List of job names associated with this event
    jobs_element = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
    jobs_element_2 = "projects/[Project ID]/tenants/[Tenant ID]/jobs/[Job ID]"
    jobs = [jobs_element, jobs_element_2]
    job_event = {"type": type_, "jobs": jobs}
    client_event = {
        "request_id": request_id,
        "event_id": event_id,
        "create_time": create_time,
        "job_event": job_event,
    }

    response = client.create_client_event(parent=parent, client_event=client_event)
    print(response)

Pesan acara

Kolom wajib diisi:

eventId (Ditetapkan pelanggan): Setiap pesan yang dikirim ke Cloud Talent Solution harus memiliki eventId unik. Sebagai praktik terbaik, sertakan stempel waktu saat menentukan kolom ini untuk memastikan tidak ada duplikat. Panjang maksimum kolom ini adalah 255 karakter.
requestId: Nilai requestId yang ditampilkan oleh objek respons penelusuran. Nilai ini unik untuk panggilan API SearchJobsRequest tertentu. Ini digunakan untuk semua pesan berikutnya yang berasal dari peristiwa IMPRESSION penelusuran asli. Saat panggilan API SearchJobsRequest baru dilakukan (misalnya: pencari lowongan membuka halaman hasil berikutnya), requestId akan berubah.
createTime Stempel waktu peristiwa (dalam format Stempel waktu, akurat hingga nanodetik. Stempel waktu ini harus mencerminkan waktu terjadinya peristiwa, bukan waktu pesan dikirim.
Kolom union event: Objek jobEvent digunakan dengan fitur Penelusuran Lowongan dan dikeluarkan saat pencari kerja berinteraksi dengan layanan.

Contoh pesan peristiwa

Panggilan API dalam contoh kode di atas akan menghasilkan pesan JSON dalam format berikut:

JSON

{ "requestId": string, "eventId": string, "createTime": string, "eventNotes": string,

// Union field event can be only be a jobEvent: "jobEvent": { object (JobEvent) }, // End of list of possible types for union field event. }

Skenario dan alur kerja

Berikut adalah dua contoh skenario pencari kerja yang menelusuri, melihat, dan melamar pekerjaan.

Alur kerja 1

Pencari kerja melakukan penelusuran. Misalnya: Product mgr SF

Hasil penelusuran ditampilkan kepada pencari kerja.

Objek respons penelusuran lowongan yang dikirim kembali ke server pelanggan berisi requestId unik (misalnya: 8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==). Gunakan requestId ini untuk semua pesan mendatang yang terkait dengan panggilan API SearchJobsRequest tertentu ini.

Kirim pesan IMPRESSION ke Cloud Talent Solution.

Contoh pesan peristiwa:
```
{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID1",
  "createTime": "2018-12-19T16:39:57-08:00",
  "jobEvent":
  {"type":"IMPRESSION",
  "jobs":["jobs/4000000000", "jobs/4000000001","jobs/4000000002",
  "jobs/4000000003", "jobs/4000000004"]}
}
```

Pencari kerja memilih hasil (postingan lowongan) untuk melihat detail lengkap lowongan tersebut.

Kirim pesan VIEW ke Cloud Talent Solution.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID2",
  "createTime": "2018-12-19T16:40:57-08:00",
  "jobEvent":
  {"type":"VIEW",
  "jobs":["jobs/4000000000"]}

}

Pencari kerja melamar ke postingan lowongan yang dilihat.

a. Jika pencari kerja dialihkan ke halaman dalam domain yang sama (halaman aplikasi internal), kirim pesan APPLICATION_START ke Cloud Talent Solution.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID3",
  "createTime": "2018-12-19T16:41:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_START",
"jobs":["jobs/4000000000"]}
}

b. Jika pencari kerja dialihkan ke halaman aplikasi eksternal, kirim pesan APPLICATION_REDIRECT ke Cloud Talent Solution.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID3",
  "createTime": "2018-12-19T16:41:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_REDIRECT",
  "jobs":["jobs/4000000000"]}

}

Saat pencari kerja menyelesaikan lamaran internal, kirim pesan APPLICATION_FINISH ke Cloud Talent Solution:

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID4",
  "createTime": "2018-12-19T16:43:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_FINISH",
  "jobs":["jobs/4000000000"]}

}

Pencari kerja kembali ke hasil penelusuran dan melanjutkan ke halaman 2 (atau melanjutkan ke halaman 2 tanpa mengklik postingan lowongan).

Kirim pesan IMPRESSION ke Cloud Talent Solution dengan kumpulan hasil berikutnya dari halaman 2. Catatan: Ada requestId baru yang dihasilkan dalam respons panggilan API SearchJobsRequest yang menghasilkan halaman kedua hasil. (misalnya, 99e5b99c-f1ba-4f85-b17d-ccf878f451f9:APAb7IRESj+/Hzwa3bBd54P3qPx2yOWm5w==).
```
{
  "requestId": "99e5b99c-f1ba-4f85-b17d-ccf878f451f9:APAb7IRESj+/Hzwa3bBd54P3qPx2yOWm5w==",
  "eventId": "ID5",
  "createTime": "2018-12-19T18:39:57-08:00",
  "jobEvent":
  {"type":"IMPRESSION",
  "jobs":["jobs/4000000005", "jobs/4000000006","jobs/4000000007",
  "jobs/4000000008", "jobs/4000000009"]}
}
```

Pencari kerja melanjutkan ke halaman 3 hasil penelusuran.

Kirim pesan IMPRESSION ke Cloud Talent Solution dengan kumpulan hasil berikutnya. CATATAN: Ada requestId baru (misalnya, e2d2b916-78c3-4c65-aecc-d8452bc0afb0:APAb7IRvCsNPiRXYkgF8PN5e8BkbFzKOyg==).

{
  "requestId": "e2d2b916-78c3-4c65-aecc-d8452bc0afb0:APAb7IRvCsNPiRXYkgF8PN5e8BkbFzKOyg==",
  "eventId": "ID6",
  "createTime": "2018-12-19T16:41:57-08:00",
  "jobEvent":
  {"type":"IMPRESSION",
  "jobs":["jobs/4000000010", "jobs/4000000011","jobs/4000000012",
  "jobs/400000013", "jobs/4000000014"]}
}

Alur kerja 2

Pencari kerja melakukan penelusuran. Misalnya: Product mgr SF

Hasil penelusuran ditampilkan kepada pencari kerja.

Objek respons penelusuran lowongan berisi requestId unik (misalnya: a2179a9b-cf73-413e-8076-98af08b991ad). Gunakan requestId ini untuk semua pesan mendatang yang terkait dengan panggilan API SearchJobsRequest ini.

Kirim pesan IMPRESSION ke Cloud Talent Solution.
```
{
  "requestId": "a2179a9b-cf73-413e-8076-98af08b991ad",
  "eventId": "ID1",
  "createTime": "2018-12-19T16:39:57-08:00",
  "jobEvent":
  {"type":"IMPRESSION",
  "jobs":["jobs/4000000000", "jobs/4000000001","jobs/4000000002",
  "jobs/4000000003", "jobs/4000000004"]}
}
```

Pencari kerja memilih hasil (postingan lowongan) untuk melihat detail lengkap lowongan tersebut.

Kirim pesan VIEW ke Cloud Talent Solution.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID2",
  "createTime": "2018-12-19T16:40:57-08:00",
  "jobEvent":
  {"type":"VIEW",
  "jobs":["jobs/4000000000"]}
}

Pencari kerja melakukan lamaran sekali klik ke suatu lowongan, seperti yang diuraikan dalam APPLICATION_QUICK_SUBMISSION.

Kirim pesan APPLICATION_QUICK_SUBMISSION ke Cloud Talent Solution dengan kumpulan hasil berikutnya.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID3",
  "createTime": "2018-12-19T16:41:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_QUICK_SUBMISSION",
  "jobs":["jobs/4000000000"]}
 }

Pencari kerja melakukan tindakan berikut.

a. Pencari kerja kembali ke hasil penelusuran dan melamar pekerjaan langsung dari halaman hasil penelusuran. Proses permohonan adalah proses yang lebih lama daripada yang ditentukan dalam APPLICATION_QUICK_SUBMISSION (yaitu, proses permohonan multi-langkah).

Kirim pesan APPLICATION_START_FROM_SERP ke Cloud Talent Solution.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID4",
  "createTime": "2018-12-19T16:43:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_START_FROM_SERP",
  "jobs":["jobs/4000000000"]}
}

b. Pencari kerja menyelesaikan lamaran pekerjaan. Kirim pesan APPLICATION_FINISH ke Cloud Talent Solution.

{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID5",
  "createTime": "2018-12-19T16:44:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_FINISH",
  "jobs":["jobs/4000000000"]}
}

Pencari kerja kembali ke hasil penelusuran dan melamar pekerjaan langsung dari halaman hasil penelusuran. Proses permohonan mengalihkan pencari kerja ke domain lain yang berada di luar situs tenant (permohonan eksternal) yang tidak dapat digunakan untuk melacak progres pelamar.

Kirim pesan APPLICATION_REDIRECT_FROM_SERP ke Cloud Talent Solution.
```
{
  "requestId": "8d2bdd5d-1361-42a5-a0fd-bd2b58b7d8fb:APAb7ISd4Sc5faibw2V5hTU/OoC2WAW5AA==",
  "eventId": "ID6",
  "createTime": "2018-12-19T16:45:57-08:00",
  "jobEvent":
  {"type":"APPLICATION_START_FROM_SERP",
  "jobs":["jobs/4000000001"]}
}
```
Hal ini berbeda dengan APPLICATION_REDIRECT saat pencari kerja berada di halaman deskripsi lowongan saat dialihkan.

Memverifikasi penerapan peristiwa klien

Cloud Talent Solution menyediakan alat layanan mandiri yang dapat Anda gunakan untuk memverifikasi penerapan peristiwa klien. Lihat alat pengelolaan untuk mengetahui informasi selengkapnya tentang opsi layanan mandiri yang tersedia.

Meningkatkan model terlatih dengan data peristiwa klien

Merekam peristiwa klien menggunakan createClientEventRequest

Go

Java

Node.js

Python

Pesan acara

Contoh pesan peristiwa

JSON

Skenario dan alur kerja

Alur kerja 1

Alur kerja 2

Memverifikasi penerapan peristiwa klien

Merekam peristiwa klien menggunakan `createClientEventRequest`