نوع التقرير: إحالة ناجحة

بيانات الأحداث الأوّلية عن الإحالات الناجحة

لا يمكن عرض هذا التقرير إلّا من خلال طلب غير متزامن (أي من خلال الأسلوب Reports.request()).

وبما أنّ الأحداث تحدث في تواريخ محدّدة، يجب أن يحدّد طلب هذا التقرير timeRange. يمكنك تحديد أيٍّ ممّا يلي:

طلب مقتطف

أرسِل محتوى طلب عاديًا Reports.request() ، ولكن حدِّد "reportType": "conversion". 

{
...
  "reportType": "conversion",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

لكل عمود تريد عرضه أو فلترته في التقرير، حدِّد columnName المدرَج في الجدول أدناه. يمكنك أيضًا اختياريًا تحديد headerText، startDate، وendDate. يُرجى العِلم أنّه لا يمكن فلترة بعض الأعمدة، راجِع "العناصر التي يمكن فلترتها" في الجدول أدناه.

columnNameالوصفالسلوكالنوعقابل للفلترة
status حالة الإحالة الناجحة: Active أو Removed. سمة Status نعم
deviceSegment شريحة الأجهزة التي تُنسَب إليها الإحالة الناجحة: Desktop أو Mobile أو Tablet أو Other. سمة Device segment نعم
floodlightGroup اسم مجموعة Floodlight. سمة String نعم
floodlightGroupConversionType نوع الإحالات الناجحة التي تم إنشاؤها من خلال أنشطة Floodlight في هذه المجموعة: Action أو Transaction. سمة Conversion type نعم
floodlightGroupId رقم تعريف مجموعة Floodlight في "إحصاءات Google‏ 4" سمة ID نعم
floodlightGroupTag علامة مجموعة Floodlight سمة String نعم
floodlightActivity اسم نشاط Floodlight سمة String نعم
floodlightActivityId رقم تعريف نشاط Floodlight في DS سمة ID نعم
floodlightActivityTag علامة نشاط Floodlight سمة String نعم
agency اسم الوكالة سمة String نعم
agencyId رقم تعريف الوكالة في DS سمة ID نعم
advertiser اسم المعلِن سمة String نعم
advertiserId رقم تعريف المعلِن في "مساحة العرض والفيديو 360" سمة ID نعم
account اسم حساب محرّك البحث سمة String نعم
accountId رقم تعريف حساب محرّك "إعلانات شبكة البحث" سمة ID نعم
accountEngineId رقم تعريف الحساب في حساب المحرّك الخارجي سمة String نعم
accountType نوع حساب المحرّك: Google AdWords أو Bing Ads أو Yahoo Japan Listing Ads أو Yahoo Search Marketing أو Yahoo Gemini أو Baidu أو Comparison Shopping سمة Engine type نعم
campaign اسم الحملة. سمة String نعم
campaignId رقم تعريف حملة "إعلانات شبكة البحث". سمة ID نعم
campaignStatus حالة الحملة التي تحتوي على هذا العنصر. سمة Status نعم
adGroup اسم المجموعة الإعلانية. سمة String نعم
adGroupId رقم تعريف المجموعة الإعلانية في "شبكة البحث" سمة ID نعم
adGroupStatus حالة المجموعة الإعلانية التي تحتوي على هذا العنصر. سمة Status نعم
keywordId رقم تعريف الكلمة الرئيسية في DS وتشير القيمة 0 إلى أنّ الكلمة الرئيسية غير منسوبة. سمة ID نعم
keywordMatchType نوع مطابقة الكلمة الرئيسية: Broad أو Exact أو Phrase أو Content سمة Match type نعم
keywordText نص الكلمة الرئيسية سمة String نعم
productTargetId رقم تعريف استهداف المنتج في "الحملات الديناميكية على شبكة البحث" سمة ID نعم
productGroupId معرّف مجموعة المنتجات المرتبط بهذه الإحالة الناجحة. لا تتضمّن سوى الإحالات الناجحة من حملات Shopping أرقام تعريف مجموعات المنتجات. يجب عدم استخدام معرّفات مجموعات المنتجات لإجراء عمليات الدمج. سمة ID نعم
ad اسم الإعلان سمة String نعم
adId رقم تعريف الإعلان في DS. تشير القيمة 0 إلى أنّ الإعلان غير مصدره. سمة ID نعم
isUnattributedAd يشير إلى ما إذا كان لا يمكن تحديد مصدر المقاييس في هذا الصف إلى إعلان معيّن. على سبيل المثال، يمكن أن يمنع الإعلان الذي يتضمّن تنسيقًا غير متوافق أو عنوان URL غير صحيح لخدمة تتبُّع النقرات (CTS) من إسناد المقاييس إلى إعلان. سمة Boolean نعم
inventoryAccountId معرّف حساب مستودع إعلانات Shopping الذي يحتوي على المنتج المرتبط بالإحالة الناجحة. تُنشئ أداة DS هذا المعرّف عند ربط حساب مستودع في DS. سمة ID نعم
productId معرّف المنتج المرتبط بهذه الإحالة الناجحة. سمة String نعم
productCountry البلد (بتنسيق ISO 3166) المسجَّل لخلاصة المستودع التي تحتوي على المنتج المرتبط بهذه الإحالة الناجحة. سمة String نعم
productLanguage لغة المنتج (ISO 639-1) المرتبطة بهذه الإحالة الناجحة سمة String نعم
productStoreId المتجر في "الإعلان للمنتجات داخل المتجر" المرتبط بالإحالة الناجحة ويجب أن يتطابق مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلية. سمة String نعم
productChannel قناة مبيعات المنتج المرتبط بالإحالة الناجحة: Online أو Local. سمة Product channel نعم
conversionId المعرّف الذي تنشئه "إعلانات شبكة البحث 360" لكلّ إحالة ناجحة. سمة ID نعم
advertiserConversionId بالنسبة إلى الإحالات الناجحة بلا إنترنت، يكون هذا المعرّف مقدَّمًا من المعلِنين. وإذا لم يحدِّد المعلِن رقم تعريف كهذا، تنشئ "إعلانات شبكة البحث 360" رقم تعريف. بالنسبة إلى الإحالات الناجحة على الإنترنت، يكون هذا العمود مساويًا لعمود conversionId أو عمود floodlightOrderId استنادًا إلى تعليمات Floodlight للمعلِن. سمة String نعم
conversionType نوع الإحالة الناجحة: Action أو Transaction. سمة Conversion type نعم
conversionRevenue إجمالي المبلغ بالدولار الأمريكي من الإحالة الناجحة. سمة Money نعم
conversionQuantity كمية السلع التي سجّلتها الإحالة الناجحة، كما تحدّدها المَعلمة qty. يتحمّل المعلِن مسؤولية تعبئة المَعلمة ديناميكيًا (مثل عدد السلع التي تم بيعها في الإحالة الناجحة)، وإلا سيتم ضبطها تلقائيًا على 1. سمة Number نعم
conversionDate التاريخ الذي حدثت فيه الإحالة الناجحة، وفقًا للمنطقة الزمنية لشبكة "مدير الحملة" ويُستخدَم هذا التاريخ لتجميع مقاييس الإحالات الناجحة. على سبيل المثال، عندما تُجمِّع "إحصاءات Google‏ 4" الإجراءات في 1 أيار (مايو)، يتم احتساب جميع الإحالات الناجحة للإجراءات التي يكون فيها conversionDate هو 1 أيار (مايو). سمة Date نعم
conversionTimestamp الطابع الزمني بالتوقيت العالمي المنسّق عند حدوث الإحالة الناجحة سمة Timestamp نعم
conversionLastModifiedTimestamp الطابع الزمني بالتوقيت العالمي المتفق عليه لآخر تعديل على الإحالة الناجحة. سمة Timestamp نعم
conversionAttributionType المصدر الذي تمّ تحديد مصدر الإحالة الناجحة إليه: Visit أو Keyword+Ad. سمة Conversion attribution type نعم
conversionVisitId رقم تعريف زيارة "الاستهداف الديناميكي للإعلانات" التي تمّ إسناد الإحالة الناجحة إليها. سمة ID نعم
conversionVisitTimestamp الطابع الزمني بالتوقيت العالمي المنسَّق للزيارة التي تمّ تحديد مصدر الإحالة الناجحة منها. سمة Timestamp نعم
conversionVisitExternalClickId سلسلة فريدة للزيارة التي تُنسَب إليها الإحالة الناجحة، ويتم تمريرها إلى الصفحة المقصودة كمَعلمة عنوان URL gclid. لا تتوفّر هذه الميزة إلا للمعلِنين الذين أكملوا عملية دمج واجهة برمجة التطبيقات Conversion API أو عملية دمج "إحصاءات Google". سمة String نعم
conversionSearchTerm عبارة البحث التي أدّت إلى الإحالة الناجحة. سمة String نعم
floodlightOriginalRevenue الأرباح الأصلية غير المتغيّرة المرتبطة بحدث Floodlight (بالعملة المحدّدة في التقرير الحالي)، قبل إجراء تعديلات على إعدادات عملة Floodlight سمة Money نعم
floodlightEventRequestString سلسلة طلب Floodlight للإحالة الناجحة. سمة String نعم
floodlightReferrer الموقع الإلكتروني المُحيل في Floodlight للإحالة الناجحة. سمة String نعم
floodlightOrderId رقم تعريف طلب Floodlight الذي قدّمه المعلِن للإحالة الناجحة. سمة String نعم
feedItemId معرّف صف عنصر الخلاصة المرتبط بهذه الإحالة الناجحة. سمة ID نعم
feedId معرّف جدول الخلاصة المرتبط بهذه الإحالة الناجحة. سمة ID نعم
feedType نوع الخلاصة المرتبطة بهذه الإحالة الناجحة. سمة Feed type نعم