ضبط الوجهات والعناوين

يظهر كل من مفهوم Destination وعناوين الطلبات بشكل متكرّر عند استخدام Data Manager API. اطّلِع على هذا الدليل للتعرّف على كيفية ضبط الوجهات والعناوين في سيناريوهات مختلفة.

حالات استخدام وجهات أو عناوين

• استخدِم Destination في طلبات الاستيعاب. يستخدم طلب النقل IngestionService لإضافة أعضاء إلى شريحة جمهور أو إزالتهم منها أو لإرسال أحداث. تحدّد قائمة destinations في IngestAudienceMembersRequest أو IngestEventsRequest ما يلي:

  1. الحساب الذي يتلقّى البيانات على سبيل المثال، حساب على "إعلانات Google" أو موقع على "إحصاءات Google".
  2. تمثّل هذه السمة الجهة المستهدَفة للبيانات ضِمن الحساب، مثل إجراء إحالة ناجحة في "إعلانات Google" أو مصدر بيانات في "إحصاءات Google".
  3. مسار الوصول إلى بيانات الاعتماد الخاصة بالطلب في الحساب الذي يتلقّى البيانات

  يمكنك تضمين وجهات متعددة في طلب الاستيعاب نفسه.

  ملاحظة: لا تضبط عناوين الطلبات في طلب IngestionService. تتجاهل واجهة برمجة التطبيقات Data Manager API العناوين في طلب استيعاب البيانات.

• استخدِم عناوين الطلبات في طلبات إدارة الموارد التي تنشئ الموارد أو تعدّلها أو تحذفها أو تستردّها. تحدّد العناوين مسار الوصول إلى بيانات اعتماد الطلب في الحساب المستهدف لطلب إدارة الموارد. في ما يلي قائمة بالمراجع التي تتضمّن طرق إدارة الموارد التي تتوافق مع عناوين الطلبات:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

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

الخطوة	نوع الطلب	عناوين الوجهة أو الطلب
إنشاء شريحة جمهور	إدارة الموارد	عناوين الطلبات
إضافة مستخدمين إلى شريحة جمهور	العرض	وجهات السفر
الاطّلاع على بيانات التشخيص	العرض	وجهات السفر
استرداد شريحة الجمهور	إدارة الموارد	عناوين الطلبات

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

إذا كنت معلنًا أو وكالة، انتقِل إلى سيناريوهات المعلنين للاطّلاع على أمثلة حول كيفية ضبط العناوين وإنشاء Destination:

• إعلانات Google
• مساحة العرض والفيديو 360
• إحصاءات Google

إذا كنت شريك بيانات، انتقِل إلى سيناريوهات شركاء البيانات للاطّلاع على أمثلة حول كيفية ضبط العناوين وإنشاء Destination لإدارة الموارد وإرسال البيانات إلى حساب يتضمّن رابط منتج إلى حساب شريك البيانات:

• إعلانات Google
• مساحة العرض والفيديو 360
• إحصاءات Google

يتناول قسم المتطلبات التفصيلية المتطلبات وقواعد التحقّق من الصحة بالتفصيل.

سيناريوهات المعلِنين

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

إعلانات Google

في ما يلي رسم بياني يعرض مثالاً على مجموعة من حسابات "إعلانات Google" والمستخدِمين.

الحساب الإداري M1

يتضمّن الحساب الإداري (M1) حسابَين فرعيَين مباشرَين:

1. الحساب الإداري M2
2. حساب العميل C1

حساب Google [e-mail] هو مستخدم في M1.

الحساب الإداري M2

يتضمّن الحساب الإداري (M2) حسابَين فرعيَّين مباشرَين:

1. حساب العميل C1
2. حساب العميل C2

حساب Google [e-mail] هو مستخدم في M2.

حساب العميل C1

لدى الحساب C1 حسابان إداريان رئيسيان مباشران:

1. الحساب الإداري M1
2. الحساب الإداري M2

حساب Google [e-mail] هو مستخدم في C1.

حساب العميل C2

الحساب الإداري M2 هو الحساب الرئيسي المباشر الوحيد للحساب C2.

