Asistan bağlantıları

İşleminizin belirli bir amacına doğrudan bağlantı veren bir URL oluşturabilirsiniz. Web tarayıcısında veya mobil tarayıcıda bir Asistan bağlantısını (eski adıyla İşlem bağlantıları) tıklayan kullanıcılar, cihazlarında bulunan ve doğrudan Action'ın ile etkileşime geçtiği Asistan'a yönlendirilir.

Asistan bağlantıları, kullanıcıyı Asistan dizinindeki İşlem sayfanıza gönderen dizin web bağlantılarından farklıdır.

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

• Kullanıcıları bir "Nasıl yapılır?" web sitesindeki sesli talimatlara yönlendirir.
• Kullanıcıları yardım sayfasından müşteri desteği deneyimine bağlama
• Gelecekteki güncellemelerinizde yer alabilmeleri için kullanıcıları bir güncelleme amacına yönlendirmek.

Asistan bağlantısı oluşturma

Actions bağlantılarını kullanarak projenizden 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, İşleminizin alfa sürümünde Asistan bağlantınız etkinse bağlantı alfa test kullanıcılarına sunulur.

Bir işlem için URL oluşturmak üzere aşağıdaki adımları uygulayın:

1. İşlemler konsolunda, Dağıt > Asistan bağlantıları'na gidin.
2. Amaç bölümünde, bağlantı oluşturmak istediğiniz niyeti 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, URL parametreleri olarak bağlantıya eklemek istediğiniz diğer bilgileri girin.
5. (isteğ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 konser için bilet satın almak üzere işlem akışına düşürüyorsa bağlantı başlığınız "konser bileti satın al" olabilir.

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

Asistan bağlantılarını test etme

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

Asistan bağlantınızı bir cihazda test etmek için şu 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önderin.
3. Asistan özellikli bir cihazda Actions'unuzu 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ı işlevlerinin 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ı, isteğe bağlı olarak URL'de bir amaç ve parametreler içerebilir. Kampanya parametreleri 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 amacını Asistan bağlantısında açıkça etkinleştirmediyseniz Asistan, "app_name ile konuş" davranışına benzer şekilde ana niyeti herhangi bir parametre olmadan eşleştirir.
• MAIN amacını açıkça etkinleştirdiyseniz Asistan, parametreleri İşlemlerinize iletir.

Ek parametre olmadan MAIN amacını 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 amaç parametrelerini ayıklamaya çalışır ve bunları İşleminize iletir. Asistan'ın yerleşik amaç parametreleri olarak anlamadığı tüm parametreler kaldırılır.

Asistan, Görüşme İşlemleri için bu parametreleri AppRequest mesajının parçası olarak karşılamanıza gönderir.

Aşağıdaki örnekte tek bir intent parametresiyle yerleşik amaç 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.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 niyetin bir parçası olarak çıkarı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 için AppRequest içinde aşağıdaki gibi bir JSON nesnesi ekler:

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

UTM parametreleri olan Asistan bağlantı 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 parametrelerini 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ı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',
}

Zengin Asistan bağlantıları

Rich Assistant bağlantıları, Assist.js kullanarak web sitenizde İşleminizin bulunabilirliğini artırmanın bir yolunu sunar. Kullanıcılar Action'ınızı deneyebilir, ayrıca hesap bağlamayı kullanarak Google hesaplarını hizmetinize bağlayabilirler.

Bir kullanıcı web sitenizi ziyaret ettiğinde "Google Asistan'la deneyin" düğmesi görünür ve Rich Assistant bağlantı akışı tetiklenir.

İşleminiz için hesap bağlama özelliğini etkinleştirmeniz, kullanıcıların Asistan özellikli cihazlarından herhangi birinde İşleminize erişmesine olanak tanır. Ayrıca kullanıcılar, hizmetlerini hizmetinize kendi Google hesaplarına bağlayarak daha kişiselleştirilmiş bir deneyim sunabilir.

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

Ön koşullar

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

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

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 proje kimliğinizle değiştirerek 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>
   

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üğmesini seçmeden etkinleştirilir.

1. Asistan bağlantı grubu etiketinize 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

Zengin Asistan bağlantıları yalnızca sahip olduğunuz ve Google ile doğruladığınız alanlarda çalışır. Yerel olarak geliştirirken 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ınızı Actions Console'daki Dağıt > Marka Doğrulama > Siteyi Bağla bölümünde kaydedin.

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

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

Kısıtlamalar ve en iyi uygulamalar

Asistan bağlantı URL'nizin dizin veya diğer Google hizmetleri dışında dağıtılabilmesi ve referans verilebilmesi için aşağıdaki kısıtlamalar ve en iyi uygulamalar 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üvenilmeyen kaynaklardan tetiklenmeyi desteklediğiniz anlamına gelir. Bağlantılı herhangi bir İşlem için herhangi bir gerçek işlem yapmadan önce kullanıcıya açık şekilde bildirimde bulunmanız gerekir. Örneğin, akıllı ev cihazını kapatan bir işlem, kullanıcıya "$applianceName hizmetini devre dışı bırakmak istediğinizden emin misiniz?" isteminde bulunmalıdır.

  Bu bağlamda gerçek dünya işlemi, kullanıcının hizmetlerini, verilerini, cihazlarını, ağlarını, bilgisayarlarını veya API'lerini etkileyen işlemlerdir. Ö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.