עדכונים יומיים (Dialogflow)

אם הפעולה מספקת ערך למשתמשים בכל יום, צריך לתת למשתמשים תזכורת להשתמש בו על ידי הגדרת עדכונים יומיים. כשמשתמש נרשם מדי יום עדכונים לפעולה שלך, הם יקבלו התראה שיוכלו צריך להקיש כדי להפעיל את אחת מהמטרות של הפעולה.

חוויית המשתמש בעדכונים האלה היא:

1. המשתמש מפעיל את אחת מכוונות הפעולה שהגדרתם כאובייקטים של עדכון יומי.
2. המשתמש עוקב אחר בקשת הרשמה לעדכונים יומיים. ההנחיה הזו במהלך השיחה, או כצ'יפ של הצעה כשהשיחה מסתיימת.
3. המשתמש מתזמן את השעה שבה הוא רוצה לקבל את הדיווח היומי מתבצע רישום של העדכון ב-Google Assistant.
4. בכל יום בשעה שנקבעה, המשתמש מקבל Assistant התראה בנייד.
5. כשהמשתמשים פותחים את ההתראה, הם מפעילים את הכוונה שלכם מוגדר כעדכון יומי ואינטראקציה עם הפעולה שלך.

כברירת מחדל, בקשת ההרשמה לעדכון יומי מופיעה כצ'יפ של הצעה כשהמשתמש יוצא בהצלחה מהפעולה. אפשר גם להוסיף שיחה באמצע השיחה. הרשמה או להתאים אישית את עדכוני המשתמש.

תרחישים לדוגמה

עדכונים יומיים יכולים להיות כלי שימושי למעורבות, אבל משולב בכל פעולה. כדאי לשקול את הטיפים הבאים כשמחליטים אם להוסיף עדכון יומי של ההרשמה לפעולה:

• חשוב לוודא שהעדכונים היומיים יגרמו למשתמשים לראות תוכן שונה ומועיל מדי יום. אם הקשה על עדכון יומי תוביל לאותה הנחיה בכל פעם, המשתמש כנראה יבטל את ההרשמה אחרי כמה ימים.
• ודאו שתיבת הדו-שיח שלכם מובנת למשתמשים אם הם יקפוץ ישירות אל את הכוונה של העדכון היומי. המשתמש לא בהכרח יתחיל מההתחלה של השיחה, כך שלא אמור להיות להם הקשר רב.
• צריך להראות למשתמשים את היתרונות של הפעולה לפני שמבקשים מהם להירשם לקבלת עדכונים יומיים. המשתמש שלך צריך לחשוב "אני רוצה שהתוכן הזה יום" כשניתנת להם האפשרות להירשם למינוי.
• אל תציפו את המשתמש בהצעות חוזרות להירשם. להציע מינוי לעדכון יומי מיד אחרי שמראים למשתמשים מה הם נרשם וגם להימנע מחזרה על ההצעה בהקשרים אחרים.
• חשוב שהשיחה תהיה קצרה אחרי שמפעילים את כוונת העדכון. הכי יומי עדכונים צריכים לכלול תגובה אחת בלבד ולאחר מכן להיסגר בלי שמחייב קלט של משתמשים.

הגדרה של עדכונים יומיים

כדי להגדיר את אחד מהמטרות של הפעולה לקבלת עדכונים יומיים, צריך לפעול לפי הוראות:

1. הכנה של כוונת עדכון

יש להגדיר את אחת מהמטרות של הפעולה ככוונת הפעלה. הכוונה הזו מאפשרת שליחה של עדכון יומי למשתמשים; כשמשתמש פותח את העדכון היומי שלו ההתראה, הטריגרים של הכוונה והשיחה וממשיך משם.

כדי להגדיר Intent לטריגר ב-Dialogflow:

1. ב-Dialogflow Console, לוחצים על שילובים.
2. בקטע Google Assistant, לוחצים על Integration Settings (הגדרות שילוב).
3. בקטע גילוי > הפעלה מרומזת, לוחצים על הוספת Intent ולבחור את הכוונה שמפעילה את המודעה, אם היא עדיין לא מופיעה שם.
4. מפעילים את ההגדרה תצוגה מקדימה אוטומטית אם היא לא מופעלת.
5. לוחצים על סגירה.

