Kullanımdan kaldırma ile ilgili en iyi uygulamalar

Bu rehberde, 13 Haziran 2023'te kullanımdan kaldırılan Conversational Actions için kullanıcı mesajları ve taşıma yolları açıklanmıştır. Aşağıdaki alanları kapsar:

  • Kullanımdan kaldırma aşamaları: İşlemler şu anda ve kullanımdan kaldırıldıktan sonra nasıl çalışır?
  • Önerilen mesajlaşma: İşlemlerinize eklemeniz için önerilen bildirimler.
  • Olası taşıma yolları: Kullanımdan kaldırma sonrasında kullanıcıları elde tutmaya yönelik seçenekler.

Proaktif blog yayınları (isteğe bağlı)

Her işlem, ajans ve işletme farklıdır. İşlemlerinizi bu kılavuzda önerilen mesajlarla güncellemenin yanı sıra kullanıcıların şu yaygın endişelerini proaktif bir şekilde yanıtlayan bir blog yayını yayınlayabilirsiniz:

  • What is happening?
  • Deneyimim ne zaman değişecek?
  • Benzer işlevleri almaya nasıl devam edebilirim?

Desteği sonlandırma duyurularıyla birlikte taşıma yolu seçeneklerini eklemenizi öneririz. Yayınınız e-posta, bülten ve sosyal medya yoluyla paylaşılabilir.

Kullanımdan kaldırma aşamaları

Aşağıdaki tabloda, Conversational Actions'ın şu anki davranışı, kullanımdan kaldırılma tarihinden sonra nasıl değişeceği ve kullanıcılarınızı bilgilendirmek için yapabileceğiniz güncellemeler açıklanmıştır.

Kullanımdan kaldırma tarihinden önce (13 Haziran 2023) Kullanımdan kaldırıldıktan sonra
İşlem davranışı Mevcut işlem deneyimi İşlem çağrısı devre dışı bırakıldı
Önerilen geliştirici güncellemeleri İşlemler'e kullanımdan kaldırma bildirimi ekleme (öneriler) Yok
Google'ın kullanıcı deneyimi güncellemeleri Çağrıda Google, İşlem'in kullanımdan kaldırılma tarihinden sonra artık kullanılamayacağını belirten bir Metin Okuma (TTS) bildirimi gönderebilir. Çağrıda Google, kullanıcıya bu işlemin artık kullanılamadığını bildiren bir TTS sağlar.

İşleminizi kullanımdan kaldırma tarihinden önce proaktif olarak devre dışı bırakmamaya karar verirseniz işlemi çağıran kullanıcılar Google tarafından sağlanan bir TTS bildirimi alır. Bu bildirimin tam metnini tanımlamaya devam ediyoruz ancak son ifadede kullanıcılarınıza yönelik taşıma bilgileri yer almayacak.

Önerilen mesajlaşma

Kullanıcıları, yaklaşan bir cihazın kullanımdan kaldırılacağı tarihi konusunda bilgilendirmenin en iyi yolu, söz konusu işlemi her çağırdığında onlara haber vermektir. Bu fırsattan yararlanarak kullanıcıları benzer işlevlere yönelik taşıma yolları konusunda da bilgilendirebilirsiniz.

  • Mesajlaşmanın amacı: Kullanıcıları yaklaşan değişiklik hakkında bilgilendirmek ve mevcut taşıma seçenekleri hakkında bilgi vermek.

  • Mesajlaşma zaman aralığı: Kullanımdan kaldırma işleminden en az 30 gün önce (13 Mayıs 2022 - 13 Haziran 2022) kullanıcıları bilgilendirmeye başlayın.

Kullanımdan kaldırılan sorguları işleme

Özellikle kullanıcılarınızdan gelen desteği sonlandırma sorularını yanıtlamak için aşağıdaki önerilen ifadeyi kullanan yeni bir Genel özel amaç oluşturun:

  • "Action Name özelliğini date tarihinde devre dışı bırakacağız. Ayrıntılar için şuraya göz atın: short link | migration path message."

