Configurarea programului pentru direcționate push-notificări - uwp dezvoltator de aplicații, documente Microsoft

În acest articol,

Puteți utiliza informațiile paginii de panoul central de dezvoltare Push-notificări pentru Windows pentru comunicarea directă cu clienții prin trimiterea direcționate push-notificări pe dispozitivele care au instalat aplicația este o platformă universală pentru Windows (UWP). De exemplu, puteți utiliza țintă push-notificare pentru a încuraja utilizatorii să acțiuni specifice, cum ar fi cererea de notare sau utilizarea noilor funcții. Puteți trimite diferite tipuri de push-notificări, inclusiv notificări pop-up, notificarea pe gresie și notificarea XML brută. Puteți urmări, de asemenea, numărul de lansări de aplicații, fabricate din push-notificări. Pentru mai multe informații despre această funcție. Trimiterea în push-notificări utilizatorilor aplicației dumneavoastră.

Înainte de a trimite direcționate push-notificări utilizatorilor Centrului de dezvoltare, trebuie să utilizați o anumită metodă în clasa StoreServicesEngagementManager pachetul Microsoft Store Services SDK, cererea de înregistrare pentru a primi notificări. Alte metode de această clasă pot fi folosite pentru a informa dezvoltarea Centrului că solicitarea dvs. a fost lansată ca răspuns la țintă push-notificare (dacă doriți să urmăriți numărul de lansări de aplicații realizate de notificări), și pentru a nu mai primi notificări.

Configurarea proiectului

Înainte de a scrie codul, urmați acești pași pentru a adăuga o trimitere la Microsoft Store Services SDK-ul pentru proiectul dumneavoastră.

Înregistrați-vă pentru notificări push-

Cereri de înregistrare pentru direcționate push-notificări de la Centrul de Dezvoltare.

In acest proiect, căutați secțiunea de cod executat în momentul lansării, în cazul în care vă puteți înregistra cererea de a primi notificări.

Adăugați în partea de sus a fișierului cu codul următoarea expresie:

Ia-StoreServicesEngagementManager obiect și apelați unul din Supraîncărcarea RegisterNotificationChannelAsync pentru a rula cod definit de tine mai devreme. Această metodă ar trebui să fie numit de fiecare dată când este lansată aplicația.

Dacă doriți să creați propriul centru de design uniform canal Resource Identifier (URI) pentru notificări, apel congestie RegisterNotificationChannelAsync ().

Dacă aplicația solicită, de asemenea, CreatePushNotificationChannelForApplicationAsync pentru a crea un canal de notificare pentru WNS, asigurați-vă că acest cod nu suna CreatePushNotificationChannelForApplicationAsync și RegisterNotificationChannelAsync (suprasarcină simultan). Dacă aveți nevoie pentru a apela ambele metode, asigurați-vă că le numim secvențial și să aștepte întoarcerea a unei metode înainte de a apela celălalt.

Dacă doriți să specificați un URI canale pentru a utiliza push-o notificare specifică a Centrului de Dezvoltare, apel congestie RegisterNotificationChannelAsync (StoreServicesNotificationChannelParameters). De exemplu, poate fi necesară în cazul în care cererea dumneavoastră este deja folosind serviciul de push-notificări pentru Windows (WNS) și doriți să utilizați același canal URI. Trebuie să creați mai întâi un obiect și să atribuie StoreServicesNotificationChannelParameters proprietatea CustomNotificationChannelUri canalul universal de resurse de cod (URI).

remarcă

Atunci când apelați o metodă în RegisterNotificationChannelAsync depozit de date cu aplicație locală creează un fișier numit MicrosoftStoreEngagementSDKId.txt pentru aplicația dvs. (dosarul returnat ApplicationData.LocalFolder proprietate). Acest fișier conține identificatorul utilizat de infrastructură vizat notificările push. Asigurați-vă că aplicația nu se schimba sau șterge fișierul. În caz contrar, utilizatorii pot primi mai multe copii ale notificărilor sau notificările nu vor funcționa în mod corespunzător.

