العلامات هي واحدة من أكثر الأدوات فائدة التي تقدمها Pushwoosh، مما يتيح مجموعة من الوظائف المتطورة. باستخدام العلامات، يمكنك تقسيم جمهورك وإرسال إشعارات لحظية مستهدفة لمستخدمين محددين بناءً على سماتهم.
يمكن أن تحتوي العلامات على أي بيانات عشوائية مرتبطة بمستخدم أو جهاز معين. قد تتضمن هذه البيانات أسماء المستخدمين، أو المعرفات، أو المدن، أو فرق كرة القدم المفضلة، أو فئات الأخبار المفضلة، أو أي معلومات أخرى ذات صلة بمستخدميك.
ابدأ بتحديد احتياجات عملك وتحديد كيفية تقسيم جمهورك. ضع في اعتبارك عوامل مثل العمر، والموقع، وسجل الشراء داخل التطبيق، أو أي معايير أخرى ذات صلة لاستهداف المستخدمين.
يمكن أن تساعدك قيم العلامات في جعل حملات الإشعارات اللحظية أكثر ذكاءً. كل علامة قادرة على تخزين عدد غير محدود تقريبًا من القيم. بشكل أساسي، هذا يعني أن علامة واحدة ستكون كافية لتسجيل نوع معين من المعلومات حول كل مستخدم نهائي في قاعدة بياناتك.
لا يتوفر سوى عدد قليل من العلامات لكل حساب، ولكن بالنظر إلى المساحة شبه اللانهائية لكل علامة، فإن علامتين فقط تكفيان لجمع كمية هائلة من المعلومات حول المستخدمين وإعداد أنماط استهداف معقدة للغاية.
لكل نوع من أنواع العلامات مجموعة محددة من عوامل التشغيل القابلة للتطبيق. تحدد عوامل تشغيل العلامات العلاقة بين العلامة وقيمها لأغراض التقسيم.
is, is not, are, not in, not set, anyis, is not, are, not in, not set, anyin, not in, not set, anyis (true/false), not set, anyexactly on, on or after, on or before, between, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyis, is not, greater or equals, less or equals, between, in, not in, not set, anyيصف هذا المعلم سلوك العلامات فيما يتعلق بالتطبيقات المختلفة في نفس الحساب. يمكن أن تحتوي العلامات الخاصة بالتطبيق على مجموعات مختلفة من القيم لكل تطبيق على نفس الحساب. على العكس من ذلك، تخزن العلامات غير الخاصة بالتطبيق نفس القيمة لجميع التطبيقات التي تستخدم هذه العلامة.
لنفترض أن لديك تطبيقين، تطبيق أخبار ولعبة، وتريد استهداف المستخدمين الذين وافقوا صراحة على تلقي الإشعارات اللحظية منك فقط. لذلك، تقوم بإنشاء علامة منطقية تسمى “Subscribed” وتعيين قيمة "true" للمستخدمين الذين يرغبون في تلقي الإشعارات منك، و "false" لأولئك الذين لا يرغبون في تلقي الإشعارات.
أحد المستخدمين، آنا، قامت بتثبيت كلا التطبيقين. لا تمانع في تلقي إشعارات حول بعض الأخبار العاجلة، لكنها اختارت عدم تلقي أي إشعارات من تطبيق اللعبة.
إذا كانت علامة “Subscribed” خاصة بالتطبيق، فسيتم كل شيء كما هو مخطط له. ومع ذلك، في حالة كانت هذه العلامة غير خاصة بالتطبيق، فسيقوم كل تطبيق من تطبيقاتك بالكتابة فوق القيمة التي حددها التطبيق الآخر، مما قد يفسد استهدافك ويسبب الإحباط.
من ناحية أخرى، قد تكون العلامات غير الخاصة بالتطبيق مفيدة إذا كنت ترغب في إجراء استهداف عبر التطبيقات وتتبع المستخدمين الذين لديهم نفس اسم المستخدم في تطبيقات مختلفة.
جميع العلامات في Pushwoosh خاصة بالمستخدم حسب التصميم ويتم تعيينها لجميع أجهزة المستخدم عند تعيينها بواسطة UserID بدلاً من HWID.
{ "request":{ "application": "XXXXX-XXXXX", // Pushwoosh application code "userId": "the id of a specific user", "tags": { "UserSpecificStringTag": "string value", "UserSpecificIntegerTag": 42 } }}هذه العلامات متاحة من Pushwoosh بشكل افتراضي، لذلك لا يتعين عليك (وفي الواقع، لا ينبغي عليك) تعيينها يدويًا. يتم تعيين معظمها من التطبيق وإرسالها إلى خادمنا عبر registerDevice واستدعاءات API أخرى، وبعضها يتم تعيينه بواسطة الخادم نفسه.
| الاسم | النوع | مكان التعيين | الوصف |
|---|---|---|---|
| Application Version | Version | SDK | الإصدار الحالي من التطبيق المثبت على الجهاز |
| Browser Type | String | SDK | عند تسجيل جهاز لمشروع الويب الخاص بك، يتم تتبع نوعه - محمول أو سطح مكتب - تلقائيًا |
| City | String | Server | آخر موقع جغرافي مسجل للجهاز |
| Country | String | Server | آخر موقع جغرافي مسجل للجهاز |
| Device Model | String | SDK | يشير إلى طراز الجهاز الذي تم تثبيت التطبيق عليه |
| First Install | Date | Server | يشير إلى الوقت الذي تم فيه تسجيل الجهاز لتلقي الإشعارات لأول مرة |
| In-App Product | List | SDK | المنتجات داخل التطبيق التي اشتراها مستخدم التطبيق |
| Last In-App Purchase Date | Date | SDK | تاريخ آخر عملية شراء داخل التطبيق تمت على الجهاز |
| Language | String | SDK | اختصار من حرفين صغيرين للغة الجهاز وفقًا لـ ISO-639-1؛ مأخوذ من إعدادات الجهاز |
| Last Application Open | Date | Server | وقت آخر تشغيل للتطبيق على الجهاز |
| OS Version | Version | SDK | إصدار نظام التشغيل الذي يعمل على الجهاز |
| Platform | String | SDK | المنصة التي يستخدم عليها المستخدم مشروعك. |
| Push Alerts Enabled | Boolean | SDK | يشير إلى ما إذا كانت تنبيهات الإشعارات اللحظية مسموح بها في إعدادات الجهاز |
| SDK Version | Version | SDK | إصدار Pushwoosh SDK المطبق على الجهاز |
| Unsubscribed Emails | Boolean | SDK | يشير إلى ما إذا كان المستخدم قد ألغى الاشتراك في تلقي رسائل البريد الإلكتروني من تطبيقك |
هذا هو المكان الذي يأتي فيه إبداعك لتحقيق أهداف عملك المحددة. يمكن إنشاء علامات مخصصة بناءً على منطق التقسيم أو نمط الاستهداف المناسب لاحتياجات عملك الفريدة. تعاون مع فريق التسويق لتحديد العلامات المخصصة الإضافية اللازمة لحملاتك.
يمكنك إضافة علامة جديدة في لوحة تحكم Pushwoosh أو استخدام طريقة /addTag.
POST https://api.pushwoosh.com/json/1.3/addTag
ينشئ علامة في حسابك.
| الاسم | النوع | الوصف |
|---|---|---|
| auth* | string | رمز الوصول إلى API من لوحة تحكم Pushwoosh. |
| tag* | object | معلمات العلامة. |
| tag.name* | string | اسم العلامة. |
| tag.type* | integer | نوع العلامة. انظر القيم الممكنة أدناه. |
| tag.application_specific | boolean | يحدد ما إذا كانت قيمة العلامة يجب أن تكون مختلفة لتطبيقات متعددة أو أن تكون هي نفسها عبر تطبيقات متعددة. |
{ "status_code": 200, "status_message": "OK", "response": { "result": true }}{ "request": { "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel "tag": { "name": "TAG_NAME", // required "type": 1, // required, see possible values below "application_specific": true, // or 'false', optional. Defines whether the tag value should be different for multiple apps or be the same across multiple apps "user_specific": true // or 'false', optional, used for application_specific tags } }}أنواع قيم العلامات الممكنة:
بمجرد إضافة وتكوين علامة، تكون جاهزة لبدء جمع المعلومات من المستخدمين. اتبع هذه الخطوات لتنفيذها:
setTags لتعيين العلامات وجمع بيانات المستخدم.فيما يلي أمثلة تنفيذ لأطر عمل مختلفة باستخدام دالة setTags.
iOS Native
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};
[[PushNotificationManager pushManager] setTags:tags];Android Native
pushwoosh.setTags(Tags.intTag("intTag", 42));Cordova
PushNotification.prototype.setTags = function( config, success, fail )Flutter
Future<void> setTags(Map tags) async { await _channel.invokeMethod("setTags", {"tags" : tags});}React Native
pushNotification.setTags({ "string_tag" : "Hello world", "int_tag" : 42, "list_tag":["hello", "world"]});Unity
يعين علامة عدد صحيح للجهاز.
public virtual void SetIntTag(string tagName, int tagValue)يعين علامة سلسلة نصية للجهاز.
public virtual void SetStringTag(string tagName, string tagValue)يعين علامة قائمة للجهاز.
public virtual void SetListTag(string tagName, List<object> tagValues)Unreal Engine
FPushwooshModule& pushwoosh = FPushwooshModule::Get();pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");Expo
Pushwoosh.setTags({ "key": keyValue, "value": inputValue });.NET MAUI
NSDictionary *tags = @{ @"Alias" : aliasField.text, @"FavNumber" : @([favNumField.text intValue]), @"price" : [PWTags incrementalTagWithInteger:5], @"List" : @[ @"Item1", @"Item2", @"Item3" ]};[[PushNotificationManager pushManager] setTags:tags];Outsystems
معلمات الإدخال
Tags – قائمة بسجلات العلامات التي تحتوي على TagName و TagValue.
TagName دائمًا من نوع Text.TagValue من نوع Text, Integer, Boolean, Date, إلخ.بينما في معظم الحالات (99%)، يتم تعيين العلامات من التطبيق، يمكنك أيضًا تعيين العلامات عبر Pushwoosh API. فيما يلي مثال على طلب نموذجي إلى نقطة نهاية /setTags:
POST https://api.pushwoosh.com/json/1.3/setTags
{ "request": { "application": "XXXXX-XXXXX", // required, Pushwoosh application code "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // required, hardware device ID used in /registerDevice API "tags": { // required "StringTag": "string value", // Example of a string tag "IntegerTag": 42, // Example of an integer tag "ListTag": ["string1", "string2"], // Example of a list tag "DateTag": "2024-10-02 22:11", // Note: time must be in UTC "BooleanTag": true // Valid values: true, false } }}لمزيد من التفاصيل، راجع وثائق setTags API
يتم تحديد موقع الجهاز بناءً على عنوان IP الخاص به في اللحظة التي تم فيها تشغيل تطبيقك على هذا الجهاز لآخر مرة. يقدم GeoIP بيانات الموقع إلى Pushwoosh، ويحفظ Pushwoosh الموقع المستلم من GeoIP كقيمة لعلامة المدينة لجهاز معين.
في بعض الحالات، يختلف الموقع الذي يقدمه GeoIP عن اسم المدينة — على سبيل المثال، عندما يشير إلى منطقة من مدينة أو وحدة إدارية أخرى. يرجى توخي الحذر عند استخدام علامة المدينة الافتراضية لأغراض التقسيم: تأكد من تحديد القيم المناسبة.
على سبيل المثال، إذا كنت ستستهدف مستخدمين من ميونيخ، فيجب عليك تغطيتها بمجموعة من قيم علامة المدينة، بما في ذلك “Munich” نفسها (مع جميع القيم المقابلة، مثل المتغيرات المختلفة للتهجئة التي يمكن أن يعيدها GeoIP ويتم حفظها كقيم للعلامة) والعديد من المناطق المجاورة.