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

المحتوى

1. ما هي البرامج التي نحتاجها
2. كيف تبدأ بحزم R
3. كران أو جيثب
4. ما هي المهارات اللازمة للعمل مع حزم R
5. ryandexdirect - تحميل البيانات من Yandex.Direct
   
   • ميزات الحزمة ryandexdirect
   • الوظائف الرئيسية
   • عينة كود لتنزيل الإحصائيات باستخدام حزمة ryandexdirect
6. RAdwords - تحميل البيانات من إعلانات Google (مثل Google AdWords)
   
   • ميزات RAdwords
   • الميزات الرئيسية ل RAdwords
   • مثال على العمل مع حزمة RAdwords
7. adwordsR - حزمة أحدث وأكثر وظيفية للتنزيل = وبيانات من إعلانات Google (مثل Google AdWords)
   
   • ميزات حزمة AdwordsR
   • الملامح الرئيسية adwordsR
   • مثال على حزمة AdwordsR
8. rfacebookstat - تنزيل البيانات من لوحات معلومات الإعلان على Facebook
   
   • ميزات حزمة Rfacebookstat
   • الملامح الرئيسية ل rfacebookstat
   • نموذج التعليمات البرمجية للعمل مع rfacebookstat
9. rvkstat - تحميل البيانات من Vkontakte API
   
   • ميزات حزمة Rvkstat
   • الوظائف الرئيسية لحزمة rvkstat
   • نموذج التعليمات البرمجية للعمل مع حزمة rvkstat
10. rmytarget - تحميل البيانات من MyTarget API
    
    • ميزات حزمة Rmytarget
    • الوظائف الرئيسية لحزمة rmytarget
    • نموذج التعليمات البرمجية للعمل مع rmytarget
11. rym - تحميل البيانات من Yandex.Metrica API
    
    • الميزات الرئيسية لحزمة ريم
    • الوظائف الرئيسية لحزمة ريم
    • مثال على العمل مع حزمة rym
12. الخلاصة

ما هي البرامج التي نحتاجها

لأن في هذه المقالة نتحدث عن لغة R ، فأنت بحاجة إلى R نفسها وبيئة تطوير RStudio .

كل من لغة R و RStudio هي برامج مجانية وموزعة مجانًا ، لذا يمكنك تنزيلها بحرية من المواقع الرسمية.

كيف تبدأ بحزم R

لا يوجد شيء معقد لبدء العمل مع حزم R ، ويتم ذلك على النحو التالي:

1. تثبيت حزمة ، عادة باستخدام الأمر install.packages الأساسي ؛
2. توصيل الحزمة ، في كل مرة تبدأ فيها جلسة جديدة مع R ، يمكن تنفيذ هذه العملية باستخدام library أو require الأمر.

الفرق بين library require هو أن library ستعطي خطأ إذا حاولت توصيل حزمة لا تملكها ، require في هذه الحالة تحذيرًا فقط ، بينما سيستمر البرنامج النصي في التنفيذ.

لتثبيت الحزم المقدمة في المقالة مع GitHub ، تحتاج أولاً إلى تثبيت حزمة devtools. للقيام بذلك ، قم بتشغيل الأمر install.packages("devtools") .

كران أو جيثب

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

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

ما هي المهارات اللازمة للعمل مع حزم R

في الواقع ، ما عليك سوى فهم مجال الموضوع للتسويق عبر الإنترنت ، ولا يلزم مهارات البرمجة في هذه الحالة ، لأنه سنتحدث عن الحزم الجاهزة ، باستخدام وظائف يمكنك من خلالها أتمتة جزء الخراب من عملك.

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

ryandexdirect - تحميل البيانات من Yandex.Direct

تثبيت حزمة باستخدام CRAN: install.packages("ryandexdirect")
تثبيت حزمة من GitHub: devtools::install_github("selesnow/ryandexdirect")
الوثائق الرسمية: رابط

تم تصميم هذه الحزمة للعمل مع API لواحدة من أكثر المنصات الإعلانية شعبية في CIS - Yandex.Direct.

ميزات الحزمة ryandexdirect

