Shadowley की वैल्यू का विश्लेषण

Shapley वैल्यू का तरीका एक एल्गोरिदम है, जो कई विज्ञापन चैनलों और टचपॉइंट को कन्वर्ज़न में उनके योगदान के आधार पर क्रेडिट असाइन करता है. Shapley वैल्यू के तरीके का इस्तेमाल करके, कन्वर्ज़न में किसी खास चैनल के योगदान को मॉडल किया जा सकता है.

Ads Data Hub, "सिंप्लिफ़ाइड शेपली वैल्यू मेथड" का इस्तेमाल करता है. इसके बारे में ज़्यादा जानकारी के लिए, इस ऑनलाइन विज्ञापन का पेपर.

ध्यान दें: Shapley वैल्यू मॉडल का इस्तेमाल सिर्फ़ डेटा ट्रांसफ़र-आधारित प्रक्रिया के साथ किया जा सकता है टेबल: cm_dt_*, dv360_dt_*.

निजता से जुड़ी पाबंदियां

प्राइवसी फ़िल्टर, 50 से कम उपयोगकर्ताओं वाले टचपॉइंट को हटा देते हैं. साथ ही, ऐसे टचपॉइंट को भी हटा देते हैं जिनके टचपॉइंट के लिए क्रेडिट का सही अनुपात में योगदान नहीं होता. इसलिए, हो सकता है कि Shapley वैल्यू मॉडल के आउटपुट में कुछ टचपॉइंट मौजूद न हों, जो इनपुट टचपॉइंट की टेबल में हैं.

Shapley वैल्यू मॉडल के हर बार के बाद, निजता से जुड़े मैसेज दिखते हैं. इन मैसेज में, फ़िल्टर किए गए उपयोगकर्ताओं और टचपॉइंट की जानकारी शामिल होती है.

शेपली वैल्यू की वैल्यू की गणना करने के बारे में खास जानकारी

1. टचपॉइंट और क्रेडिट टेबल बनाएं:
   1. touchpoint_temp_table.
   2. user_credit_temp_table.
2. ऊपर दी गई अस्थायी टेबल को आर्ग्युमेंट के तौर पर इस्तेमाल करके, ADH.TOUCHPOINT_ANALYSIS टेबल की वैल्यू वाले फ़ंक्शन को कॉल करें.

टचपॉइंट और क्रेडिट टेबल बनाना

टचपॉइंट टेबल बनाएं

टचपॉइंट की टेबल में, टचपॉइंट से जुड़े उपयोगकर्ता इवेंट तय किए जाते हैं. उदाहरण के तौर पर दिए गए डेटा में campaign_id, creative_id, placement_id या site_id के अलावा और भी चीज़ें शामिल हो सकती हैं.

ध्यान दें: फ़िलहाल, Shapley वैल्यू का विश्लेषण ज़्यादा से ज़्यादा 150 टचपॉइंट तक किया जा सकता है.

टेबल में ये कॉलम होने चाहिए:

कॉलम का नाम	टाइप
touchpoint	string आर्बिट्ररी टचपॉइंट का नाम. (शून्य नहीं होना चाहिए या उसमें कॉमा नहीं होने चाहिए.)
user_id	string टचपॉइंट पर जाने वाले उपयोगकर्ता का आईडी. (शून्य या शून्य नहीं होना चाहिए.)
event_time	int उपयोगकर्ता के टचपॉइंट पर जाने का समय. (शून्य नहीं होना चाहिए.)

चेतावनी: अलग-अलग टचपॉइंट की कुल संख्या 150 से ज़्यादा होने पर या user_credit_temp_table में user_id मौजूद न होने पर, क्वेरी फ़ेल हो जाएगी.

टेबल बनाने के लिए सैंपल कोड:

CREATE TABLE touchpoint_temp_table
AS (
  SELECT user_id, event.event_time, CAST(event.site_id AS STRING) AS touchpoint
  FROM adh.cm_dt_impressions
  WHERE
    event.event_type IN ('VIEW')
    AND user_id <> '0'
    AND event.campaign_id IN UNNEST(@campaign_ids)

  UNION ALL

    SELECT
      user_id, event.event_time, CAST(event.site_id AS STRING) AS touchpoint
    FROM adh.cm_dt_clicks
    WHERE
      event.event_type IN ('CLICK')
      AND user_id <> '0'
      AND event.campaign_id IN UNNEST(@campaign_ids)
);