لا يمثّل أي من حسابات Google المُدرَجة مستخدمًا في C2.

يوضّح سيناريو الوصول المباشر وسيناريو وصول المشرف كيفية إعداد وجهة لإرسال البيانات إلى هذه الحسابات.

سيناريو الوصول المباشر

إذا كنت تريد إرسال بيانات إلى حساب على "إعلانات Google" وكانت بيانات الاعتماد خاصة بحساب Google مستخدَم في حساب "إعلانات Google":

العرض

الوجهة
operating_account	account_id رقم تعريف العميل الخاص بحساب "إعلانات Google" account_type GOOGLE_ADS
login_account	إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account	لا تضبط الحقل linked_account.
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على سيناريو الوصول المباشر، باستخدام الحسابات من المخطط وبيانات الاعتماد الخاصة بحساب Google [e-mail]:

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	لا تضبط العنوان linked-account.

سيناريو وصول المدير

إذا أردت إرسال بيانات إلى حساب على "إعلانات Google" وكانت بيانات الاعتماد خاصة بحساب Google مستخدَم في حساب إداري على "إعلانات Google" حيث يكون حساب المعلِن حسابًا فرعيًا:

العرض

الوجهة
operating_account	account_id الرقم التعريفي للعميل المتعلّق بحساب العميل على "إعلانات Google" account_type GOOGLE_ADS
login_account	account_id رقم تعريف العميل الخاص بالحساب الإداري على "إعلانات Google" account_type GOOGLE_ADS
linked_account	لا تضبط الحقل linked_account.
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على سيناريو وصول إداري إلى حساب عميل (C2) على "إعلانات Google" من المخطّط وبيانات اعتماد حساب Google ‏([e-mail]):

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال آخر على سيناريو وصول المدير إلى حساب العميل C2 على "إعلانات Google" وبيانات اعتماد حساب Google [e-mail]، وهو مستخدم في الحساب الإداري M1 على "إعلانات Google":

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	لا تضبط العنوان linked-account.

مساحة العرض والفيديو 360

يمكنك إرسال البيانات إلى "مساحة العرض والفيديو 360" باتّباع طريقتَين:

1. الوصول المباشر، حيث تكون بيانات الاعتماد خاصة بحساب Google يمثّل مستخدمًا في حساب المعلِن أو الشريك على "مساحة العرض والفيديو 360 ".
2. إذن وصول الشريك إلى "مساحة العرض والفيديو 360"، حيث تكون بيانات الاعتماد خاصة بحساب Google يملكه مستخدم في حساب الشريك على "مساحة العرض والفيديو 360"، ويكون الحساب التشغيلي هو حساب معلِن على "مساحة العرض والفيديو 360" ضمن حساب الشريك

سيناريوهات الوصول المباشر

إذا كنت تريد إرسال بيانات إلى حساب معلِن على "مساحة العرض والفيديو 360" وكانت بيانات الاعتماد خاصة بحساب Google تابع لمستخدم في حساب المعلِن، اتّبِع الخطوات التالية:

العرض

الوجهة
operating_account	account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_ADVERTISER
login_account	إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account	لا تضبط الحقل linked_account.
product_destination_id	معرّف شريحة الجمهور.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لسيناريو الوصول المباشر لإرسال البيانات إلى معلِن على "مساحة العرض والفيديو 360 ":

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	لا تضبط العنوان linked-account.

وبالمثل، إذا أردت إرسال بيانات إلى حساب شريك في "مساحة العرض والفيديو 360" وكانت بيانات الاعتماد الخاصة بك لحساب Google يملك إذن الوصول إلى حساب الشريك:

العرض

الوجهة
operating_account	account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_PARTNER
login_account	إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account	لا تضبط الحقل linked_account.
product_destination_id	معرّف شريحة الجمهور.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لسيناريو الوصول المباشر لإرسال البيانات إلى شريك في "مساحة العرض والفيديو 360 ":

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

