قائمة تحقق المبتدئين في إعلانات Google

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

تتضمن القائمة ثلاثة أنواع من العناصر:

	المهام: الخطوات المطلوبة لتنفيذ مهمّة معيّنة أو إعداد جزء معيّن من أداتك.
	المعلومات: هي معلومات ليست أساسية للعملية، لكنّها تساعدك في فهم السياق أو توضيح خطوات معيّنة.
	تحذير: الأمور التي يجب الانتباه إليها خلال العملية، لأنها قد تتطلب جهدًا إضافيًا في التنفيذ أو عرضة لمخاطر معينة.

إذا كنت تطبع قائمة التحقق، يمكنك استخدام مربعات الاختيار على اليمين لتحديد الخطوات التي تم إكمالها. توفّر قائمة التحقق هذه ترتيب قراءة مقترحًا للمعلومات الواردة في مستندات Google Ads API.

الوصول والإعداد

	احصل على الرمز المميز للمطوّر من مركز واجهة برمجة التطبيقات في حسابك الإداري ذي المستوى الأعلى. يجب إكمال جميع الحقول في نموذج Access API، والموافقة على "الأحكام والشروط". تأكَّد من أنّ البريد الإلكتروني لجهة اتصال واجهة برمجة التطبيقات الذي تقدّمه ينقل المستخدمين إلى صندوق بريد إلكتروني يتم تتبّعه بانتظام. سيتم إصدار رمز مميز للمطوِّر من خلال مستوى الوصول إلى الحساب التجريبي.
	هذا كل ما تحتاج إليه لتجربة Google Ads API باستخدام الحسابات التجريبية. يمكنك استخدام حسابات اختبارية لإنشاء حملات وإعلانات وما إلى ذلك، ولكن لن يتم عرض أي من إعلاناتك (مقابل التكاليف المستحَقة) وستكون جميع إحصاءات التقارير 0. للسماح للرمز المميز للمطوِّر بالوصول إلى حسابات الإنتاج، يجب أن يوافق عليه فريق مراجعة الرموز المميزة لدينا.
	للموافقة على رمزك المميّز للدخول العلني، عليك ملء نموذج طلب المتابعة وشرح الطريقة التي تنوي بها استخدام واجهة برمجة التطبيقات. يجب عليك أيضًا تقديم مستند تصميم. يمكنك استخدام نموذجنا للبدء. يُرجى تقديم أكبر قدر ممكن من التفاصيل. سيتواصل معك فريق مراجعة الرموز المميزة إذا كانوا بحاجة إلى مزيد من المعلومات، ولكن يمكنك أيضًا التواصل معنا من خلال نموذج التواصل في حال عدم تلقي أي ملاحظات خلال يومَي عمل.
	بعد الموافقة على الرمز المميّز للمطوّر، يمكنك استخدامه لإجراء طلبات بيانات من واجهة برمجة التطبيقات إلى حسابات الإنتاج. في البداية، سيتم منحك إذن الوصول الأساسي الذي يسمح بإجراء 15,000 عملية في اليوم وبحدّ أقصى 1,000 عملية في اليوم.
	إذا تم رفض طلبك، ستتلقّى رسالة إلكترونية توضح الأسباب. يمكنك إجراء تغييرات على طلبك وتقديم المزيد من التفاصيل حول الحلّ الذي تقدّمه وتقديم طلب جديد.

إعداد مكتبة برامج

	نستخدم OAuth 2.0 لمصادقة طلباتك مقابل واجهة برمجة التطبيقات. اتبع التعليمات الواردة في دليل OAuth 2.0 لإعداد بيانات الاعتماد الخاصة ببروتوكول OAuth 2.0. لتحديد المشاكل وحلّها، يمكنك استخدام ملعب OAuth 2.0.
	نحن نوفّر مكتبات للعملاء لبعض لغات البرمجة الشائعة. نزِّل مكتبة اللغة التي تريد استخدامها واضبط ملف الضبط الخاص بها باستخدام بيانات الاعتماد التي حصلت عليها سابقًا.

