الأسئلة الشائعة حول الإبلاغ

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن توفر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات إعداد التقارير والعمليات. مزيد من المعلومات عن نقل البيانات إلى التجربة الجديدة من "إعلانات شبكة البحث 360" واستخدامها API.

ماذا يجب أن يكون نطاق تقريري؟

في معظم التقارير، ننصحك بإعداد Reports.reportScope إلى حساب محرك بحث معيّن أو معلِن محدّد للأحجام الكبيرة جدًا التقارير - مثل تقارير الكلمات الرئيسية أو تقارير الإحالات الناجحة تقارير مقسَّمة بدقة - نوصي بقصر النطاق على حساب محرّك بحث معيّن. قد تعرض واجهة برمجة التطبيقات أخطاءً للتقارير التي يزيد حجمها عن 10 ملايين صف.

لماذا أتلقى رسالة الخطأ "محظور (403)؟

على الأرجح، تحتاج إلى الحصول على رمز OAuth المميز لإعادة التحميل.

كيف يمكنني العثور على أرقام تعريف الوكالات والمعلِنين؟

في حال لم يسبق لك إضافة أرقام تعريف الوكالات والمعلنين إذن لعرض، طلب advertiser باستخدام العمودين agencyId وadvertiserId، ولكن لا تحدد reportScope. ستعرض "إعلانات شبكة البحث 360" قائمة بجميع أرقام تعريف الوكالات والمعلِنين التي لدى حساب Google إذن بالعرض.

إليك مثال على الطلب:

POST  https://www.googleapis.com/doubleclicksearch/v2/reports/generate
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
  "reportType": "advertiser",
  "columns": [
    { "columnName": "agency" },
    { "columnName": "agencyId" },
    { "columnName": "advertiser" },
    { "columnName": "advertiserId" }
  ],
  "statisticsCurrency": "usd"
}
        

استخدام النص البرمجي لأداة "إعلانات شبكة البحث 360" لإرسال هذا الطلب

لإرسال طلب JSON POST الأولي، يمكنك استخدام sa360Api.py البرنامج النصي على النحو التالي:

1. انسخ مثال كائن JSON (كل ما بين العنصرين، بما في ذلك الأقواس المتعرجة) في ملف نصي جديد باسم request.txt.
2. غيِّر رقم تعريف الوكالة الوارد في رمز JSON إلى رقم تعريف الوكالة الخاص بك.
3. إزالة أي تعليقات، مثل // The date column segments the report by individual days.
4. يمكنك تجميع بيانات اعتماد OAuth 2.0 في سلسلة واحدة يتم الفصل بينها بفواصل. يتابع:
   client-ID,client-secret,refresh-token
   (هذه هي السلسلة نفسها التي يُخرجها sa360Api.py عند تشغيل sa360Api.py --login كما هو موضّح في الإعداد التفويض).
5. استدعِ sa360Api.py على النحو التالي:
   sa360Api.py --cred CREDENTIALS --server API-method --post < request.txt
   في الأمر أعلاه، استبدل السلسلة التي جمعتها في الخطوة السابقة بـ CREDENTIALS.
   استبدِل اسم طريقة POST في المربّع أدناه بـ API-method.

   مثال:
   sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw --server https://www.googleapis.com/doubleclicksearch/v2/reports/generate --post < request.txt

ملاحظة:

بما أنّ statisticsCurrency حقل مطلوب، يجب تحديد usd في هذا الطلب. في التقارير الأخرى التي تم تحديد نطاقها معلنًا أو أقل، يمكنك طلب عرضه بعملة أخرى.

إلى أي مدى تكون بيانات إعداد التقارير حديثة؟

وتكون بعض المقاييس أحدث من غيرها. لمعرفة التفاصيل، يُرجى الاطّلاع على مدى حداثة بيانات إعداد التقارير. في "إعلانات شبكة البحث 360"؟