Etkileşimli Tuval

Bildirim banner'ının gösterildiği akıllı ekran.

İşleminiz Etkileşimli Tuval kullanıyorsa kanvas yükleme sayfasına aşağıdaki örnek ifadeleri kullanan bir bildirim banner'ı ekleyin:

  • "Action Name, date tarihinde devre dışı bırakılacak. Ayrıntılar için shortlink url sayfasına gidin."
  • "Action Name, migration path message date tarihinde kapanacak."

İsteğe bağlı iletişimler

Kullanıcıları yapılacak değişiklik hakkında bilgilendirmek için mevcut işlemlerinizi güncellemenin başka yolları da vardır. Mevcut işlem mesajlarınıza kullanımdan kaldırma bildirimlerini son ek olarak ekleyebilirsiniz:

  • "existing message. Ayrıca, Action Name adlı cihazın date tarihinde (kapanacağını | kapatılacağını) hatırlatmak istiyorum."
  • "existing message. Ayrıca, Action Name adlı cihazın migration path date tarihinde (kapanacağını | kapatılacağını) bildirmek isterim."

İşleminizin uygulayabileceği tüm özel özelliklere de bildirimler ekleyebilirsiniz:

  • Derin bağlantı çağrıları: Bilgilendirici bir Temel Kart görüntüleyin (örnek).

  • Last prompt mesaj: Aşağıdaki istem türlerinden herhangi birine last prompt mesajı (örnek) ekleyebilirsiniz:

    • Yerleşik amaçlar (BII). Play Oyun, Hikaye Anlatma ve Eğitim İş Ortakları'nda geçerlidir.
    • Rutin önerileri'ne dokunun.
    • Karşılama istemleri.
  • Çıkış istemleri: Çıkış istemlerine (actions.intent.CANCEL) özel bir last prompt mesajı (örnek) de ekleyebilirsiniz.

  • Push bildirimleri: Action Builder veya Dialogflow kullanılarak derlenen tüm push bildirimlerine aşağıdaki önerilen ifadeleri ekleyin:

    • "Hatırlatıcı, Action Name date tarihinde kapanacak. Ayrıntılar için shortlink url adresini ziyaret edin."
    • "Hatırlatıcı Action Name migration path message tarihinde date tarihinde kapanacak.

Olası taşıma yolları

Conversational Action'dan öncekine benzer bir taşıma süreci bulunmasa da kullanıcı ihtiyaçlarınıza ve mevcut geliştirici kaynaklarına bağlı olarak aşağıdaki seçenekleri değerlendirin.

Medya içeriği

Medya İşlemleri, kullanıcıların Google Asistan'da içeriğinizi keşfetmelerini ve içeriği doğrudan uygulamanızda oynatmalarını sağlar. Aşağıdaki örnek mesajı kullanarak kullanıcıların medya işlemlerine geçiş yapmasına yardımcı olabilirsiniz:

  • "Bizi her zaman "Ok Google, Media Brand Name oyna" diyerek bulabilirsiniz."
  • "Bizi istediğiniz zaman Media Brand Name uygulamasında "Ok Google" diyerek bulabilirsiniz."

Medya İşlemleri, Conversational Actions'dan farklıdır:

  • Medya İşlemleri sayesinde kullanıcı, doğrudan 3. taraf ile değil, Asistan üzerinden 3. taraf ile "etkileşimde bulunur".
  • Medya İşlemleri konuşmaya dayalı değildir ve yalnızca "tek seferlik" sorguları destekler.

Android uygulamaları