الرمز المميز للمطوِّر - مستويات الوصول

	يمكنك الاطّلاع على مستويات الوصول، وتحديد ما إذا كانت أداتك ستتطلّب أكثر من 15,000 عملية في اليوم في وقت ما في المستقبل. إذا كان الأمر كذلك، عليك تقديم طلب إذن بالوصول العادي لإجراء عمليات غير محدودة على mutate وGoogleAdsService.Search و GoogleAdsService.SearchStream طلبات في اليوم. ومع ذلك، لا يزال ذلك خاضعًا للحدّ اليومي البالغ عملية الحصول على 1,000 عملية.
	يُرجى مراجعة ورقة الأسعار لفهم كيفية احتساب العمليات لمستوى الوصول. ملاحظة: إنّ طلبات GoogleAdsService.Search التي تتضمّن مجموعة حقول page_token لا يتم احتسابها ضمن الحدّ الأقصى للعمليات.

الحد الأدنى المطلوب من الوظائف

	تعرَّف على الحد الأدنى المطلوب من الوظائف (RMF)، وهو مجموعة من الوظائف التي يجب أن تنفّذها أداتك استنادًا إلى طبيعة الأداة.
	الأدوات التي يمكن أن تعمل مع "الوصول الأساسي"، أي أقل من 15,000 طلب في اليوم، معفاة من "الحد الأدنى المطلوب من الوظائف". الأدوات التي لا يمكن للمعلنين الوصول إليها، والمخصصة للاستخدام الداخلي فقط، معفاة من الحد الأدنى المطلوب من الوظائف. إذا كانت أداتك تُعنى بإعداد التقارير فقط، سيسري الحد الأدنى المطلوب من الوظائف لإعداد التقارير فقط. إذا كانت أداتك محدودة ومتخصصة للغاية، مثل التسوّق أو الترويج للتطبيق فقط، لن يسري سوى جزء "الحد الأدنى المطلوب من الوظائف" الذي تستخدمه أداتك. إذا لم تكن متأكدًا من انطباق سياسة "الحد الأدنى المطلوب من الوظائف" على أداتك، يُرجى التواصل مع فريق الامتثال في Google Ads API.
	يمكنك الاطّلاع على رسوم عدم الامتثال لفهم ما يحدث عندما لا يتم تنفيذ حدود الحد الأدنى المطلوب بشكل صحيح.
	إذا كان الغرض من الأداة استخدام خارج مؤسستك (بعبارة أخرى، هي ليست أداة للاستخدام الداخلي فقط)، يجب أن تنفّذ الأداة "الحد الأدنى المطلوب من الوظائف" السارية قبل تقديم طلب للحصول على "إذن الوصول العادي". تذكر أن الحد الأدنى المطلوب من الوظائف عرضة للتغيير مع تغير واجهة برمجة التطبيقات. إذا قرّرت تقديم طلب للحصول على إذن الوصول العادي، سيكون عليك تحديث الأداة بأحدث إصدار من "الحد الأدنى المطلوب من الوظائف".
	تأكَّد من أنّ الأداة تنفِّذ إطار العمل الساري.
	قدِّم طلبًا للحصول على إذن الوصول العادي.

بدء العمل باستخدام واجهة برمجة التطبيقات

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

أمثلة على التعليمات البرمجية

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

إعداد التقارير

	لإعداد التقارير، يجب استخدام حساب كان يعرض الإعلانات لفترة زمنية كافية (ننصح باستخدامه لمدة 7 أيام على الأقل).
	ألقِ نظرة عامة سريعة على التقارير ومثال لتلخيص أداء أحد الحسابات على مدار آخر 30 يومًا باستخدام GoogleAdsService كمصدر وحيد للحقيقة لإعداد التقارير في "إعلانات Google".
	اطّلع على لغة طلب البحث في "إعلانات Google" (GAQL) للتعرُّف على قواعد طلبات البحث وبنية طلب البحث ومفاهيم المورد والشريحة والمقاييس.
	ننصحك بالاطّلاع على مقاييس المعايير لفهم كيفية استرداد بيانات الأداء الخاصة بمعايير مختلفة باستخدام موارد *_view، على سبيل المثال، KeywordView، وTopicView وGenderView.