سيناريو وصول الشريك إلى "مساحة العرض والفيديو 360"

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 360"، وكانت بيانات الاعتماد خاصة بحساب Google تابع لمستخدم في حساب الشريك الرئيسي الخاص بالمعلِن على "مساحة العرض والفيديو 360 "، اتّبِع الخطوات التالية:

العرض

الوجهة
operating_account	account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_PARTNER
linked_account	لا تضبط الحقل linked_account.
product_destination_id	معرّف شريحة الجمهور.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لسيناريو وصول الشريك إلى البيانات بهدف إرسالها إلى أحد المعلِنين على "مساحة العرض والفيديو 360 ". في هذه الحالة، يجب أن تكون بيانات الاعتماد خاصة بحساب Google تابع لمستخدم في حساب الشريك على "مساحة العرض والفيديو 360" DISPLAY_VIDEO_PARTNER_ID، ويجب أن يكون حساب المعلِن على "مساحة العرض والفيديو 360" DISPLAY_VIDEO_ADVERTISER_ID تابعًا لحساب الشريك DISPLAY_VIDEO_PARTNER_ID.

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

إحصاءات Google

ملاحظة: إذا كان operating_account هو حساب على "إحصاءات Google"، لا تضبط login_account أو اضبطه على القيم نفسها التي تم ضبط operating_account عليها. وفي حال عدم توفّرها، يتعذّر تنفيذ الطلب ويظهر الخطأ OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

العرض

الوجهة
operating_account	account_id معرّف الموقع على "إحصاءات Google" account_type GOOGLE_ANALYTICS_PROPERTY
login_account	إما لا تضبط login_account أو اضبطه على القيم نفسها التي ضبطتها في operating_account.
linked_account	لا تضبط الحقل linked_account.
product_destination_id	معرّف القياس لمصدر البيانات

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لإرسال الأحداث إلى "إحصاءات Google":

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	لا تضبط العنوان linked-account.

سيناريوهات شركاء البيانات

في ما يلي كيفية إعداد Destination للحالات الشائعة التي تخصّ شريك بيانات يرسل البيانات إلى حسابات المعلِنين التي تم ربطها بالمنتج بحساب شريك البيانات.

ملاحظة: في كل سيناريو من سيناريوهات شركاء البيانات، يجب أن تكون بيانات الاعتماد خاصة بحساب Google يملكه مستخدم في حساب شريك البيانات.

يوضّح هذا المخطّط البياني كيف تستخدم Data Manager API بيانات الاعتماد والحقول Destination للوصول إلى حساب المعلِن من خلال ربط المنتج.

إعلانات Google

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

شريك البيانات D1

يتوفّر رابط منتج بين الحساب D1 والحساب الإداري M2 على "إعلانات Google".

حساب Google [e-mail] هو مستخدم في D1.

شريك البيانات D2

يتوفّر رابط منتج بين الحساب D2 وحساب العميل C1 على "إعلانات Google".

حساب Google [e-mail] هو مستخدم في D2.

الحساب الإداري M1

يتضمّن الحساب الإداري (M1) حسابَين فرعيَين مباشرَين:

1. الحساب الإداري M2
2. حساب العميل C1

الحساب الإداري M2

يتضمّن الحساب الإداري (M2) حسابَين فرعيَّين مباشرَين:

1. حساب العميل C1
2. حساب العميل C2

حساب العميل C1

لدى الحساب C1 حسابان إداريان رئيسيان مباشران:

1. الحساب الإداري M1
2. الحساب الإداري M2

حساب العميل C2

الحساب الإداري M2 هو الحساب الرئيسي المباشر الوحيد للحساب C2.

في ما يلي الإجراءات التي يمكنك اتّخاذها باستخدام هذه المجموعة من الحسابات:

العمل بصفتك شريك بيانات D1

للتصرف كشريك بيانات D1، استخدِم بيانات اعتماد حساب Google [e-mail] لإرسال البيانات إلى الحساب الإداري M2 أو حساب العميل C1 أو حساب العميل C2، وذلك باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D1 وتم ضبط linked_account فيها على الحساب الإداري M2.