Asistan Uygulama İşlemleri, kullanıcıların Asistan'ı kullanarak Android uygulamalarını sesleriyle başlatıp kontrol etmelerini sağlayan bir Android özelliğidir. Aşağıdaki örnek mesajı kullanarak kullanıcıları uygulama işlemleriniz hakkında bilgilendirebilirsiniz:

  • "Bizi istediğiniz zaman "Ok Google, App Name uygulamasını aç" diyerek bulabilirsiniz.
  • "App Name uygulamasında "Ok Google, BII" diyerek Android uygulamamızı açabilirsiniz.
  • ““Ok Google, App Name uygulamasını aç” diyerek Android uygulamamızı yükleyebilirsiniz.

Uygulama İşlemleri, Conversational Actions'dan birkaç farkla çalışır:

  • Uygulama İşlemi ABI'ları sınırlı dil ve yerel ayar desteği sunar.
  • Uygulama işlemlerini başlatmak için bir Android Uygulaması gerekir.
  • Akıllı ekranlar, Uygulama İşlemleri'ni desteklemez.
  • Uygulama İşlemleri konuşma odaklı değildir ve yalnızca "tek seferlik" sorgularını destekler.

Nalbur

Google Akıllı Ev, geliştiricilerin Asistan'ı kullanarak cihazları sesle etkinleştirmesine olanak tanır. Aşağıdaki örnek mesajı kullanarak kullanıcıları Akıllı Ev İşlemleriniz hakkında eğitebilirsiniz:

  • "Bizimle dilediğiniz zaman iletişim kurmak için store adresinde bulunan device name numarasını kullanabilirsiniz"
  • "Google Home uygulamasında bizimle device name üzerinden konuşabilirsiniz."

Akıllı Ev, Conversational Actions'dan aşağıdaki farklılıklara sahiptir:

  • Akıllı Ev yalnızca uyumlu cihazlara eklenebilir.
  • Akıllı Ev konuşkan değildir ve yalnızca "tek seferlik" sorguları destekler.

Sohbet temsilcileri

Chatbot'lar üzerinden kullanıcılarla iletişim kurmak için aşağıdaki ürünleri kullanabilirsiniz:

  • Dialogflow CX, büyük ve karmaşık aracılar için gelişmiş bir aracı türü sağlar. Dialogflow CX Telefon Ağ Geçidi, Dialogflow Messenger, Facebook'tan Messenger, LINE ve daha pek çok platformla entegrasyon olanağı sunar. Tam entegrasyon listesini inceleyin.
  • Dialogflow EX, daha küçük ve daha basit aracılar için uygun olan standart bir aracı türü sağlar. Slack, Telegram, LINE, Facebook'tan Messenger, Workplace from Meta ve daha pek çok uygulamayla entegrasyon sağlar. Tam entegrasyon listesine bakın.

Aşağıdaki örnek mesajı kullanarak kullanıcıları sohbet aracılarınız hakkında eğitebilirsiniz:

  • "İleride destek almak için support number numaralı telefonu arayın."
  • "Gelecekteki destek için short link url adresinden web sitemizi ziyaret edin."
  • "Gelecekteki geri bildirimleriniz için Company Name Slack kanalında bizimle sohbet edin."

Sohbet aracısı hizmetlerinin Conversational Actions'dan birkaç farkı vardır:

  • Aracılar Akıllı Ekranlarda desteklenmez.
  • Temsilciler Asistan'la entegre olamaz.

Müşteri Hizmetleri

Agent Assist ve CCAI Insights gibi Contact Center AI tekliflerinde yerleşik olarak bulunan chatbot'lar, sesli botlar ve telefon yardım masaları ile müşterilerinizin ihtiyaçlarını daha hızlı çözün. Aşağıdaki örnek mesajı kullanarak kullanıcıları müşteri hizmetleri seçenekleri hakkında bilgilendirebilirsiniz:

  • Gelecekte destek almak için support number numaralı telefonu arayın."
  • "İleride destek almak için short link url adresindeki web sitemizi ziyaret edin."
  • Gelecekte geri bildirim almak için "Şirket adı" Slack kanalında bizimle sohbet edin."

Müşteri hizmetleri seçenekleri, Conversational Actions'dan birkaç fark sunar:

  • Bunlar Akıllı Ekranlarda desteklenmez.
  • Asistan'la entegre edilemez.

