نوع التقرير: زيارة

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

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

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

طلب مقتطف

إرسال رسالة عادية Reports.request() نص الطلب، ولكن يجب تحديد "reportType": "visit". 

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

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

columnNameالوصفالسلوكالنوعقابلة للفلترة
status حالة الزيارة. الزيارات غير قابلة للتغيير، وبالتالي تكون هذه القيمة دائمًا Active. سمة Status نعم
deviceSegment شريحة الجهاز التي تُنسَب إليها الزيارة: Desktop أو Mobile أو Tablet أو Other سمة Device segment نعم
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) التي تمّ ضبطها لخلاصة Merchant Center التي تحتوي على بيانات عن المنتج. سمة String نعم
productStoreId المتجر في "الإعلان للمنتجات داخل المتجر" الذي تم النقر عليه يجب أن تتطابق هذه القيمة مع أرقام تعريف المتاجر المستخدَمة في خلاصة المنتجات في المتاجر المحلّية. سمة String نعم
productChannel قناة بيع المنتج الذي تم النقر عليه: Online أو Local. سمة Product channel نعم
visitId رقم تعريف الزيارة في DS. سمة ID نعم
visitSearchQuery طلب البحث الذي أدى إلى إنشاء هذه الزيارة. سمة String نعم
visitDate التاريخ، في المنطقة الزمنية لحساب محرّك البحث، وقت حدوث الزيارة. يُستخدَم هذا التاريخ لتجميع الزيارات. على سبيل المثال، عندما يجمع DS الزيارات ليوم 1 أيار (مايو)، يتم احتساب جميع الزيارات التي تكون قيمة visitDate فيها 1 أيار (مايو). سمة Date نعم
visitTimestamp الطابع الزمني للتوقيت العالمي المتفق عليه عند حدوث الزيارة سمة Timestamp نعم
visitNetworkType شبكة الإعلانات التي أدت إلى إنشاء هذه الزيارة: Content أو Search أو Other. سمة Network type نعم
visitReferrer عنوان URL المُحيل للزيارة. سمة String نعم
visitExternalClickId سلسلة فريدة لكل زيارة يتم تمريرها إلى الصفحة المقصودة على أنّها معلَمة عنوان URL للسمة gclid. لا يتم تفعيل هذا الخيار إلا للمعلِنين الذين لديهم دمج واجهة برمجة تطبيقات للإحالات الناجحة أو دمج "إحصاءات Google". سمة String نعم
feedItemId رقم تعريف صف عنصر الخلاصة المرتبط بهذه الزيارة. سمة ID نعم
feedId رقم تعريف جدول الخلاصة المرتبط بهذه الزيارة. سمة ID نعم
feedType نوع الخلاصة المرتبطة بهذه الزيارة سمة Feed type نعم