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

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

لا يمكن عرض هذا التقرير إلا باستخدام طلب غير متزامن (أي عبر 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 في DS. سمة ID نعم
floodlightGroupTag علامة مجموعة Floodlight. سمة String نعم
floodlightActivity اسم نشاط Floodlight. سمة String نعم
floodlightActivityId رقم تعريف نشاط Floodlight في DS. سمة ID نعم
floodlightActivityTag علامة نشاط Floodlight. سمة String نعم
agency اسم الوكالة سمة String نعم
agencyId رقم تعريف وكالة DS. سمة ID نعم
advertiser اسم المعلِن سمة String نعم
advertiserId الرقم التعريفي للمعلِن في DS. سمة ID نعم
account اسم حساب محرّك البحث سمة String نعم
accountId رقم تعريف حساب محرك البحث في DS. سمة 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 رقم تعريف الحملة في DS. سمة ID نعم
campaignStatus حالة الحملة التي تحتوي على هذا العنصر. سمة Status نعم
adGroup اسم المجموعة الإعلانية. سمة String نعم
adGroupId رقم تعريف المجموعة الإعلانية في DS. سمة ID نعم
adGroupStatus حالة المجموعة الإعلانية التي تحتوي على هذا العنصر. سمة Status نعم
keywordId رقم تعريف الكلمة الرئيسية في DS. تشير القيمة 0 إلى أنّ الكلمة الرئيسية لم يتم تحديد مصدرها. سمة ID نعم
keywordMatchType نوع مطابقة الكلمة الرئيسية: Broad أو Exact أو Phrase أو Content. سمة Match type نعم
keywordText نص الكلمة الرئيسية. سمة String نعم
productTargetId رقم تعريف استهداف المنتج في DS. سمة ID نعم
productGroupId رقم تعريف مجموعة المنتجات المرتبطة بهذه الإحالة الناجحة. تشتمل الإحالات الناجحة من حملات التسوّق فقط على معرّفات مجموعات منتجات. ينبغي عدم استخدام أرقام تعريف مجموعات المنتجات للانضمام. سمة ID نعم
ad اسم الإعلان. سمة String نعم
adId رقم تعريف الإعلان في DS. وتشير القيمة 0 إلى أنّ الإعلان لم يتمّ تحديد مصدره. سمة ID نعم
isUnattributedAd يشير إلى ما إذا كانت المقاييس في هذا الصف لا يمكن نسبها إلى إعلان معيّن. على سبيل المثال، يمكن أن يمنع إعلان ذو شكل غير متوافق أو عنوان URL لخادم النقرات خطأ DS من إسناد المقاييس إلى أحد الإعلانات. سمة Boolean نعم
inventoryAccountId رقم تعريف حساب المستودع في DS الذي يحتوي على المنتج المرتبط بالإحالة الناجحة. يُنشئ 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" رقمًا تعريفيًا. بالنسبة إلى الإحالات الناجحة على الإنترنت، تساوي هذه القيمة عمود "رقم تعريف الإحالة الناجحة" أو عمود Floodlight OrderId استنادًا إلى تعليمات Floodlight لدى المعلِن. سمة String نعم
conversionType نوع الإحالة الناجحة: Action أو Transaction. سمة Conversion type نعم
conversionRevenue إجمالي المبلغ بالدولار الأمريكي من الإحالة الناجحة. سمة Money نعم
conversionQuantity عدد السلع التي سجّلتها الإحالة الناجحة، على النحو الذي تحدّده المَعلمة qty. المعلِن مسؤول عن تعبئة المَعلمة بشكلٍ ديناميكي (مثل عدد السلع المُباعة في الإحالة الناجحة)، وإلّا يتم ضبطه تلقائيًا على 1. سمة Number نعم
conversionDate التاريخ، في المنطقة الزمنية لشبكة "مدير الحملة"، وقت حدوث الإحالة الناجحة. يُستخدَم هذا التاريخ لتجميع مقاييس الإحالات الناجحة. على سبيل المثال، عندما يجمع DS الإجراءات ليوم 1 أيار (مايو)، يتم احتساب كل الإحالات الناجحة للإجراءات التي تكون قيمة conversionDate فيها 1 أيار (مايو). سمة Date نعم
conversionTimestamp الطابع الزمني للتوقيت العالمي المتفق عليه عند حدوث الإحالة الناجحة. سمة Timestamp نعم
conversionLastModifiedTimestamp الطابع الزمني للتوقيت العالمي المتفق عليه لأحدث تعديل في الإحالة الناجحة. سمة Timestamp نعم
conversionAttributionType ما تُنسَب إليه الإحالة الناجحة: Visit أو Keyword+Ad. سمة Conversion attribution type نعم
conversionVisitId رقم تعريف زيارة DS الذي تُنسَب إليه الإحالة الناجحة. سمة ID نعم
conversionVisitTimestamp الطابع الزمني للتوقيت العالمي المتفق عليه للزيارة التي تُنسَب إليها الإحالة الناجحة. سمة Timestamp نعم
conversionVisitExternalClickId سلسلة فريدة للزيارة التي تُنسب إليها الإحالة الناجحة، والتي يتم تمريرها إلى الصفحة المقصودة باعتبارها معلَمة عنوان URL gclid. لا يتم تفعيل هذا الخيار إلا للمعلِنين الذين لديهم دمج واجهة برمجة تطبيقات للإحالات الناجحة أو دمج "إحصاءات Google". سمة String نعم
conversionSearchTerm عبارة البحث التي أدت إلى الإحالة الناجحة. سمة String نعم
floodlightOriginalRevenue الأرباح الأصلية التي لم تتغيّر والمرتبطة بحدث Floodlight (بعملة التقرير الحالي)، قبل تعديلات تعليمات عملة Floodlight. سمة Money نعم
floodlightEventRequestString سلسلة طلب Floodlight للإحالة الناجحة. سمة String نعم
floodlightReferrer الموقع الإلكتروني لمحيل Floodlight للإحالة الناجحة سمة String نعم
floodlightOrderId رقم تعريف طلب Floodlight الذي يقدّمه المعلِن للإحالة الناجحة سمة String نعم
feedItemId رقم تعريف صف العنصر في الخلاصة المرتبط بهذه الإحالة الناجحة. سمة ID نعم
feedId رقم تعريف جدول الخلاصة المرتبط بهذه الإحالة الناجحة. سمة ID نعم
feedType نوع الخلاصة المرتبطة بهذه الإحالة الناجحة. سمة Feed type نعم