العناصر الاختيارية لـ "حملة الأداء الأفضل"

أهداف الإحالات الناجحة

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

ولإجراء ذلك، عليك أولاً جلب قائمة بجميع أهداف الإحالات الناجحة للعملاء.

const searchResults = AdsApp.search(
  `SELECT
     customer_conversion_goal.category,
     customer_conversion_goal.origin
   FROM customer_conversion_goal`
);

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

قبل تنفيذ هذا الرمز، عليك جلب معرّف الحملة ل "حملة الأداء الأفضل".

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

operations = [];
while (searchResults.hasNext()) {
  const row = searchResults.next();
  const conversionGoal = row.customerConversionGoal;

  operations.push({
    "campaignConversionGoalOperation": {
      "update": {
        "resourceName": `customers/${customerId}/campaignConversionGoals/${campaignId}~${conversionGoal.category}~${conversionGoal.origin}`,
        // Insert your logic here to determine whether you want this particular
        // campaign conversion goal to be biddable or not.
        // This code will just default everything to being biddable, but that
        // is not necessarily best for your use case.
        "biddable": true
      },
      "updateMask": "biddable"
    }
  });
}

AdsApp.mutateAll(operations, {partialFailure: false});

استهداف الحملة

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

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

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

operations.push({
  "campaignCriterionOperation": {
    "create": {
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "negative": false,
      "location": {
        // 1023191 represents New York City
        "geoTargetConstant": "geoTargetConstants/1023191"
      }
    }
  }
});

إشارات مجموعة مواد العرض

اطّلِع على إشارات مجموعة مواد العرض في مستندات واجهة برمجة التطبيقات قبل البدء. يتم إعداد هذه المجموعات من خلال ربط مجموعة مواد عرض بأحد معايير AudienceInfo أو SearchThemeInfo الحالية. إذا أردت استخدام شريحة جمهور بدلاً من ذلك، حدِّد الحقل audience بدلاً من الحقل searchTheme مع اسم مورد شريحة الجمهور.

operations.push({
  "assetGroupSignalOperation": {
    "create": {
      "assetGroup": assetGroupOperation.assetGroupOperation.create.resourceName,
      "searchTheme": {
        "text": "mars cruise"
      }
    }
  }
});