أداة إنشاء الطلبات التفاعلية في "إعلانات Google"

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

أبحاث الكلمة الرئيسية

إذا لم تكن على دراية بأداة "أداة تخطيط الكلمات الرئيسية"، جرِّبها للاطّلاع على آلية عمل تخطيط الكلمات الرئيسية في واجهة مستخدم "إعلانات Google".

توفّر Google Ads API عدّة خدمات تعكس وظيفة "أداة تخطيط الكلمات الرئيسية" وتساعدك في إجراء أبحاث الكلمات الرئيسية. تقترح KeywordPlanIdeaService أفكارًا للكلمات الرئيسية استنادًا إلى معلَمات معيّنة، وتقدّم KeywordPlanService إحصاءات تقديرية حول أداء الكلمات الرئيسية، وتساعدك في تقييم جودتها. وننصحك بشدة باستخدام حساب "إعلانات Google" يتضمن حملات نشطة لإصدار طلبات البيانات من واجهة برمجة التطبيقات هذه للحصول على مقاييس دقيقة.

أمثلة على التعليمات البرمجية

	يمكنك التعرّف على وظائف تخطيط الكلمات الرئيسية من خلال تنفيذ نماذج الرموز أدناه.
	نماذج التخطيط -> إنشاء مقاييس التوقّعات
	نماذج التخطيط -> إنشاء أفكار للكلمات الرئيسية

استخدام الميزانيات تلقائيًا

	اطّلِع على طرق الدفع وإعداداته لفهم خيارات الفوترة المتاحة في "إعلانات Google"، مثل الدفعات التلقائية والدفعات اليدوية والفواتير الشهرية (حد الائتمان).
	إذا كنت لا تستخدم نظام الفواتير الشهرية ولا تخطِّط للتسجيل فيه، ما عليك سوى تخطّي هذا الفصل.
	راجع إعداد الفوترة للتعرّف على كيفية إدارة الملفات الشخصية للدفع وحسابات الدفع آليًا.
	اطّلع على ميزانية الحساب لفهم كيفية تخصيص الميزانيات تلقائيًا للحسابات.
	ويتطلب استخدام AccountBudgetProposalService إدراج حسابك الإداري على "إعلانات Google" في القائمة المسموح بها لهذا الغرض. لن تتمكن من استخدام هذه الخدمة حتى تكتمل هذه العملية. ستحتاج أيضًا إلى إعداد نظام الفواتير الشهرية مع Google. تواصَل مع مدير الشركاء الاستراتيجي الذي تتعامل معه في Google للترتيب لهذه العملية. لا تتوفّر إمكانية الوصول إلا لشركاء Google.
	تواصَل مع ممثل نشاطك التجاري في Google لتقديم طلب للتسجيل في الفوترة الشهرية.
	تواصَل مع ممثل نشاطك التجاري في Google لتقديم طلب للحصول على إذن بالوصول إلى AccountBudgetProposalService .
	أنشئ AccountBudgetProposal (مقترحًا لميزانية الحساب) وعيّنه إلى حساب. حاوِل استخدام الميزانية مع ميزانية الحملة.

إعلانات Shopping

	إذا كنت ستستخدم إعلانات Shopping، عليك على الأرجح استخدام Google Merchant Center وContent API for Shopping لإدارة بيانات المنتجات. يصف هذا القسم الخطوات الأساسية لبدء استخدام واجهة برمجة التطبيقات هذه.
	يمكنك إعداد حساب على Merchant Center والحصول على MerchantID.
	احصل على مفتاح حساب خدمة إذا كان تطبيقك يحتاج فقط إلى الوصول إلى حسابك الخاص على Merchant Center. إذا كنت تكتب تطبيقًا تابعًا لجهة خارجية ويحتاج إلى الوصول إلى حسابات عملائك على Merchant Center، راجِع دليل تفويض الطلبات باستخدام OAuth 2.0.
	تنزيل مكتبة برامج للّغة التي تختارها
	يمكنك الاطّلاع على أمثلة لرمز Content API في ما يخص Java و.NET وPHP وPython وغير ذلك.
	تعرَّف على كيفية ربط Merchant Center بحساب "إعلانات Google" يدويًا.
	يمكنك الاطّلاع على كيفية إعداد قائمة منتجاتك باستخدام Content API.
	اطّلع على دليل إنشاء حملة Shopping باستخدام Google Ads API.

