# مراسلة حاملي بطاقات Google Wallet

بمجرد أن يحفظ المستخدم بطاقة Google Wallet الخاصة بك، يقوم Pushwoosh بتسجيلها كاشتراك في منصة Google Wallet مرتبط بـ [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/) الخاص به.

يمكنك بعد ذلك الوصول إليهم بعدة طرق: تحديث البطاقة مع إشعار، إرسال رسالة دفع لمرة واحدة، أتمتة الرسائل من Customer Journey، استخدام السياج الجغرافي المدمج في Google، أو إخطار حاملي بطاقة معينة عبر API.

## إرسال تحديث للبطاقة مع إشعار

يؤدي تحرير البطاقة وحفظها إلى مزامنة الإصدار الجديد مع كل جهاز قام بحفظها. بالنسبة لبطاقات الولاء وتذاكر الفعاليات وتذاكر الطيران، يمكنك أيضًا تمكين إشعار لتنبيه الحاملين بالتغيير.

1. في **Campaigns ← Wallet Passes ← Google Wallet**، ابحث عن البطاقة وانقر على **Edit** في قائمة الإجراءات.
2. غيّر الحقول التي تحتاجها.
3. تأكد من تمكين **Notify about changed fields**.
4. انقر على **Save changes**.

يقوم Google بمزامنة التحديث مع كل جهاز قام بحفظ البطاقة. إذا كان خيار [**Notify about changed fields**](/ar/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes) مفعلًا، يرسل Google أيضًا إشعارًا لنظام Android إلى الحاملين.

<Aside type="note" title="تذاكر الفعاليات والطيران">
- يقوم Google بإنشاء نص الإشعار.
- بالنسبة لتذاكر الفعاليات والطيران، لا يتم إطلاق الإشعارات إلا إذا بقي أقل من 3 ساعات حتى وقت البدء.
- يسمح Google بـ 3 إشعارات كحد أقصى لكل بطاقة كل 24 ساعة. إذا تم الوصول إلى الحد الأقصى، يتم تحديث البطاقة بصمت.
</Aside>

## إرسال رسالة دفع لمرة واحدة إلى حاملي البطاقات

أرسل رسالة دفع مستقلة إلى حامل بطاقة واحد أو إلى جمهور أوسع.

