İşlemlerinizin bağlantısı (Dialogflow)

İşlem başına doğrudan, belirli bir Action'a bağlanacak bir URL oluşturabilirsiniz. Bir web tarayıcısında veya mobil tarayıcıda Asistan bağlantısını (daha önce İşlem bağlantıları olarak adlandırılıyordu) tıklayan kullanıcılar, cihazlarındaki Asistan'a yönlendirilir ve buradaki ilgili Action'ınızla doğrudan etkileşim kurarlar.

Faydalı Asistan bağlantılarından bazıları:

  • Kullanıcıları bir "Nasıl yapılır?" web sitesindeki sesli talimatlarla buluşturma.
  • "Yardım alın" sayfasından kullanıcıları müşteri desteği deneyimine bağlama
  • Gelecekteki güncellemelere kaydolmaları için kullanıcıları bir güncelleme amacına bağlamak.

Bir işleme yönelik URL oluşturmak için aşağıdakileri yapın:

  1. Actions Console'da Geliştirme > İşlemler'e gidin.
  2. Bağlantı oluşturmak istediğiniz işlemi tıklayın.
  3. Bağlantılar bölümünde Bu İşlem için bir URL'yi etkinleştirmek istiyor musunuz? seçeneğini etkinleştirin.
  4. Bir Bağlantı başlığı girin. Bu başlık, Action'ın ne yapacağını açıklayan bir fiil içermelidir. Örneğin, Action'ın bir konser bileti satın almak için kullanıcıyı bir işlem akışına açarsa kullanışlı bir bağlantı başlığı "konser bileti satın al" olur.
  5. Kaydet'i tıklayın.

Sağlanan URL'yi kopyalayıp, kullanıcıları bu belirli İşlemlere yönlendirmek istediğiniz her yere referans verebilirsiniz.

Asistan bağlantıları, URL'de isteğe bağlı olarak bir niyet ve parametre içerebilir. Google, parametreleri URL'de belirtilen amaç türüne göre işler.

Bir Asistan bağlantısının URL'sinin genel söz dizimi aşağıdaki gibidir:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

Ayarlayabileceğiniz URL parametreleri aşağıdaki tabloda açıklanmıştır:

URL parametresi Açıklama
$action_id İşlemin sayısal tanımlayıcısı.
$intent Yerleşik veya özel niyetin tam adı.
$param İşlem paketinde belirtilen intent parametresinin tam adı.
$value İşlem paketinde $param için tanımlanan türün URL kodlamalı değeri.
$utm_param Bir veya daha fazla UTM parametresi türü listesi. Geçerli değerler şunları içerir: utm_source, utm_medium, utm_campaign, utm_term ve utm_content.
$utm_value UTM parametresinin dize değeri.

Asistan bağlantısı yerleşik bir amaç içeriyorsa (amaç actions.intent.* ile başlar) Google, URL'deki yerleşik intent parametrelerini çıkarmaya çalışır ve bunları İşleminize aktarır. Google'ın yerleşik amaç parametreleri olarak anlamadığı tüm parametreler çıkarılır.

Google, konuşmaya dayalı İşlemler için bu parametreleri AppRequest mesajının bir parçası olarak karşılamanıza gönderir.

Aşağıdaki örnekte tek bir intent parametresine sahip yerleşik niyet içeren bir Asistan bağlantısı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

Google, özel amaçlar için yalnızca, amacınız kapsamında İşleminiz tarafından tanımlanan parametreleri çıkarır ve diğer parametreleri siler.

Aşağıdaki örnekte özel amaç içeren bir Asistan bağlantısı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

Google, yukarıdaki örnek URL için AppRequest öğesine aşağıdaki gibi bir JSON nesnesi ekler:

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

Asistan bağlantısında bir amaç belirtmezseniz Google, varsayılan olarak aşağıdaki davranışla birlikte işlemin MAIN amacına (actions.intent.MAIN) bağlanır:

  • Asistan bağlantısında MAIN amacını açıkça etkinleştirmediyseniz Google, "app_name ile konuş" davranışına benzer şekilde herhangi bir parametre olmadan ana niyeti tetikler.
  • MAIN amacını açıkça etkinleştirdiyseniz Google, parametreleri İşlemlerinize iletir.

Aşağıdaki örnekte amaç olmadan bir Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

UTM parametreleri, kullanıcılar bir Asistan bağlantısını tıkladığında Google'ın İşleminize gönderdiği ve daha sonra analiz için kullanabileceğiniz dizelerdir.

Google'ın İşleminize gönderdiği UTM (Urchin Trafik İzleme) parametreleri aşağıdakileri içerir:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Aşağıdaki örnekte, UTM parametreleri içeren bir Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

Yukarıdaki örnek URL için Google, AppRequest mesajına aşağıdaki bağımsız değişkenleri ekler:

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

Asistan bağlantılarını bir simülasyon aracı veya bir cihaz üzerinden herhangi bir amaç için (ana ya da özel, parametre içeren veya içermeyen) test edebilirsiniz.

Asistan bağlantınızı test etmek için:

  1. Konsolda Asistan bağlantısını etkinleştirin.
  2. Actions on Google projenizi oluşturmak için kullandığınız hesapla Asistan'da oturum açın.
  3. Asistan bağlantınızın (e-posta, sohbet, doküman vs.) tıklanabilir bir sürümünü oluşturun.
  4. Asistan özellikli bir cihazda, önceki adımda oluşturulan bağlantıyı tıklayın.

Asistan bağlantısının beklendiği gibi çalıştığını onayladıktan sonra, bağlantıyı kullanıcılarınıza sunmak için İşleminizi yeniden dağıtmanız gerekir.

Kısıtlamalar ve en iyi uygulamalar

Asistan bağlantısı URL'niz artık dizin veya diğer Google hizmetlerinin dışında dağıtılabildiğinden ve bunlara atıfta bulunulabildiğinden lütfen aşağıdaki kısıtlamaların ve en iyi uygulamaların geçerli olduğunu unutmayın:

  • Tüm Asistan bağlantılarınızı desteklemeye devam ettiğinizden emin olun. Daha sonra bozulan bir Asistan bağlantısı dağıtırsanız Actions projeniz sağlıksız olarak işaretlenebilir ve kaldırılabilir.
  • Bağlantı yayınlamak, güvenilir olmayan kaynaklardan tetiklemeyi desteklediğinizi gösterir. Bağlantılı İşlemlerle ilgili olarak, "gerçek dünyada" bir işlem gerçekleştirmeden önce kullanıcıyla açık bir şekilde iletişime geçmeniz gerekir. Örneğin, akıllı ev cihazını kapatan bir işlemde kullanıcıya "$applianceName hizmetini devre dışı bırakmak istediğinizden emin misiniz?" şeklinde bir istem görüntülenmelidir.

    Bu bağlamda "gerçek dünya" ifadesi kullanıcının hizmetlerini, verilerini, cihazlarını, ağlarını, bilgisayarlarını veya API'lerini etkileyen her türlü işlemdir. Örneğin, e-posta gönderme, işlem yapma, Akıllı Ev cihazının durumunu değiştirme, abonelik oluşturma veya içerik güncelleme.