الاقتراحات وتغيير الحالة

	إذا لم تكن على دراية بوظيفتَي الاقتراحات وسجلّ التغييرات، يمكنك تجربةهما في واجهة مستخدِم "إعلانات Google".
	توفّر Google Ads API خدمتَين مطابقتَين لهذه الوظائف. تقترح RecommendationService اقتراحات تحسين ذات تأثير مقدَّر، في حين يجلب ChangeStatusService سجلّ التغييرات في حسابك، والذي يمكن استخدامه لأغراض متعددة، مثل مزامنة النسخ على الجهاز والتدقيق البسيط والمزيد.

RecommendationService

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

ChangeStatusService

	اقرأ دليلنا حول كيفية استخدام ChangeStatusService لاسترداد سجل التغييرات لتتبع التغييرات التي تم إجراؤها على حسابك، مثل الحملات والإعلانات.
	يمكنك اكتشاف وظائف سجلّ التغييرات من خلال تشغيل نموذج الرمز التالي: نماذج ChangeStatus -> الحصول على تغييرات الحساب.

البقاء على اطّلاع

تحديد الإصدارات

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

منتجات Google المرتبطة بالإعلانات

	Google Merchant Center	تساعدك خدمة Google Merchant Center في تحميل بيانات متجرك ومنتجاتك إلى Google وإتاحتها على إعلانات Shopping وخدمات Google الأخرى.
	الملف التجاري	يساعدك ملفك التجاري في الوصول إلى العملاء المحليين والتفاعل معهم على "بحث Google" و"خرائط Google".
	إحصاءات Google	توفِّر خدمة "إحصاءات Google" تقارير تفصيلية حول كيفية استخدام الأشخاص موقعك الإلكتروني. ويمكنك استخدام "إحصاءات Google" للاطّلاع على الإجراءات التي يتخذها الأشخاص بعد النقر على إعلاناتك.
	إدارة العلامات من Google	أداة "إدارة العلامات من Google" هي نظام إدارة علامات (TMS) يتيح لك تعديل رموز التتبّع وأجزاء الرمز ذات الصلة، المعروفة إجمالاً بالعلامات، على موقعك الإلكتروني أو تطبيقك المتوافق مع الأجهزة الجوّالة، وذلك بسرعة وسهولة.
	أدوات تحسين الأداء من Google	تقدّم "أدوات تحسين الأداء من Google" أدوات اختبار أ/ب واختبار المواقع الإلكترونية وأدوات التخصيص للأنشطة التجارية الصغيرة بهدف المساعدة في تقديم تجارب تفاعلية للعملاء.
	مركز البيانات من Google	يعمل "مركز البيانات" على تحويل بياناتك إلى لوحات بيانات وتقارير غنيّة بالمعلومات وسهلة القراءة والمشاركة وقابلة للتخصيص بالكامل.

الحصول على المساعدة

	أضِف إشارة مرجعية إلى أدلة Google Ads API. يتم شرح معظم المفاهيم الأساسية بدقة هناك.
	أضِف إشارة مرجعية إلى مرجع Google Ads API. وتشرح هذه الصفحة جميع وظائف واجهة برمجة التطبيقات بالتفصيل
	أضف إشارة مرجعية إلى صفحة دعم Google Ads API، التي توضّح قنوات الدعم الرئيسية.
	راجِع قناة YouTube للمطوّرين في "إعلانات Google".
	يمكنك التواصل مع ممثل نشاطك التجاري أو مدير الشركاء في Google لتحديد موعد اجتماع من أجل حلّ المشاكل الاستراتيجية الأكثر تعقيدًا المرتبطة بواجهة برمجة التطبيقات.