إعداد تقارير عن إضافات روابط أقسام الموقع في "إعلانات Google"

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

يمكنك طلب أنواع مختلفة من التقارير التي تحتوي على مقاييس لإضافات روابط أقسام الموقع في "إعلانات Google":

  • تقرير adGroup أو campaign مقسّم يعرض عدد النقرات ومرات الظهور والبيانات الأخرى لكل رابط أقسام موقع في المجموعة الإعلانية أو الحملة.

  • تقرير conversion أو visit يعرض بيانات أولية عن الزيارات والإحالات الناجحة الفردية، بما في ذلك أرقام تعريف أي روابط أقسام موقع تم النقر عليها والتي تمّ تحديد مصدرها للزيارة/الإحالة الناجحة.

  • تقرير feedItem يعرض المقاييس وتفاصيل الإعدادات لكل رابط أقسام موقع على مستوى جميع الحملات والمجموعات الإعلانية التي تم تطبيق الرابط عليها.

طلب تقرير مقسّم للمجموعة الإعلانية أو الحملة

للاطّلاع على عدد النقرات ومرّات الظهور والبيانات الأخرى لكل رابط من روابط أقسام الموقع في مجموعة إعلانية أو حملة معيّنة، يمكنك طلب تقرير adGroup أو campaign وتضمين أحد أعمدة "تصنيف روابط أقسام الموقع"، مثل sitelinkDisplayText.

مثال على الطلب

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaign",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "sitelinkDisplayText" },
    { "columnName": "feedItemId" },
    { "columnName": "clicks" },
    { "columnName": "clicksWithFeedItemShowing" },
    { "columnName": "adWordsConversions" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

مثال للتقرير

في ما يلي مثال على تقرير campaign بتنسيق CSV مقسّمًا حسب sitelinkDisplayText:

account,campaign,sitelinkDisplayText,feedItemId,clicks,clicksWithFeedItemShowing,adWordsConversions
Hooper's - Google,Accessories,Summer 2014,33700000014504870,10895,12895,1157
Hooper's - Google,Accessories,$30 and Under,33700000014504871,10816,12816,1145
Hooper's - Google,Accessories,Tote Bags,33700000014504872,12790,12790,1147

للاطّلاع على البيانات الأولية حول الزيارات والإحالات الناجحة الفردية، بما في ذلك أرقام تعريف أي روابط أقسام موقع تم النقر عليها ونسبها إلى الزيارة/الإحالة الناجحة، اطلب تقرير conversion أو visit وأدرِج عمود feedItemId في الطلب.

مثال على الطلب

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "conversion",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "floodlightActivity" },
    { "columnName": "feedType" },
    { "columnName": "feedItemId" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

مثال للتقرير

في ما يلي مثال على تقرير conversion بتنسيق CSV مع بعض أعمدة عناصر الخلاصة:

account,campaign,floodlightActivity,feedType,feedItemId
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504870
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504871
Hooper's - Google,Bedroom,Thank you page,Sitelink,33700000014504872

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

طلب تقرير FeedItem

للاطّلاع على المقاييس وتفاصيل الإعدادات لكل رابط أقسام موقع على مستوى جميع الحملات والمجموعات الإعلانية التي تم تطبيق الرابط عليها، يمكنك طلب تقرير feedItem .

مثال على الطلب

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "feedItem",
  "columns": [
     { "columnName": "feedItemId" },
     { "columnName": "sitelinkDisplayText" },
     { "columnName": "sitelinkDescription1" },
     { "columnName": "sitelinkDescription2" },
     { "columnName": "sitelinkLandingPageUrl" },
     { "columnName": "clicks" },
     { "columnName": "clicksWithFeedItemShowing" },
     { "columnName": "dfaRevenue" }
  ],
  "timeRange" : {
    "startDate" : "2014-07-21",
    "endDate" : "2014-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}

مثال للتقرير

في ما يلي مثال على تقرير feedItem بتنسيق CSV:

feedItemId,sitelinkDisplayText,sitelinkDescription1,sitelinkDescription2,sitelinkLandingPageUrl,clicks,clicksWithFeedItemShowing,dfaRevenue
33700000014504870,Summer 2014,,,http://www.hoopers.com/summer2012,10895,12895,141653.25421900
33700000014504871,$30 and Under,,,http://www.hoopers.com/sortby/lowprice,10816,12816,143600.27534400
33700000014504872,Tote Bags,,,http://www.hoopers.com/tote,12790,12790,140178.19750400