țintă de transfer push-notificări utilizatorilor

Reacția aplicației când se execută utilizatorul

După înregistrarea cererii de a primi notificări și trimite push-notificări utilizatorilor aplicației dvs. din Centrul de Dezvoltare va fi de asteptare unul dintre aceste puncte de intrare în aplicație, atunci când utilizatorul pentru a rula o aplicație ca răspuns la împingere de notificare. Dacă aveți orice cod care este necesară atunci când un utilizator se execută aplicația dvs., puteți adăuga acest cod la unul din punctele de intrare în aplicare.

În cazul în push-notificare este tipul de activare a prim-plan, suprascrie metoda OnActivated App clasa în proiectul dumneavoastră și adăugați codul în această metodă.

În cazul în push-notificare este tipul de fond de activare, adăugați codul la metoda Run pentru sarcina de fond.

De exemplu, vă decideți pentru a recompensa utilizatorii aplicației care au achiziționat orice add-in plătit cerere, oferindu-le gratuit programe de completare. În acest caz, puteți trimite o notificare push anumit segment de utilizatori. destinate acelor utilizatori. Apoi, puteți adăuga cod pentru a le permite dreptul la un achiziții de aplicații gratuite. într-unul dintre punctele de intrare de mai sus.

Centrul de notificări pentru dezvoltarea aplicației începe

În cazul în care numărul Track Development Center, ați selectat de aplicația se lansează la țintă push-notificare, apelați metoda ParseArgumentsAndTrackAppLaunch din punctul de intrare corespunzătoare în aplicația de notificare Centrul de Dezvoltare pentru a lansa aplicația ca răspuns la o apăsare de notificare.

Această metodă returnează, de asemenea, argumentele inițiale de pornire pentru aplicație. Când selectați opțiunea de a urmări numărul de cereri pentru lansarea dvs. de push-notificări la argumentele începe de urmărire adaugă un identificator de opac pentru lansarea aplicației de numărare în Centrul de Dezvoltare. Ai nevoie să treci argumente pentru a rula ParseArgumentsAndTrackAppLaunch metoda de aplicare. și această metodă va trimite un cod de urmărire în Centrul de Dezvoltare, scoateți-l din argumentele de pornire și a reveni argumentele originale rula codul.

O metodă de a apela la această metodă depinde de activare de tip push-notificare:

În cazul în push-notificare este tipul de activare a prim-plan, numesc această metodă de imperative metoda OnActivated în cererea dumneavoastră și să treacă argumente care sunt disponibile în ToastNotificationActivatedEventArgs obiect. transmis prin această metodă. Următorul exemplu de cod presupune că fișierul conține declarații de cod folosind pentru namespace Microsoft.Services.Store.Engagement și Windows.ApplicationModel.Activation.

În cazul în push-notificare este tipul de fond de activare, numesc această metodă din metoda de a alerga sarcina de fundal și să treacă argumentele disponibile în ToastNotificationActionTriggerDetail obiect. transmis prin această metodă. Următorul exemplu de cod presupune că fișierul conține codul folosind declarații pentru namespace Microsoft.Services.Store.Engagement. Windows.ApplicationModel.Background și Windows.UI.Notifications.

De-înregistrarea push-notificări

Dacă doriți ca aplicația oprit trimiterea push-notificare țintită a Centrului de Dezvoltare, apelată metoda UnregisterNotificationChannelAsync.

Rețineți că această metodă invalidează canalul care este folosită pentru notificări, astfel încât cererea nu va mai primi push notificare de la orice servicii. După închiderea canalului nu mai poate fi utilizat pentru orice servicii, inclusiv push-notificare vizat de la Centrul pentru Dezvoltare și alte notificări care utilizează WNS de serviciu. Pentru a relua trimiterea de push-notificări pentru această aplicație, aplicația va trebui să solicitați un nou canal.