1. التفويض في Yandex API ؛
2. تنزيل قائمة الحملات الإعلانية والكلمات الرئيسية والإعلانات ؛
3. قم بتنزيل إحصائيات من حسابات Yandex.Direct باستخدام خدمة التقارير .
4. أوقف واستأنف الإعلانات على مستوى الحملات الإعلانية والكلمات الرئيسية والإعلانات.
5. طلب رصيد الصندوق والمعاملات الأخرى للحساب العام.
6. تنزيل المعلومات المرجعية (أسعار الصرف ، الدليل الجغرافي ، إلخ.)

الوظائف الرئيسية

الوظائف الرئيسية المتاحة في ryandexdirect ، والتي قد تحتاج إليها للعمل مع Yandex.Direct API:

• yadirAuth - التفويض في واجهة برمجة التطبيقات ؛
• yadirGetAds ، yadirGetCampaignList ، yadirGetKeyWords - قم بتنزيل قائمة الإعلانات والحملات الإعلانية والكلمات الرئيسية ؛
• yadirGetReport - تنزيل الإحصائيات من Yandex.Direct.
• yadirGetDictionary - تنزيل معلومات المساعدة.
• yadirStartAds ، yadirStartCampaigns ، yadirStartKeyWords -

 library(ryandexdirect) stat <- yadirGetReport(ReportType = "ACCOUNT_PERFORMANCE_REPORT", DateRangeType = "CUSTOM_DATE", DateFrom = "2018-01-01", DateTo = "2018-05-10", FieldNames = c("AdNetworkType", "Impressions", "Clicks", "Cost"), FilterList = c("CampaignId IN 123456 ,987654","Clicks GREATER_THAN 100"), IncludeVAT = "YES", IncludeDiscount = "NO", Login = " ", TokenPath = "C:/token_yandex") 

يمكنك معرفة المزيد حول كل وسيطة من المساعدة الرسمية لخدمة ryandexdirect أو Yandex.Direct API Reports .

RAdwords - تحميل البيانات من إعلانات Google (مثل Google AdWords)

تثبيت حزمة باستخدام CRAN: install.packages("RAdwords")
تثبيت حزمة من GitHub: devtools::install_github("jburkhardt/RAdwords")
الوثائق الرسمية: رابط

ميزات RAdwords

السمة الرئيسية لهذه الحزمة هي التفويض في إعلانات Google API وتنزيل الإحصائيات من جميع التقارير المتاحة في هذه الواجهة.

الميزات الرئيسية ل RAdwords

في الواقع ، لا تحتوي الحزمة ، من حيث المبدأ ، على العديد من الوظائف ، ولكن طوال الوقت استخدمت ثلاث وظائف فقط:

• doAuth - التفويض ؛
• statement - تشكيل نص الطلب إلى API ؛
• getData - تحميل البيانات من API.

 library(RAdwords) #   adw_token <- doAyth() #   body <- statement(select=c('AccountDescriptiveName', 'ExternalCustomerId', 'AccountCurrencyCode', 'AdNetworkType1', 'RegionCriteriaId', 'CountryCriteriaId', 'CityCriteriaId', 'Device', 'Month', 'Year', 'Impressions', 'Clicks', 'Interactions', 'VideoViews', 'Cost', 'Conversions' ), report="GEO_PERFORMANCE_REPORT", start="2018-09-01", end="2018-09-20") my_data <- getData(clientCustomerId = "000-000-0000", google_auth = adw_token , statement = body, transformation = T) 

يمكن العثور على قائمة التقارير المتاحة في إعلانات Google API والحقول على الرابط في المساعدة الرسمية.

adwordsR - حزمة أحدث وأكثر وظيفية للتنزيل = وبيانات من إعلانات Google (مثل Google AdWords)

تثبيت حزمة باستخدام CRAN: install.packages("adwordsR")
تثبيت حزمة مع GitHub: devtools::install_github("cran/adwordsR")

حزمة adwordsR مشابهة في معنى RAdwords ، لكنها أحدث وتحتوي على مجموعة أكبر بكثير من الوظائف.

ميزات حزمة AdwordsR

بالإضافة إلى ميزات حزمة RAdwords الموضحة أعلاه ، يمنحك adwordsR فرصًا كبيرة للعمل مع TargetingIdeaService ، وهي خدمة يمكنك من خلالها الحصول على خيارات الاستهداف مباشرة من أداة أو نظام أساسي ، مما يساعد على أتمتة تحسين الحساب.