بصفتك شريك بيانات D1، لا يمكنك إرسال البيانات إلى الحساب الإداري M1 لأنّه لا يوجد ربط بين منتجَي D1 وM1.

العمل كشريك بيانات D2

للتصرف كشريك بيانات D2، استخدِم بيانات اعتماد حساب Google [e-mail] لإرسال البيانات إلى حساب العميل C1، وذلك باستخدام وجهة تم ضبط login_account فيها على حساب شريك البيانات D2 وتم ضبط linked_account فيها على حساب العميل C1.

بصفتك شريك بيانات D2، لا يمكنك إرسال بيانات إلى الحساب الإداري M1 أو الحساب الإداري M2 أو حساب العميل C2 لأنّه لا يوجد ربط منتج بين D2 وأي من هذه الحسابات أو حساباتها الإدارية الرئيسية.

يتمثّل الاختلاف الرئيسي بين شركاء البيانات D1 وD2 في طريقة ربط شريك البيانات بحسابات "إعلانات Google".

• تم ربط شريك البيانات D1 بحساب إداري على "إعلانات Google". هذا مثال على سيناريو ربط المنتج بالحساب الإداري.
• شريك البيانات D2 مرتبط بحساب عميل على "إعلانات Google". هذا مثال على سيناريو رابط المنتج المباشر.

سيناريو رابط المنتج المباشر

إذا كنت تريد إرسال البيانات إلى حساب على "إعلانات Google" وكان الربط بين حساب "إعلانات Google" وحساب شريك البيانات:

العرض

الوجهة
operating_account	account_id رقم تعريف العميل الخاص بحساب "إعلانات Google" account_type GOOGLE_ADS
login_account	account_id رقم تعريف العميل لحساب شريك البيانات account_type DATA_PARTNER
linked_account	لا تضبط الحقل linked_account.
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على سيناريو رابط مباشر للمنتج باستخدام حسابات من المخطّط، وعناوين الطلبات المقابلة لطلبات إدارة الموارد. في هذا السيناريو، يرسل شريك البيانات D2 بيانات أحد أفراد شريحة الجمهور إلى عميل "إعلانات Google" C1 باستخدام ربط المنتج بين D2 وC1، وبيانات اعتماد حساب Google [e-mail]:

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	لا تضبط العنوان linked-account.

سيناريو ربط المنتج بالحساب الإداري

إذا كنت تريد إرسال بيانات إلى حساب على "إعلانات Google" وكان رابط المنتج بين حساب إداري رئيسي على "إعلانات Google" وحساب شريك البيانات، اتّبِع الخطوات التالية:

العرض

الوجهة
operating_account	account_id الرقم التعريفي للعميل المتعلّق بحساب العميل على "إعلانات Google" account_type GOOGLE_ADS
login_account	account_id رقم تعريف العميل لحساب شريك البيانات account_type DATA_PARTNER
linked_account	account_id رقم تعريف العميل الخاص بالحساب الإداري على "إعلانات Google" account_type GOOGLE_ADS
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

في ما يلي مثال على سيناريو ربط منتج بحساب إداري باستخدام حسابات من المخطّط. في هذا السيناريو، يرسل شريك البيانات D1 بيانات أعضاء شريحة الجمهور إلى العميل C2 في "إعلانات Google" باستخدام رابط المنتج بين D1 وM2، وبيانات اعتماد حساب Google [e-mail]:

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

مساحة العرض والفيديو 360

بصفتك شريكًا في البيانات، يمكنك إرسال البيانات إلى حساب على "مساحة العرض والفيديو 360" باستخدام طريقتَين:

1. استخدام رابط منتج مباشر بين حساب شريك بيانات وحساب شريك أو حساب معلِن على "مساحة العرض والفيديو 360"
2. إرسال البيانات إلى أحد المعلِنين على "مساحة العرض والفيديو 360" باستخدام رابط منتج بين حساب أحد شركاء البيانات وحساب الشريك الرئيسي للمعلِن على "مساحة العرض والفيديو 360"