للتأكّد من احتواء تقاريرك على جميع المقاييس المتاحة، نقترح انتظار حوالي 4 مقاييس. بعد منتصف الليل (المنطقة الزمنية لحساب محرك البحث) قبل طلب تقارير عن أحداث الأمس metrics; لتقرير conversion، ننصحك بانتظار تقرير 12 ساعة بعد منتصف الليل (المنطقة الزمنية لمعلِن "مدير الحملة") في حال استخدام واجهة برمجة التطبيقات لتحميل بيانات الإحالات الناجحة، اطّلِع على insert.operation للحصول على تفاصيل حول توفّر البيانات المحمَّلة.

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

متى ستظهر تغييرات السمات في التقارير؟

يستغرق ظهور تغييرات السمات التي يجريها المستخدم في "إعلانات شبكة البحث 360" حوالي دقيقة. التي تنزّلها عبر واجهة برمجة التطبيقات التغييرات التي يتم إجراؤها مباشرةً على المحرّك الخارجي (وليس من خلال "إعلانات شبكة البحث 360") إلى "إعلانات شبكة البحث 360" أولاً باستخدام المزامنة الواردة.

ونقترح عليك العودة فقط البيانات التي تم تغييرها لتحديد الكيانات التي تغيرت السمات.

ما هي الإعلانات والكلمات الرئيسية غير المحدَّدة المصدر؟

في بعض الأحيان، لا يمكن أن تنسب "إعلانات شبكة البحث 360" المقاييس إلى إعلان معيّن. على سبيل المثال، إذا كان أحد الإعلانات يحتوي على إنّ التنسيق غير المتوافق أو عنوان URL لخادم النقرات الذي يتضمّن خطأ يمكن أن يمنع "إعلانات شبكة البحث 360" من تحديد مصدر الإحالات الناجحة. المقاييس إلى الإعلان. بالنسبة إلى كل مجموعة إعلانية، تُبلغ "إعلانات شبكة البحث 360" عن أي مقاييس غير منسوبة إلى "إعلان غير منسوبة" لطلب هذه المقاييس في تقرير، يجب ضبط includeRemovedEntities إلى true. لتسهيل معرفة الإعلانات التي لم يتم تحديد مصدرها، ضمِّن عمود "isUnattributedAd" في الطلب.

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

هل تتضمّن التقارير إحالات ناجحة مُعدَّلة؟

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

يطبِّق Floodlight دائمًا تغيير الحجم على أعمدة إعداد التقارير التالية:

• dfaActions
• dfaRevenue
• dfaTransactions
• dfaWeightedActions
• الأعمدة المحفوظة التي إعداد تقارير عن أنشطة Floodlight

conversion الإحالات الناجحة المُعدَّلة. لا تعرِض سوى الإحالات الناجحة التي تم قياسها. مباشرةً. عدد الإحالات الناجحة ومبلغ الأرباح في تقرير "conversion" من المتوقع أن تتطابق مع الإحالات الناجحة والأرباح الواردة في الأعمدة المذكورة أعلاه.

لماذا لا يتم جمع الإحالات الناجحة الأولية إلى المقياس المجمّع X؟

في حال عدم توافق المقاييس المجمّعة مع الأحداث الأولية في "إعلانات شبكة البحث 360"، يُرجى الثقة في مقياس مجمّع. عند احتساب عمليات تجميع المقاييس، تحاول "إعلانات شبكة البحث 360" تنقيح البيانات المصادر عن طريق إزالة الإحالات الناجحة التي يشتبه في أنّها مكرّرة.

ماذا لو لم تتم الإجابة عن سؤالي هنا؟

إذا واجهتك مشكلة لا يمكنك حلها بعد قراءة الموارد على هذا الموقع، التواصل مع فريق الدعم والحصول على المعلومات التالية جاهزة:

• الرقم التعريفي للوكالة والرقم التعريفي للمعلِن في "إعلانات شبكة البحث 360" اللذين تحاول الوصول إليهما

• رقم المشروع من وحدة تحكم Google API

• اسم المستخدم لحساب Google الذي تستخدمه للوصول إلى واجهة برمجة التطبيقات.
  هذا هو الحساب الذي تم منحه إذن للوصول إلى "إعلانات شبكة البحث 360"، وهو الحساب نفسه الذي تستخدمه إعداد التفويض

• مقتطف رمز طلبك

• استجابة JSON
  إذا كان الرد خطأً، فتأكد من تضمين رسالة الخطأ، وليس فقط رمز الخطأ الرقمي.