إعداد تقرير عن أهداف الحملة والمجموعة الإعلانية

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

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

يمكن تطبيق بعض أنواع الاستهداف على الحملات فقط، بينما يمكن تطبيق البعض الآخر على المجموعات الإعلانية فقط. لمعرفة الاستهدافات المتوفرة في كل مستوى، يُرجى الرجوع إلى مستندات تقريرَي campaignTarget وadGroupTarget.

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

الاستهدافات السلبية

تمنع الاستهدافات السلبية ظهور الإعلانات عندما تتطابق عمليات البحث مع معايير معيّنة. على غرار الاستهدافات، لا يمكن تطبيق بعض أنواع الاستهدافات السلبية إلا على الحملات، في حين لا يمكن تطبيق البعض الآخر إلا على المجموعات الإعلانية. يمكنك الاطّلاع على negativeCampaignTarget وnegativeAdGroupTarget لمعرفة التفاصيل.

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

أمثلة على الطلبات

في ما يلي أمثلة على الطلبات الخاصة بأنواع مختلفة من الاستهدافات:

• المواقع الجغرافية المستهدَفة في الحملة
• استهدافات تجديد النشاط التسويقي لجميع المجموعات الإعلانية في الحساب
• استهدافات الإعلانات الديناميكية لجميع المجموعات الإعلانية في أحد الحسابات
• استهدافات المواقع الجغرافية السلبية لجميع الحملات في الحساب

إعداد تقارير عن المواقع الجغرافية المستهدفة في الحملة

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

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

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "campaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

مثال للتقرير

إليك مثال على تقرير campaignTarget. يعرض التقرير أداء موقع جغرافي مستهدف يحدّد "الولايات المتحدة"، وهدف قريب يحدّد "100.0 ميل حول (37.4220041،-122.0862462)"، وموقع جغرافي مستهدف آخر يحدّد الرمز البريدي للولايات المتحدة (90210):

account,campaign,locationTargetName,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,US,10895,12895,1255.07000000,1157
Hooper's - Google,Accessories,"100.0 miles around (37.4220041,-122.0862462)",10816,12816,1285.07000000,1145
Hooper's - Google,Accessories,90210,12790,12790,1124.06000000,1147
    

أهداف تجديد النشاط التسويقي لجميع المجموعات الإعلانية في الحساب

يعرض المثال التالي طلب غير متزامن عدد النقرات ومرات الظهور والبيانات الأخرى لجميع أهداف تجديد النشاط التسويقي المحددة للمجموعات الإعلانية في حملة معينة على "إعلانات Google".

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

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201", // Replace with your IDs
    "campaignId": "700000000058578" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "engineRemarketingList" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

مثال للتقرير

إليك مثال على تقرير adGroupTarget. ويوضّح التقرير أن ثلاث مجموعات إعلانية في حملة "الملحقات" تحدّد أهداف تجديد النشاط التسويقي. يتم أيضًا تضمين مقاييس الأداء لكل هدف تجديد نشاط تسويقي:

account,campaign,adGroup,engineRemarketingList,clicks,impr,cost,dfaActions
Hooper's - Google,Accessories,Summer 2016,Weekend Warriors,7707,26333,1255.07000000,3
Hooper's - Google,Accessories,$30 and Under,Email Subscribers,6992,29630,3170.18000000,8
Hooper's - Google,Accessories,Tote Bags,Repeat Buyers,4535,20504,1524.88000000,2
    

استهدافات الإعلانات الديناميكية لجميع المجموعات الإعلانية في الحساب

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

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

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

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "adGroupTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "adGroup" },
    { "columnName": "dynamicSearchAdsTargetConditions" },
    { "columnName": "dynamicSearchAdsTargetCoverage" },
    { "columnName": "clicks" },
    { "columnName": "impr" },
    { "columnName": "cost" },
    { "columnName": "dfaActions"}
  ],
  "timeRange" : {
    "startDate" : "2016-07-21",
    "endDate" : "2016-08-19"
  },
 "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

مثال للتقرير

إليك مثال على تقرير adGroupTarget. يوضح التقرير أن مجموعة إعلانية واحدة في حملة "متاجر Google Store" تحدّد استهداف إعلان ديناميكي. يتم أيضًا تضمين مقاييس الأداء للهدف:

account,campaign,adGroup,dynamicSearchAdsTargetConditions,dynamicSearchAdsTargetCoverage,clicks,impr,cost,dfaActions
Hooper's - Google,Google Stores,Chargers,"AND(CATEGORY = ""Electronics"",CATEGORY = ""Accessories"")",4535,20504,1524.88000000,2
    

إعداد تقارير عن المواقع الجغرافية المستهدفة السلبية للحملات

يعرض المثال التالي طلب غير متزامن المواقع الجغرافية المستبعدة من الحملات في حساب محرك بحث (لا تتوفّر ميزة إعداد التقارير عن المواقع الجغرافية المستهدفة السلبية إلا للحملات على "إعلانات Google"). لا تستخدم المواقع الجغرافية المستهدفة السلبية إلا المواقع الجغرافية المستهدفة كمعايير (لا يمكنها تحديد استهدافات قريبة أو استهدافات نطاق جغرافي مستهدف). لذا، تحتوي تقارير المواقع الجغرافية المستهدفة السلبية فقط على قائمة بالمواقع الجغرافية التي يتم استثناؤها من الحملات ضمن نطاق التقرير.

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

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

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345", // Replace with your IDs
    "engineAccountId": "700000000042201" // Replace with your IDs
  },
  "reportType": "negativeCampaignTarget",
  "columns": [
    { "columnName": "account" },
    { "columnName": "campaign" },
    { "columnName": "locationTargetName" }
  ],
  "downloadFormat": "csv",
  "maxRowsPerFile": 6000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
    

مثال للتقرير

إليك مثال على تقرير negativeCampaignTarget. يوضّح التقرير أنّ حملة "الافتتاحات الكبرى - شمال شرق" تستثني ولاية مين، في حين تستثني حملة "الافتتاحات الكبرى - الغرب" ولاية كاليفورنيا:

account,campaign,locationTargetName
Hooper's - Google,Grand openings - NE,US-ME
Hooper's - Google,Grand openings - West,US-CA