سيناريوهات روابط المنتجات المباشرة

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 360" وكان ربط المنتج بين حساب المعلِن على "مساحة العرض والفيديو 360" وحساب شريك البيانات:

العرض

الوجهة
operating_account	account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id رقم تعريف العميل لحساب شريك البيانات account_type DATA_PARTNER
linked_account	لا تضبط الحقل linked_account.
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لسيناريو ربط مباشر بين المنتجات بهدف إرسال البيانات إلى معلِن على "مساحة العرض والفيديو 360 "، وعناوين الطلبات المقابلة لطلبات إدارة الموارد:

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

إذا كنت تريد إرسال بيانات إلى حساب شريك على "مساحة العرض والفيديو 360"، يجب أن يكون لديك رابط منتج بين حساب الشريك على "مساحة العرض والفيديو 360" وحساب شريك البيانات.

العرض

الوجهة
operating_account	account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_PARTNER
login_account	account_id رقم تعريف العميل لحساب شريك البيانات account_type DATA_PARTNER
linked_account	لا تضبط الحقل linked_account.
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

في ما يلي مثال على Destination لسيناريو رابط منتج مباشر لإرسال البيانات إلى شريك في "مساحة العرض والفيديو 360 "، وعناوين الطلبات المقابلة لطلبات إدارة الموارد:

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	لا تضبط العنوان linked-account.

سيناريو ربط منتج شريك في "مساحة العرض والفيديو 360"

إذا كنت تريد إرسال بيانات إلى معلِن على "مساحة العرض والفيديو 360"، وكان رابط المنتج إلى حساب شريك البيانات الخاص بك مع حساب شريك على "مساحة العرض والفيديو 360" حيث يكون حساب المعلِن حسابًا فرعيًا:

العرض

الوجهة
operating_account	account_id رقم تعريف حساب المعلِن على "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id رقم تعريف العميل لحساب شريك البيانات account_type DATA_PARTNER
linked_account	account_id رقم تعريف حساب الشريك في "مساحة العرض والفيديو 360" account_type DISPLAY_VIDEO_PARTNER
product_destination_id	رقم تعريف الجمهور أو إجراء الإحالة الناجحة.

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

في ما يلي مثال على Destination لسيناريو ربط منتج شريك لإرسال البيانات إلى معلِن على "مساحة العرض والفيديو 360 " باستخدام رابط منتج بين شريك البيانات وشريك "مساحة العرض والفيديو 360 " الرئيسي للمعلِن:

العرض

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

إدارة الموارد

عناوين الطلبات
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

إحصاءات Google

لا تتيح Data Manager API إرسال البيانات إلى حساب على "إحصاءات Google" باستخدام رابط منتج. استخدِم نهج سيناريوهات المعلِنين في "إحصاءات Google" بدلاً من ذلك.

المتطلبات التفصيلية

يحتوي هذا القسم على متطلبات تفصيلية لحقول الحساب الخاصة Destination لطلب IngestionService، وعناوين الطلبات المكافئة لطلبات إدارة الموارد، ونصائح حول كيفية ضبط product_destination_id، وكيفية تحديد الأماكن التي يمكن أن تصل إليها بيانات الاعتماد.

حقول الحساب

يمكن أن يتضمّن Destination ما يصل إلى 3 حسابات مختلفة:

operating_account

operating_account مطلوب.

يشير operating_account إلى الحساب الذي يتلقّى البيانات في الطلب. يمكن أن تكون operating_account أيًّا ممّا يلي:

• حساب على "إعلانات Google"
• حساب مُعلِن على "مساحة العرض والفيديو 360"
• حساب شريك في "مساحة العرض والفيديو 360"
• موقع على "إحصاءات Google"
• حساب شريك بيانات في حال إرسال البيانات إلى شريحة جمهور يملكها حساب شريك البيانات

لا يتوفّر عنوان طلب يتوافق مع الحقل operating_account في Destination. عند إرسال طلب إدارة موارد، يكون الحساب المستهدف هو حساب التشغيل.

الحقل login_account وعنوان الطلب login-account