ב-Actions SDK, מגדירים את כוונת העדכון ככוונת הפעלה חבילת פעולה.

2. הפעלת העדכונים

כדי להפעיל עדכונים יומיים לגבי כוונת הטריגר, מבצעים את הפעולות הבאות:

1. במסוף Actions, ניווט אל פיתוח > פעולות.
2. בוחרים את כוונת ההפעלה. אם הכוונה שלכם לא מופיעה ברשימה, לוודא שהוא מוגדר ככוונת טריגר ושל Assistant של Dialogflow של השילוב מוגדר לתצוגה מקדימה אוטומטית של שינויים.
3. גוללים למטה לקטע התעניינות המשתמשים ומפעילים את רוצה להציע עדכונים יומיים למשתמשים.
4. מזינים את שם התוכן.
5. לוחצים על שמירה.

הגדרת עכשיו את הפעולה להציע מינויים לעדכונים יומיים עבור בכוונה טובה. עכשיו אפשר לבדוק את העדכונים היומיים במכשיר הנייד שלך.

התאמה אישית של הרשמת עדכון (אופציונלי)

בנוסף לצ'יפ ההצעה ולעדכון יומי עם Assistant הרשמה, להירשם משתמשים לעדכונים יומיים באמצעות תיבת דו-שיח ובקשת הרשמה.

כדי לראות דוגמה מלאה לפעולה שמטפלת בתכונות אופציונליות של עדכון יומי: לצפייה בדוגמאות של התעניינות משתמשים ב-Actions on Google (Node.js ו-Java).

כדי להוסיף לשיחה הנחיה אישית להרשמה לעדכון יומי, פועלים לפי השלבים הבאים: הוראות אלה:

1. הוספת הצעה להרשמה

מוסיפים לשיחה תיבת דו-שיח וצ'יפ של הצעות כשרוצים להציג אותה למשתמשים להירשם לעדכונים יומיים. הציעו את ההנחיות האלה אחרי שהמשתמש מבצע אינטראקציה עם כוונת העדכון שלך, כדי שהם יבינו את התוכן של הפעולות היומיומיות

הקוד לדוגמה הבא מעודד משתמש להירשם לקבלת עדכונים יומיים להציע את הטמפרטורה הנמוכה ביותר הצפויה בכל יום:

app.intent('Daily Lowest Temperature', (conv, params) => {
  const today = DAYS[new Date().getDay()];
  const lowestTemperature = lowestTemperatures[today];
  conv.ask(`The lowest temperature for today is ${lowestTemperature}`);
  conv.ask('I can send you daily updates with the lowest temperature' +
    ' of the day. Would you like that?');
  conv.ask(new Suggestions('Send daily updates'));
});
index.js

@ForIntent("Daily Lowest Temperature")
public ActionResponse dailyLowestTemperature(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  Integer lowestTemperature =
      LOWEST_TEMPERATURES.get(LocalDate.now().getDayOfWeek());
  responseBuilder
      .add("The lowest temperature for today is " +  lowestTemperature + " degrees Fahrenheit.")
      .add("I can send you daily updates with the lowest temperature of " +
          "the day. Would you like that?")
      .addSuggestions(new String[] {
          "Send daily updates"
      });
  return responseBuilder.build();
}
UpdatesApp.java

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "The lowest temperature for today is 75 degrees Fahrenheit"
            }
          },
          {
            "simpleResponse": {
              "textToSpeech": "I can send you daily updates with the lowest temperature of the day. Would you like that?"
            }
          }
        ],
        "suggestions": [
          {
            "title": "Send daily updates"
          }
        ]
      }
    }
  }
}

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.TEXT"
        }
      ],
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "The lowest temperature for today is 75 degrees Fahrenheit"
              }
            },
            {
              "simpleResponse": {
                "textToSpeech": "I can send you daily updates with the lowest temperature of the day. Would you like that?"
              }
            }
          ],
          "suggestions": [
            {
              "title": "Send daily updates"
            }
          ]
        }
      }
    }
  ]
}

2. הכינוי של הרישום לעדכון

הגדרה של Intent חדש שמופעל כשהמשתמש עוקב אחרי הרישום . מילוי הבקשה של ה-Intent החדש, צריך להפעיל את השדה actions_intent_CONFIGURE_UPDATES Intent מובנה עם את הפרמטרים הבאים:

• intent – הגדרה לכוונת העדכון שהגדרתם.
• frequency – מגדירים את הערך 'DAILY'.

בקוד הבא מתועדים עדכונים יומיים לגבי המדד 'הטמפרטורה הנמוכה ביותר היומית' Intent:

app.intent('Subscribe to Daily Updates', (conv) => {
  conv.ask(new RegisterUpdate({
    intent: 'Daily Lowest Temperature',
    frequency: 'DAILY',
  }));
});
index.js

conv.ask(new RegisterUpdate({
  intent: 'Daily Lowest Temperature',
  frequency: 'DAILY',
}));
index.js

@ForIntent("Subscribe to Daily Updates")
public ActionResponse subscribeToDailyUpdates(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  return responseBuilder.add(new RegisterUpdate()
      .setIntent("Daily Lowest Temperature")
      .setFrequency("DAILY"))
      .build();
}
UpdatesApp.java

ResponseBuilder responseBuilder = getResponseBuilder(request);
return responseBuilder.add(new RegisterUpdate()
    .setIntent("Daily Lowest Temperature")
    .setFrequency("DAILY"))
    .build();
UpdatesApp.java

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "systemIntent": {
        "intent": "actions.intent.REGISTER_UPDATE",
        "data": {
          "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
          "intent": "Daily Lowest Temperature",
          "triggerContext": {
            "timeContext": {
              "frequency": "DAILY"
            }
          }
        }
      }
    }
  }
}

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.REGISTER_UPDATE",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
            "intent": "Daily Lowest Temperature",
            "triggerContext": {
              "timeContext": {
                "frequency": "DAILY"
              }
            }
          }
        }
      ]
    }
  ]
}

3. טיפול בתוצאה

Assistant שולטת בשיחה ומנחה את המשתמש את שאר ההגדרות של העדכונים היומיים שלהם. כשהרישום יסתיים, ה-Assistant מפעיל Intent עם פרמטר שמציין אם ההרשמה הצליחה או לא.

ההוראות בשלב הזה משתנות בהתאם למכשיר שבו משתמשים Dialogflow או Actions SDK לפיתוח.

app.intent('Confirm Daily Updates Subscription', (conv, params, registered) => {
  if (registered && registered.status === 'OK') {
    conv.close(`Ok, I'll start giving you daily updates.`);
  } else {
    conv.close(`Ok, I won't give you daily updates.`);
  }
});
index.js

@ForIntent("Confirm Daily Updates Subscription")
public ActionResponse confirmDailyUpdatesSubscription(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  if (request.isUpdateRegistered()) {
    responseBuilder.add("Ok, I'll start giving you daily updates.");
  } else {
    responseBuilder.add("Ok, I won't give you daily updates.");
  }
  return responseBuilder.endConversation().build();
}
UpdatesApp.java

{
  "payload": {
    "google": {
      "expectUserResponse": false,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "Ok, I'll start giving you daily updates."
            }
          }
        ]
      }
    }
  }
}

app.intent('actions.intent.REGISTER_UPDATE', (conv, params, registered) => {
  if (registered && registered.status === 'OK') {
    conv.close(`Ok, I'll start giving you daily updates.`);
  } else {
    conv.close(`Ok, I won't give you daily updates.`);
  }
});
index.js

@ForIntent("actions.intent.REGISTER_UPDATE")
public ActionResponse confirmDailyUpdatesSubscription(ActionRequest request) {
  ResponseBuilder responseBuilder = getResponseBuilder(request);
  if (request.isUpdateRegistered()) {
    responseBuilder.add("Ok, I'll start giving you daily updates.");
  } else {
    responseBuilder.add("Ok, I won't give you daily updates.");
  }
  return responseBuilder.endConversation().build();
}
UpdatesApp.java

{
  "expectUserResponse": false,
  "finalResponse": {
    "richResponse": {
      "items": [
        {
          "simpleResponse": {
            "textToSpeech": "Ok, I'll start giving you daily updates."
          }
        }
      ]
    }
  }
}

התאמה אישית של העדכונים (אופציונלי)