Web Siteleri

Kullanıcıları web sitenizin sunabileceği işlevlere yönlendirebilirsiniz. Aşağıdaki örnek mesajı kullanarak kullanıcıları web seçenekleriniz hakkında eğitebilirsiniz:

  • "İleride destek almak için short link url adresindeki web sitemizi ziyaret edin."

Web siteleri, Conversational Actions'dan aşağıdaki farkları içerir:

  • Akıllı ekranlar web sitelerini desteklemez.
  • Web siteleri doğrudan Asistan ile entegre edilemez

Kod örnekleri

Conversational Actions'ınızda kullandığınız içeriklerin kullanımdan kaldırılmasıyla ilgili yanıtlar oluşturmak için bu kod örneklerini kullanın.

Temel Kart örneği

YAML

candidates:
  - first_simple:
    variants:
    - speech: >-
      We are turning off  on . For more details check out 
    text: >-
      We are turning off  on . For more details check out 
    content:
      card:
        title: Turning Off 
        subtitle: 
        text: >-
          `We are turning off  on . For more details check out .`
        button:
          name: Learn more
          open:
            url: 
    

JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "We are turning off  on . For details, check out .",
            "text": "We are turning off  on . For details, check out ."
          }
        ]
      },
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "`We are turning off  on . For details, check out .`",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      }
    }
  ]
}
      

Node.js

app.handle('Card', conv => {
  conv.add('We are turning off  on . For details, check out .');
  conv.add(new Card({
    "title": "Turning Off ",
    "subtitle": "",
    "text": "Card Content",
    "button": new Link({
      name: 'Learn more',
      open: {
          url: '',
        },
    })
  }));
});
    

JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "content": {
        "card": {
          "title": "Turning Off ",
          "subtitle": "",
          "text": "We are turning off  on . For, details check out .",
          "button": {
            "name": "Learn more",
            "open": {
              "url": ""
            }
          }
        }
      },
      "firstSimple": {
        "speech": "We are turning off  on . For details, check out .",
        "text": "We are turning off  on . For details, check out ."
      }
    }
  }
}
      

Son istem örneği

YAML

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on 
          text: Also, just reminding you that  will be turning off on 

JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on ",
            "text": "Also, just reminding you that  will be turning off on "
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on ',
    text: 'Also, just reminding you that  will be turning off on '
  }));
});

JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on ",
        "text": "Also, just reminding you that  will be turning off on "
      }
    }
  }
}

Son istem (Çıkış/İptal) örneği

YAML

candidates:
  - first_simple:
      variants:
        - speech: 
          text: 
    last_simple:
      variants:
        - speech: Also, just reminding you that  will be turning off on . Bye.
          text: Also, just reminding you that  will be turning off on . Bye.

JSON

{
  "candidates": [
    {
      "first_simple": {
        "variants": [
          {
            "speech": "",
            "text": ""
          }
        ]
      },
      "last_simple": {
        "variants": [
          {
            "speech": "Also, just reminding you that  will be turning off on . Bye.",
            "text": "Also, just reminding you that  will be turning off on . Bye."
          }
        ]
      }
    }
  ]
}

Node.js

app.handle('Simple', conv => {
  conv.add(new Simple({
    speech: '',
    text: ''
  }));
  conv.add(new Simple({
    speech: 'Also, just reminding you that  will be turning off on . Bye.',
    text: 'Also, just reminding you that  will be turning off on . Bye.'
  }));
});

JSON

{
  "responseJson": {
    "session": {
      "id": "session_id",
      "params": {}
    },
    "prompt": {
      "override": false,
      "firstSimple": {
        "speech": "",
        "text": ""
      },
      "lastSimple": {
        "speech": "Also, just reminding you that  will be turning off on . Bye.",
        "text": "Also, just reminding you that  will be turning off on . Bye."
      }
    }
  }
}