به‌روزرسانی‌های روزانه (Dialogflow)

اگر «کنش» شما هر روز برای کاربران مفید است، با پیکربندی به‌روزرسانی‌های روزانه، به کاربران یادآوری کنید از آن استفاده کنند. وقتی کاربری در به‌روزرسانی‌های روزانه «کنش» شما مشترک می‌شود، اعلان لحظه‌ای دریافت می‌کند که می‌تواند با تک‌ضرب زدن روی آن، یکی از هدف‌های «کنش» شما را فراخوانی کند.

تجربه کاربر از این به‌روزرسانی‌ها به‌صورت زیر است:

1. کاربر یکی از هدف‌های «کنش» شما را که به‌عنوان به‌روزرسانی روزانه پیکربندی کرده‌اید فراخوانی می‌کند.
2. کاربر پیام‌واره‌ای را برای مشترک شدن در به‌روزرسانی‌های روزانه دنبال می‌کند. این پیام‌واره در اواسط مکالمه یا به‌عنوان تراشه پیشنهاد در پایان مکالمه ارائه می‌شود.
3. کاربر زمانی از روز را که می‌خواهد به‌روزرسانی روزانه شما را دریافت کند زمان‌بندی می‌کند و به‌روزرسانی شما را در «دستیار Google» ثبت می‌کند.
4. هر روز در زمان زمان‌بندی‌شده، کاربر اعلانی از «دستیار» در دستگاه همراهش دریافت می‌کند.
5. وقتی کاربر این اعلان را باز می‌کند، قصدی را که به‌عنوان به‌روزرسانی روزانه پیکربندی کرده‌اید فراخوانی می‌کند و با «کنش» شما تعامل برقرار می‌کند.

به‌طور پیش‌فرض، پیام‌واره ثبت به‌روزرسانی روزانه به‌صورت تراشه پیشنهادی هنگامی که کاربر با موفقیت از «کنش» شما خارج می‌شود ظاهر می‌شود. همچنین می‌توانید پیام‌واره ثبت‌نام در میان مکالمه اضافه کنید یا به‌روزرسانی‌های کاربر را شخصی‌سازی کنید.

موارد استفاده

به‌روزرسانی‌های روزانه می‌تواند ابزار تعامل مفیدی باشد اما نباید در همه «کنش‌ها» گنجانده شود. هنگام تصمیم‌گیری برای افزودن اشتراک‌های به‌روزرسانی روزانه به «کنش»، این نکات را درنظر بگیرید:

• مطمئن شوید که به‌روزرسانی‌های روزانه باعث می‌شود کاربر هر روز اطلاعات متفاوت و مفیدی را ببیند. اگر ضربه زدن روی به‌روزرسانی روزانه هربار به همان پیام‌واره منجر شود، کاربر احتمالاً پس‌از چند روز اشتراکش را لغو خواهد کرد.
• مطمئن شوید که اگر کاربر مستقیماً به قصد به‌روزرسانی روزانه شما برود، مکالمه برای او منطقی باشد. کاربر لزوماً از ابتدای مکالمه شروع نمی‌کند، بنابراین نباید انتظار داشت که بافت زیادی داشته باشد.
• قبل‌از اینکه از کاربر بخواهید برای به‌روزرسانی‌های روزانه ثبت‌نام کند، مزیت «کنش» خود را به او نشان دهید. کاربر شما باید وقتی گزینه مشترک شدن را می‌بیند، با خود فکر کند «من این محتوا را هر روز می‌خواهم».
• کاربر را با پیشنهادهای مکرر برای ثبت‌نام کلافه نکنید. اشتراک به‌روزرسانی روزانه را درست پس‌از نشان دادن آنچه کاربر در آن مشترک خواهد شد ارائه دهید و از تکرار پیشنهاد در زمینه‌های دیگر خودداری کنید.
• پس‌از راه‌اندازی هدف به‌روزرسانی، مکالمه را کوتاه نگه دارید. اکثر به‌روزرسانی‌های روزانه باید فقط شامل یک پاسخ باشند و سپس بدون نیاز به ورودی کاربر بسته شوند.

راه‌اندازی به‌روزرسانی‌های روزانه

برای پیکربندی یکی از هدف‌های «کنش» برای به‌روزرسانی‌های روزانه، این دستورالعمل‌ها را دنبال کنید:

۱. قصد به‌روزرسانی را آماده کنید

یکی از اهداف «کنش» خود را به‌عنوان هدف راه‌انداز پیکربندی کنید. این هدف امکان ارسال به‌روزرسانی روزانه به کاربران را فراهم می‌کند؛ وقتی کاربر اعلان به‌روزرسانی روزانه خود را باز می‌کند، هدف فعال می‌شود و مکالمه از آنجا ادامه می‌یابد.

برای تعریف کردن قصد راه‌انداز در Dialogflow، کارهای زیر را انجام دهید:

1. در کنسول Dialogflow، روی ادغام‌ها کلیک کنید.
2. در بخش دستیار Google، روی تنظیمات ادغام کلیک کنید.
3. در بخش اکتشاف > فراخوانی ضمنی، روی افزودن قصد کلیک کنید و قصد راه‌اندازتان را انتخاب کنید (اگر ازقبل آنجا نیست).
4. اگر پیش‌دید خودکار تغییرات ازقبل فعال نشده است، آن را روشن کنید.
5. روی بستن کلیک کنید.

در Actions SDK، هدف به‌روزرسانی را به‌عنوان هدف راه‌انداز در بسته Action تعریف کنید.

۲. فعال کردن به‌روزرسانی‌ها

