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

يوضِّح هذا المستند كيفية استخدام 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. استخدِم واجهة برمجة تطبيقات الإدارة أو مستكشف الحساب لاسترداد accountId وwebPropertyId.
2. استخدِم واجهة برمجة تطبيقات الإدارة أو مستكشف الحساب لاسترداد رقم تعريف الملف الشخصي (الملف الشخصي) للموقع 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 إيجابي، بدون عامل التشغيل NOT (الحرف !). إذا أردت تضمين شرط استثناء، عليك تحديد statebasedDefinition. اطّلِع على شرائح الجمهور المستندة إلى الولاية لمزيد من المعلومات. اطّلِع على المثال المرجعي لمعرفة التفاصيل.

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

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

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

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

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