Asistan bağlantıları

İşleminizin belirli bir amacına doğrudan yönlendiren bir URL oluşturabilirsiniz. Web tarayıcılarında veya mobil tarayıcılarda Asistan bağlantısını (daha önce İşlem bağlantıları olarak adlandırılıyordu) tıklayan kullanıcılar, cihazlarında Asistan'la doğrudan etkileşimde bulunduklarında Asistan'a yönlendirilirler.

Asistan bağlantıları dizin web bağlantılarındanfarklıdır. Bu bağlantılar, kullanıcıyı Asistan dizinindeki sayfanıza yönlendirir.

Asistan bağlantılarının faydalı olabileceği bazı durumlar aşağıda belirtilmiştir:

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

Asistan bağlantısı oluşturma

Actions Console'da projenizin içinden Asistan bağlantıları oluşturabilirsiniz. Asistan bağlantıları tüm dağıtım kanalları (alfa, beta ve üretim) üzerinden kullanılabilir. Örneğin, Asistan bağlantınız Action'ınızın alfa sürümünde etkinleştirilmişse alfa test kullanıcıları tarafından kullanılabilir.

Bir işleme yönelik URL oluşturmak için şu adımları uygulayın:

1. İşlemler konsolunda, Dağıt > Asistan bağlantıları'na gidin.
2. Niyet bölümünde, bağlantı oluşturmak istediğiniz amacı seçin.
3. Intent_name için bağlantıyı etkinleştirmek istiyor musunuz? seçeneğini etkinleştirin.
4. (isteğe bağlı) Kampanya parametreleri bölümünde, bağlantıda yakalamak istediğiniz bilgileri de URL parametreleri olarak girin.
5. (İsteğe bağlı) Bir Bağlantı başlığı girin. İşlemin ne yaptığını açıklamak için bu başlığı kullanın. Örneğin, İşleminiz kullanıcıyı bir konsere bilet satın almak için işlem akışını durdurursa bağlantı başlığınız "konser bileti satın al" olabilir.

Bilgilerinizi girdikten sonra, oluşturulan URL'yi veya Asistan bağlantısı için oluşturulan kod snippet'ini görüntüleyebilir ve kopyalayabilirsiniz. Kullanıcıları bu belirli İşleme yönlendirmek istediğiniz her yerde Asistan bağlantısını kullanın.

Not: İşleminiz dağıtıldıktan sonra bir Asistan bağlantısını etkinleştirirseniz bağlantının etkili olması için İşleminizi yeniden dağıtmanız gerekir.

Not: Dialogflow kullanıcıları bu sayfadaki adımları uygulamalıdır.

Test Asistanı bağlantıları

Asistan bağlantılarını simülatör üzerinden veya bir cihaz üzerinden, herhangi bir amaçla (ana ya da özel) ve parametre kullanarak ya da kullanmadan test edebilirsiniz.

Asistan bağlantınızı bir cihazda test etmek için aşağıdaki adımları uygulayın:

1. Actions konsolunda Asistan bağlantısını oluşturun.
2. Asistan bağlantısını e-posta, sohbet mesajı veya başka bir biçimde kendinize URL olarak gönderebilirsiniz.
3. Asistan özellikli bir cihazdan Actions projenizi oluşturmak için kullandığınız hesapla Asistan'da oturum açın.
4. Aynı cihazda, kendinize gönderdiğiniz Asistan bağlantısını 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.

Asistan bağlantısı parametreleri

Asistan bağlantıları, URL'de isteğe bağlı olarak bir niyet ve parametre içerebilir. Kampanya parametrelerini eklemek için Kampanya parametreleri bölümünü kullanın.

Bir Asistan bağlantısı ek parametre içermediğinde Google Asistan, aşağıdaki davranışı kullanarak işleminizin MAIN amacına (actions.intent.MAIN) bağlantı verir:

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

Ek parametre olmadan MAIN niyetini kullanan bir Asistan bağlantısı URL'si örneğini burada bulabilirsiniz:

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

Asistan bağlantısı URL spesifikasyonu

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 kullanıcı niyetinin 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.

Yerleşik amaçlara sahip Asistan bağlantısı URL'leri

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

Konuşma İşlemleri için Asistan 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 intent içeren bir Asistan bağlantı URL'sini nasıl belirtebileceğiniz gösterilmektedir:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

Kullanıcı amaçlarına sahip Asistan bağlantı URL'leri

Google Asistan, kullanıcı amaçları için yalnızca İşleminizin parçası olarak tanımlanan parametreleri çıkartır ve diğer parametreleri siler.

Aşağıdaki örnekte, kullanıcı amacı 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

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

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

UTM parametreleriyle Asistan bağlantısı URL'leri

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

Asistan'ın İşleminize gönderdiği UTM parametreleri şunları 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

Asistan, yukarıdaki örnek URL için AppRequest mesajında 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',
}

Rich Assistant bağlantıları

Zengin Asistan bağlantıları, action.js kullanarak web sitenizde İşleminizin keşfedilme oranını artırmanın bir yolunu sunar. Kullanıcılar İşleminizi deneyebilir ve hesap bağlama işlevini kullanarak Google hesaplarını hizmetinize bağlayabilirler.

Web sitenizi ziyaret eden kullanıcılar, "Google Asistan ile Deneyin" düğmesini görür. Bu düğme, Zengin Asistan bağlantı akışını tetikler.

