تحميل مجمع

تتيح لك نصوص "إعلانات Google" البرمجية إجراء تغييرات مجمّعة في حسابك من خلال تحميل البيانات بتنسيق CSV. يمكنك تحميل البيانات من ملف CSV من Google Drive أو جدول بيانات Google أو جدول بيانات Microsoft Excel، أو إنشاء طلب تحميل مجمّع في النص البرمجي أثناء التشغيل. يوضّح هذا الدليل كيفية استخدام هذه الميزة في نصوصك البرمجية.

الاستخدام

باستخدام عمليات التحميل المجمّعة، يمكنك إجراء أنواع معيّنة من التغييرات التي لن تكون متاحة برمجيًا في "إعلانات Google"، مثل إدارة الحملات أو تحميل الإحالات الناجحة بلا إنترنت.

إنشاء عملية تحميل مجمّع من Google Drive

إنّ أبسط طريقة لاستخدام ميزة التحميل المجمّع هي تحميل ملف CSV في Google Drive، ثم تحميل هذا الملف إلى "إعلانات Google" باستخدام نصوص "إعلانات Google" البرمجية:

const file = DriveApp.getFilesByName("BulkCampaignUpload.csv")
    .next();
const upload = AdsApp.bulkUploads().newFileUpload(file);
upload.forCampaignManagement();
upload.preview();

يؤدي ذلك إلى إنشاء إدخال معاينة للتحميل المجمّع في حسابك ضمن الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل.

انقر على الرابط معاينة لعرض التغييرات.

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

بعد التأكّد من أنّ النص البرمجي يعمل بشكل صحيح، يمكنك تخطّي مرحلة المعاينة وتطبيق التغييرات مباشرةً من النص البرمجي. ويمكن إجراء ذلك من خلال استدعاء الأسلوب apply() لمثيل التحميل المجمّع بدلاً من الأسلوب preview() .

إنشاء عملية تحميل مجمّع من البداية

يمكنك إنشاء مهمة تحميل مجمّع من البداية باتّباع الخطوات التالية:

// The best way to find column names is to consult a template
// as described in the last section of this guide.
const columns = [
   "Campaign", "Budget", "Bid Strategy type", "Campaign type"
];

const upload = AdsApp.bulkUploads().newCsvUpload(columns);

// Call append once for each row you'd like to upload
upload.append({
   "Campaign": "Test Campaign 1",
   "Budget": 2.34,
   "Bid Strategy type": "cpc",
   "Campaign type": "Search Only"
});
upload.forCampaignManagement();
upload.preview();

ضبط الوحدة النقدية

يتم تلقائيًا تفسير مبالغ الأموال في عمليات التحميل المجمّعة على أنّها المبلغ الفعلي للعملة. إذا كنت تفضّل استخدام المايكرو، يمكنك ضبط الخيار moneyInMicros على true عند إنشاء مهمة التحميل (على سبيل المثال، يجب إدخال 2.34 يورو على النحو التالي 2340000).

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {moneyInMicros: true});

ضبط لغة الملف

يتم تفسير محتوى ملف CSV تلقائيًا باللغة الإنجليزية (الولايات المتحدة) (en_US). يمكنك تحديد لغة مختلفة باستخدام الخيار fileLocale، كما هو موضّح أدناه:

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {fileLocale: "fr_FR"});

عند تحديد لغة، يمكنك تقديم رؤوس الأعمدة إما بلغة en_US أو باللغة التي تحددها في السمة fileLocale.

تعيين المنطقة الزمنية

يتم تلقائيًا تفسير إدخالات الوقت في الملف بالتنسيق America/Los_Angeles. يمكنك تحديد منطقة زمنية مختلفة باستخدام الخيار timeZone. حدِّد المنطقة الزمنية بتنسيق قاعدة بيانات TZ .

const upload = AdsApp.bulkUploads().newCsvUpload(columns,
    {timeZone: "America/New_York"});

يمكن أن يكون ضبط منطقة زمنية مفيدًا عند تحميل الإحالات الناجحة بلا إنترنت.

نماذج جداول البيانات للتحميل المجمّع

إنّ أسهل طريقة للحصول على نموذج جدول بيانات لإجراء عملية تحميل مجمّعة هي من واجهة مستخدِم "إعلانات Google".

• سجِّل الدخول إلى حسابك على "إعلانات Google".
• انتقِل إلى الأدوات والإعدادات > الإجراءات المجمّعة > عمليات التحميل.
• انقر على الزر + لبدء عملية تحميل جديدة.
• سيظهر بعد ذلك قسم يتضمّن مجموعة متنوعة من النماذج للاختيار من بينها.

يمكنك أيضًا تنزيل العديد من النماذج المختلفة من مركز المساعدة .