1. افتح محرر رسائل الدفع لمرة واحدة. إما بالنقر على **Send message** في **Campaigns ← Wallet Passes ← Google Wallet**، أو بالذهاب إلى **Campaigns ← One-Time Messages** والنقر على **Send message ← One-time push**.
2. في خطوة **Content**، اكتب الرسالة أو اختر إعدادًا مسبقًا.
3. في خطوة **Audience**، حدد من سيتلقى الرسالة. يعتمد الإعداد الافتراضي على المكان الذي فتحت منه المحرر:

   * **من Send message على بطاقة:** يتم تحديد **Send to specific users**، وتكون قائمة **Recipients (User IDs)** تحتوي بالفعل على [User ID](/ar/product/pushwoosh-knowledge-hub/users-userids/) الخاص بحامل تلك البطاقة. أرسل كما هي للوصول إلى ذلك الحامل الواحد، أو قم بتغيير الجمهور:
     * أضف المزيد من User IDs في **Recipients (User IDs)**
     * انتقل إلى **Send to segment**
     * اختر **Send to all subscribers**
   * **من One-Time Messages:** حدد الجمهور كما في [رسالة دفع لمرة واحدة](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#select-audience-for-push-notification) عادية: **Send to specific users**، **Send to segment**، أو **Send to all subscribers**.

<img src="/google-wallet-passes-message-pass-holders-1.webp" alt="خطوة الجمهور مع تحديد خيار الإرسال إلى مستخدمين محددين ومعرف المستخدم لحامل البطاقة مملوء مسبقًا في حقل المستلمين"/>

4. تحت **Target platforms**، حدد **Google Wallet**.
5. أرسل الرسالة أو قم بجدولتها.

<Aside type="note">
عندما تستهدف شريحة، يتم التسليم للمستخدمين في تلك الشريحة الذين لديهم منصة Google Wallet مسجلة، وليس لكل من قام بحفظ بطاقة معينة.
</Aside>

## أتمتة الرسائل من Customer Journey

أرسل الرسائل تلقائيًا بناءً على الأحداث أو الشرائح.

### رحلة الدخول المستندة إلى مشغل (Trigger-based entry journey)

<Aside type="caution" icon="setting" title="مطلوب مساعدة المطورين">
يتطلب إرسال الأحداث المخصصة من فريق المطورين لديك دمج استدعاء API [`postEvent`](/ar/developer/api-reference/user-centric-api/#postevent) في الواجهة الخلفية أو نظام CRM الخاص بك. شارك هذا القسم معهم.
</Aside>

1. أنشئ [Customer Journey](/ar/product/customer-journey/pushwoosh-journey-overview/) وأضف [**Trigger-based entry**](/ar/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/).
2. حدد الحدث الذي يجب أن يبدأ الرحلة. أنشئ حدثًا مخصصًا في لوحة التحكم أولاً إذا لم تكن قد فعلت ذلك بالفعل، على سبيل المثال `RewardAvailable`.
3. أضف عنصر دفع وقم بتكوينه. قم بتمكين [**Send by User ID**](/ar/product/customer-journey/journey-elements/channels/push/#send-by-user-id) حتى تصل رسالة الدفع إلى كل جهاز مرتبط بالمستخدم، بما في ذلك البطاقة المحفوظة.
4. أكمل تكوين الرحلة وقم بتفعيلها.

عندما يتم إطلاق حدث الدخول، يرسل Pushwoosh رسالة الدفع إلى كل جهاز مرتبط بالمستخدم. يتلقى حاملو البطاقات الإشعار على البطاقة. أما المستخدمون الذين ليس لديهم بطاقة Google Wallet فيتلقونها على أجهزتهم الأخرى.

<Aside type="tip" title="محتوى البطاقة">
لا تغير رسالة الدفع أي حقول في البطاقة. لتحديث محتوى البطاقة إلى جانب الرسالة، على سبيل المثال رصيد النقاط، قم بتحديث البطاقة بشكل منفصل عبر **Edit** في [All passes](/ar/product/messaging-channels/google-wallet-passes/#view-and-manage-existing-passes) أو من خلال [Google Wallet API](/ar/developer/api-reference/google-wallet-api/).
</Aside>

**مثال: إخطار مستخدم بأن مكافأة متاحة**

`POST https://api.pushwoosh.com/json/1.3/postEvent`

```json
{
  "request": {
    "application": "XXXXX-XXXXX",
    "userId": "u12345",
    "event": "RewardAvailable",
    "attributes": {
      "reward": "Free coffee",
      "expires": "2026-07-01"
    }
  }
}
```

يجب أن يتطابق اسم `event` مع حدث تم إنشاؤه في لوحة التحكم الخاصة بك.

### طرق أخرى لبناء الرحلة

يعد التدفق المستند إلى مشغل أعلاه خيارًا واحدًا. اعتمادًا على ما يجب أن يبدأ الرحلة، اختر [عنصر دخول](/ar/product/customer-journey/journey-elements/entry-elements/) مختلفًا:

* **[Audience-based entry](/ar/product/customer-journey/journey-elements/entry-elements/audience-based-entry/):** ابدأ الرحلة لشريحة كاملة بدلاً من حدث واحد. قم بتشغيلها مرة واحدة، أو وفقًا لجدول زمني، أو بشكل دوري (على سبيل المثال، كل أسبوع لكل من يحمل بطاقة نشطة)، مع دخول مستخدمين جدد عند انضمامهم إلى الشريحة.
* **[API-based entry](/ar/product/customer-journey/journey-elements/entry-elements/api-based-entry/):** ابدأ الرحلة من حدث عمل يحدث خارج التطبيق، مثل تأخير رحلة طيران أو تغيير بوابة. يقوم نظامك الخارجي باستدعاء قالب طلب عنصر الدخول ويمرر مرشحًا لاستهداف المستخدمين المناسبين، على سبيل المثال كل من لديه Tag `flightNumber = SU1234` تم تعيينه عند إصدار البطاقة. مناسب جدًا لبطاقات الصعود إلى الطائرة وتذاكر الفعاليات.

## إخطار حاملي بطاقة معينة عبر API

لإرسال إشعار مخصص لكل من قام بحفظ بطاقة معينة، استدعِ [Update a pass](/ar/developer/api-reference/google-wallet-api/#update-a-pass) مع تعيين `notifyMessage`.

<LinkCard title="تحديث بطاقة" href="/developer/api-reference/google-wallet-api/#update-a-pass" />