İşleminiz için hesap bağlamayı etkinleştirmek, kullanıcıların Asistan özellikli tüm cihazlarından İşleminize erişmesine olanak tanır. Ayrıca, kullanıcılar hesaplarını Google hizmetlerine bağlayabilir. Bu sayede daha kişiselleştirilmiş bir deneyim sunabilir.

Hesap bağlama ile birlikte kullanıldığında Rich Assistant bağlantıları, Actions konsolunda projenizde ayarlanan yetkilendirme URL'nizi kullanır. Daha fazla bilgi için hesap bağlama belgelerini inceleyin.

Not: Kullanıcı, Google hesabında oturum açmadıysa Rich Assistant bağlantısı, kullanıcının cihazında Asistan'daki İşleminizi tetikler (Asistan kullanılabiliyorsa) veya kullanıcıyı Action'ınızın Asistan dizin sayfasına gönderir.

Ön koşullar

Rich Assistant bağlantılarını kullanmak için aşağıdakilere ihtiyacınız vardır:

• Actions projesi.
• İşleminiz için Asistan bağlantısı etkinleştirildi.
• (İsteğe bağlı) İşleminiz için hesap bağlama etkin.

Yerel gelişim

Web sitenize zengin bir Asistan bağlantısı eklemek için aşağıdaki adımları uygulayın:

1. <PROJECT_ID> sayfanıza Actions projesi kimliğinizi girerek aşağıdaki JavaScript kitaplığını ekleyin:

   <script async
   src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
   </script>
   

2. Aşağıdaki HTML etiketini sayfanızda bir yere ekleyin. Satır içi "Google Asistan ile deneyin" düğmesi yüklenir:

   <google-assistant-link-group>
     <!-- One or more <google-assistant-link> tags -->
     <google-assistant-link href="{ASSISTANT_LINK_1}">
     </google-assistant-link>
     <google-assistant-link href="{ASSISTANT_LINK_2}">
     </google-assistant-link>
   </google-assistant-link-group>
   

   Not: Bir Asistan kullanıcısı giriş yapmadıysa ilk Asistan bağlantısı Asistan'ı tetikler veya kullanıcıyı İşleminizin Asistan Dizini sayfasına yönlendirir.

Proaktif tetikleme

Kullanıcılar sayfanızı ilk kez ziyaret ettiğinde zengin Asistan bağlantısı akışının otomatik olarak başlamasını istiyorsanız <google-assistant-proactive-link> etiketini kullanın. Bu etiketi uyguladığınızda bağlantı, kullanıcılar ilk ziyaretlerinde satır içi düğmeyi seçmeden etkinleştirilir.

Not: Proaktif tetikleme bir süre etkin kalsa da proaktif proaktif akışı yeniden etkinleştirmek için kullanıcıların zaman zaman satır içi düğmesini seçmesi gerekir.

1. Asistan bağlantı grubu etiketinize bir id ekleyin:

   <google-assistant-link-group id="my-group">
     <!-- One or more <google-assistant-link> tags -->
     <google-assistant-link href="{ASSISTANT_LINK_1}">
     </google-assistant-link>
     <google-assistant-link href="{ASSISTANT_LINK_2}">
     </google-assistant-link>
   </google-assistant-link-group>
   

2. Web sayfanıza bir <google-assistant-proactive-action-link> etiketi yerleştirin ve groupId özelliğini id olarak ayarlayın:

   <google-assistant-link-group id="my-group">
     <!-- One or more <google-assistant-link> tags -->
     <google-assistant-link href="{ASSISTANT_LINK_1}">
     </google-assistant-link>
     <google-assistant-link href="{ASSISTANT_LINK_2}">
     </google-assistant-link>
   </google-assistant-link-group>
   
   <google-assistant-proactive-link
   groupId="my-group">
   </google-assistant-proactive-link>
   

Dağıtım

Rich Assistant bağlantıları yalnızca size ait olan ve Google ile doğrulanmış alanlarda çalışır. Yerel olarak geliştirme yaparken Actions projesine erişim, Google hesabınıza giriş yapma ve komut dosyası etiketinizde dev=true sorgu parametresini ayarlama yoluyla bu koşul atlanır.

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

İşleminizi zengin Asistan bağlantılarıyla dağıtmak için:

1. Herkese açık alan adınızı Actions konsolunda Dağıt > Marka Doğrulama > Siteyi Bağla altında kaydedin.

2. Komut dosyasından dev=true sorgu parametresini kaldırın:

   <script async
   src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
   </script>
   

Kısıtlamalar ve en iyi uygulamalar

Aşağıdaki bağlantı ve en iyi uygulamalar, Asistan bağlantı URL'nizin dizin veya diğer Google hizmetleri dışında dağıtılabilmesi ve bunlara referans verilebilmesi için geçerlidir:

• Tüm Asistan bağlantılarınızı desteklemeye devam edin. 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ğlı İşlemler için, gerçek dünyada bir işlem yapmadan önce kullanıcıyla bunu açıkça onaylamanız gerekir. Örneğin, akıllı ana cihazı kapatan bir Action, kullanıcıdan"$applianceName hizmetini devre dışı bırakmak istediğinizden emin misiniz?" isteminde bulunmalıdır.

  Bu bağlamda gerçek dünya eylemi 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.