उपयोगकर्ता की क्रेडिट टेबल बनाना

उपयोगकर्ता की क्रेडिट टेबल वह जगह होती है जहां कन्वर्ज़न इवेंट तय किए जाते हैं. हर उपयोगकर्ता के लिए, सिर्फ़ कन्वर्ज़न से पहले के टाइमस्टैंप वाले इवेंट गिने जाते हैं.

टेबल में ये कॉलम होने चाहिए:

कॉलम का नाम	टाइप
user_id	string टचपॉइंट पर जाने वाले उपयोगकर्ता का आईडी. (शून्य या शून्य नहीं होना चाहिए.)
event_time	int वह समय जब योगदान इवेंट हुआ. (शून्य नहीं होना चाहिए.)
credit	integer उपयोगकर्ता का दिया गया क्रेडिट. इसके लिए, कोई भी क्रेडिट प्रॉडक्ट का विश्लेषण किया जा सकता है. उदाहरण के लिए, कन्वर्ज़न वैल्यू, कन्वर्ज़न की संख्या वगैरह. यह 1 से 100 के बीच होना चाहिए.

ध्यान दें: अगर किसी एक उपयोगकर्ता के पास कई कन्वर्ज़न इवेंट हैं, तो उन्हें किसी दूसरे इवेंट की तरह ही अपलोड करें. पक्का करें कि किसी भी इवेंट में user_id और event_time के डुप्लीकेट पेयर का इस्तेमाल न किया गया हो.

टेबल बनाने के लिए सैंपल कोड:

CREATE TABLE user_credit_temp_table AS (
  SELECT
    user_id,
    MAX(event.event_time) AS event_time,
    1 AS credit
  FROM adh.cm_dt_activities_attributed
  WHERE user_id <> '0'
    AND event.campaign_id IN UNNEST(@campaign_ids)
    AND DATE(TIMESTAMP_MICROS(event.event_time)) BETWEEN @start_date AND @end_date
    AND event.activity_id IN UNNEST (@activity_ids)
  GROUP BY user_id
);

टेबल की वैल्यू वाला फ़ंक्शन

टेबल की वैल्यू वाला फ़ंक्शन ऐसा फ़ंक्शन है जो नतीजे के तौर पर टेबल दिखाता है. इस तरह, किसी सामान्य टेबल की तरह ही, टेबल की वैल्यू वाले फ़ंक्शन से क्वेरी की जा सकती है.

सिंटैक्स

ADH.TOUCHPOINT_ANALYSIS(TABLE touchpoints_tmp_table_name, TABLE credits_tmp_table_name, STRING model_name)

तर्क

नाम
touchpoints_tmp_table_name	क्लाइंट के बनाए गए अस्थायी टचपॉइंट की टेबल का नाम. टेबल में स्कीमा होना ज़रूरी है, जिसमें touchpoint, user_id, और event_time कॉलम शामिल हों.
credits_tmp_table_name	क्लाइंट के बनाए गए अस्थायी उपयोगकर्ता क्रेडिट टेबल का नाम. टेबल में स्कीमा होना ज़रूरी है, जिसमें user_id, credit, और conversion_time कॉलम शामिल हों.
model	string SHAPLEY_Values होनी चाहिए.

आउटपुट टेबल

आउटपुट टेबल में यह स्कीमा शामिल होगा:

कॉलम का नाम	टाइप
touchpoint	string टचपॉइंट का नाम.
score	integer इस टचपॉइंट के लिए, Shapley की वैल्यू स्कोर का हिसाब लगाया.

टेबल की वैल्यू वाले फ़ंक्शन का इस्तेमाल करने के लिए सैंपल कोड

SELECT *
FROM ADH.TOUCHPOINT_ANALYSIS(
  TABLE tmp.touchpoint_temp_table,
  TABLE tmp.user_credit_temp_table,
  'SHAPLEY_VALUES')