دليل مطوّري برامج شرائح جمهور تجديد النشاط التسويقي

يصف هذا المستند كيفية استخدام Management API لإدارة شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google".

ملاحظة: عند استخدام واجهة برمجة التطبيقات هذه، عليك التقيّد بسياسة الميزات الإعلانية في "إحصاءات Google"، بما في ذلك القواعد المتعلقة بالفئات الإعلانية الحساسة.

المقدمة

تسمح لك Management API بإدارة شرائح جمهور تجديد النشاط التسويقي create وget وdelete وlist وupdate وpatch لموقع إلكتروني على "إحصاءات Google". لمعرفة مزيد من المعلومات عن آلية عمل شرائح جمهور تجديد النشاط التسويقي، اطّلِع على مقالة مركز المساعدة لمحة عن شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google".

حالات الاستخدام

يتوافق مورد جمهور تجديد النشاط التسويقي مع الحصول والحذف والقائمة والتصحيح المجمّع والتحديث، ولكن حالات الاستخدام الأساسية هي:

• إدراج جمهور تجديد النشاط التسويقي:
• إنشاء جمهور جديد لتجديد النشاط التسويقي:
• تعديل جمهور حالي لتجديد النشاط التسويقي

ملاحظة: ستظل شرائح جمهور تجديد النشاط التسويقي فارغة وقد لا يتم تشغيل حملات تجديد النشاط التسويقي إذا لم تُفعِّل علامتك لجمع البيانات المناسبة. يمكنك البدء من خلال تفعيل الميزات الإعلانية ضمن إعدادات موقعك على "إحصاءات Google".

إدراج شرائح جمهور تجديد النشاط التسويقي

لإدراج جميع شرائح جمهور تجديد النشاط التسويقي لأحد المواقع:

1. استخدِم Management API أو Account Explorer لاسترداد accountId وwebPropertyId.
2. نفِّذ طريقة list لمورد جمهور تجديد النشاط التسويقي.

اطّلع على مرجع واجهة برمجة التطبيقات لمعرفة تفاصيل طريقة list لمورد جمهور تجديد النشاط التسويقي.

إنشاء جمهور جديد لتجديد النشاط التسويقي

لإنشاء شريحة جمهور جديدة لتجديد النشاط التسويقي لأحد المواقع:

1. استخدِم Management API أو Account Explorer لاسترداد accountId وwebPropertyId.
2. استخدِم Management API أو Account Explorer لاسترداد رقم تعريف الملف الشخصي لموقع linkedViews [].
3. استخدِم مجموعة روابط "إعلانات Google" لاسترداد رقم تعريف حساب "إعلانات Google" من أجل linkedAdAccounts.linkedAccountId.
   • تقتصر السمة linkedAdAccounts[] حاليًا على linkedForeignAccount واحدة فقط.
   • يمكن ضبط linkedAdAccounts[].type على ADWORDS_LINKS أو DBM_LINKS أو MCC_LINKS أو OPTIMIZE.
4. استخدِم مجموعة الشرائح للحصول على خيارات لضبط السمة segment في includeConditions، وفي حال إنشاء جمهور مستند إلى الحالة، نفِّذ الإجراء نفسه بالنسبة إلى excludeConditions. اطّلِع أيضًا على مرجع الشرائح لتحديد شريحة.
   • يمكن أن يتضمن includeConditions اختياريًا قيمًا لـ membershipDurationDays وdaysToLookBack
   • يمكن إعداد excludeConditions.exclusionDuration اختياريًا على PERMANENT.
5. نفِّذ طريقة insert لمورد جمهور تجديد النشاط التسويقي.

تتيح لك واجهة برمجة التطبيقات إنشاء نوعَين من الجماهير: SIMPLE وSTATE_BASED. بالنسبة إلى شرائح جمهور SIMPLE، يجب فقط إنشاء audienceDefinition باستخدام segment موجب، بدون عامل تشغيل (الحرف !). إذا كنت تريد تضمين شرط استبعاد، يجب تحديد statebasedDefinition، ويمكنك الاطّلاع على الجماهير المستندة إلى الحالة لمعرفة المزيد من المعلومات. يُرجى الاطّلاع على مثال المرجع لمعرفة التفاصيل.

ملاحظة: يمكنك تحديد audienceDefinition أو stateBasedAudienceDefinition وضبط audienceType على القيمة المقابلة. هناك أيضًا 2000 جمهور مسموح به لتجديد النشاط التسويقي مسموح به. لذا، عليك توخّي الحذر عند التشغيل التلقائي لإنشاء شرائح جمهور تجديد النشاط التسويقي.

تعديل شريحة جمهور حالية لتجديد النشاط التسويقي

لتعديل جمهور تجديد نشاط تسويقي حالي لأحد المواقع:

1. وإذا كان لديك رقم تعريف جمهور تجديد النشاط التسويقي، يمكنك الاتصال بالرقم get، وإلا يمكنك طلب list واختيار الجمهور الذي تريد تعديله.
2. عدِّل أيًا من الحقول القابلة للكتابة واستدعِ update في كائن الجمهور المعدَّل.

ملاحظة: بعد إنشاء جمهور، لا يمكنك تغيير audienceType. بعبارة أخرى، إذا كان الجمهور يتضمّن قيمة audienceDefinition، لا يمكنك طلب تعديل القيمة باستخدام stateBasedAudienceDefinition. يمكنك الاطّلاع على شرائح الجمهور المستندة إلى الدولة للحصول على مزيد من المعلومات. يمكنك الاطّلاع على المثال المرجعي للحصول على التفاصيل.