يتم تقييد قياس تحسين التحويل في الوقت الحالي. يُرجى الاتصال بممثل Meta للحصول على معلومات حول كيفية الوصول.
يمكنك إنشاء تجربة لقياس فعالية الحملة الإعلانية وتشغيلها على فيسبوك. كما يمكنك تحديد إستراتيجية الإعلانات التي تحقق أعلى درجات التأثير بالنسبة للنشاط التجاري. راجع دراسة الإعلانات، المرجع.
عند إنشاء دراسة تحسين التحويل، يحب إنشاء مجموعة اختبارية عشوائية تتكون من حسابات مركز الحسابات تشاهد الإعلانات ومجموعة قياسية لا تشاهد الإعلانات.
يمكنك مشاركة بيانات التحويل من الحملة الإعلانية مع فيسبوك بشكل آمن باستخدام وحدات بيكسل فيسبوك أو أحداث التطبيق. ويحدد فيسبوك التحويلات المتزايدة التي حدثت نتيجة لحملتك الإعلانية. كما نقارن بين المجموعة الاختبارية والمجموعة القياسية من حيث عدد التحويلات حسابات مركز الحسابات التي تقوم بالتحويل وإيرادات المبيعات المتوفرة.
يمكنك إعداد دراسة مع مجموعة واحدة أو أكثر تُسمى الخلايا. عند إعداد دراستك، يختار فيسبوك مجموعات عشوائية من جمهور إعلاناتك ويعين حسابات مركز الحسابات إلى المجموعة الاختبارية أو المجموعة القياسية. بعد تشغيل الدراسة، يحسب فيسبوك الاختلاف بين المجموعات الاختبارية والمجموعات القياسية حتى تتمكّن من تقييم تأثير إعلانات فيسبوك في تحقيق أهداف النشاط التجاري.
لإعداد دراسة، يمكنك إجراء استدعاء POST
:
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'
يمكنك إعداد دراسة باستخدام مجموعة اختبارية واحدة لمعرفة كيف يمكن لإعلانات فيسبوك تحقيق مزيد من النجاح والأرباح للنشاط التجاري. كما يمكنك إعداد دراسة تتضمن مجموعات اختبارية متعددة مما يسمح لك بتحديد نهج الإعلان الذي يتناسب بشكل أفضل مع جمهورك.
مثال - إعداد دراسة تحسين التحويل باستخدام مجموعة اختبارية واحدة
curl \
-F 'name="new study"' \
-F 'description="description of my study"' \
-F 'start_time=1435622400' \
-F 'end_time=1436918400' \
-F 'cooldown_start_time=1433116800' \
-F 'observation_end_time=1438300800' \
-F 'viewers=[<USER_ID1>, <USER_ID2>]' \
-F 'type=LIFT' \
-F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
-F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'
لإنشاء دراسة جديدة، يجب تقديم ما يلي:
المعلمة | الوصف |
---|---|
| يمثل اسم الدراسة. |
| يمثل وصفًا موجزًا حول الغرض من الدراسة. |
| تم إيقاف استخدامه. لا يزال بإمكان فيسبوك العرض خلال الفترة بين |
| يمثل وقت بدء فترة نشاط الحملة الإعلانية. يجب أن يكون وقت بدء الدراسة في المستقبل. |
| يمثل وقت انتهاء فترة نشاط الحملة الإعلانية. |
| نهاية فترة التحويل ما بعد الاختبار. أثناء هذه الفترة (التي تقع، بين |
| تمثل الخلايا الموجودة في الدراسة والتي تحدد مجموعات الاختبار والمجموعات القياسية. |
| أهداف الدراسة. راجع تحديد هدف الدراسة. |
| يمكنك مشاركة هذه الدراسة مع قائمة من معرفات مستخدمي فيسبوك. |
| بالنسبة إلى تحسين التحويل، يجب أن يكون النوع |
التقييدات - بمجرد بدء الدراسة، لن تتمكن من تحديث start_time
وtreatment_percentage
للخلايا. ولن تتمكن أيضًا من إزالة الكائنات المرتبطة، مثل adaccounts
وcampaigns
للمجموعات الاختبارية. ولا يزال بإمكانك تحديث end_time
وobservation_end_time
إلى وقت في المستقبل إذا لم تكن الدراسة قد انتهت بعد، ويمكنك إضافة كائنات مرتبطة جديدة إلى المجموعات الاختبارية.
لتشغيل الوصول وتكرار الظهور مع قياس تحسين التحويل، يجب عليك إعداد دراسة تحسين التحويل أولاً والتأكد من أن مدة الوصول وتكرار الظهور تقع ضمن مدة دراسة تحسين التحويل.
للبدء، حدّد عدد حسابات مركز الحسابات التي تتلقى إعلاناتك وعدد حسابات مركز الحسابات التي لا تتلقاها. ويجب عليك إنشاء مجموعة اختبارية عند إعداد الدراسة؛ من خلال إدخال قائمة بكائنات JSON في cells
ضمن ad_studies
. راجع خلية دراسة الإعلانات، المرجع. تتضمن المجموعة الاختبارية المعلومات التالية.
المعلمة | الوصف |
---|---|
| اسم المجموعة الاختبارية. |
| وصف موجز للمجموعة الاختبارية. |
| يحدد حسابات مركز الحسابات التي تتلقى الإعلانات. |
| يحدد نسبة المجموعة المستبعدة لحسابات مركز الحسابات التي لن تتمكن من مشاهدة إعلانك. ويجب أن يكون مجموع النسبة المئوية لجمهور المجموعة القياسية ونسبة المعالجة يساوي 100. |
| تمثل قائمة بالكيانات الإعلانية، مثل |
مثال - قراءة المجموعات الاختبارية في الدراسة
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>/cells'
مثال - تحديث معلومات الخلية والمعالجة والنسبة المئوية لجمهور المجموعة القياسية أو تعديلها من خلال توفير معرف الخلية في cells
curl \
-F 'cells=[{id:<CELL_ID>,treatment_percentage:80,control_percentage:20}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'
مثال - قراءة كل الدراسات التي أنشأتها في ad_studies
لنشاطك التجاري
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'
كما يمكنك عرض كل الدراسات المرتبطة بالحساب الإعلاني من خلال إجراء استدعاء GET
في {ad-account-ID/include_all_studies=true}
من خلال رمز الوصول.
يمكنك إعداد دراسة تتكون من عدة مجموعات اختبارية تضم مستخدمي فيسبوك. ويساعد ذلك في قياس التأثير المتزايد للإستراتيجيات المختلفة في فيسبوك على الأهداف التجارية، مثل استخدام خيارات استهداف إعلانات مختلفة. ولإعداد دراسة تتضمن مجموعات اختبارية متعددة، يجب تقديم قائمة بالمجموعات الاختبارية في cells
.
curl \
-F 'name="new study"' \
-F 'description="description of my study"' \
-F 'start_time=1435622400' \
-F 'end_time=1436918400' \
-F 'cooldown_start_time=1433116800' \
-F 'observation_end_time=1438300800' \
-F 'viewers=[<USER_ID1>, <USER_ID2>]' \
-F 'type=LIFT' \
-F 'cells=[{name:"group A",description:"description of group A",treatment_percentage:50,control_percentage:20,campaigns:[<CAMPAIGN_ID1>]},{name:"group B",description:"description of group B",treatment_percentage:20,control_percentage:10,campaigns:[<CAMPAIGN_ID2>]}]' \
-F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'
تحدد control_percentage
المجموعة المستبعدة في كل مجموعة اختبارية بالنسبة لإجمالي العدد المُستخدم. فعلى سبيل المثال، إذا كانت لديك دراسة تتضمن اثنتين من المجموعات الاختبارية: المجموعة أ تتضمن معالجة بنسبة 50% ومجموعة قياسية بنسبة 20%، بينما تتضمن المجموعة ب معالجة بنسبة 20% ومجموعة قياسية بنسبة 10%. وذلك يؤدي إلى أن نسبة ~28.6%، أو 20%/70% من الجمهور في المجموعة أ، ليكونوا من المستخدمين في المجموعة القياسية ونسبة ~33.3%، أو 10%/30% من الجمهور في المجموعة ب، ليكونوا من المستخدمين في المجموعة القياسية.
ويجب أن يكون إجمالي مجموعة النسب المئوية لجمهور المعالجة والمجموعة القياسية يساوي 100. وعلى الرغم من ذلك، فقد يقل المجموع عن 100 في بعض حالات الاستخدام الخاصة. فعلى سبيل المثال، عندما يكون لديك ثلاث مجموعات اختبارية مقسّمة بالتساوي بنسبة 33% لكل منها.
يمكنك تحديث مجموعات الاختبار في الدراسة وإضافتها وإزالتها.
cells
عند تحديث الدراسة:curl \
-F 'cells=[{id:<CELL_ID1>,treatment_percentage:60,control_percentage:10},{name:"group C",description:"replacing group B",treatment_percentage:25,control_percentage:5,campaigns:[<CAMPAIGN_ID3>]}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'
حدد الأهداف الإعلانية التي تريد قياسها وكيفية إدخال بيانات التحويل إلى فيسبوك. وتتطلب دراسة تحسين التحويل وجود هدف إعلاني واحد على الأقل. ولا يمكنك تعديل الأهداف بعد تشغيل الدراسة. راجع هدف دراسة الإعلانات، المرجع.
مثال - إنشاء الهدف CONVERSIONS
وإضافته إلى دراسة
curl \
-F 'name="new study"' \
-F 'description="description of my study"' \
-F 'start_time=1435622400' \
-F 'end_time=1436918400' \
-F 'cooldown_start_time=1433116800' \
-F 'observation_end_time=1438300800' \
-F 'viewers=[<USER_ID1>, <USER_ID2>]' \
-F 'type=LIFT' \
-F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
-F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'
الاسم | الوصف | مصادر البيانات |
---|---|---|
| قياس التحسين في التحويلات. | وحدات بيكسل فيسبوك المستندة إلى واجهة API التحويلات |
إذا كنت تستخدم CONVERSIONS
وتستخدم بيكسل فيسبوك أو تطبيق الهواتف المحمولة كمصادر للأحداث، فيجب عليك تقديم قائمة بأسماء الأحداث التي تريد تسجيلها للهدف. ويمكن لفيسبوك بعد ذلك إعداد تقرير بالنتائج استنادًا إلى أحداث التحويل المحددة هذه.
مصدر القياس | أسماء الأحداث |
---|---|
بيكسل فيسبوك |
|
تطبيق الهواتف المحمولة |
|
يمكنك إنشاء هدف من خلال إدخال قائمة بكائنات JSON objectives
عند إنشاء دراسة جديدة. تتضمن الأهداف المعلومات التالية:
المعلمة | الوصف |
---|---|
| اسم الهدف. |
| يمثل قيمة منطقية تحدد أن هذا هو هدفك الإعلاني الأساسي. ولا يمكن أن تتضمن الدراسة إلا هدفًا إعلانيًا أساسيًا واحدًا. |
| قيمة |
| يمثل قائمة بمعرفات بيكسل فيسبوك، إلى جانب القائمة ذات الصلة التي تتضمن |
| قائمة بتطبيقات الهواتف المحمولة تتضمن |
| يمثل قائمة بمعرفات مجموعة أحداث التحويل بلا اتصال، إن وجد. لا ندعم حاليًا تقسيمات الأحداث لعملية التحويل بلا اتصال. |
| يمثل قائمة بمعرفات التحويل المخصص، إن وجد. |
ويمكنك أيضًا استخدام عدة أهداف لكل دراسة. ستكون النتيجة تراكمية مجمّعة تستند إلى الأهداف. فيما يلي أدناه مثال على دراسة متعددة الأهداف.
curl \
-F 'name="another study"' \
-F 'description="description of another study"' \
-F 'start_time=1435622400' \
-F 'end_time=1436918400' \
-F 'cooldown_start_time=1433116800' \
-F 'observation_end_time=1438300800' \
-F 'viewers=[<USER_ID1>, <USER_ID2>]' \
-F 'type=LIFT' \
-F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
-F 'objectives=[{name:"first objective objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID1>},{id:<APP_ID2>}]},{name:"scond objective",type:"CONVERSIONS",applications:[{id:<APP_ID3>,event_names:["fb_mobile_purchase"]}],adspixels:[{id:<FB_PIXEL_ID>,event_names:["fb_pixel_purchase","fb_pixel_lead"]}]}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'
يمكنك تحديث الأهداف وإضافتها وإزالتها في الدراسة من خلال القيام بذلك على مستوى الدراسة بما يشابه كيفية تعديل مجموعات الاختبار. ولتحديث هدف موجود، يمكنك الرجوع إلى المعرف الخاص به في الكائن objectives
. لإضافة هدف جديد، يجب تقديم كائن هدف جديد. لإزالة هدف، ما عليك سوى حذفه من المعلمة objectives
عند تحديثه.
مثال - تحديث مصادر قياس applications
للهدف وإزالة مصادر قياس adspixels
الخاص به
curl \
-F 'objectives=[{id:<OBJECTIVE_ID>,name:"new objective name",applications:[{id:<APP_ID>}],adspixels:[]}]' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'
مثال - قراءة أهداف دراسة
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'
ستظهر كل أدوات قياس "المشترين" للدراسات التي بدأت قبل تاريخ الانتهاء 13/7/2021. أما الدراسات التي بدأت بعد 13/7، فلن تشتمل على أدوات قياس "المشترين" وسيتم تقسيمها حسب الجنس والعمر والبلد. سيؤثر هذا التغيير على الحقول المذكورة أدناه التي تبدأ بكلمة "buyers (المشترون)" (buyers_test
وbuyers_control_scaled2
وغيرها).
لاحظ أيضًا أنك تحتاج إلى استخدام تقسيم cell_id
للحصول على نتائج على مستوى الخلية.
يتم تحديد أهداف الدراسة أثناء عملية إعداد الدراسة. يمكنك الرجوع إلى دليل الإعداد لمعرفة كيفية تحديد أهداف الدراسة
يمكنك قراءة الأهداف التي تم إنشاؤها للدراسة من خلال إجراء استدعاء GET
إلى عنصر الربط objectives
بالدراسة.
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'
ولمزيد من التفاصيل حول الأهداف، يمكنك الرجوع إلى وثائق هدف دراسة الإعلان المرجعية.
لاسترداد نتائج خاصة بهدف ما، يمكنك إجراء استدعاء GET
لعقدة الهدف من خلال تحديد القيمة results
في معلمة الحقول. كما يخبرك الحقل last_updated_results
بوقت آخر تحديث لبيانات النتائج لهذا الهدف المحدد.
مثال على الاستجابة المعروضة ككائن JSON تم تحليله لسهولة القراءة.
الأمر:
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'
تظهر بيانات النتائج في شكل كائن بلغة JSON وتحتوي على اسم أدوات القياس وسلاسل القيم. يُرجى الرجوع إلى مسرد أدوات قياس التحسين الذي يوفره فيسبوك.
مع المشترين:
{ "results": [ "{"cell_id":"<cell_id>", "population_test":2334212, "population_control":123407, "population_reached":1862084, "impressions":19020874, "spend":26059, "buyers_control_raw_scaled":37672.615701199, "buyers_exposed":30085.482427228, "buyers_frequentist_pValue":0.00064950107027983, "conversions_control_raw_scaled":110918.27003534, "conversions_exposed":86961.044050743, "conversions_raw_pValue":0.12863848309723, "conversions_test":104412.89695396, "conversions_control_scaled":104575.81331581, "conversions_incremental":-162.91636184894, "conversions_notExposed":87123.960412592, "conversions_confidence":0.69291721817069, "conversions_multicell_confidence":null, "conversions_incremental_lower":-3470.6251396487, "conversions_incremental_upper":3235.0644420632, "conversions_multicell_rank":null, "conversions_incremental_share":-0.001873440730011, "conversions_CPiC":-159.95324044961, "buyers_test":40732.369934386, "buyers_control_scaled":41990.129061459, "buyers_incremental":-1257.7591270729, "buyers_notExposed":36617.935710157, "buyers_confidence":0.19318944031404, "buyers_multicell_confidence":null, "buyers_incremental_lower":-2905.5296282828, "buyers_incremental_upper":426.25813050358, "buyers_multicell_rank":null, "buyers_incremental_share":-0.041806181107957, "buyers_CPiB":-20.718593440578}" ], "id": "<objective_id>" }
بدون المشترين:
{ "results": [ "{"cell_id":"<cell_id>", "population_test":2334212, "population_control":123407, "population_reached":1862084, "impressions":19020874, "spend":26059, "conversions_control_raw_scaled":110918.27003534, "conversions_exposed":86961.044050743, "conversions_raw_pValue":0.12863848309723, "conversions_test":104412.89695396, "conversions_control_scaled":104575.81331581, "conversions_incremental":-162.91636184894, "conversions_notExposed":87123.960412592, "conversions_confidence":0.69291721817069, "conversions_multicell_confidence":null, "conversions_incremental_lower":-3470.6251396487, "conversions_incremental_upper":3235.0644420632, "conversions_multicell_rank":null, "conversions_incremental_share":-0.001873440730011, "conversions_CPiC":-159.95324044961}" ], "id": "<objective_id>" }
بالإضافة إلى إمكانية استرداد النتائج لكل هدف، قد تختار تقسيم النتائج من خلال تقديم المعلمة breakdowns
.
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'
فيما يلي أبعاد التقسيمات المتوفرة:
لن تشتمل الدراسات التي بدأت بعد 7/13 على تقسيمات حسب الجنس والعمر والبلد.
التقسيم | القيم |
---|---|
|
|
| معرفات الخلايا المتوفرة في الدراسة. |
|
|
| رموز البلدان المكوّنة من حرفين ( يتم دعم ذلك حاليًا فقط عند الاستعلام عنه إلى جانب مثال: |
تعرض النتائج العديد من كائنات JSON في المصفوفة استنادًا إلى التقسيمات المتوفرة. فعلى سبيل المثال، إذا تم تقديم cell_id
، فسيتم تقسيم النتائج وفقًا لعدد الخلايا الموجودة في الدراسة. ويمكنك توفير تقسيم واحد أو أكثر؛ ومع ذلك يجب أن تحتوي مجموعات التقسيمات على 100 عملية تحويل على الأقل من المجموعات الاختبارية والمجموعات القياسية مجتمعة حتى يتم عرض النتائج.
{ "id": "<STUDY_OBJECTIVE_ID>", "results": [ { "cell_id": "<CELL_ID1>", ... Default fields where the values are specific to the <CELL_ID1> breakdown ... }, { "cell_id": "<CELL_ID2>", ... Default fields where the values are specific to the <CELL_ID2> breakdown ... }], }
يمكنك تحديد طابع تاريخ في استدعاء واجهة API الذي تجريه للحصول على نتائج الدراسة بداية من تاريخ محدد. ولاحظ أن الاستدعاء يعرض النتيجة نفسها التي كنت ستحصل عليها في حالة إجراء الاستدعاء نفسه في هذا التاريخ المحدد دون تضمين حقل طابع التاريخ. ويجب أن يكون التاريخ في غضون الـ 30 يومًا السابقة.
curl -G \
-d 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&ds=2020-03-01'