برای روشن کردن به‌روزرسانی‌های روزانه برای قصد راه‌انداز، کارهای زیر را انجام دهید:

1. در کنسول Actions، به توسعه > Actions بروید.
2. قصد راه‌انداز را انتخاب کنید. اگر قصدتان در فهرست نشان داده نمی‌شود، مطمئن شوید که به‌عنوان قصد راه‌انداز پیکربندی شده باشد و ادغام «دستیار» Dialogflow روی پیش‌نمایش خودکار تغییرات تنظیم شده باشد.
3. به بخش تعامل کاربر پیمایش کنید و آیا می‌خواهید به‌روزرسانی‌های روزانه به کاربران ارائه دهید را روشن کنید.
4. عنوان محتوا را وارد کنید.
5. روی ذخیره کلیک کنید.

اکنون «کنش» خود را پیکربندی کرده‌اید تا اشتراک‌های به‌روزرسانی روزانه را برای یک هدف ارائه دهد. اکنون می‌توانید به‌روزرسانی‌های روزانه‌تان را در دستگاه همراه خودتان آزمایش کنید.

سفارشی‌سازی ثبت‌نام به‌روزرسانی (اختیاری)

علاوه‌بر تراشه پیشنهاد و جریان ثبت‌نام به‌روزرسانی روزانه که «دستیار» آن را مدیریت می‌کند، کاربران را با پیام‌واره ثبت‌نام و کادر گفتگوی خودتان در به‌روزرسانی‌های روزانه مشترک کنید.

برای مشاهده نمونه کاملی از «کنش» که ویژگی‌های به‌روزرسانی روزانه اختیاری را مدیریت می‌کند، نمونه‌های تعامل کاربر Actions on Google را ببینید (Node.js و Java).

برای افزودن پیام‌واره ثبت‌نام به‌روزرسانی روزانه سفارشی به مکالمه‌تان، این دستورالعمل‌ها را دنبال کنید:

۱. افزودن پیام‌واره ثبت‌نام

وقتی می‌خواهید از کاربران بخواهید در به‌روزرسانی‌های روزانه مشترک شوند، مکالمه و تراشه پیشنهادی به مکالمه اضافه کنید. این پیام‌واره‌ها را پس‌از تعامل کاربر با قصد به‌روزرسانی شما ارائه دهید تا کاربر محتوای به‌روزرسانی‌های روزانه شما را درک کند.

کد نمونه زیر از کاربر می‌خواهد در به‌روزرسانی‌های روزانه که پایین‌ترین دمای موردانتظار را برای هر روز ارائه می‌دهد مشترک شود:

app.intent('Daily Lowest Temperature', (conv, p>arams) = {
  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(
9;Send d
aily 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"<
/span>
      });
  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"
            }
          ]
        }
      }
    }
  ]
}

۲. ثبت‌نام به‌روزرسانی شناسه مجازی

قصد جدیدی راه‌اندازی کنید که وقتی کاربر پیام‌واره ثبت‌نام شما را دنبال می‌کند، فعال شود. در اجرای این قصد جدید، قصد ازپیش‌تعریف‌شده actions_intent_CONFIGURE_UPDATES را با پارامترهای زیر راه‌اندازی کنید:

• intent - روی قصد به‌روزرسانی‌ای که پیکربندی کرده‌اید تنظیم شده است.
• frequency - روی «DAILY» تنظیم شده است.

کد زیر به‌روزرسانی‌های روزانه را برای قصد «پایین‌ترین دمای روزانه» ثبت می‌کند:

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

conv.ask(new RegisterUpdate({
  intent: 'Daily Lowest Temperature',
  frequency: '
DAILY
9;,
}));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("D
AILY"))
  
    .build();
}UpdatesApp.java

ResponseBuilder responseBuilder = getResponseBuilder(request);
return responseBuilder.add(new RegisterUpdate()
    .setIntent("Daily Lowest Temperature")
    .setFrequency("DAILY&q
uot;))
    .bui
ld();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"
              }
            }
          }
        }
      ]
    }
  ]
}

۳. مدیریت نتیجه

«دستیار» مکالمه شما را به‌عهده می‌گیرد و کاربر را در بقیه پیکربندی به‌روزرسانی‌های روزانه راهنمایی می‌کند. وقتی ثبت‌نام تکمیل شد، «دستیار» قصدی را با پارامتری راه‌اندازی می‌کند که نشان می‌دهد ثبت‌نام موفقیت‌آمیز بوده است یا نه.

دستورالعمل‌های این مرحله بسته به اینکه از Dialogflow یا Actions SDK برای توسعه استفاده می‌کنید متفاوت است.

app.intent('Confirm Daily Updates Subscription', (conv, params, regis>tered) = {
  if (reg&&istered  registered.status === 'OK') {
    conv.close(`Ok, I'll start giving you daily updates.`);
  } else {
    conv.close(`Ok, I won't give you d
aily upd
ates.`);
  }
});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 respon
seBuilder.endCo
nversation().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, regis>tered) = {
  if (reg&&istered  registered.status === 'OK') {
    conv.close(`Ok, I'll start giving you daily updates.`);
  } else {
    conv.close(`Ok, I won't give you d
aily upd
ates.`);
  }
});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 respon
seBuilder.endCo
nversation().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<) {
  Li>stArgument 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<) {
  Li>stArgument 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» دارد و با همان حساب Google که برای ساختن «کنش» استفاده کردید، آزمایش کنید. «کنش» خود را فراخوانی کنید و در به‌روزرسانی‌های روزانه مشترک شوید، سپس اعلان‌های دستگاهتان را در حدود زمان به‌روزرسانی بررسی کنید.