כדי להתאים אישית את כוונת העדכון, צריך להוסיף פרמטרים מותאמים אישית כשמשתמשים נרשמים עדכונים יומיים. אחרי שמסיימים את הכוונה לעדכון, צריך להפנות לפרמטרים האלה כדי להתאים אישית את העדכון היומי למשתמש הזה.

ההוראות לשימוש בתכונה הזו תלויות במכשיר שבו אתם משתמשים Dialogflow או Actions SDK לפיתוח.

app.intent('setup_update', (conv) => {
  conv.ask(new RegisterUpdate({
    intent: 'update_of_the_day',
    arguments: [
      {
        name: 'category',
        textValue: 'Daily_lowest_temperature',
      },
    ],
    frequency: 'DAILY',
  }));
});

@ForIntent("setup_update")
public ActionResponse setupUpdate2(ActionRequest request) {
  List<Argument> args =
      Arrays.asList(
          new Argument()
              .setName("category")
              .setTextValue(request.getParameter("category").toString()));
  return getResponseBuilder(request)
      .add(new RegisterUpdate().setIntent("intent_name").setArguments(args).setFrequency("DAILY"))
      .build();
}

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "PLACEHOLDER"
            }
          }
        ]
      },
      "userStorage": "{\"data\":{}}",
      "systemIntent": {
        "intent": "actions.intent.REGISTER_UPDATE",
        "data": {
          "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
          "intent": "update_of_the_day",
          "arguments": [
            {
              "name": "category",
              "textValue": "Daily_lowest_temperature"
            }
          ],
          "triggerContext": {
            "timeContext": {
              "frequency": "DAILY"
            }
          }
        }
      }
    }
  },
  "outputContexts": [
    {
      "name": "/contexts/_actions_on_google",
      "lifespanCount": 99,
      "parameters": {
        "data": "{}"
      }
    }
  ]
}

app.intent('actions.intent.TEXT', (conv) => {
  if (conv.input.raw === 'Send daily') {
    conv.ask(new RegisterUpdate({
      intent: 'update_of_the_day',
      arguments: [
        {
          name: 'category',
          textValue: 'Daily_lowest_temperature',
        },
      ],
      frequency: 'DAILY',
    }));
  }
});

@ForIntent("actions.intent.CONFIGURE_UPDATES")
public ActionResponse configureUpdatesActionsSdk(ActionRequest request) {
  List<Argument> args =
      Arrays.asList(
          new Argument()
              .setName("category")
              .setTextValue(request.getParameter("category").toString()));
  return getResponseBuilder(request)
      .add(new RegisterUpdate().setIntent("intent_name").setArguments(args).setFrequency("DAILY"))
      .build();
}

@ForIntent("actions.intent.TEXT")
public ActionResponse text(ActionRequest request) {
  ResponseBuilder rb = getResponseBuilder(request);
  String input = request.getRawInput().getQuery();
  if (input.equals("DAILY_NOTIFICATION_SUGGESTION")) {
    rb.add("For which category do you want to receive daily updates?");
  } else {
    rb.add("Sorry, I didn't get that. Please try again later").endConversation();
  }
  return rb.build();
}

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "PLACEHOLDER"
              }
            }
          ]
        }
      },
      "possibleIntents": [
        {
          "intent": "actions.intent.REGISTER_UPDATE",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.v2.RegisterUpdateValueSpec",
            "intent": "update_of_the_day",
            "arguments": [
              {
                "name": "category",
                "textValue": "Daily_lowest_temperature"
              }
            ],
            "triggerContext": {
              "timeContext": {
                "frequency": "DAILY"
              }
            }
          }
        }
      ]
    }
  ],
  "conversationToken": "{\"data\":{}}",
  "userStorage": "{\"data\":{}}"
}

כשהמשתמש מפעיל את העדכון היומי, עכשיו כוונת העדכון כוללת ארגומנטים שמכילים את הערכים שהמשתמש נתן במהלך הרישום. שימוש באלה כדי להתאים אישית את העדכון לכל משתמש.

בדיקה של עדכונים יומיים

אפשר לבדוק את העדכונים היומיים במכשיר נייד עם Google Assistant באמצעות לאותו חשבון Google שבו השתמשתם כדי ליצור את הפעולה. הפעלת הפעולה ולהירשם לקבלת עדכונים יומיים, ואז לבדוק את ההתראות במכשיר את שעת העדכון.