حول المُعلِّمات

المُعلِّمات هي خصائص يمكن إقرانها بأيّ حدث للتأثير في أداء الحملة. هناك مُعلِّمات مُعيَّنة مطلوبة، بينما يُوصَى بشدَّة بوجود مُعلِّمات أُخرى لتحسين الأداء.

اعرف المزيد عن مستندات المُطوِّر لتنفيذ المُعلِّمات.

المُعلِّمات المُتوفِّرة:

• content_type: يجب تعيين القيمة إلى "product" أو "product_group". إذا استخدمتَ sku_id كـ "content_ids" أو "contend_id"، فاستخدِم "product"، وإذا استخدمتَ item_group_id كـ "content_ids" أو "content_id"، فاستخدِم "product_group". هذا الحقل مطلوب لإعلانات التسوُّق عبر الفيديو (VSA).

• contents: قائمة كائنات المحتوى التي تُمثِّل المنتجات ذات الصِلة في حدث ويب مع معلومات المُنتَج. يجب أن تكون القيمة مصفوفة من الكائنات. هذا الحقل مطلوب لإعلانات التسوُّق عبر الفيديو (VSA).

• content_ids: مُعرِّف فريد أو مصفوفة من المُعرِّفات المُتعدِّدة للمُنتَجات أو المحتوى، على سبيل المثال [‎'987','654']. يجب تضمين حرف 's' في 'content_ids'، سواء أرسلتَ مُعرِّفًا واحدًا أو مصفوفة من المُعرِّفات. نُوصِي باستخدام sku_id أو item_group_id يطابق sku_id/item_group_id الذي أعددتَه في الكتالوج، إذا كان مُتوفِّرًا. هذا الحقل مطلوب لإعلانات التسوُّق عبر الفيديو (VSA).

• delivery_category: يمكنك الإشارة إلى طريقة التسليم لعمليات الشراء عبر الإنترنت باستخدام المُعلِّمة delivery_category. تساعد هذه المُعلِّمة في تعقُّب عمليات الشراء بحسب طريقة التسليم، مثل الاستلام داخل السيارة، أو الاستلام داخل المتجر، أو التوصيل إلى المنزل.

• price وvalue: سعر مُنتَج فردي، و"value" عبارة عن السعر الإجمالي للطلب. على سبيل المثال، إذا كان لديك سلعتان تمّ بيع كل منهما مقابل 10 دولارات، فإن مُعلِّمة price ستجتاز 10 بينما مُعلِّمة value ستجتاز 20. يجب أن يكون نوع القيمة رقمًا. هذا الحقل مطلوب للعائد على الإنفاق الإعلاني (ROAS) والتحسين المُستنِد إلى القيمة (VBO).

• quantity: يُستخدَم لتحديد كمية المنتجات عند بدء إتمام عملية الشراء.

• content_name: اسم الصفحة، المُنتَج. يجب أن يكون نوع القيمة سلسلة.

• content_category: فئة الصفحة \ المُنتَج. يجب أن يكون نوع القيمة سلسلة.

• currency: رمز ISO 4127. يحتوي القسم التالي على قائمة بالعملات المدعومة حاليًا. يجب أن يكون نوع القيمة تعداديًا (سلسلة). هذا الحقل مطلوب للعائد على الإنفاق الإعلاني (ROAS).

• search_string: السلسلة التي أدخلَها المُستخدِم للبحث، والمُستخدَمة مع حدث البحث.

• description: وصف سلسلة للمُنتَج أو الصفحة.

• status: حالة طلب أو مُنتَج أو خدمة. يجب أن يكون نوع القيمة سلسلة.

  • ملاحظة: بناءً على استخدامك لـ "status"، قد تكون واجهة برمجة التطبيقات (API) للأحداث مطلوبة لمُشارَكة تغييرات الحالة على TikTok.

العُملة التي يدعمها TikTok حاليًا: درهم إماراتي، بيسو أرجنتيني، دولار أسترالي، تاكا بنغلاديشي، دينار بحريني، فرنك بوروندي، بوليفيانو بوليفي، ريال برازيلي، دولار كندي، فرنك سويسري، بيسو تشيلي، رنمينبي صيني، بيسو كولومبي، كولون كوستاريكي، كرونة تشيكية، كرونة دنماركية، دينار جزائري، جنيه مصري، يورو، جنيه إسترليني، كتزال غواتيمالي، دولار هونغ كونغ، لمبيرة هندوراسية، فورنت مجري، روبية إندونيسية، شيكل إسرائيلي، روبية هندية، كرونة آيسلندية، ين ياباني، شيلينغ كيني، ريال كمبودي، وون كوري جنوبي، دينار كويتي، تينغ كازاخستاني، درهم مغربي، باتاكا ماكاوية، بيسو مكسيكي، رينغيت ماليزي، نيرة نيجيرية، كوردبا نيكاراغوا، كرونة نروجية، دولار نيوزيلندي، ريال عُماني، سول بيروفي جديد، بيسو فلبيني، روبية باكستانية، زلوتي بولندي، غواراني باراغواي، ريال قطري، ليو روماني، روبل روسي، ريال سعودي، كرونة سويدية، دولار سنغافوري، بات تايلاندي، ليرة تركية، دولار تايواني جديد، هريفنا أوكرانية، دولار أمريكي، بوليفار فنزويلي، دونغ فيتنامي، راند جنوب إفريقي

يمكنك إعداد القيم الديناميكية التي تُمرِّر القيم الديناميكية المتعلقة بالحدث إلى TikTok. تحقَّق مع مُطوِّر موقع الويب الخاص بك لإعداد قيم ديناميكية، أو استخدِم أداة مُنشِئ الأحداث التي تعمل بالخدمة الذاتية من TikTok. وسيحدِّد هذا الكود الديناميكي تلقائيًا القِيَم الصحيحة لحدثك، مثل سعر الشراء، بدلًا من استخدام قيمة مُحدَّدة. يمكنك أيضًا استخدام الدليل الفني الخاص بنا لإعداد القِيَم الديناميكية باستخدام الكود.

على سبيل المثال، إذا وصَلت زائرة إلى موقع الويب الخاص بك وأضافت فستانًا إلى عربة التسوق الخاصة بها، فهذا ما ستبدو عليه القيمة الثابتة أو المُعيَّنة:

لجعل هذه القيم ديناميكية، استبدل قيم المجموعة بالكود الذي سيُمرِّر القيم الصحيحة مثل 'dress' أو 8' تلقائيًا.