لا يكون login_account مطلوبًا دائمًا، ويتم ضبطه تلقائيًا على operating_account في طلب IngestionService، وعلى الحساب المستهدف في طلب إدارة الموارد. في طلب إدارة الموارد، استخدِم عنوان الطلب login-account لتحديد حساب تسجيل الدخول.

تتحقّق Data Manager API مما يلي:

1. حساب Google الذي تتضمّنه بيانات الاعتماد هو حساب مستخدم في حساب تسجيل الدخول.

2. حساب تسجيل الدخول هو أحد الحسابات التالية:

   • يجب أن يكون مطابقًا لـ operating_account. هذا هو الإعداد التلقائي في حال عدم ضبط login_account Destination في طلب IngestionService، أو عدم ضبط عنوان login-account في طلب إدارة الموارد.

   • حساب إداري على "إعلانات Google" أو حساب شريك على "مساحة العرض والفيديو 360" يكون حسابًا رئيسيًا operating_account في طلب IngestionService، أو حسابًا رئيسيًا للحساب المستهدَف في طلب إدارة الموارد

   • حساب شريك بيانات يتضمّن رابط منتج إلى linked_account في طلب IngestionService، أو إلى عنوان linked-account في طلب إدارة موارد.

الحقل linked_account وعنوان الطلب linked-account

ملاحظة: لا تحدّد حسابًا مرتبطًا إلا إذا كان حساب تسجيل الدخول مضبوطًا على DATA_PARTNER وكان الحساب الرئيسي الخاص بـ operating_account مرتبطًا بحساب شريك البيانات.account_type إذا كان operating_account مرتبطًا مباشرةً بحساب شريك البيانات، لا تضبط linked_account.

يشير الرمز linked_account إلى الحساب الذي يتضمّن رابط منتج إلى login_account في طلب IngestionService، أو إلى الحساب المستهدف في طلب إدارة الموارد.

رقم تعريف وجهة المنتج

يحدّد product_destination_id الخاص بـ Destination الكائن الذي يتلقّى البيانات في operating_account. على سبيل المثال، يمكن أن يكون هذا المعرّف معرّف شريحة جمهور في "إعلانات Google" أو "مساحة العرض والفيديو 360"، أو معرّف إجراء إحالة ناجحة في "إعلانات Google"، أو معرّف قياس لبيانات Google Analytics.

في ما يلي كيفية العثور على المعرّف لكل نوع من وجهات المنتجات.

شريحة جمهور في "إعلانات Google"

معرّف وجهة المنتج الذي يتم استخدامه لإدخال أفراد الجمهور هو معرّف الجمهور. يمكنك استرداد هذا المعرّف باستخدام واجهة مستخدم "إعلانات Google" أو Data Manager API.

واجهة مستخدم "إعلانات Google"

للحصول على رقم تعريف شريحة الجمهور من واجهة مستخدم "إعلانات Google"، اتّبِع الخطوات التالية:

1. انتقِل إلى مدير الجمهور في واجهة مستخدم "إعلانات Google".
2. انقر على اسم شريحة الجمهور للاطّلاع على التفاصيل.
3. يظهر رقم تعريف الجمهور بجانب رقم تعريف القائمة.

Data Manager API

استرجِع UserList باستخدام طريقة List، مع توفير عناوين الطلبات إذا لزم الأمر، واستخدِم id الخاص بـ UserList لمعرّف وجهة المنتج.

حدث "إعلانات Google"

معرّف وجهة المنتج الذي يتمّ استيعاب الأحداث منه هو معرّف إجراء الإحالة الناجحة.

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

1. انتقِل إلى الإحالات الناجحة في واجهة مستخدم "إعلانات Google".
2. انقر على اسم إجراء الإحالة الناجحة لعرض التفاصيل.

3. معرّف إجراء الإحالة الناجحة هو قيمة مَعلمة طلب البحث في عنوان URL التي تحمل الاسم ctId.

   https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
   

للحصول على رقم تعريف إجراء الإحالة الناجحة من Google Ads API، اتّبِع الخطوات التالية:

1. أرسِل طلب Search أو SearchStream إلى GoogleAdsService باستخدام الاستعلام التالي:

   SELECT
     conversion_action.id,
     conversion_action.name
   FROM conversion_action
   WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
   

2. احصل على رقم تعريف إجراء الإحالة الناجحة من الحقل id في conversion_action في الردّ.

   [
     {
       "results": [
         {
           "conversionAction": {
             "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
             "id": "CONVERSION_ACTION_ID",
             "name": "CONVERSION_ACTION_NAME"
           }
         }
       ]
     }
   ]
   

شريحة جمهور "مساحة العرض والفيديو 360"

معرّف وجهة المنتج الذي يتم استخدامه لإدخال أفراد الجمهور هو معرّف الجمهور. يمكنك استرداد رقم التعريف هذا باستخدام واجهة مستخدم "مساحة العرض والفيديو 360" أو Data Manager API.

واجهة مستخدم "مساحة العرض والفيديو 360"

للحصول على رقم تعريف شريحة الجمهور من واجهة مستخدم "مساحة العرض والفيديو 360"، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى واجهة مستخدم "مساحة العرض والفيديو 360" على https://displayvideo.google.com.
2. انتقِل إلى الشريك أو المعلِن على "مساحة العرض والفيديو 360" الذي تستخدمه في operating_account.
3. انتقِل إلى شرائح الجمهور في القائمة اليمنى، ثمّ اختَر كل شرائح الجمهور.
4. ابحث عن الجمهور في القائمة. معرّف الجمهور هو الرقم بجانب الاسم في عمود الاسم.

Data Manager API

استرجِع UserList باستخدام طريقة List، مع توفير عناوين الطلبات إذا لزم الأمر، واستخدِم id الخاص بـ UserList لمعرّف وجهة المنتج.

حدث "إحصاءات Google"

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

تحديد الأماكن التي يمكن فيها استخدام بيانات الاعتماد

إنّ بيانات الاعتماد التي تستخدمها لتفويض طلب Data Manager API مرتبطة بحساب Google معيّن.

• في حال استخدام بيانات اعتماد المستخدم، يتم منح الإذن للطلبات بصفتها حساب Google الخاص بالمستخدم الذي منح الإذن بالتصرّف نيابةً عنه عند إنشاء بيانات الاعتماد.
• في حال استخدام بيانات اعتماد حساب الخدمة، يتم تفويض الطلبات بصفتها حساب Google الخاص بحساب الخدمة.

إليك كيفية التأكّد من أنّ حساب Google الذي تستخدمه في بيانات الاعتماد لديه إذن الوصول إلى حساب على "إعلانات Google" أو "مساحة العرض والفيديو 360" أو "إحصاءات Google".

"إعلانات Google" أو شريك البيانات

1. انتقِل إلى الوصول والأمان في واجهة مستخدم "إعلانات Google" للحساب login_account.
2. انقر على علامة التبويب المستخدمون.
3. إذا كان login_account حسابًا إداريًا على "إعلانات Google"، أوقِف مفتاح التبديل عرض المستخدمين في التدرّج الهرمي الكامل لإخفاء المستخدمين من الحسابات الفرعية.
4. تأكَّد من أنّ حساب Google الذي تمّ إدخال بيانات الاعتماد الخاصة به يظهر في قائمة الحسابات ضمن علامة التبويب المستخدمون.

مساحة العرض والفيديو 360

1. انتقِل إلى إدارة المستخدم وإعدادات البريد الإلكتروني في واجهة مستخدم "مساحة العرض والفيديو 360".
2. تأكَّد من أنّ إدارة المستخدمين توضّح أنّ حساب Google الخاص ببيانات الاعتماد هو حساب مستخدم على login_account.

إحصاءات Google

1. انتقِل إلى إدارة أذونات الوصول إلى الموقع في واجهة مستخدم "إحصاءات Google".
2. تأكَّد من اختيار موقع "إحصاءات Google" المحدّد في login_account.
3. تأكَّد من أنّ حساب Google الذي تستخدمه في بيانات الاعتماد لديه دور المحرِّر أو المشرف في الموقع.