الملامح الرئيسية adwordsR

• generateAdwordsToken - طلب رمز مميز للعمل مع إعلانات Google API ؛
• loadAdwordsToken - تنزيل الرمز المميز المطلوب والمحفوظ مسبقًا ؛
• getReportData - تنزيل الإحصائيات من حساب إعلانات Google.

 library(adwordsR) #   adw_token <- generateAdwordsToken(saveNewToken = TRUE, addGitignore = FALSE) #     adw_token <- loadAdwordsToken() #   AdWordsData <- getReportData(reportType = "CAMPAIGN_PERFORMANCE_REPORT", startDate = "2018-08-01", endDate = "2018-08-15", clientCustomerId = "000-000-0000", credentials = adw_token, attributes = "CampaignName,CampaignStatus", segment = "Date,AdNetworkType1", metrics = "AverageCost,Clicks,Conversions", includeZeroImpressions = TRUE, useRequestedHeaders = FALSE) 

rfacebookstat - تنزيل البيانات من لوحات معلومات الإعلان على Facebook

تثبيت حزمة باستخدام CRAN: install.packages("rfacebookstat")
تثبيت حزمة من GitHub: devtools::install_github("selesnow/rfacebookstat")
الوثائق الرسمية: رابط

ميزات حزمة Rfacebookstat

1. تسجيل الدخول إلى واجهة برمجة تطبيقات Facebook
2. تنزيل قائمة مديري الأعمال المتاحة لك ؛
3. تنزيل قائمة بالحسابات الإعلانية ؛
4. قم بتنزيل قائمة الحملات الإعلانية والمجموعات الإعلانية والإعلانات.
5. تنزيل الإحصائيات على مستوى حساب الإعلان والحملات الإعلانية والمجموعات الإعلانية والإعلانات.
6. تنزيل قائمة المستخدمين الذين لديهم حق الوصول إلى حساب الإعلان.
7. إدارة الوصول إلى حسابات الإعلانات.

الملامح الرئيسية ل rfacebookstat

• fbGetToken - التخويل في Facebook API ؛
• fbGetBusinessManagers - تنزيل قائمة مديري الأعمال ؛
• fbGetAdAccounts - تنزيل قائمة بالحسابات الإعلانية ؛
• fbGetCampaigns ، fbGetAds ، fbGetAdSets - تنزيل قائمة الحملات الإعلانية والإعلانات والمجموعات الإعلانية ؛
• fbGetMarketingStat - تنزيل الإحصائيات من حسابات الإعلان على Facebook.

 library(rfacebookstat) token <- fbGetToken(app_id = 00000000000000) fb_data <- fbGetMarketingStat(accounts_id = "act_00000000000000", level = "campaign", fields = "campaign_name,actions", action_breakdowns = "action_link_click_destination", date_start = "2017-11-01", date_stop = "2017-11-20", interval = "day", access_token = token) 

rvkstat - تحميل البيانات من Vkontakte API

تثبيت حزمة من GitHub: devtools::install_github("selesnow/rvkstat")
الوثائق الرسمية: رابط

حزمة قوية بما فيه الكفاية ومتعددة الوظائف للعمل مع واجهة برمجة التطبيقات للشبكة الاجتماعية فكونتاكتي.

ميزات حزمة Rvkstat

1. إذن في فكونتاكتي API ؛
2. تنزيل البيانات من حسابات فكونتاكتي الإعلانية ؛
3. تنزيل معلومات المساعدة من فكونتاكتي ؛
4. تنزيل بعض المعلومات حول مستخدم فكونتاكتي ؛
5. تنزيل الإحصائيات من حساب فكونتاكتي الإعلاني ؛
6. تنزيل إحصائيات حول زيارات مجتمعات فكونتاكتي.

الوظائف الرئيسية لحزمة rvkstat

تحتوي حزمة rvkstat في وقت الكتابة على أكثر من 30 وظيفة ، وهنا أكثرها فائدة:

• vkAuth - إذن ؛
• vkGetAdStatistics - تنزيل الإحصائيات من vkGetAdStatistics إعلاني ؛
• vkGetAdCampaigns ، vkGetAds - تنزيل قائمة الحملات الإعلانية والإعلانات ؛
• vkGetGroupStat - تنزيل إحصائيات حول زيارات لمجموعات ومجتمعات فكونتاكتي.

 library(rvkstat) my_tok <- vkAuth(app_id = 111,app_secret = "efbscuyewb7cb4ru4bj") #    camp <- vkGetAdCampaigns(account_id = 1, access_token = my_tok$access_token) #     vk_stat_by_campaign <- vkGetAdStatistics(account_id = 1, ids_type = "campaign", ids = camp$id , period = "day", date_from = "2010-01-01", date_to = "2017-09-10", access_token = my_tok$access_token) 

rmytarget - تحميل البيانات من MyTarget API

تثبيت حزمة باستخدام CRAN: install.packages("rmytarget")
تثبيت حزمة من GitHub: devtools::install_github("selesnow/rmytarget")
الوثائق الرسمية: رابط

ميزات حزمة Rmytarget

1. التفويض في MyTarget API وفقًا لنظام Code Grant ؛
2. تنزيل قائمة الحملات الإعلانية والإعلانات.
3. تنزيل الإحصائيات على مستوى الحملات الإعلانية والإعلانات.

الوظائف الرئيسية لحزمة rmytarget

• myTarAuth - التفويض ؛
• myTarGetAdList ، myTarGetCampaignList - تنزيل قائمة الإعلانات والحملات الإعلانية ؛
• myTarGetStats - تنزيل الإحصائيات حول الإعلانات والحملات.

 library(rmytarget) #    Ads <- myTarGetAdList(login = " ") #     a_stat <- myTarGetStats(date_from = "2016-08-01", date_to = "2016-08-10", object_type = "banners", object_id = Ads$id, stat_type = "day", login = " ") 

rym - تحميل البيانات من Yandex.Metrica API

تثبيت حزمة باستخدام CRAN: install.packages("rym")
تثبيت حزمة من GitHub: devtools::install_github("selesnow/rym")
الوثائق الرسمية: رابط

الميزات الرئيسية لحزمة ريم

تسمح لك حزمة rym بالعمل مع جميع واجهات برمجة التطبيقات المتاحة في Yandex.Metrica:

1. تفويض بروتوكول OAuth2
2. العمل مع واجهة برمجة تطبيقات الإدارة ؛
3. العمل مع تقارير API ؛
4. العمل مع API متوافق مع Core API Google Analytics v3 ؛
5. العمل مع Logs API .

الوظائف الرئيسية لحزمة ريم

• rym_auth - الترخيص ؛
• rym_get_counters - تنزيل قائمة بعدادات Yandex.Metrica ؛
• rym_get_data - تحميل البيانات من تقارير API ؛
• rym_get_ga - تحميل البيانات من API متوافق مع Core API Google Analytics ؛
• rym_get_logs - تحميل البيانات الأولية من واجهة برمجة تطبيقات السجلات.

 reporting.api.stat <- rym_get_data(counters = "00000000,111111111", date.from = "2018-08-01", date.to = "yesterday", dimensions = "ym:s:date,ym:s:lastTrafficSource", metrics = "ym:s:visits,ym:s:pageviews,ym:s:users", filters = "ym:s:trafficSourceName=='   ' AND ym:s:isNewUser=='Yes'", sort = "-ym:s:date", accuracy = "full", login = " ", token.path = "metrica_token", lang = "ru") 

الخلاصة

لذا ، بمساعدة الحزم المقدمة في هذه المقالة ، يمكنك أتمتة جمع البيانات من مصادر مثل Yandex.Direct و إعلانات Google و Facebook و Vkontakte و MyTarget و Yandex.Metrica. بالطبع ، هذه ليست قائمة شاملة للخدمات التي يستخدمها المسوقون عبر الإنترنت ، ولكن احتواء جميع الأدوات في مقال واحد يمثل مشكلة كبيرة ، لذلك إذا حصلت هذه المقالة على مراجعات إيجابية ، فسأكتب تكملة.

علاوة على ذلك ، يمكن تحويل البيانات التي تم الحصول عليها باستخدام حزمة dplyr ، وكتابتها إلى قواعد بيانات مختلفة باستخدام واجهة DBI ، ولكن هذه بالفعل مواضيع طويلة جدًا للمقالات التالية.

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

اشترك في قناتي برقية ويوتيوب ، ومعظم محتواها من المواد المفيدة على لغة R.