Verifica dell'identità dell'inserzionista

Offrire agli utenti un ecosistema pubblicitario sicuro e affidabile e rispettare normative emergenti, Google ora richiede agli inserzionisti di completare uno o più programmi di verifica.

Se ti viene richiesto di completare un programma di verifica, è possibile che sia stata impostata una scadenza per la procedura di verifica. Se la scadenza viene trascorsa senza verifica il tuo account potrebbe essere messo in pausa.

Puoi anche sottoporti alla verifica in modo proattivo senza dover farlo. La IdentityVerificationService offre metodi per:

• Recuperare lo stato della procedura di verifica per un account cliente, incluse eventuali scadenze
• Avviare una procedura di verifica

Recuperare lo stato della verifica

Per recuperare lo stato della procedura di verifica dell'identità dell'inserzionista per un account cliente, chiama il metodo GetIdentityVerification:

This example is not yet available in Java; you can take a look at the other languages.
    

private static IdentityVerification GetIdentityVerification(
        GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V17.IdentityVerificationService);

    try {
        GetIdentityVerificationResponse response =
            identityVerificationService.GetIdentityVerification(
                new GetIdentityVerificationRequest()
                {
                    CustomerId = customerId.ToString()
                }
            );

            if (response.IdentityVerification.Count == 0)
            {
                return null;
            }

            IdentityVerification identityVerification = response.IdentityVerification[0];
            string deadline =
                identityVerification.IdentityVerificationRequirement.VerificationCompletionDeadlineTime;
             IdentityVerificationProgress identityVerificationProgress =
                identityVerification.VerificationProgress;
            Console.WriteLine($"Account {customerId} has a verification completion " +
                $"deadline of {deadline} and status " +
                $"{identityVerificationProgress.ProgramStatus} for advertiser identity " +
                "verification.");

            return identityVerification;
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }


}
VerifyAdvertiserIdentity.cs
      

This example is not yet available in PHP; you can take a look at the other languages.
    

This example is not yet available in Python; you can take a look at the other languages.
    

def get_identity_verification(client, customer_id)
  response = client.service.identity_verification.get_identity_verification(
    customer_id: customer_id
  )

  return nil if response.nil? || response.identity_verification.empty?

  identity_verification = response.identity_verification.first
  deadline = identity_verification.
    identity_verification_requirement.
    verification_completion_deadline_time
  progress = identity_verification.verification_progress
  puts "Account #{customer_id} has a verification completion deadline " \
    "of #{deadline} and status #{progress.program_status} for advertiser " \
    "identity verification."

  identity_verification
end
verify_advertiser_identity.rb
      

sub get_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $response = $api_client->IdentityVerificationService()->get({
    customerId => $customer_id
  });

  if (!defined $response->{identityVerification}) {
    printf "Account %s does not require advertiser identity verification.",
      $customer_id;
    return;
  }

  my $identity_verification = $response->{identityVerification}[0];
  my $deadline = $identity_verification->{identityVerificationRequirement}
    {verificationCompletionDeadlineTime};
  my $identity_verification_progress =
    $identity_verification->{verificationProgress};

  printf "Account %s has a verification completion deadline of %s and status " .
    "%s for advertiser identity verification.", $customer_id, $deadline,
    $identity_verification_progress->{programStatus};
  return $identity_verification;
}
verify_advertiser_identity.pl
      

Se l'account del cliente è registrato nell'identità dell'inserzionista obbligatoria di verifica, il servizio restituisce una risposta non vuota contenente di oggetti IdentityVerification. Un la risposta vuota indica che l'account del cliente non deve sottoporsi verifica dell'identità dell'inserzionista.

A partire dalla versione 16, l'API Google Ads supporta solo il ADVERTISER_IDENTITY_VERIFICATION programma, quindi sarebbe l'unico elemento dell'elenco.

Un oggetto IdentityVerification contiene le seguenti proprietà:

• Una IdentityVerificationRequirement che descrive le scadenze per avviare e completare la procedura di verifica

• Un elemento IdentityVerificationProgress che descrive lo stato attuale della la procedura di verifica, che può includere anche l'URL di azione per l'utente per completare la procedura di verifica.

Avvia il processo di verifica

Se un account cliente è registrato nell'identità dell'inserzionista obbligatoria programma di verifica - GetIdentityVerification ha restituito un campo non vuoto con una scadenza per il completamento della procedura di verifica, puoi iniziare una sessione di verifica chiamando il numero StartIdentityVerification:

This example is not yet available in Java; you can take a look at the other languages.
    

private static void StartIdentityVerification(GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V17.IdentityVerificationService);

    StartIdentityVerificationRequest request = new StartIdentityVerificationRequest()
    {
        CustomerId = customerId.ToString(),
        VerificationProgram = IdentityVerificationProgram.AdvertiserIdentityVerification
    };

    try {
        identityVerificationService.StartIdentityVerification(request);
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
VerifyAdvertiserIdentity.cs
      

This example is not yet available in PHP; you can take a look at the other languages.
    

This example is not yet available in Python; you can take a look at the other languages.
    

def start_identity_verification(client, customer_id)
  client.service.identity_verification.start_identity_verification(
    customer_id: customer_id,
    verification_program: :ADVERTISER_IDENTITY_VERIFICATION,
  )
end
verify_advertiser_identity.rb
      

sub start_identity_verification {
  my ($api_client, $customer_id) = @_;

  my $request =
    Google::Ads::GoogleAds::V17::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

  $api_client->AdvertiserIdentityVerificationService()
    ->start_identity_verification($request);
}
verify_advertiser_identity.pl
      

Questa operazione avrà esito positivo solo se non è in corso un'altra sessione di verifica. una volta avviata una sessione di verifica, le chiamate successive a GetIdentityVerification restituirà l'URL di azione che l'utente dovrà completare il processo di verifica e la scadenza dell'URL di azione.

Una volta trascorsa la scadenza, potrai chiamare StartIdentityVerification di nuovo per avviare una nuova sessione di verifica.