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

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى واجهة Search Ads 360 Reporting 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 ساعات بعد منتصف الليل (المنطقة الزمنية لحساب محرّك البحث) قبل طلب تقارير عن مقاييس الأمس. وبالنسبة إلى تقرير 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
  إذا كانت الاستجابة خطأ، تأكَّد من تضمين رسالة الخطأ، وليس رمز الخطأ الرقمي فقط.